VS CodeにおけるOpenAI Codex連携の実用ガイド (2026年版)

要約

VS CodeにおけるOpenAI Codexは、単なる高性能なオートコンプリートではなく、非同期のコーディングエージェントです。 ext install openai.chatgpt（公式拡張機能は980万インストールを記録）経由でインストールし、月額20ドルのPlusプランでサインインすると、サイドバーエージェントが利用可能になります。このエージェントはファイルを読み込み、ターミナルコマンドを実行し、さらに自分が別の作業をしている間に時間のかかるタスクをCodex Cloudに引き渡すことができます。自律的なコーディングタスクにおけるSWE-bench Verifiedのスコアは85.5%に達しており、GitHub Copilotの54%を上回っています。しかし、重要なのは「どちらが優れているか」ではなく、「これらは異なる役割を担っている」ということです。インライン補完にはCopilotを使い、バックログに溜まってしまいがちなタスクにはCodexを使いましょう。

また、Codexによって開発スピードが上がった後は、eeselがサポート側を支えます。自律型AIエージェントが、チームの手を借りることなくZendesk、Freshdesk、Slack内でチケットを解決します。

2026年における「VS CodeでのOpenAI Codex」の意味

名称に関する混乱があるため、まずはそれを整理しましょう。

オリジナルの「OpenAI Codex」は2021年のAPIモデルであり、初期のGitHub Copilotの自動補完を支えていたGPT-3をコード用に微調整したバージョンでした。OpenAIは2023年3月にこれを廃止しました。現在のVS Code拡張機能が接続しているのは、2025年5月にリリースされた、名前こそ同じですが全く別の製品です。

2025年版Codexは、GPT-5ファミリー（GPT-5.3-Codex、GPT-5.4、GPT-5.5）の特化型モデルを搭載したクラウドベースのソフトウェアエンジニアリングエージェントです。リポジトリがプリロードされた隔離済みのクラウドサンドボックスでタスクを実行し、複雑な作業に対して最大25時間自律的に動作し、複数のワークストリームを並行して管理できます。VS Code拡張機能は、Codexデスクトップアプリ、オープンソースのCLI、GitHub連携、Slack、iOSなどと並ぶインターフェースの一つです。

VS Codeはこのシステムへの窓口の一つです。単なるプラグインではなく「システム」として理解すれば、全体のセットアップがより腑に落ちるはずです。

VS CodeでCodexを実行する3つの方法

「VS CodeでのCodex」には、ワークフローに応じた3つの異なるパターンがあります。

VS Code拡張機能（サイドバーパネル） - 拡張機能ID openai.chatgpt、パブリッシャー：openai。これがメインの連携方法です。サイドバーのチャットパネルで、開いているファイルの読み取り、Agentモードでの編集適用、ターミナルコマンドの実行、そしてCodex Cloudへの長時間タスクの接続が可能です。

VS Codeターミナル内のCodex CLI - オープンソースのCLI（GitHubスター数88,000以上）は、VS Codeの統合ターミナル内でフル機能のエージェントとして動作します。拡張機能と設定を共有しており、開発者によっては複雑な推論タスクにおいてCLIの方が明らかに優れていると感じる場合もあります。

拡張機能からのクラウド委任 - これがCodexを他のVS Code用AIツールと分かつ最大の特徴です。拡張機能パネルからCodex Cloudにタスクを送信すると、GitHubリポジトリに接続された隔離サンドボックスでタスクが実行されます。VS Codeを閉じてもタスクは継続され、戻ってきた時には完了した差分（diff）が用意されています。

セットアップ：拡張機能のインストール

手順は以下の3ステップです。

1. Cmd+P（Mac）または Ctrl+P（Windows/Linux）を押してクイックオープンを開く
2. ext install openai.chatgpt を貼り付けてEnterを押す
3. Codexパネルで Sign in をクリックし、ChatGPTアカウントまたはOpenAI APIキーで認証する

拡張機能パネルで「Codex」と検索し、パブリッシャーが「openai」であることを確認してインストールすることもできます。

同じ拡張機能IDは Cursor や Windsurf でも機能します。クイックオープンで vscode: というURIプレフィックスを cursor: または windsurf: に置き換えるだけです。拡張機能、CLI、および ~/.codex/config.toml 設定ファイルはすべてエディタ間で共有されるため、複数の環境で作業する場合でも設定を引き継ぐことができます。

