Codex VS Code 拡張の使い方:サイドパネルでの指示、ローカルとクラウドの切り替え

Codex は CLI だけでなく、VS Code のサイドパネルからも使えます。拡張機能を入れると、開いているワークスペースに対して指示を出し、変更差分をエディタ上で確認しながら進められます。ローカルでの作業に加えて、クラウド版の Codex にタスクを委任することもできます。

この記事では、拡張機能の導入から、指示の出し方、ローカル・クラウドの使い分け、承認設定の変更までをまとめます。

インストールとサインイン

1. VS Code の拡張機能ビューで「Codex」を検索し、発行元が OpenAI のものをインストールします。
2. アクティビティバーに Codex のアイコンが追加されます。クリックしてサイドパネルを開きます。
3. 「Sign in with ChatGPT」でブラウザが開くので、ChatGPT アカウントでサインインします。API キーで使う場合は設定から切り替えます。
4. ワークスペースを開いた状態で、入力欄に指示を書きます。

利用には ChatGPT の有料プランまたは API キーが必要です。CLI との関係やログインの注意点は Codex CLI のセットアップと AGENTS.md の書き方 と共通です。

サイドパネルの基本操作

操作	内容
指示の入力	入力欄に日本語で書く。ファイルを @ で参照できる
差分の確認	Codex が変更したファイルは差分ビューで確認できる
承認	コマンド実行やワークスペース外への書き込みは、承認ダイアログで許可・拒否する
会話の切り替え	新しい会話を開始してタスクを分ける
モデル・推論の深さ	パネル内の設定から切り替える

指示の出し方のコツ

拡張機能ではエディタで開いているファイルや選択範囲が文脈として渡せます。

• 選択範囲を指定する: コードを選択した状態で「この関数にエラーハンドリングを追加して」と指示すると、対象が明確になります。
• AGENTS.md を整えておく: 拡張機能でも AGENTS.md は読み込まれます。コマンドや規約を書いておくと、毎回説明する必要がなくなります。
• 段階を分ける: 大きな変更は「まず方針を提示して」と頼み、方針を確認してから「実装して」と進めると手戻りが減ります。

ローカル実行とクラウド実行

項目	ローカル	クラウド
作業場所	手元のワークスペース	OpenAI 側のコンテナ(リポジトリをクローン)
変更の反映	ファイルが直接変わる	PR やブランチとして返る
待ち時間	対話的に進む	バックグラウンドで進み、完了後に確認
向いている作業	対話しながらの実装、デバッグ	時間のかかる独立したタスク、複数タスクの並列

サイドパネルからクラウドにタスクを送ると、手元の作業を続けながら別のタスクを進められます。クラウド実行には GitHub との連携設定が必要です。手順は Codex クラウド版で GitHub のタスクを任せる を参照してください。

承認設定を変更する

既定では、ワークスペース内のファイル変更は自動で行い、コマンド実行や外部への影響がある操作には承認を求めます。パネル内の設定、または CLI と共通の ~/.codex/config.toml で変更できます。

# ~/.codex/config.toml
approval_policy = "on-request"
sandbox_mode = "workspace-write"

承認モードとサンドボックスの組み合わせは approval mode と sandbox 設定の違い で詳しく説明しています。

Claude Code 拡張との違い

同じ VS Code で Claude Code の拡張も使えます。操作感は似ていますが、クラウド実行の統合、承認モデル、設定ファイルの形式が異なります。両方を試して使い分ける場合は Codex と Claude Code の違いと使い分け を参照してください。

まとめ

• 発行元 OpenAI の「Codex」拡張を入れ、ChatGPT アカウントでサインインする
• @ でファイルを参照し、選択範囲を渡すと精度が上がる
• 対話的な作業はローカル、時間のかかる独立タスクはクラウドに委任する
• 承認とサンドボックスの設定は config.toml で CLI と共有される