AIコーディングガイド

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

Codex 公開: 更新:

OpenAI の Codex を VS Code で使うための拡張機能のインストール、ChatGPT アカウントでのサインイン、サイドパネルからの指示の出し方、ローカル実行とクラウド実行の切り替え、承認設定の変更方法を解説します。

検証日 2026年10月17日 仕様変更が早い分野です。最新の公式ドキュメントも併せてご確認ください。 記事の作り方と検証手順
#Codex#VS Code#拡張機能#インストール
目次
  1. インストールとサインイン
  2. サイドパネルの基本操作
  3. 指示の出し方のコツ
  4. ローカル実行とクラウド実行
  5. 承認設定を変更する
  6. Claude Code 拡張との違い
  7. まとめ

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

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

KEY POINT

この記事で分かること

  • 拡張機能のインストールとサインイン
  • サイドパネルからの指示、差分確認、承認の流れ
  • ローカル実行とクラウド実行の使い分け

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

公式ドキュメントが書いているのは、「VS Code and compatible editors use the Codex extension」と、「Install or enable Codex, sign in, and start a chat with the context already open in your editor」の 2 点です。

  1. Visual Studio Marketplace から Codex 拡張をインストールします。対象のエディタとして「VS Code, Cursor, or Windsurf」が挙げられています。
  2. Codex のアイコンを選んでサイドパネルを開きます。アイコンが見当たらない場合は、コマンドパレットから Codex: Open Codex Sidebar を実行します。
  3. サインインします。エディタで開いている内容が文脈として入った状態でチャットが始まります。

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

サインインの画面遷移は公式に書かれていない

以前は「Sign in with ChatGPT」のボタンからブラウザが開く手順を書いていましたが、現在の公式 IDE ページはサインインの具体的な手順を説明していません。画面の文言はバージョンで変わりうるため、この記事では公式に記載のある範囲だけを書いています。

サイドパネルの基本操作

公式ドキュメントが明記しているのは、エディタで開いている内容が文脈として入った状態でチャットが始まるという点です。そのうえで、パネル内でできることは次のとおりです。

操作内容
指示の入力入力欄に書く
差分の確認Codex が変更したファイルを確認する
承認コマンド実行など承認が必要な操作を許可・拒否する
会話の切り替え新しい会話を開始してタスクを分ける

パネルの個別機能は公式ドキュメントで確認できなかった

@ によるファイル参照、選択範囲の受け渡し、パネル内でのモデル切り替えといった個々の操作は、2026 年 10 月 17 日時点の公式 IDE ページには記載がありません。実際の拡張で使える場合もありますが、この記事では仕様として断定しません。

指示の出し方のコツ

  • 開いているファイルを活かす: 公式ドキュメントは「start a chat with the context already open in your editor」と書いています。対象のファイルを開いた状態で始めるほうが、説明が短くて済みます。
  • AGENTS.md を整えておく: コマンドや規約を書いておくと、毎回説明する必要がなくなります。
  • 段階を分ける: 大きな変更は「まず方針を提示して」と頼み、方針を確認してから「実装して」と進めると手戻りが減ります。

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

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

公式ドキュメントの表現は「Choose local work for fast, hands-on iteration, or connect Codex web to delegate a longer task」です。長いタスクは Codex web に委任する、という使い分けが案内されています。クラウド側の手順は Codex クラウド版で GitHub のタスクを任せる を参照してください。

なお、拡張機能からクラウドのタスクを開始・管理できるかどうかは、公式の IDE ページには明記されていません。CLI についてはターミナルからタスクを開始し、最近のクラウドのチャットを一覧して状態を確認できると書かれています。

承認設定を変更する

承認とサンドボックスの設定キーは、公式の設定リファレンスに載っています。~/.codex/config.toml に次のように書きます。

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

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

拡張機能がこの設定を読むかは公式に明記されていない

config.toml は Codex CLI の設定ファイルです。VS Code 拡張が同じファイルを読むかどうかは、公式の IDE ページには書かれていませんでした。CLI 側で承認を緩めている場合は、拡張機能側でも実際の挙動を確認してください。

Claude Code 拡張との違い

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

まとめ

  • Marketplace から Codex 拡張を入れ、Codex のアイコン(なければ Codex: Open Codex Sidebar)でサイドパネルを開く
  • 対象は VS Code・Cursor・Windsurf。エディタで開いている内容が文脈として入った状態でチャットが始まる
  • 対話的な作業はローカル、時間のかかるタスクは Codex web に委任する
  • @ 参照やパネル内のモデル切り替えなど、個々の操作は公式 IDE ページでは確認できなかった

よくある質問

Codex の VS Code 拡張と Codex CLI は別々にインストールが必要ですか?
拡張機能単体で動作します。CLI は必須ではありませんが、config.toml による細かい設定や非対話実行をしたい場合は CLI も入れておくと便利です。
Cursor でも使えますか?
使えます。公式ドキュメントは対象として「VS Code, Cursor, or Windsurf」を挙げています。Codex のアイコンが見当たらない場合は、コマンドパレットから Codex: Open Codex Sidebar を実行します。
クラウド実行とローカル実行の違いは?
ローカル実行は手元のファイルを直接変更します。クラウド実行は OpenAI 側のコンテナでリポジトリをクローンして作業し、結果を PR として返します。

参考にした一次情報

この記事は公式ドキュメントを基に AI が下書きを作成し、運営者が内容を確認して公開しています。誤りを見つけた場合は お問い合わせからお知らせください。

関連記事