CodexをVS Codeに導入してみた|Windowsの権限エラーに苦戦した解決記録

CodexをVS Codeに導入してみた|Windowsの権限エラーに苦戦した解決記録【AI株ツール開発】 AIツール

CodexをVS Codeに導入したところ、ファイルが読み取り専用になり、Pythonコードを編集できない問題が発生しました。さらに、Windows SandboxのセットアップやGit操作でも権限エラーが続き、導入に苦戦しました。

最終的には、codex doctorでSandboxの問題を特定し、管理者PowerShellから設定をやり直すことで解決しました。その後、Codexによるコードの直接編集、バックテスト実行、GitHubへのcommit・pushまで成功しています。

この記事では、実際に発生したエラー、解決できなかった操作、最終的に成功した手順を紹介します。同じエラーで困っている方が、原因を切り分ける際の参考になれば幸いです。

※この記事は2026年9月に私のWindows環境で行った導入記録です。CodexのバージョンやPC環境によって、設定画面や必要な操作は異なる可能性があります。

今回発生したエラー・トラブル一覧

同じエラーに遭遇した方は、以下の一覧から該当する対処記録へ移動できます。

Codexを導入した理由:コードのコピー&ペーストを減らしたかった

これまではChatGPTにPythonコードを作ってもらい、自分でVS Codeへ貼り付けて実行していました。

この方法でも、株価データの取得、RSIやMACDなどのテクニカル指標計算、複数銘柄のスコアリング、バックテストまで開発できました。

しかし、プログラムが複数のファイルに分かれるようになると、修正箇所の特定やコードの貼り付けに時間がかかるようになりました。

  1. ChatGPTに実装方法を相談する
  2. 提示されたコードをVS Codeに貼り付ける
  3. Pythonを実行する
  4. エラーが出たらスクリーンショットを撮る
  5. ChatGPTに確認して修正する

特に困ったのが、「どのファイルの、どこを変更するのか」を自分で確認しなければならないことです。修正する場所を間違えたり、インデントが崩れたりすることも気になります。

そこで、既存のプロジェクトを直接調査し、必要なファイルを編集できるCodexをVS Codeに導入することにしました。

Codexを導入したが、ファイルが読み取り専用だった

今回Codexを導入したのは、Windows PC上の日本株AI自動売買ツール開発プロジェクトです。

プロジェクトの保存先は、次のようなフォルダです。

C:\Users\<ユーザー名>\japan-stock-ai

Codexから既存のプロジェクトを認識できたため、最初は問題なく使えると思いました。

ところが、環境を確認すると、ファイルシステムが「読み取り専用」になっていました。

コードを読むことはできても、Codex自身がファイルを書き換えられない状態です。これでは、導入した目的を達成できません。

「Approve for me」に変更できない

最初に確認したのはCodexの承認設定でした。

当時の画面には「Ask for approval」「Approve for me」「Full access」「Custom(config.toml)」などの選択肢がありました。

「Approve for me」に変更しようとしましたが、クリックしてもチェックマークが付かず、設定が切り替わりません。

この時点では、承認設定とファイルへの書き込み権限がどう関係しているのかも理解できていませんでした。

config.tomlを変更しても解決しなかった

次に、Codexの設定ファイルを確認しました。

C:\Users\<ユーザー名>\.codex\config.toml

ChatGPTに相談しながら設定を変更し、Codex側でも「Custom(config.toml)」として認識されるようになりました。

しかし、ファイルシステムは読み取り専用のまま。設定ファイルを変更するだけでは解決しませんでした。

この段階で分かったのは、承認設定を変更することと、Windows側のSandboxが正常に動作することは別の問題だという点です。

Windows Sandboxのセットアップでもエラーが発生

さらに、Codexへメッセージを送ろうとすると、次のエラーが表示されました。

Unable to send message
Update Agent sandbox to continue
Finish Windows setup to continue

そこでWindows側のセットアップを実行しましたが、今度はユーザーアカウント制御(UAC)の確認画面が何度も表示されました。

途中では「指定されたモジュールが見つかりません。」というエラーも発生。codex-windows-sandbox-setup.exeに関連するものでした。

承認設定を変更しても直らず、Windowsセットアップでもエラーが出る状態です。

そこで、設定を手探りで変更し続けるのではなく、Codexの環境診断を実行して問題を切り分けることにしました。

codex doctorでSandboxの問題を特定

実行したのが、次のコマンドです。

codex doctor

これはCodexの環境状態を確認するために、当時利用した診断コマンドです。私はWindowsのターミナルから実行しました。

診断結果には、次の表示がありました。

elevated Windows sandbox provisioning is incomplete or outdated
sandbox provisioning: incomplete

一方、Git、VS Code、Codex本体、認証、ネットワーク接続などは正常と判定されていました。

この結果から、Windows用Sandboxのセットアップが正常に完了していない可能性が高いと分かりました。

