Codex VSCode拡張の使い方 インストール手順と基本操作・CLIとの違い

Codexをターミナルで使ってみたものの、コードを見ながら作業したい場面では画面を行き来する手間が気になります。エディタの中でそのまま指示を出せれば、開いているファイルを説明し直す必要もありません。

OpenAIはVS Code向けの公式拡張機能を提供しており、サイドバーからCodexを呼び出せます。開いているファイルや選択した範囲が自動で文脈として渡されるため、短い依頼でも意図が伝わりやすくなります。

本記事では、拡張機能の特徴とインストール手順、サインインと初回の操作、差分の確認方法、CLIやクラウドとの使い分け、表示されないときの対処までをまとめました。エディタ中心で作業したい方に向けた内容です。

確認したいポイント	結論	詳細
VSCode拡張とは何か？	エディタ内で使う公式拡張	サイドバーからCodexを呼び出し、コードを見ながら作業を依頼できます。
ターミナル版との違いは？	文脈と差分の扱いやすさ	開いているファイルが自動で渡され、変更はエディタ上で確認できます。
導入に必要なものは？	対象プランへの加入のみ	拡張機能を入れて契約中のアカウントでサインインすれば使えます。
インストール方法は？	拡張機能パネルから検索	発行元がOpenAIであることを確認してからインストールします。
使う前の準備は？	プロジェクトを開いておく	フォルダが指定されていないと処理の対象が定まらず実行できません。
最初に何を試す？	読むだけの依頼から始める	構成の説明や関数の解説など、変更を伴わない依頼で挙動を確かめます。
アイコンが出ない時は？	再起動して有効化を確認	多くは再起動で解決し、コマンドパレットからも起動できます。
CLIとどう使い分ける？	編集は拡張、自動化はCLI	同じ枠で動くため、細かい修正と自動処理で入り口を切り替えられます。

この記事でわかること

• VS Code拡張の特徴と、ターミナル版との作業感の違い
• 拡張機能のインストールからサインインまでの具体的な手順
• エディタの文脈を使った依頼の出し方と、差分を確認する流れ
• CLI・クラウド・デスクトップという4つの入り口の使い分け
• アイコンが表示されない場合など、つまずいたときの対処法

開発現場へのAI導入を検討している方へ ツールを配布するだけでは、開発フローへの定着までは進みません。ネクストスケールでは、組み込み方の設計から社内ルールの整備、エンジニア向けの研修までを一貫して支援していますので、まずは無料相談をご利用ください。 ▶ 開発現場のAI活用について相談する

Codex VSCode拡張とは

最初に、この拡張機能がどのような位置づけにあるかを整理します。エディタの中でコーディングエージェントを使うための入り口にあたります。

エディタの文脈をそのまま使える

最大の特徴は文脈の扱いです。開いているファイルや選択したコードが自動で依頼に添えられるため、長い説明を書かなくても意図が伝わります。参考：OpenAI公式「Codex IDE extension」

ターミナルで作業する場合、どのファイルを見てほしいのかを言葉で伝える手間がかかります。拡張機能では、いま画面に映っているものが前提として共有された状態から始められます。

この差は、作業の量が増えるほど効いてきます。1回あたりは数十秒の違いでも、1日に何度も繰り返せばまとまった時間になります。

過去のやり取りを参照させることもできます。関連する会話を添えれば、前回の続きから作業を進められます。

画像を渡して指示する使い方にも対応しています。画面の見た目を伝えたい場面では、言葉で説明するより意図が正確に伝わります。

変更をその場で確認できる

提案された変更は、要約と差分がエディタの中に表示されます。どの行がどう変わるのかを見たうえで、採用するかどうかを判断できます。

別の画面へ移動せずに確認できるため、レビューの流れが途切れません。必要な変更だけを残し、その場で追加の依頼を出すこともできます。

変更された箇所が複数のファイルにまたがる場合も、まとめて確認できます。どのファイルに手が入ったかを見落とさずに済みます。

ターミナル版でも差分は確認できますが、エディタ上で該当箇所を見ながら判断できる点は作業感が大きく異なります。

取り込んだ変更を後から取り消すこともできます。試しに適用して挙動を見てから判断する、という進め方が取りやすくなっています。

対応するエディタと必要なもの

VS Codeのほか、それをもとにした互換のエディタでも同じ拡張機能が使えます。JetBrains系やXcodeには、それぞれ専用の統合が用意されています。

利用には、ChatGPTの有料プランへの加入か、APIキーの設定が必要です。契約中のプランの枠内で使う形が一般的で、追加の契約は必要ありません。