レイアウトのヒント：Codexパネルをエディタの右側に移動させましょう。サイドバーのアイコンを右側のアクティビティバーにドラッグします。左側にコード、右側にCodexを配置することで、ファイルエクスプローラーと重ねることなく、自然な分割表示で作業できます。

どのプランが必要ですか？ CodexはPlus（月額20ドル）以上のすべての有料ChatGPTプランにバンドルされています。Codex専用のサブスクリプションはありません。APIキーによるアクセスは拡張機能やCLIで利用可能ですが、GitHubコードレビューやクラウド委任などのクラウド機能は利用できません。詳細は OpenAI Codex料金ガイド全文 を参照してください。

拡張機能の機能：実際にできること

モデル選択と推論の強度（Reasoning Effort）

Codexパネルの下部にあるモデルピッカーは、GitHub Copilotのチャットとは明確に異なる点です。モデルと推論の強度（Reasoning Effort）を明示的に選択できます：GPT-5.3-Codex（低/中/高）、GPT-5.4、GPT-5.4-mini、およびGPT-5.5が選べます。「中（Medium）」の推論強度はほとんどのタスクを十分にこなせます。複雑なリファクタリングなど、1分余計に思考させることで数回の修正ループを省けるような場面では「高（High）」に上げましょう。日常的な質問にはGPT-5.4-miniを使用してください。メインモデルに比べてメッセージの消費枠を2.5〜3倍節約できます。

@によるファイル参照

@filename 構文は、この拡張機能で最も実用的な機能の一つです。コードをチャットに貼り付ける代わりに、次のように指示します。

@auth.ts と @user.model.ts を使用して、
@error-handler.ts のパターンに整合したエラーハンドリングを保ちつつ、
登録フローにメール検証機能を追加してください。

Codexは参照されたすべてのファイルをフルで読み込み、ファイル間のコンテキストを理解し、それらすべてにわたって一貫した変更を加えます。拡張機能は、@ を入力するとファイル名を自動補完します。

3つの承認モード

チャット入力欄の下にあるセレクターからモードを切り替えられます。「Agent」がデフォルトとして最適です。npm run test を実行し、ファイルを編集し、変更がコンパイルされるか確認するなど、ほとんどのコーディングタスクに必要なローカル操作を実行できます。「Full Access」はインターネット検索が可能になるため、タスクの途中でドキュメントを参照する必要がある場合に便利です。

現在の拡張機能において、パーミッションの承認ループは最も指摘される不満点の一つです。 「常に許可する」を有効にしていても、コマンドがわずかに変わるだけでCodexが再度承認を求めてくることがあります。これは既知のバグです。

「Linuxでも同様です。CLIに少しでもバリエーションがあると、新しい承認が必要な新しいコマンドとして認識されてしまいます。この点に関してはClaude Codeの方がはるかに優れています。」

u/jimheim, r/ChatGPTCoding

もし承認ループがストレスになる場合は、~/.codex/config.toml で承認を「auto」に設定するか、ターミナル内でCLIバージョンを使用してください。CLI版の方が再承認を賢く処理します。

Agentモードが得意とするタスク

Codexが一貫して成果を出すタスクは、「auth.spec.ts の失敗しているテストを修正する」「コンポーネントライブラリにダークモード対応を追加する」「新しいAPIクライアントを使用するように支払いフローをリファクタリングする」「エクスポートされたすべての関数にJSDocコメントを追加する」などです。読み取り、編集、テスト実行、検証を1回のパスで行える、自己完結型の作業に向いています。

苦手とするのは、リアルタイムの視覚的フィードバックが必要な作業、反復的なフロントエンドのピクセル単位の調整、そしてコードを変更し始める前に実行計画をレビューしたいタスクです。Codexには「計画モード（Plan Mode）」がありません。Claude Codeとは異なり、即座に実行を開始します。r/codexやr/ClaudeCodeのコミュニティでの定石は、「複雑なバックエンド作業にはCodex、フロントエンドや反復的な洗練にはClaude Code」という使い分けです。

クラウドへの委任：拡張機能の真の差別化ポイント

この非同期ワークフローこそが、CodexをVS Codeの他のAIツールから際立たせている要素です。

