OpenAI Codex CLIのVS Code拡張｜設定と活用ガイド

⚡ 3秒でわかる！この記事のポイント

Codex VS Code拡張でIDE内からCLIの全機能が使える
チャット・編集・プレビューの3モードを使い分けるのがコツ
GPT-5 Codexモデルで精度と速度が大幅向上

「Codex CLIは便利だけど、ターミナルとエディタの行き来が面倒」「IDE内で完結させたい」——そんな開発者の声に応えて登場したのが、Codex CLIのVS Code拡張です。

結論：VS Code拡張を使えば、ターミナルに切り替えることなくIDE内でCodex CLIの全機能を利用でき、開発効率がさらに向上します。 2026年3月のアップデートでGPT-5 Codexモデルにも対応し、精度・速度ともに大きく進化しました。

この記事でわかること

Codex VS Code拡張とCLI版の違い
インストールと初期設定の手順
チャット・編集・プレビューの3モード活用法
実践テクニック5選
セキュリティとApproval Modes

Codex VS Code拡張とは？CLIとの違い

拡張機能の概要とできること

Codex VS Code拡張は、OpenAIが公式に提供するVS Code向け拡張機能です。CLI版のCodexが提供するファイル編集・コマンド実行・コードレビューの機能を、VS CodeのUI内で直接利用できます。

主な特徴：

サイドバーチャット： VS Codeのサイドバーからチャット形式でCodexに指示
インラインコード編集： 選択したコードに対して直接修正を指示
差分プレビュー： 変更点をdiff形式で確認してからApply
ファイルコンテキスト自動認識： 開いているファイルを自動的にコンテキストに追加

CLI版との使い分け戦略

用途	CLI版	VS Code拡張
大規模リファクタリング	◎ 複数ファイル一括操作	○ サポート対応
単一ファイル編集	○	◎ インライン編集が便利
プロジェクト分析	◎ ディレクトリ全体	○ ワークスペース限定
Git操作	◎ コミット・PR作成	△ 基本操作のみ
ペアプログラミング	○	◎ サイドバーで常時対話

おすすめの使い分け： 日常的なコーディング作業はVS Code拡張、大規模な変更やプロジェクト横断の作業はCLI版と使い分けるのがベストです。

インストールと初期設定

対応プラン（Plus/Team/Pro/Enterprise）

Codex VS Code拡張を利用するには、以下のいずれかのOpenAIプランが必要です：

プラン	月額	Codex利用	備考
Plus	$20	○	個人開発者向け
Team	$25/人	○	チーム共有機能あり
Pro	$200	◎	無制限利用
Enterprise	要問合せ	◎	セキュリティ強化

認証とAPIキーの設定

# 1. VS Code Marketplaceからインストール
# 拡張機能名: "OpenAI Codex CLI"

# 2. 認証（CLIと共通）
codex auth login

# 3. VS Codeの設定（settings.json）

{
  "codex.model": "gpt-5-codex",
  "codex.approvalMode": "suggest",
  "codex.contextFiles": "auto",
  "codex.maxTokens": 16384
}

認証はCLI版と共通のため、すでにCLI版を使っている方は追加の認証設定は不要です。

基本的な使い方

チャット・編集・プレビューの3モード

Codex VS Code拡張には3つの操作モードがあります。

1. チャットモード サイドバーのCodexパネルから、自然言語でチャット形式の指示を送ります。

指示例：
「このプロジェクトのREADMEを更新して、インストール手順を追加して」
「src/配下のTypeScriptファイルで、型定義が不足しているものを一覧して」

2. 編集モード コードを選択した状態でCmd+Shift+E（Mac）/ Ctrl+Shift+E（Windows）を押すと、選択範囲に対する編集を指示できます。

3. プレビューモード Codexが提案した変更は、まずdiff形式でプレビュー表示されます。内容を確認してから「Accept」「Reject」「Edit」を選択できます。

ファイルコンテキストの活用

VS Code拡張の強みは、開いているファイルや関連ファイルを自動的にコンテキストに含める点です。

現在アクティブなファイル
ワークスペース内のimport先ファイル
最近編集したファイル（直近5ファイル）
手動で追加したファイル（@file記法）

指示例：
「@src/types/user.ts の型定義を参考にして、
 新しいOrderインターフェースを作成して」

実践テクニック5選

1. 選択コードの即リファクタ

コードを選択 → Cmd+Shift+E → 「この関数をclean architectureの原則に沿ってリファクタして」

これだけで、依存関係の分離やインターフェースの抽出が自動的に行われます。

2. テスト生成の自動化

「この関数のユニットテストをJest/Vitestで書いて。
 正常系3パターン、異常系2パターン、エッジケース1パターンで」

テストファイルの作成からテスト内容まで一括で生成されます。

3. コミットメッセージの自動生成

ステージングされた変更から、Conventional Commits形式のコミットメッセージを自動生成。

4. ドキュメントコメントの一括追加

「src/services/配下の全ファイルに、JSDocコメントを追加して。
 引数・戻り値・例外を記載して」

5. パフォーマンス改善の提案

「このコンポーネントのレンダリングパフォーマンスを分析して、
 改善案をコード付きで提案して」

GPT-5 Codexモデルの活用

2026年3月のアップデートで、VS Code拡張からGPT-5 Codexモデルが利用可能になりました。

従来のモデルとの比較：

特性	GPT-4o	GPT-5 Codex
コード理解精度	◎	◎◎
大規模コンテキスト	128K tokens	256K tokens
マルチファイル編集	○	◎
実行速度	標準	約1.5倍高速

特に大規模プロジェクトでのコンテキスト理解が大幅に向上しており、「関連ファイルを見落とす」問題が解消されています。

セキュリティとApproval Modes

SES現場での利用を考慮すると、セキュリティ設定は重要です。

Approval Modesの選択肢：

モード	動作	推奨シーン
suggest	全変更を確認してから適用	本番コード、SES現場
auto-edit	ファイル編集は自動、コマンド実行は確認	個人開発
full-auto	全操作を自動実行	CI/CD、テスト環境のみ

SES現場ではsuggestモードを推奨します。 クライアントのコードに対する変更は、必ず目視確認してから適用すべきです。

Codex CLI VS Code拡張の機能概要図解