組織で使う場合は、どのプランが対象になるかを事前に確認します。個人の契約と法人の契約では、利用できる範囲が異なる場合があります。

対応する環境はmacOS、Windows、Linuxです。Windowsでは、環境によってはLinux環境を経由する構成のほうが安定します。

複数の入り口は同じ実行の仕組みを共有しています。エディタで渡した文脈の続きを別の入り口で扱う、といった連携も可能です。

関連記事：Codexの使い方｜プロンプトの型からAGENTS.md・権限設定まで実践手順を解説

インストールとサインインの手順

導入は数分で終わります。拡張機能を入れてサインインするだけで、すぐに使い始められます。

手順1：拡張機能をインストールする

VS Codeの拡張機能パネルを開き、検索欄にCodexと入力します。発行元がOpenAIであることを確認してからインストールします。

検索結果には似た名前の拡張機能が並ぶ場合があります。公式の配布ページからインストールする方法であれば、取り違えを避けられます。

インストール後は、拡張機能の一覧で有効になっているかを確認します。無効のままだとサイドバーに表示されません。

発行元を信頼するかを確認する表示が出た際は、内容を読んだうえで進めます。組織の端末では、拡張機能の導入に制限がかかっている場合もあります。

社内の端末で導入できない場合は、情報システム部門への申請が必要になることがあります。事前に確認しておくと手戻りを防げます。

手順2：サインインする

インストール後、サイドバーからCodexを開くとサインインを求められます。契約中のアカウントでログインすれば、その後の設定は不要です。

ブラウザが開いて認証画面が表示されるため、案内に従って進めます。完了するとエディタに戻り、利用できる状態になります。

すでにターミナル版でログインしている環境では、同じ認証情報が引き継がれる場合があります。サインインを求められなければ、そのまま使い始められます。

APIキーを使う構成も選べます。自動化の用途と併用する場合や、利用の区分を分けたい場合に検討する方式です。

手順3：作業するフォルダを開く

プロジェクトのフォルダを開いた状態で使うことが前提です。フォルダが指定されていないと、処理の対象が定まらず実行できません。

開いたフォルダの範囲が、参照と変更の対象になります。関係のないファイルまで含めると判断の材料が散らかるため、対象を絞って開くほうが結果は安定します。

規模の大きいリポジトリでは、作業する範囲のディレクトリだけを開く方法も有効です。読み込みにかかる時間も短くなります。

作業を始める前に、変更を元に戻せる状態を確保しておきます。区切りごとに記録を残しておけば、想定と違う変更が入っても復旧できます。

バージョン管理されていない場所での利用は避けます。取り消せる状態があることが、安心して任せるための条件になります。

サイドバーの配置を調整する

VS Codeでは、初期状態で右側のサイドバーに表示されます。左側で使いたい場合は、アイコンをドラッグして移動できます。

互換のエディタでは、既存のチャット機能と並べたい場合に配置の調整が必要になることがあります。表示の向きを一時的に変更してから移動する方法が案内されています。

配置は好みで問題ありません。コードと差分を同時に見たい場合は、エディタの幅に余裕がある側へ置くと確認しやすくなります。

関連記事：Codex appとは？ChatGPTアプリ統合後の使い方・料金・Mac／Windowsの始め方を解説

基本的な使い方

導入が済んだら実際の操作に入ります。まず読むだけの依頼から試すと、挙動を把握しやすくなります。

最初に試したい依頼

プロジェクトを開いた状態で、構成を説明させる依頼から始めます。変更を伴わないため、想定と違う結果が返っても影響がありません。

初めて触るコードを読む場面でも役立ちます。特定の関数の処理内容や、どこから呼ばれているのかを尋ねると、把握にかかる時間を短縮できます。

引き継いだプロジェクトの全体像を掴む用途にも向きます。仕様書が残っていない状況でも、実装から構造を説明させられます。

挙動が掴めたら、小さな修正を依頼します。1回の依頼で扱う範囲を絞るほど、差分の確認が楽になります。

テストの作成を依頼する使い方も、最初の一歩として扱いやすい作業です。既存の処理を変えずに追加するだけで済みます。

エディタの文脈を活かした依頼の出し方

修正したい箇所を選択してから依頼すると、対象を言葉で説明する必要がなくなります。「ここを直して」という短い指示でも通じるのはこのためです。

複数のファイルにまたがる作業では、関連するファイルを明示的に添えます。探させる手間が省け、対象の取り違えも防げます。

期待する結果は具体的に書きます。どのような状態になれば完了なのかが伝われば、確認のやり取りが減ります。

指示は日本語でも構いません。期待する結果と満たすべき条件を書くと、手直しの量が減ります。書き方の基本はプロンプトの書き方でも整理しています。