セットアップ（初回のみ）： chatgpt.com/codex/settings/environments にアクセスし、GitHubリポジトリをクラウド環境に接続します。

タスクごとの手順：

1. VS Codeパネルのセレクターからクラウド環境を選択する
2. Run in the cloud をクリックする
3. 開始点を選択する：新機能なら main ブランチ、進行中の作業を続けるなら現在のブランチ
4. タスクの内容を記述して送信する

Codexは隔離されたサンドボックスで作業を開始します。この間、VS Codeを閉じても構いません。タスクはクラウド上で実行され続けます。完了するとサイドバーに進捗が表示されます。差分を確認し、ローカルに適用して、必要に応じて調整します。

「次のステップについて相談している間に、バックグラウンドで複数のワークフローを並行処理できるのも魅力です。驚くほど便利で、大幅な時間短縮になります。Plusサブスクリプションでのリクエスト制限も、5時間で30-150回と十分に高いようです。」

u/pnkpune, r/OpenAI

クラウド設定は GitHub連携 にも繋がります。Codexは、PRがドラフトから「準備完了」になった際に自動でレビューを行い、GitHubのプルリクエストに直接分析結果を投稿します。また、@codex review とメンションすることで、特定のバグ検出を依頼することも可能です。RampのAI Dev Xチームリード、Austin Ray氏は次のように述べています。"CodexのPRレビューはチームが見逃していたバグを指摘してくれるため、より自信を持って出荷できるようになりました。"

知っておくべき重大な制限が一つあります。CodexがAgentモードでローカルに変更を適用する際、承認/却下の差分ワークフローが存在しません。編集内容は直接作業ディレクトリに書き込まれます。これは、GitHub Copilotの洗練された差分表示と比較すると、UX上の大きなギャップと言えます。大規模なタスクを委任する前には、必ずコミットするかスタッシュして、いつでも git reset できるようにしておきましょう。

VS CodeターミナルでCodex CLIを実行する

CLIは拡張機能とは別にインストールします。

npm i -g @openai/codex

その後、VS Codeの統合ターミナル内で実行します。

# インタラクティブなTUIセッション
codex

# 初回プロンプトを指定して実行
codex "このコードベースについて説明してください"

# スクリプト用の非インタラクティブ実行
codex exec "src/ 内のすべてのリンターエラーを修正してください"

CLIと拡張機能は ~/.codex/config.toml を共有します。セッションごとにUIで切り替えるのではなく、一度デフォルトを設定しておくと便利です。

# ~/.codex/config.toml
model = "gpt-5.3-codex"
approval_mode = "agent"

おすすめの使い分け：プロンプトの入力にはVS Codeの統合ターミナルでCLIを実行し、VS Code本体は同じフォルダを開いたままにしてリアルタイムのgit diffレビューに使用します。これにより、CLIの推論能力を最大限に活かしつつ、VS Codeの優れた差分ビジュアライザーを併用できます。

CLIは実行終了時に、コンテキストウィンドウの使用量、5時間のレート制限の残り、合計トークン数などの統計情報を表示します。Plusプランの制限を管理するのに役立ちます。

また、CLIは Bitbucket リポジトリとネイティブに統合され、Google Colab や Jupyter ノートブック内でも動作し、Replit 環境にも接続できます。他のIDEを使用している場合は、PyCharm、IntelliJ、そして Visual Studio（VS Codeではない、Microsoftのフル機能IDE）の連携ガイドもあります。

VS CodeにおけるCodex vs GitHub Copilot：用途の違い

「CodexかCopilotか」という比較は、本質を見失っています。これらはワークフローにおいて同じ枠を争っているわけではありません。

Copilot は常にオンです。タイピング中にリアルタイムでゴーストテキストによる補完を提供し、現在の関数についてのクイックな質問にはインラインチャットで答え、次の編集箇所を提案します。また、マルチモデル対応により、タスクに応じてOpenAI GPT-5、Anthropic Claude、Google Geminiを切り替えることができます。フロントエンドの作業において、一部の開発者はCopilot経由でClaudeを使用する方が、Codex（OpenAIモデルに固定されています）よりも優れたUIコードを生成できると感じています。詳細については、Copilotの料金 の内訳を参照してください。

