VS Code で Codex を使用する場合、通常、エディター拡張機能、ログイン セッション、ワークスペースの信頼、およびローカル ファイルのアクセス許可を同時に処理する必要があります。特定の手順が完了していない場合、表面的な症状は「実行できない」または「プロジェクトが読み込まれない」である可能性があるため、トラブルシューティングはスタートアップ リンクに基づいて行う必要があります。
インストールとログイン
VS Code 拡張機能マーケットまたは Codex の現在の公式入口から拡張機能をインストールします。ログイン後、信頼できる共通のローカル リポジトリでテストします。拡張機能、デスクトップ、および CLI の機能と入り口は異なる場合があります。古いチュートリアルのボタンの位置に依存しないでください。現在のインターフェイスが優先されます。
ワークスペースの権限が重要な理由
VS Code のワークスペース信頼メカニズムは、タスク、ターミナル、拡張機能、またはスクリプトの動作を制限します。ダウンロード フォルダー、一時ディレクトリ、またはリモート マウント ディレクトリを開いた場合は、まずそれが信頼できるかどうかを確認してください。不明なソースからのリポジトリの場合、エージェントが動作できるようにするためにすべての権限を直接付与しないでください。
読み取り専用分析、単一ファイルの変更、または小規模なテストから始めて、プロジェクト構造を理解していることを確認してから、テストまたは大規模な変更を許可することをお勧めします。
よくある質問
拡張機能はインストールされていると表示されますが、ログインしていないか、応答できません。
VS Code を再度開き、ネットワーク、ログイン セッション、および拡張出力ログを確認します。アカウントの使用が制限されている場合は、まず製品インターフェイスに表示される実際のプロンプトを読み、制限をインストールの失敗と誤判断しないでください。
Codex がプロジェクト ファイルを読み取れません
孤立したファイルではなく、リポジトリのルートを開いていることを確認してください。ワークスペースの信頼、ファイル システムのアクセス許可、.gitignore を超える追加のアクセス ルールを確認してください。 Windows では、端末で使用される実際のシェル変数と環境変数にも注意を払う必要があります。
コマンドまたは端末エラー
エラー レポートをコマンド、ディレクトリ、および再現可能な手順にまとめます。 PowerShell のパス、引用符、環境変数に関する問題については、「Windows PowerShell で Codex を実行するときのエラーのトラブルシューティング」(/ja/2026/07/10/windows-powershell-codex-error-troubleshooting/) を参照してください。
毎日の使用に関する提案
明確なタスクを送信します。ターゲット ファイル、受け入れ方法、および変更不可能な範囲を記述します。 Codex に最初に変更計画または位置付け結果を提供させ、次にそれらを段階的に実行させます。資格情報、実稼働構成、またはバッチ削除に関連する操作は明確にレビューする必要があります。
概要
VS Code で Codex を安定して使用するには、正しい拡張機能、有効なログイン、信頼できるワークスペース、および最小限の権限が必要です。問題が発生した場合は、まずエディター、アカウント、またはファイルのアクセス許可レベルで問題が発生しているかどうかを確認します。解決策ははるかに速くなります。
初めてのユーザーに推奨されるプロセス
- VS Code を使用してウェアハウスのルート ディレクトリを開き、言語、依存関係、およびテスト コマンドがローカルで正常に実行できることを確認します。
- Codex ポータルをインストールしてログインした後、プロジェクト構造の読み取りまたはファイルの解釈を依頼するだけです。
- テストの追加、コピーの修正、関数の整理など、簡単に検証できる小さな問題を修正させます。
- 差分を確認し、プロジェクトの既存のテストを実行します。
- 上記のプロセスが安定したら、徐々に広範囲のコマンドの実行や複数ファイルのタスクの処理を許可していきます。
これにより、エディターの統合、認証、ファイル アクセス、プロジェクト環境を個別に検証できます。最初のステップでエージェントに倉庫全体の再構築を依頼すると、報告されたエラーを特定するのが難しくなり、レビューコストが高くなります。
ワークスペースの信頼と権限の境界
「信頼ワークスペース」は、自分が保守またはレビューしたリポジトリにのみ付与する必要があります。リポジトリが信頼されている場合でも、コマンドの実行範囲には注意する必要があります。ファイルの読み取り、現在のファイルの変更、単体テストの実行、依存関係のインストール、スクリプトの実行にはさまざまなリスクがあります。実稼働資格情報、デプロイメント・スクリプト、または顧客データを含むプロジェクトの場合は、アクセス不可能なスコープを明示的に設定することから始めます。
特に、.env、キー ファイル、クラウド構成、デプロイメント ディレクトリ、およびビルドがタスクによって誤って読み取られたり変更されたりすることがないかどうかを確認してください。バージョン管理とクリーンなワークスペースを使用して、すべての変更を明確に確認できる状態に保ちます。
VS Code とターミナルの違い
VS Code 拡張機能は、外部 PowerShell とは異なる環境変数、作業ディレクトリ、およびシェルを継承する場合があります。特定のコマンドが手動ターミナルで正常に動作するからといって、拡張機能によって開始されたタスクも同じノード、Python、Git、またはネットワーク エージェントを見つけることができるとは限りません。トラブルシューティングの際は、「どの端末、どのディレクトリ、どのコマンドが成功したか」を記録してください。 「このマシンは実行できる」とだけ言ってはいけません。
プロジェクトが WSL、コンテナー、またはリモート SSH で開かれている場合は、Codex が同じファイル システムおよび環境内で実行されていることも確認する必要があります。 Windows パスと Linux パスが混在することが一般的な原因です。
よくあるエラーの判定表
| パフォーマンス | 最初に確認する場所 |
|---|---|
| ログインできないかリクエストが失敗しました | ネットワーク、セッション、および使用状況のプロンプト |
| ウェアハウス ファイルが表示されません | ワークスペースのルート ディレクトリ、信頼および権限 |
| ターミナルコマンドが失敗しました | シェル、PATH、現在のディレクトリ、および引用符 |
| 変更後にテストが失敗しました | 最初に diff を確認し、次に最小限のテストを使用して再現します。 |
| 同じタスクの繰り返し実行 | タスクの説明に受容性と限界が欠けているかどうか |
FAQ: Codex はコードを自動的に送信できますか?
リポジトリ ルール、分岐戦略、レビュー手順が明確である場合にのみ考慮してください。日常的なタスクの場合は、通常、差分を確認し、テストを実行してから、コミットするかどうかを決定する方が安全です。
FAQ: 拡張機能と CLI のどちらを選択する必要がありますか?
必要なし。この拡張機能はエディターでコンテキストと差分を表示するのに適しており、CLI はスクリプト化されたワークフローやターミナル ワークフローに適しています。重要なのは、同じプロジェクト ルートを使用し、それぞれの範囲を理解することです。