うまくいった依頼の書き方は残しておきます。似た作業を繰り返す場面で、同じ品質の結果を得やすくなります。

変更を確認して取り込む

作業が終わると、何をどう変えたかの要約と、変更された行が表示されます。内容を確認したうえで、採用するかどうかを決めます。

納得できない箇所があれば、その場で追加の依頼を出します。全体をやり直させるより、部分を指定して直すほうが精度は上がります。

意図と違う変更が含まれていた場合は、その理由を尋ねる方法もあります。前提の伝え方に不足があったのかを確認できます。

動いたという報告だけで受け入れず、差分に目を通す運用を維持します。テストが用意されている環境であれば、実行結果まで確認します。

変更を取り込んだ後も、まとめて確認する工程を残します。個別には問題がなくても、全体として整合が取れていない場合があります。

開発フローへの組み込み方を設計しませんか コーディングエージェントは、どの工程に置くかで効果が大きく変わります。ネクストスケールでは、現在の開発体制をうかがったうえで、無理なく組み込める形をご提案しています。 ▶ 導入支援サービスの詳細を見る

関連記事：CodexのGitHub連携｜PRレビュー自動化の設定手順とレビュー基準の作り方

CLI・クラウドとの使い分け

Codexには複数の入り口があります。同じアカウントと同じ利用枠で動くため、場面に応じて使い分けられます。

4つの入り口の役割

エディタ拡張、ターミナル版、クラウド、デスクトップ向けのアプリという構成です。それぞれ得意な場面が異なります。

エディタ拡張は、コードを見ながら細かく直す作業に向いています。ターミナル版は自動化の仕組みに組み込む用途や、決まった処理を一度きりで実行する場面で扱いやすくなります。

入り口が違っても、設定や前提を書いたファイルは共有されます。一度整えれば、どこから使っても同じ振る舞いになります。

クラウドは時間のかかる作業を任せる用途、デスクトップ向けのアプリは開発以外の業務も含めて使う場面が想定されています。

どれか1つに絞る必要はありません。同じ利用枠で動くため、作業の性質に応じて入り口を切り替える使い方が想定されています。

エディタ拡張が向いている場面

変更点を目で確認しながら進めたい作業、初めて触るコードを理解する作業、部分的な修正を重ねる作業が該当します。

レビューの前段として使う場合も、該当箇所を開きながら指摘を受けられる点が利点になります。指摘の内容を確認しながら判断できます。

設計の方針を相談しながら進める作業にも向きます。実装に入る前に、選択肢を並べて検討する使い方ができます。

ターミナル版が向いている場面

継続的な検証の仕組みに組み込む、決まった作業をスクリプトから呼び出すといった用途は、ターミナル版のほうが扱いやすい構成です。

複数のリポジトリに同じ処理をまとめてかける場合も、ターミナル版が向いています。手順をスクリプトとして残せる点が利点です。

承認の扱いや設定ファイルの書き方など、詳しい内容はCodex CLIの使い方と基本コマンドで解説しています。導入手順はCodex CLIのインストール方法をご覧ください。

時間のかかる作業は委ねる

数十分かかるような作業は、エディタの前で待つ必要がありません。別の環境に任せて、結果が出てから確認に戻るという進め方が選べます。

自律的に作業を進める仕組み全般の考え方は、AIエージェントの仕組みと業務への活かし方で整理しています。

つまずいたときの対処

起きやすい症状は限られています。切り分けの順番を知っておけば、短時間で復旧できます。

アイコンが表示されない

最も多い症状です。エディタを再起動すると表示されるケースがほとんどで、それでも出ない場合は拡張機能が有効になっているかを確認します。

コマンドパレットからCodexのサイドバーを開く操作を実行する方法もあります。アイコンが見当たらなくても、この経路から起動できます。

エディタ本体の版が古い場合も、対応していない可能性があります。更新してから再度確認します。

複数の拡張機能を入れている場合は、発行元が公式のものかを見直します。似た名前の別の拡張を入れていることがあります。

実行できない、対象が見つからない

フォルダを開かずにファイル単体で開いていると、処理の対象が定まらず実行できません。プロジェクトのフォルダを開き直して確認します。

複数のフォルダを同時に開いている場合も、対象があいまいになります。作業するプロジェクトだけを開く構成にすると安定します。

読み取り専用の場所に置かれたファイルでは、変更を適用できません。書き込みができる場所で作業しているかを確認します。

サインインが完了しない

ブラウザが開かない、あるいは戻ってこない場合は、外部サイトを開く許可の表示を見落としていないかを確認します。