Codex は非同期です。タスクの指示を与えると、隔離された環境で独立して作業し、完了した結果を返します。85.5%というSWE-bench Verifiedのスコアは、自律的なエンドツーエンドのタスク完了能力を測定したもので、まさにそのために構築されています。

効果的なパターン：インライン補完やクイックな質問には GitHub Copilot を常に有効にしておきます。そして、本来ならバックログに回すような大きめのタスクを、一日に2-3個Codexにキューとして投げます。戻ってきたら、完了した差分を確認するだけです。

より広く Copilotの代替案 を検討している場合、Cursor はリアルタイムのペアプログラミングにおいてCopilotと直接競合します。ワークフローによっては Cursorの代替案 も検討に値するでしょう。Anthropic側の比較については、Claude vs Copilot ガイドで解説しています。

料金：実際のコスト

2つの課金体系があります。詳細な内訳は OpenAI Codex料金ガイド を参照してください。

ChatGPTサブスクリプション（Codexが付属）：

制限は5時間のローリングウィンドウでリセットされます。OpenAIは、Claude Codeの価格設定に対抗して2026年4月にPro 5xティアを追加しました。Plusプランの制限に達していても、月額200ドルまでは出せない開発者にとって明確な中間プランとなっています。

APIキー（サブスクリプションなし）： 拡張機能とCLIで利用可能です。codex-mini-latestの場合、入力100万トークンあたり1.50ドル、出力100万トークンあたり6.00ドルです（75%のプロンプトキャッシュ割引あり）。ただし、クラウド委任やGitHubコードレビュー機能は利用できません。

制限管理のコツ：ルーチン的な質問（「この関数の説明をして」「このテストは何を検証している？」）にはGPT-5.4-miniを使いましょう。メインモデルの消費カウントを2.5〜3倍抑えられるため、本当に推論が必要なタスクのためにGPT-5.3-Codexの枠を残しておくことができます。

率直な評価

VS CodeにおけるCodexは、その設計目的に対して真に価値を提供しています。85.5%というSWE-benchスコアは実務でも裏付けられています。複雑なバックエンドのリファクタリング、複数ファイルにわたる機能開発、そして静的解析では見逃されるようなバグを捉えるコードレビューなど、その実力は本物です。

一方で、粗削りな部分も確かにあります。拡張機能の承認ループはリリース時から改善されていません。ローカルへの変更適用前に差分プレビューがない点は、Copilotに劣ります。「計画モード」がないため、実行前にアプローチを確認できず、戸惑う開発者もいます。また、2026年4月のクレジット消費率の変更後、一部のProプランユーザーからは、GPT-5.5の「中（Medium）」強度で3〜4個のタスクをこなすと制限に達したという報告もあります。制限管理にはモデル選択が重要です。

「100ドルのClaude Codeライセンスと20ドルのOpenAIプランを使っています。Claude Codeで解決できない難しい問題に直面したとき、Codexに投げると時間はかかりますが、Claude Codeが解決できなかった数多くの問題を修正してくれました。」

u/SequentialHustle, r/ClaudeAI

これが率直な立ち位置です。「Claude CodeやCopilotより優れている」わけではなく、「特定の仕事に向けた、際立ったツール」なのです。「仕様書からこの機能を実装する」「このモジュールのテストを書く」といったタスクに時間を取られているなら、月額20ドルのPlusプランに加入して1週間試してみる価値は十分にあります。

Codexを他のコンテキストで使用したい場合は、Discord、Notion、Slack 用のガイドも用意されています。デスクトップ体験をフルに活用したい方は、macOSでの利用可否や並行タスク管理センターについて解説した Codexアプリガイド をご覧ください。もし用途に合わないと感じた場合は、OpenAI Codexの代替案 まとめ記事であらゆる選択肢を網羅しています。

eeselを試す

Codexが開発キューをこなすなら、eesel はサポートキューをこなします。

eeselは、Zendesk、Freshdesk、Slack、メール、その他100以上の既存ツール内で自律的に動作するAIエージェントを導入します。Codexと同様の「委任して結果を待つ」という哲学を、サポート業務に適用したものです。eeselのエージェントは、チームの作業を中断させることなく、チケットの解決、返信の下書き作成、問題の分類、エッジケースのエスカレーションを行います。新しいインターフェースを学習する必要はありません。無料で始められ、クレジットカード不要で50ドル分のクレジットが提供されます。

eesel.ai で無料で始める