Codex導入時のエラーとcodex doctorによるSandbox診断結果
実際に発生したCodexのエラーと、Sandboxの問題を診断した記録。

今回のトラブルでは、codex doctorによって調査対象を絞れたことが大きな転機でした。

管理者PowerShellでSandboxを設定し直した

原因がSandboxにありそうだと分かったため、WindowsのスタートメニューからPowerShellを管理者として起動しました。

以下は、Codexのチャット欄ではなく、管理者PowerShellに入力したコマンドです。

最初のコマンドは引数不足だった

最初に実行したのは、次のコマンドです。

codex sandbox setup --elevated

ところが、required arguments were not providedと表示されました。

当時の環境では、--userまたは--current-userの指定が必要だったため、次のように変更しました。

codex sandbox setup --elevated --current-user

今度はセットアップ完了のメッセージが表示されました。しかし、その後の診断では依然としてincompleteが残っていました。

再起動後も改善せず、ユーザーと保存先を明示した

PCを再起動しても状態は変わりませんでした。

そこで、再び管理者PowerShellを開き、対象ユーザーとCodexのホームディレクトリを明示してセットアップを実行しました。

codex sandbox setup --elevated --user <ユーザー名> --codex-home C:\Users\<ユーザー名>\.codex

※<ユーザー名>は実際のWindowsユーザー名に置き換える部分です。これは当時の私の環境で実行したコマンドであり、すべての環境で同じ操作が必要という意味ではありません。管理者権限を使う操作のため、実行前に対象ユーザーと保存先を確認してください。

その後、再度codex doctorを実行すると、以前は警告になっていたSandboxが次の表示に変わりました。

✓ sandbox

最終的な診断結果は18 ok / 0 failでした。

Microsoft DefenderやWindows Dev Driveに関する警告は残っていましたが、Codexの動作を妨げるエラーは解消されたため、開発を再開しました。

今回の環境では、承認設定やconfig.tomlを変更するだけでは解決せず、対象ユーザーとCodexの保存先を明示してSandboxを再設定したことが解決につながりました。

CodexでPythonコードを直接修正できた

Sandboxの診断が正常になっただけでは、導入成功とは言えません。実際の開発で使えるか確認しました。

検証に使ったのは、開発中の日本株AI自動売買ツールです。

対象ファイルは次のPythonプログラムでした。

backtest/simple_backtest.py

依頼した内容は、バックテストの取引結果として保存する情報を増やすことです。

具体的には、売買日、売買価格、損益、損益率、保有日数、買いシグナル時のスコアなどを、取引ごとに記録できるようにしました。

このときCodexには、既存のBUY/SELL判定ロジックを変更しないという条件も伝えています。

Codexは既存コードを調査したうえで、必要な箇所を直接編集しました。以前のように、ChatGPTから修正コードを受け取って自分で貼り付ける作業は不要でした。

修正前後でバックテスト結果が変わらないことも確認

今回の目的は取引結果の保存項目を増やすことであり、売買ルールを変更することではありません。

そこで、Codexにバックテストを実行してもらい、従来の結果と一致するか確認しました。

項目検証結果
決済済み取引12回
勝ち7回
負け5回
勝率58.3%
平均損益1,109円
最大利益6,055円
最大損失-2,592円
合計損益13,310円

※この表は当時のバックテストプログラムが出力した検証結果です。実際の投資収益ではありません。「平均損益」は全12取引を対象とした平均値です。

結果は修正前と一致しました。

つまり、保存する情報を増やしながら、既存の売買判定と集計結果を維持できたことを確認できました。

コードを書き換えるだけでなく、変更によって既存機能に影響が出ていないか確認できた点も、Codexを使うメリットだと感じました。

Git操作でも権限エラーが発生した

CodexによるPythonコードの修正とバックテストが成功したため、次は変更内容をGitHubへ保存することにしました。

ところが、CodexにGitのステージングを依頼すると、git addで次のエラーが発生しました。

fatal: Unable to create '.git/index.lock': Permission denied

.git/index.lockは、Gitがインデックスを更新する際に使用するロックファイルです。今回のエラーは、このファイルを作成できず、ステージングに失敗したことを示しています。

すでにWindows Sandboxのセットアップは正常になっており、CodexによるPythonファイルの編集も成功していました。しかし、Gitの管理領域への書き込みでは、別途権限の承認が必要でした。

解決方法:Codexの追加権限を承認して再実行

今回の環境では、Codexが求めた追加の権限を承認し、Git操作を再実行することで解決しました。

実際に行った対応は次のとおりです。

  1. git addでPermission deniedが発生したことを確認する
  2. Codexが提示した追加の権限承認を確認する
  3. 実行する操作の内容を確認して承認する
  4. Codexにステージングを再実行してもらう
  5. ステージ対象と変更差分を確認し、commit・pushを実行する