社内のネットワークに制限がある環境では、通信そのものが遮断されている可能性があります。証明書やプロキシの設定を済ませてから再度試します。

ブラウザで別のアカウントにログインしたままだと、意図しないアカウントで認証されることがあります。切り替えてから試します。

契約しているプランが対象に含まれているかも確認します。無料の範囲では利用できない場合があります。

動作が重い

扱うファイル数が多いプロジェクトでは、読み込みに時間がかかります。対象のフォルダを絞って開くだけで改善する場合があります。

Windows環境では、参照する経路によって読み書きが遅くなることがあります。Linux環境側にプロジェクトを置く構成にすると差が出ます。

やり取りが長くなった場合は、新しい会話に切り替えます。前の内容が残ったままだと、判断の材料が増えて処理が遅くなります。

エンジニア向けのAI研修をご用意しています 導入しても、使い方が定まらないまま放置されるケースは少なくありません。ネクストスケールの研修では、実際のリポジトリを題材にした演習を通じて、開発チームが自走できる状態をつくります。 ▶ 法人向けAI研修の内容を確認する

実務で安定して使うためのコツ

導入しても成果が出ない場合、依頼の粒度と確認の方法に原因があることがほとんどです。

依頼は小さく分ける

大きな作業をまとめて任せると、変更範囲が広がって確認が追いつかなくなります。1回の依頼で扱う対象を絞り、差分を読み切れる大きさに保ちます。

読み切れない量の差分が出た時点で、依頼の分け方を見直す合図と考えます。速さより確実さを優先するほうが、結果的に早く進みます。

手戻りが起きたときも、範囲が小さければ影響を限定できます。1つの依頼で1つの目的に絞る意識が有効です。

区切りごとに記録を残す

作業の前後で状態を保存しておくと、想定と違う変更が入っても元に戻せます。安心して任せるための前提になります。

変更の意図と確認した内容も残しておきます。担当者が変わったときの引き継ぎが進めやすくなります。

依頼した内容そのものも記録に残しておくと、後から経緯を追えます。どの指示でどの変更が入ったのかが対応づけられます。

前提をファイルに書いておく

使用している言語やフレームワークの版、テストの実行方法、命名の決まりを記載したファイルを置いておくと、毎回説明する手間がなくなります。

同じ仕組みはターミナル版でも共有されます。一度整えておけば、どの入り口から使っても同じ前提で作業が進みます。

内容は長く書きすぎないほうが機能します。分量が増えるほど重要な指示が埋もれるため、要点を絞って更新し続ける運用が向いています。

業務で使う際の注意点

開発の現場で使う以上、扱う情報と生成物の品質について確認が必要です。

参照させる範囲と機密情報

開いたフォルダの中に、鍵や接続情報が含まれていないかを確認します。環境変数を記載したファイルや認証情報は、対象から外しておくことが前提です。

社内での取り扱い基準の整え方は、生成AI利用時のセキュリティ対策で詳しく解説しています。

生成されたコードの確認

動作するコードが出力されても、保守しやすい設計とは限りません。既存の方針との整合と、追加された依存関係の妥当性は人が判断します。

外部から取り込む情報に指示が紛れ込む形の攻撃も想定されています。信頼できない内容をそのまま読ませない運用が必要です。

追加されたライブラリについては、必要性とライセンスを確認します。自動で導入された依存が、後の運用で問題になる場合があります。

チームで基準をそろえる

担当者ごとに使い方が異なると、成果物の質にばらつきが出ます。参照させてよい範囲と確認の手順を文書化して共有します。

他のツールと併用する場合の役割分担は、AIツールの使い分けと選び方もあわせてご確認ください。体制づくりはAI研修の選び方と導入手順が参考になります。

まとめ

Codex VSCode拡張は、開いているファイルや選択したコードをそのまま文脈として使える点が最大の利点です。対象を説明する手間がなくなり、短い依頼でも意図が伝わります。

導入は拡張機能をインストールしてサインインするだけで、数分で終わります。プロジェクトのフォルダを開いた状態で使うことが前提で、読むだけの依頼から試すと挙動を把握しやすくなります。

ターミナル版やクラウドとは同じ利用枠で動くため、場面に応じた使い分けができます。細かい修正はエディタ、自動化はターミナル、長時間の作業はクラウドという整理が実務では扱いやすい構成です。

開発現場のAI活用を成果につなげませんか ネクストスケールは、法人企業向けにAI研修・システム開発・業務改革の支援を提供しています。ツールの導入から開発フローへの定着までを伴走します。現状の課題をうかがったうえでご提案しますので、まずはお気軽にご相談ください。 ▶ 無料相談・資料請求はこちら