CodexをVS Codeで使う方法｜拡張機能の導入手順・使い方とCLIとの違い【2026年最新】
Codexを試してみたものの、ターミナルでの操作に慣れず手が止まっていませんか。普段使っているエディタの中でそのまま使えれば、コードを見ながら依頼でき、変更内容もその場で確認できます。OpenAIはVS Code向けに公式の拡張機能を提供しています。
本記事では、この拡張機能でできることから、追加とサインインの手順、表示されないときの対処、動作モードの使い分け、料金の考え方、CLIやクラウドとの使い分け、そしてチームで使う場合の設計までを、公式ドキュメントの情報をもとに整理します。
| 確認したいポイント | 結論 | 詳細 |
|---|---|---|
| VS Codeで使える？ | OpenAI公式の拡張機能で利用できます | VS Codeのほか、CursorやWindsurfなどの派生エディタでも同じ拡張機能を使えます。 |
| 導入は難しい？ | 拡張機能を追加してサインインするだけ | 発行元がOpenAIであることを確認して追加し、ChatGPTアカウントでサインインします。 |
| 追加料金は？ | ChatGPTの有料プランに含まれます | Plus・Pro・Business・Edu・Enterpriseが対象。無料プランでは利用できません。 |
| CLIとどう違う？ | 画面で差分を見ながら進められます | 短い修正や学習はIDE拡張、長時間の自動実行やCIへの組み込みはCLIが向いています。 |
この記事でわかること
- Codex VS Code拡張でできることと、対応しているエディタ
- 拡張機能の追加からサインインまでの手順
- アイコンが表示されないときの対処
- 動作モードの使い分けと、差分の確認方法
- CLIやクラウドとの使い分けと、チームでの設計
| 資料請求のご案内 AIコーディングツールを開発チームへ導入する際の進め方と、評価項目をまとめた資料をご用意しています。 試用の段階からご活用ください。 ▶ 資料を無料でダウンロードする |
Codex VS Code拡張とは｜エディタの中で動くコーディングエージェント
手順に入る前に、この拡張機能の性格を押さえます。ここでは何ができるのか、対応しているエディタ、他の入り口との関係という3点を確認します。普段の作業環境から離れずに使える点が最大の利点です。
何ができるのか
Codexは、コードを読み、編集し、実行できるOpenAIのコーディングエージェントです。拡張機能を入れると、エディタのサイドバーに対話画面が表示され、そこに依頼を書くだけで作業が始まります。
公式ドキュメントでは、開いているファイルや選択している範囲をそのまま文脈として渡せる点が挙げられています。何について話しているかを説明し直す手間がなくなります。
変更内容は差分として画面上に提示され、そのまま確認して取り込めます。コードと変更案、その理由を同じ画面で見られるため、判断がしやすくなります。
用途としては、初めて触るコードの理解、焦点を絞った修正、不具合の調査、変更内容の点検などが挙げられます。書く作業だけでなく、その前後の工程まで対象になる点が特徴です。
対応しているエディタ
VS Codeだけでなく、これをもとに作られた派生エディタでも利用できます。公式では、VS Code、Cursor、Windsurf、VS Code Insidersが案内されています。
JetBrains系のIDEやXcodeについては、拡張機能ではなくそれぞれ専用の連携が用意されています。使っている環境に応じて選んでください。
つまり、エディタを乗り換えなくてもCodexを使える構成になっています。既存の開発環境をそのまま活かせる点は、導入のハードルを大きく下げます。
CLIやデスクトップとの関係
Codexには複数の入り口があります。ターミナルで動くCLI、デスクトップアプリ、Web版、そしてこの拡張機能です。
いずれも同じアカウントで利用でき、契約は共通です。用途に応じて使い分けても、二重に契約する必要はありません。
設定の一部も共有されます。すでにCLIを使っている場合、拡張機能を入れてもゼロから設定し直す必要はないと考えてよいでしょう。
どの入り口から始めるかは、普段どこで作業しているかで決めてください。エディタを開いている時間が長いなら拡張機能、ターミナル中心ならCLIというのが自然な選び方です。
導入手順
作業は数分で終わります。拡張機能の追加、サインイン、プランの確認という3つの段階です。注意すべきは、似た名前の拡張機能を選ばないことだけです。
拡張機能を追加する
エディタの拡張機能の画面を開き、検索欄にCodexと入力します。候補が複数表示されることがあるため、発行元がOpenAIであるものを選んでください。
表示名は更新によって変わることがあります。名称ではなく発行元で判断するのが確実です。公式ドキュメントからも、各エディタ向けのインストール用リンクをたどれます。
追加が終わると、サイドバーにアイコンが表示されます。公式によれば、VS Codeでは既定で右側のサイドバーに配置されます。
配置は後から変更できます。左側に置きたい場合はアイコンをドラッグするだけで移動でき、使い慣れた並びに合わせられます。
サインインする
追加後、アイコンを開くとサインインを求められます。ChatGPTアカウントでのサインインか、APIキーの入力かを選べます。
有料プランを契約している場合は、そのアカウントでサインインするだけで利用を開始できます。ブラウザが開いて認証し、エディタに戻れば完了です。
APIキーを使う方式もありますが、この場合はクラウド側の一部機能が利用できません。個人の日常利用であれば、アカウントでのサインインが基本になります。
必要なプランを確認する
利用には有料プランが必要です。公式ドキュメントによると、ChatGPTのPlus、Pro、Business、Edu、Enterpriseの各プランにCodexが含まれています。
無料プランでは利用できません。まず試したいという段階でも、いずれかの契約が前提になる点は最初に共有しておくべきです。
拡張機能のために追加で契約する必要はありません。すでにChatGPTの有料プランを使っているなら、そのまま利用できます。CLIの導入についてはCodex CLIの使い方とインストール手順で解説しています。
表示されない・つまずいたときの対処
導入直後に相談が集中するのがこの部分です。アイコンが見当たらない、派生エディタでの配置、サインインの問題という3点を整理します。多くは配置の問題で、機能自体は正常です。
アイコンが見当たらない
追加したのにサイドバーに出てこない場合、まずエディタを再起動してください。公式ドキュメントでも、すぐに表示されない場合は再起動するよう案内されています。
それでも見つからない場合は、コマンドパレットから専用のコマンドを実行すると開けます。表示されていないだけで、機能は追加されている状態です。
サイドバーの表示項目が多いと、折りたたまれて隠れていることもあります。項目の並びを整理すると見つかる場合があります。
派生エディタでの配置
CursorやWindsurfでは、既定の配置が異なる場合があります。公式でも、これらのエディタでは手動で右側へ移動する必要があると案内されています。
アイコンの配置を変えるには、いったん表示の向きに関する設定を切り替えてから移動する手順が示されています。移動後に設定を戻せば、元の見た目を保ったまま配置だけ変更できます。
既存のチャット機能と並べて配置しておくと、両方を切り替えながら使えます。用途によって使い分けたい場合に便利です。
表示の設定を変更した際は、作業前の状態に戻すことを忘れないでください。並びだけを変えたつもりが、他の項目の見え方まで変わってしまうことがあります。
サインインできない
認証が完了しない場合、まず契約しているプランを確認してください。無料プランのアカウントでは利用できないため、サインイン自体は通っても機能が使えません。
複数のアカウントを使い分けている場合、ブラウザ側でログインしているアカウントと、契約しているアカウントが一致しているかを確認します。ここが原因であることは少なくありません。
社内ネットワークで通信が制限されている環境では、認証の途中で止まることがあります。この場合は情報システム部門への確認が必要になります。
なお、拡張機能は自動で更新されます。動作が以前と変わったと感じた場合は、更新によって仕様が変わっている可能性もあるため、拡張機能の画面で版を確認してみてください。
| 無料相談のご案内 どの作業から任せるか、既存の開発フローにどう組み込むかは、体制とコードベースによって変わります。 現状をお聞かせいただければ、進め方を一緒に整理します。 ▶ 無料相談を申し込む |
基本的な使い方
導入が終わったら実際の作業です。文脈の渡し方、動作モードの使い分け、差分の確認という3点を押さえてください。まずは読み取り中心の依頼から試すのが安全です。
開いているコードを文脈として渡す
この拡張機能の中心的な機能がこれです。開いているファイル、選択している範囲、過去のやり取りを、そのまま依頼に添えられます。
たとえば気になる関数を選択したうえで「この処理を説明して」と書けば、どのコードのことかを説明する必要がありません。コードを貼り付ける手間もなくなります。
最初の依頼は、書き換えを伴わない内容にしてください。「このプロジェクトの構成を説明して」「この関数がどこから呼ばれているか調べて」といった質問であれば、安全に挙動を確かめられます。
過去のやり取りを参照させることもできます。前回の会話で決めた方針を引き継ぎたい場合に、説明をやり直さずに済みます。
動作モードを使い分ける
どこまで任せるかを選べる仕組みがあります。質問と相談に絞る使い方と、実際にファイルを編集させる使い方、より広い操作を許可する使い方が用意されています。
業務のコードを扱う場合は、確認を挟む設定から始めてください。慣れてきたら、影響の小さい作業から自動化の範囲を広げていく進め方が無難です。
モデルの選択と、どの程度じっくり考えさせるかも指定できます。単純な質問は軽い設定で、複雑な修正はしっかり考えさせる設定で、と使い分けると待ち時間と費用の両方を抑えられます。
差分を確認して取り込む
変更が提案されると、要約と変更された行が画面に表示されます。内容を確認したうえで、取り込むかどうかを判断できます。
意図と違う場合は、その場で条件を補足して作り直させるほうが、後から手で直すより早く済みます。同じ会話の中で続けられるため、文脈も保たれます。
大きな変更に入る前には、バージョン管理で区切りを付けておいてください。公式でも、作業の前後で記録を残しておくよう案内されています。
よく使う操作は、キー操作として割り当てられます。対話画面の表示切り替えや、文脈への追加といった操作を登録しておくと、作業のテンポが上がります。
精度を上げる工夫
同じツールでも、依頼の書き方で結果は変わります。具体性、段階の分け方、前提の受け渡しという3点を押さえてください。慣れが必要なのは操作ではなく、この部分です。
具体的に伝える
曖昧な依頼からは曖昧な結果しか返りません。「直して」ではなく「入力が空のときに画面が真っ白になる不具合を直して」と書くだけで、精度は変わります。
変えてほしくない部分も添えると、影響範囲を抑えられます。「公開している関数の仕様は変えずに」といった制約があると、想定外の変更を防げます。
対象となるファイルを選択したうえで依頼すると、さらに範囲が絞られます。エディタの中で使う利点を活かしてください。
段階に分けて渡す
大きな依頼を一度に投げると、途中で方向がぶれやすくなります。調査、設計、実装、テストを別のやり取りに分けるだけでも結果は安定します。
各段階の終わりに内容を確認すると、誤りが後工程へ持ち越されません。手戻りの総量で見れば、この確認のほうが安上がりです。
複数の作業が必要な場合は、番号を振って順序を示す方法も有効です。何をどの順で行うかが明確になり、抜けが減ります。
プロジェクトの前提を渡す
毎回同じ説明を書いているなら、それは設定に移すべき内容です。コーディング規約、使っているフレームワーク、テストの実行方法、触ってはいけない領域などが対象になります。
プロジェクトの直下に前提を書いたファイルを置いておけば、毎回のやり取りで説明する必要がなくなります。チームで共有すれば、誰が使っても同じ前提で動きます。
書き方のコツは具体性です。「読みやすく書く」ではなく「インデントは2スペース」「テストは特定のコマンドで実行する」といった、検証できる粒度にしてください。
指示の設計そのものについては、生成AIの精度を上げるプロンプト設計の基本も参考になります。
| 資料請求のご案内 チームで共有する設定の例と、社内展開の手順をまとめた資料をお配りしています。 標準の環境をそろえたい段階でご利用ください。 ▶ 資料請求はこちら |
料金と利用枠
費用の考え方を整理します。プランに含まれる範囲、APIキーで使う場合、消費を抑える工夫という3点です。拡張機能そのものに追加費用はかかりません。
ChatGPTプランに含まれる
Codexは各有料プランに含まれており、別途の契約は不要です。利用した分はプランの枠から消費される形になります。
枠はモデルごと、そして一定時間の枠として設定されています。軽い質問と、長時間かかる自律的な作業とでは消費量が大きく異なるため、依頼の長さだけでは見積もれません。
上位のプランほど枠は広がります。日常的に使うかどうかを確かめてから、上位への変更を検討する順序が合理的です。
出典：Codex公式ドキュメント「IDE extension」
APIキーで使う場合
アカウントの代わりにAPIキーを使う方式もあります。この場合は使ったトークン量に応じた従量課金となり、プランの枠とは別に計算されます。
一方で、クラウド側の一部機能は利用できなくなります。共有環境や自動実行での利用を想定した選択肢と考えてください。
個人の日常的な開発であれば、アカウントでのサインインのほうが費用の見通しが立てやすくなります。
消費を抑える工夫
設定次第で消費は変わります。日常的な質問は軽いモデル、複雑な判断が必要な場面だけ上位のモデルという使い分けが基本です。
考える深さの設定も影響します。単純な作業まで深く考えさせると、待ち時間と消費の両方が増えます。
渡す文脈を絞ることも有効です。関係のないファイルまで読み込ませない、会話が長くなったら区切るといった運用で、無駄を減らせます。
消費の状況は管理画面から確認できます。週に一度は確認する運用にしておくと、想定より早く枠を使い切る事態を避けられます。
CLI・クラウドとの使い分け
同じCodexでも、入り口によって向いている作業が変わります。IDE拡張、CLI、クラウドという3つを比較します。どれか1つに絞るより、場面で使い分ける前提のほうが実態に合います。
IDE拡張が向いている場面
エディタを開いている時間が長い人には、この入り口が最も自然です。焦点を絞った修正、初めて触るコードの理解、変更内容をその場で確認したい作業に向いています。
画面上で差分を見ながら進められるため、確認の負担が小さくなります。非エンジニアに説明する場面でも、視覚的に伝えやすい利点があります。
逆に、資料作成や議事録の整理といった一般業務が中心であれば、エディタを覚える必要はありません。その場合はデスクトップアプリのほうが適しています。
CLIが向いている場面
ターミナルで動くCLIは、自動化との相性が優れています。長時間かかる作業、繰り返し実行する処理、CIへの組み込みといった用途が対象です。
指示を引数として渡して結果だけを受け取る使い方ができるため、スクリプトの一部として組み込めます。定期的に実行したい処理があれば、こちらを選びます。
設定の一部は拡張機能と共有されるため、両方を併用しても大きな負担にはなりません。作業の性質で選んでください。
クラウドへ委任する
拡張機能からは、規模の大きい作業をクラウド側へ渡すこともできます。手元で素早く反復する作業と、時間のかかる作業を分けられる構成です。
委任した作業の結果は、同じエディタの画面に戻って確認できます。作業の流れを切らずに、規模の異なる依頼を扱えます。
エージェント型のAIをどう業務に組み込むかという考え方は、AIエージェントとは？仕組みと業務への組み込み方で扱っています。
チームで使う場合の設計
個人で慣れたら、次はチームへの展開です。設定の共有、権限とレビュー、効果の測定という3点を整理します。個人設定のままでは、結果の再現性が出ません。
設定を共有する
エディタの設定やプロジェクトの前提は、バージョン管理に含めて共有できます。全員が同じ設定で作業すれば、出力の傾向がそろいます。
モデルの既定値、応答の言語、コメントの書き方といった項目をそろえておくと、レビューの際の違和感も減ります。新しく参加した人も同じ環境で始められます。
更新の流れも決めておきます。気づいた人が追記し、レビューを経て反映する運用にすると、内容が実態から離れません。
権限とレビュー
どこまで自動で実行させるかは、チームで統一しておきます。業務のコードでは確認を挟む状態を基本とし、影響の小さい作業から範囲を広げる進め方が無難です。
生成された変更をそのまま取り込む運用は避けてください。差分を人が確認し、なぜその実装になっているかを理解したうえで判断する工程を残します。
レビューの観点を事前に定義しておくと、確認の質がそろいます。セキュリティ、可読性、テストの有無といった項目を明示してください。
効果を測る
導入の効果は、既存の指標に紐づけて記録します。実装にかかる時間、レビューでの指摘件数、テストの追加量などが分かりやすい指標です。
背景には人材面の課題もあります。情報処理推進機構（IPA）の調査では、DXを推進する人材が不足していると回答した企業の合計が85.5%に達しました。限られた人数で成果を出す手段として、こうしたツールの位置づけは大きくなっています。
出典：独立行政法人情報処理推進機構「DX動向2026」（2026年7月16日公表）
全社的な推進体制の設計は、AI導入を成功させる進め方と社内推進体制の作り方で解説しています。
| 無料相談のご案内 全社展開の設計や、レビュー体制への組み込みについてもご相談を承っています。 要件整理の段階から対応可能です。 ▶ 無料で相談する |
他ツールとの比較の考え方
選択肢は複数あります。補完中心のツールとの違い、他社のエージェント型ツール、判断のポイントという3点を整理します。評価は自社のコードで行うのが確実です。
補完中心のツールとの違い
従来のコード補完は、書きかけの行の続きを提案するものでした。Codexの拡張機能は、これに加えて複数のファイルにまたがる変更を提案し、コマンドの実行まで担えます。
任せる粒度が上がる分、確認の負担も増えます。書く手間が減った時間を、内容を理解する時間に振り向ける意識が必要になります。
併用も可能です。細かい補完は従来のツール、まとまった作業はCodex、という分担にしている開発者もいます。
ただし、同じ役割のツールを重ねると提案が競合します。どの場面でどちらを使うかを決めてから併用してください。
他社のエージェント型ツール
エディタの中で動くAIツールは他にもあります。AIを前提に作られたエディタを使う方法と、既存のエディタに拡張機能を足す方法という違いがあります。
既存の環境を変えたくない場合は拡張機能、AI機能を中心に据えたいならエディタごと乗り換える、という判断になります。チームの構成によって適した選択は変わります。
エディタ側の選択肢については、Cursorの使い方と基本機能の使い分けで解説しています。
導入判断のポイント
判断材料は3点に集約されます。既存契約との相性、対象業務との適合、統制要件です。
既存契約との相性は追加費用の有無に直結します。すでにChatGPTの有料プランを使っているなら、拡張機能を試す追加コストはありません。
対象業務との適合は、実際のコードで試すほかありません。ベンチマークの数値ではなく、自社のプロジェクトで手応えがあるかを確認してください。
統制要件は、監査記録や権限管理が必要かどうかで選ぶべきプランが決まります。個人契約の寄せ集めでは管理が成り立たないため、人数が増える前に法人向けの契約形態を検討してください。
まとめ｜既存の環境を変えずに試せる入り口
Codex VS Code拡張は、普段使っているエディタの中でCodexを利用できるOpenAI公式の拡張機能です。VS Codeのほか、CursorやWindsurfといった派生エディタにも対応しており、開いているファイルや選択範囲をそのまま文脈として渡せます。
導入は拡張機能を追加してサインインするだけで、追加の契約は不要です。ChatGPTのPlus以上のプランに含まれるため、すでに契約している組織であれば追加コストなしで試せます。無料プランでは利用できない点だけ注意してください。
使いこなす鍵は、読み取り中心の依頼から始め、確認を挟む設定のまま範囲を広げていくことです。そのうえで、プロジェクトの前提を設定として共有し、差分を人が確認する運用にすれば、チームでも安全に効果を出せます。
| 無料相談のご案内 AI開発ツールの選定から環境構築、社内ルールの整備、開発体制への定着までを一貫して支援しています。 まずは現状の課題をお聞かせください。 ▶ 無料相談フォームはこちら |
