CodexをVS Codeで使う方法！拡張機能の導入と変更確認の手順を解説
VS Codeで開いているコードについてAIに相談する際、ファイルを別のチャットへ貼り直すと、対象箇所の指定や変更の確認に手間がかかります。Codexの公式拡張は、エディタ内からファイルや選択範囲を参照して作業を依頼できるツールです。
この記事では、Codex拡張の導入・サインイン・変更内容の確認・表示されない場合の対処を解説します。記事を読めば、自分の作業環境で確認すべき設定と使い分けを整理できます。初回は変更前の状態を保存し、編集を依頼する前に対象ファイルと権限を確認しましょう。
CodexのVS Code拡張とは【コードを見ながら依頼できる】
まず全体像を以下の3つで押さえます。
- 公式拡張からエディタ内で依頼できる
- 開いているファイルをそのまま見て作業する
- 自動補完ではなくエージェント型のツール
公式拡張からエディタ内で依頼できる
CodexのVS Code拡張は、OpenAIが公式に提供する拡張機能です。VS Codeの拡張機能ストア(Marketplace)で配布されており、発行元はOpenAI・拡張の識別名はopenai.chatgptです。公式IDE案内から配布ページへ進めます。
CLIと違い、ターミナルを開く必要はありません。VS Codeのサイドバーにパネルが加わり、そこにやってほしいことを日本語で書くだけです。Codex全体の位置づけは次の記事で解説しています。
Codexとは？読み方や旧モデルとの違い・できることまで徹底解説！
開いているファイルをそのまま見て作業する
VS Code拡張の強みは、エディタで開いている内容をそのまま文脈として使える点です。公式ドキュメントによると、開いているファイル・選択したコード・直近のチャットを入力欄から参照できます。
つまり「今開いているこのファイルを説明して」「選択した部分を直して」といった、目の前の作業に密着した頼み方ができます。ファイルの場所を毎回指定する手間が省けるのが、エディタ統合ならではの利点です。
自動補完ではなくエージェント型のツール
Codexの拡張では、コードの続きを入力候補として受け取るだけでなく、調査・編集・コマンド実行をまとめて依頼できます。作業のまとまりを任せるエージェント型の開発支援です。
許可された範囲のファイル編集やコマンド実行は、自動で進む場合があります。差分を見られる機能があっても、すべての変更が適用前の確認待ちになる意味ではありません。作業前に現在の権限設定を確認し、変更後は差分と実行結果をレビューしましょう。承認とサンドボックス
VS Code拡張のインストール手順
導入は以下の3ステップです。
- 拡張機能ストアからCodexを入れる
- ChatGPTアカウントでサインインする
- 作業したいフォルダを開く
拡張機能ストアからCodexを入れる
最初に拡張機能を入れます。VS Codeの拡張機能ビューを開き(WindowsはCtrl+Shift+X、MacはCmd+Shift+X)、「Codex」で検索します。表示された候補から、発行元がOpenAIの「Codex – OpenAI's coding agent」を選んでインストールしてください。
検索結果には似た名前の拡張が並ぶことがあるため、発行元がOpenAIであることを必ず確認してください。拡張機能の導入と、プロジェクトの実行に必要な開発環境は別です。例えばNode.jsを使うプロジェクトのテストには、そのプロジェクトに必要な実行環境を用意します。
ChatGPTアカウントでサインインする
インストール後、サイドバーに追加されたCodexのアイコンを開きます。初回はサインインを求められるので、Sign in with ChatGPTを選択してください。ブラウザが開き、ChatGPTアカウントでの認証で連携が完了します。
APIキーでのサインインも選べますが、その場合はプランの枠ではなくAPIの従量課金です。個人でChatGPTの有料プランを使っているなら、ChatGPTアカウントでのサインインが簡単です。
作業したいフォルダを開く
最後に、作業したいプロジェクトのフォルダをVS Codeで開きます。Codexへ渡す作業範囲を明確にするため、対象プロジェクトをフォルダとして開きましょう。
フォルダを開いたら、Codexのパネルに「このプロジェクトの構成を説明して」のような指示を日本語で入力しましょう。初回は「ファイルは変更せず、構成と実行方法を説明して」と依頼すると、作業対象を確認できます。編集する場合は、Gitで変更前の状態を保存するか、元ファイルのバックアップを用意してください。
VS Code拡張でできること
拡張を入れると、主に以下の3つができます。
- 開いているコードの説明と修正を頼む
- 変更後の差分とテスト結果を確認する
- 重い作業はクラウドへ委譲する
開いているコードの説明と修正を頼む
日常でよく使うのが、目の前のコードの説明と修正です。公式ドキュメントも、エディタに開いたコンテキストを持ったまま、説明・編集・デバッグを頼めると案内しています。
「このエラーの原因を調べて」「この関数にコメントを付けて」といった依頼を、ファイルを開いたまま日本語で出せる手軽さです。作業と会話を同じ画面で確認でき、対象のコードへ戻りやすい構成です。日本語での回答が必要なら、依頼に「日本語で説明して」と明記してください。
変更後の差分とテスト結果を確認する
Codexが作業した後は、変更ファイルと差分、テスト結果を確認します。書き込みが許可されていれば、確認画面を見る前に作業フォルダが変更されている場合があるためです。変更前に保存した状態と比べ、依頼した範囲を超えていないかを確かめましょう。
確認する項目は以下のとおりです。
- 変更されたファイルと、依頼内容との対応
- 意図しない削除や設定変更の有無
- 実行したテストと、その結果
- テストを実行できなかった部分
差分を見られるだけで事故を防げるわけではありません。内容を判断できない変更は、詳しい担当者に確認を依頼することが必要です。
重い作業はクラウドへ委譲する
時間のかかる大きな作業は、クラウドに任せられます。公式ドキュメントによると、素早い反復はローカルで行い、より時間と余地が必要なタスクはCodexのクラウド側に接続して委譲する形です。
委譲した後も、進み具合はVS Codeを離れずに追えます。手元では別の作業を続けながら、重いタスクをクラウドで走らせられます。
拡張が表示されない・動かないときの対処
つまずきやすい点への対処は以下の3つです。
- パネルが出ないときはコマンドで開く
- サインイン後に進まないときは認証と接続を確認する
- 入力できないときはフォルダの状態を確認する
パネルが出ないときはコマンドで開く
インストールしたのにパネルが見当たらない場合は、コマンドから開けます。公式ドキュメントによると、コマンドパレットを開いて「Codex: Open Codex Sidebar」を実行すると、Codexのサイドバーが開きます。
アイコンが見当たらない場合は、まずこのコマンドを試してください。それでも拡張自体が見当たらない場合は、拡張機能ビューでインストール済みかを確認します。
サインイン後に進まないときは認証と接続を確認する
ブラウザでの認証後に拡張へ戻れない場合は、認証が完了したか、意図したアカウントとワークスペースでサインインしたかを確認します。公式の認証手順では、ブラウザでログインした後に認証情報がCodexへ戻る仕組みです。認証方法の公式説明
作業中のファイルを保存してVS Codeを再起動する方法もありますが、再起動で必ず直るとは限りません。表示されたエラーを確認し、ネットワーク制限や組織の利用許可、拡張の有効状態を切り分けましょう。問い合わせる場合は、VS Codeと拡張のバージョン・発生した操作・秘密情報を除いたエラー内容を整理します。
入力できないときはフォルダの状態を確認する
入力できない場合は、まず対象プロジェクトのフォルダが開いているかを確認しましょう。フォルダを開いていても、認証状態・利用上限・拡張のエラーなどを調べる必要があり、原因をフォルダだけに決めつけないことが大切です。
拡張が無効になっていないかを確認し、Codexパネルに表示されている案内を読みます。認証トークンやAPIキーをエラー報告へ貼らないようにしましょう。
VS Code版とCLI版・クラウドの使い分け
3つの入口の使い分けは以下のとおりです。
- 対話しながら作業するならVS Code版
- スクリプトへ組み込む自動化にはCLI版
- 長時間の重い作業はクラウド
対話しながら作業するならVS Code版
コードを見ながら少しずつ相談して進めたいなら、VS Code版が向いています。変更後の差分をエディタで確認でき、普段の操作に続けて作業できます。開いているファイルや選択範囲を参照した、短い修正依頼に使いやすい構成です。
ターミナルに不慣れな人にとっても、VS Code版は始めやすい入口です。
スクリプトへ組み込む自動化にはCLI版
決まった処理をスクリプトに組み込んだり、定期的に無人で実行したりする用途ではCLI版が向いています。公式ドキュメントによると、CLI版とVS Code拡張はログイン情報と設定を共有するため、同じ環境では保存済みの認証を再利用できます。ただし、片方でログアウトすると再ログインが必要になり、別マシンや別の認証保存先まで常に共有されるわけではありません。
CLIには、Webやデスクトップアプリにある定期実行の管理画面はありません。スクリプト実行を組み込む用途と、アプリ内で予定を設定する機能を分けて選びましょう。CLI版の導入は次の記事で解説しています。
Codex CLIの使い方を徹底解説！インストールから基本操作まで紹介
長時間の重い作業はクラウド
大規模な変更や時間のかかるタスクは、クラウドへの委譲が効きます。VS Code版から接続でき、委譲後は手元を占有せずに進捗だけ追える形です。
クラウドへ送ったタスクはリモート環境で実行されます。接続先や実行結果を確認し、手元の変更と混ぜずにレビューしましょう。
CodexのVS Code利用に関するよくある質問
迷いやすい点への回答は以下の3つです。
- VS Codeで使うのにいくらかかりますか？
- Cursorなど他のエディタでも使えますか？
- CLIを入れないとVS Code拡張は使えませんか？
VS Codeで使うのにいくらかかりますか？
拡張機能自体は無料で、利用にはChatGPTのプランかAPIキーが必要です。公式料金ページによると、CodexはFree・Go・Plus・Pro・Business・Enterpriseの各プランに含まれます。ChatGPTログインでは契約プランの利用枠を使います。追加クレジットの購入やAPI利用には別の費用が発生するため、拡張のインストール料金と実行費用を分けて確認しましょう。
APIキーで使う場合のみ、トークン量に応じた従量課金です。料金の詳細は次の記事にまとめました。
Codexの料金を徹底解説！無料でできることとプランの選び方も紹介
Cursorなど他のエディタでも使えますか？
使えます。公式ドキュメントによると、VS Code・VS Code Insiders・Cursor・WindsurfではCodex拡張を使えます。XcodeとJetBrains系IDEは独自の統合機能からCodexを利用するため、同じ拡張機能を入れる方式ではありません。CursorやWindsurfでも、VS Codeと同じくアイコンかコマンドからCodexのサイドバーを開けます。
VS Code系のエディタを使っているなら、多くの場合そのままCodexを導入できます。使い慣れたエディタを変えずに始められる点は、大きな利点です。
CLIを入れないとVS Code拡張は使えませんか？
必須ではありません。VS Code拡張は単体でインストールでき、ターミナルのCLIを別途入れなくても動きます。まずは拡張だけで始めても大丈夫です。
CLIと拡張は同じ環境で認証キャッシュや設定を共有します。実行環境や保存先が異なる場合は、実際の認証状態を確認することが必要です。必要になった段階でCLIを追加すれば十分です。
CodexをVS Codeに導入したら権限と差分を確認しよう
Codexの公式拡張を使うと、VS Codeで開いたファイルや選択範囲を参照して、調査や編集を依頼できます。発行元と拡張IDを確認して導入し、ChatGPTアカウントまたはAPIキーでサインインしましょう。課金先はログイン方法によって変わります。
編集を任せる前に、作業フォルダと現在の権限設定、変更前の保存状態を確認することが必要です。作業後は差分とテスト結果を確認し、判断できない変更は詳しい担当者へ相談してください。まずはプロジェクトの説明を依頼し、対象範囲を把握するところから始めましょう。