この対応によって、今回変更したbacktest/simple_backtest.pyだけをステージできました。

なお、当時の記録からは承認画面の具体的なボタン名までは確認できません。そのため、画面上の表示を決めつけず、実行しようとしている操作を確認したうえで承認することが重要です。

commit・pushまで成功した

権限エラーを解消した後は、変更差分の確認、commit、push、Gitの状態確認まで実行しました。

作成されたcommitは次のとおりです。

497a543 Step36-2: store structured trade results

origin/mainへのpushも成功し、ローカルのmainと同期していることを確認できました。

また、未追跡ファイルだったdata/8035_backtest.csvには触れず、意図したPythonファイルだけをGitHubへ反映できました。

CodexにGit操作を任せる場合でも、意図しないファイルを追加していないか、commit前に確認することは欠かせません。

同じエラーが出た場合の注意点

index.lockの作成に失敗する原因は、必ずしもCodexの権限設定とは限りません。別のGit操作が実行中だったり、ファイルのアクセス権に問題があったりする場合もあります。

今回の環境では、追加の権限承認によって解決したため、Windowsのファイル権限を変更したり、index.lockを削除したりする必要はありませんでした。

同じエラーが表示された場合は、まずCodexが追加の承認を求めていないか確認してください。承認しても解決しない場合は、ほかのGit操作が実行中でないか、対象フォルダへの書き込み権限に問題がないかを切り分ける必要があります。

今回のポイントは、Windows Sandboxの診断が正常になっても、Git操作では別途権限承認が必要になる場合があるということです。

CodexによるPythonコード修正、Gitの権限エラー解消、GitHubへの反映記録
Codexでコードを修正し、追加の権限承認を経てGitHubへのcommit・pushまで実行した記録。

ChatGPTのコピペ開発から何が変わったのか

実際にCodexを使えるようになって、一番変わったのはAIと自分の間でコードを受け渡す作業が減ったことです。

ChatGPTによる手動コピペ開発とCodexによる直接編集の比較

これまでは、コードを受け取った後のファイル編集や実行操作を自分で行っていました。

Codexでは、目的と変更条件を伝えれば、既存コードの調査、ファイル編集、テスト実行まで一連の作業として進められます。

ただし、すべてを無条件で任せられるわけではありません。

今回もGit操作では権限承認が必要でした。また、変更対象が正しいか、売買ロジックに意図しない影響がないか、テスト結果が妥当かは引き続き確認する必要があります。

私にとっての大きな変化は、コードの貼り付け作業から、変更内容と検証結果を確認する作業へ時間を使えるようになったことでした。

同じようなエラーに遭遇したら確認したいこと

今回の経験から、Codexがファイルを編集できない場合には、エラー表示を確認して問題を切り分けることが重要だと分かりました。

私の場合、次の順番で原因が見えてきました。

  1. Codexが対象プロジェクトを認識しているか確認する
  2. 読み取り専用など、実際の制限内容を確認する
  3. 承認設定とconfig.tomlを確認する
  4. Windows Sandboxに関するエラー表示を確認する
  5. 利用中のCodexで診断コマンドが使える場合は環境を診断する
  6. 診断結果に応じて必要なセットアップを行う
  7. 再診断し、実際にファイルを編集できるか試す

特に初心者の場合は、コマンドを「何に入力するのか」も確認した方がよいと思います。

今回使用したセットアップコマンドは管理者PowerShellで実行しました。一方、Codexへの開発依頼はVS Code上のCodexに入力しています。

また、Sandboxや権限に関する設定を安易に緩めるのではなく、エラー内容と必要な権限を確認して対処することが重要です。

まとめ:Codexの導入で確認できたこと

今回、Windows PCのVS Code環境にCodexを導入し、実際の開発プロジェクトで動作を確認しました。

導入から動作確認までに得られた結果は、次のとおりです。

  • 環境診断:codex doctorでSandboxの問題を特定し、最終的に18 ok / 0 failを確認した
  • コード編集:CodexでPythonファイルを直接修正し、バックテストの結果が変わらないことを確認した
  • GitHub連携:追加の権限承認でGitのエラーを解消し、対象ファイルのcommit・pushまで実行できた

今回の経験で、Codexはコードの貼り付け作業を減らす一方、変更内容やテスト結果を人間が確認することは引き続き重要だと分かりました。

Codexの導入で同じエラーに遭遇した場合は、まず表示されたエラーを確認し、Sandboxの問題なのか、個別の操作に必要な権限の問題なのかを切り分けることをおすすめします。

自動売買ツール開発の現在地

この記事は、2026年9月にCodexをWindowsの開発環境へ導入したときの記録です。

その後も、バックテストの改善やPaper Tradingに向けた機能開発を進めています。

開発の全体像や各段階の検証結果は、以下のページにまとめています。

日本株AI自動売買ツール開発記録|未経験から実運用を目指すまで

コメント

タイトルとURLをコピーしました