AIツール活用

CodexをVS Codeで使う方法!拡張機能の導入と変更確認の手順を解説

中島大介(なかじ)読了時間 約17分
Codex VS Codeのアイキャッチ

VS Codeで開いているコードについてAIに相談する際、ファイルを別のチャットへ貼り直すと、対象箇所の指定や変更の確認に手間がかかります。Codexの公式拡張は、エディタ内からファイルや選択範囲を参照して作業を依頼できるツールです。

この記事を読めば、Codexの公式拡張をVS Codeに導入してサインインする方法と、変更内容の確認・表示されない場合の対処が分かります。自分の作業環境で確認すべき設定と、CLI版・クラウドとの使い分けも整理できます。初回は変更前の状態を保存し、編集を依頼する前に対象ファイルと権限を確認しましょう。

目次

CodexのVS Code拡張とは【コードを見ながら依頼できる】

CodexのVS Code拡張は、VS Codeの画面の中からCodexに作業を依頼するための公式の拡張機能です。どのように動き、何を任せられるのかを先に知っておくと、作業前に権限を確認する理由も理解しやすくなります。CodexのVS Code拡張について押さえておきたい特徴は、以下の3つです。

  • 公式拡張からエディタ内で依頼できる
  • 開いているファイルをそのまま見て作業する
  • 自動補完ではなくエージェント型で作業を任せられる

公式拡張からエディタ内で依頼できる

CodexのVS Code拡張は、OpenAIが公式に提供する拡張機能です。VS Codeの拡張機能ストア(Marketplace)で配布されており、発行元はOpenAI・拡張の識別名はopenai.chatgptです。配布ページへは、ChatGPT公式ドキュメントのCodex IDE拡張のページから進めます。

CLI版と違い、ターミナルを開く必要はありません。VS Codeのサイドバーにパネルが加わり、Codexのパネルにやってほしいことを日本語で書くだけです。

Codexの読み方や全体の位置づけ、できることは以下の記事で解説しています。

Codexとは?読み方や旧モデルとの違い・できることまで徹底解説!

開いているファイルをそのまま見て作業する

CodexのVS Code拡張の強みは、エディタで開いている内容をそのまま文脈として使える点です。ChatGPT公式ドキュメントによると、開いているファイル・選択したコード・直近のチャットを入力欄から参照できます。

つまり「今開いているこのファイルを説明して」「選択した部分を直して」といった、目の前の作業に密着した頼み方ができます。ファイルの場所を毎回指定する手間が省けるのが、エディタ統合ならではの利点です。

自動補完ではなくエージェント型で作業を任せられる

Codexの拡張では、コードの続きを入力候補として受け取るだけでなく、調査・編集・コマンド実行をまとめて依頼できます。作業のまとまりを任せられる、エージェント型の開発支援です。

許可された範囲のファイル編集やコマンド実行は、自動で進む場合があります。差分を見られる機能があっても、すべての変更が適用前の確認待ちになるわけではありません。作業前に現在の権限設定を確認し、変更後は差分と実行結果をレビューしましょう。

承認とサンドボックスの仕組みは、ChatGPT公式ドキュメントの承認とセキュリティのページで説明されています。

CodexのVS Code拡張をインストールする手順

CodexのVS Code拡張は、拡張機能ストアから入れてサインインし、作業したいフォルダを開くと使い始められます。名前の似た拡張と取り違えないよう、発行元を確かめながら進めることが大切です。CodexのVS Code拡張を導入する手順は、以下の3ステップです。

  1. 拡張機能ストアからCodexを入れる
  2. ChatGPTアカウントでサインインする
  3. 作業したいフォルダを開く

拡張機能ストアからCodexを入れる

最初に、CodexのVS Code拡張を入れます。拡張機能ストアからCodexを入れる手順は、以下のとおりです。

  1. VS Codeの拡張機能ビューを開く(WindowsはCtrl+Shift+X、MacはCmd+Shift+X)
  2. 拡張機能ビューで「Codex」と検索する
  3. 表示された候補から、発行元がOpenAIの「Codex – OpenAI's coding agent」を選んでインストールする

検索結果には似た名前の拡張が並ぶことがあるため、発行元がOpenAIであることを必ず確認してください。

拡張機能の導入と、プロジェクトの実行に必要な開発環境は別です。たとえばNode.jsを使うプロジェクトのテストには、プロジェクトが必要とする実行環境を用意します。

ChatGPTアカウントでサインインする

インストール後、サイドバーに追加されたCodexのアイコンを開きます。初回はサインインを求められるので、Sign in with ChatGPTを選択してください。ブラウザが開き、ChatGPTアカウントで認証すると連携が完了します。

APIキーでのサインインも選べます。APIキーでサインインした場合は、プランの枠ではなくAPIの従量課金です。個人でChatGPTの有料プランを使っているなら、ChatGPTアカウントでのサインインが簡単です。

作業したいフォルダを開く

最後に、作業したいプロジェクトのフォルダをVS Codeで開きます。Codexへ渡す作業範囲を明確にするため、対象プロジェクトをフォルダとして開きましょう。

フォルダを開いたら、Codexのパネルに「このプロジェクトの構成を説明して」のような指示を日本語で入力しましょう。初回は「ファイルは変更せず、構成と実行方法を説明して」と依頼すると、作業対象を確認できます。

編集する場合は、Gitで変更前の状態を保存するか、元ファイルのバックアップを用意してください。

CodexのVS Code拡張でできること

CodexのVS Code拡張では、開いているコードについて相談するだけでなく、変更の確認や重い作業の委譲もエディタから行えます。できることを知っておくと、手元で進める作業とクラウドへ任せる作業を分けやすくなります。CodexのVS Code拡張でできることは、主に以下の3つです。

  • 開いているコードの説明と修正を頼む
  • 変更後の差分とテスト結果を確認する
  • 重い作業はクラウドへ委譲する

開いているコードの説明と修正を頼む

日常でよく使うのが、目の前のコードの説明と修正です。ChatGPT公式ドキュメントも、エディタに開いたコンテキストを持ったまま、説明・編集・デバッグを頼めると案内しています。

「このエラーの原因を調べて」「この関数にコメントを付けて」といった依頼を、ファイルを開いたまま日本語で出せます。作業と会話を同じ画面で確認できるため、対象のコードへ戻りやすくなります。日本語での回答が必要なら、依頼に「日本語で説明して」と明記してください。

変更後の差分とテスト結果を確認する

Codexが作業した後は、変更ファイルと差分、テスト結果を確認します。書き込みが許可されていれば、確認画面を見る前に作業フォルダが変更されている場合があるためです。変更前に保存した状態と比べ、依頼した範囲を超えていないかを確かめましょう。

Codexの作業後に確認する項目は、以下のとおりです。

  • 変更されたファイルと、依頼内容との対応
  • 意図しない削除や設定変更の有無
  • 実行したテストの内容と結果
  • テストを実行できなかった部分

差分を見られるだけで、事故を防げるわけではありません。内容を判断できない変更は、詳しい担当者に確認を依頼することが必要です。

重い作業はクラウドへ委譲する

時間のかかる大きな作業は、クラウドに任せられます。ChatGPT公式ドキュメントによると、素早い反復はローカルで行い、より時間と余地が必要なタスクはCodexのクラウド側に接続して委譲する形です。

委譲した後も、進み具合はVS Codeを離れずに追えます。手元では別の作業を続けながら、重いタスクをクラウドで走らせられます。

CodexのVS Code拡張が表示されない・動かないときの対処

CodexのVS Code拡張が表示されない・動かないときは、症状を分けて原因を調べます。パネルの表示・サインイン・入力のどこで止まっているかによって、確認する場所が変わるためです。CodexのVS Code拡張でつまずきやすい症状と対処は、以下の3つです。

  • パネルが出ないときはコマンドで開く
  • サインイン後に進まないときは認証と接続を確認する
  • 入力できないときはフォルダの状態を確認する

パネルが出ないときはコマンドで開く

インストールしたのにパネルが見当たらない場合は、コマンドから開けます。ChatGPT公式ドキュメントによると、コマンドパレットを開いて「Codex: Open Codex Sidebar」を実行すると、Codexのサイドバーが開きます。

Codexのアイコンが見当たらない場合は、まず「Codex: Open Codex Sidebar」を試してください。コマンドを試しても拡張自体が見当たらない場合は、拡張機能ビューでインストール済みかを確認します。

サインイン後に進まないときは認証と接続を確認する

ブラウザでの認証後に拡張へ戻れない場合は、認証が完了したか、意図したアカウントとワークスペースでサインインしたかを確認します。ChatGPT公式ドキュメントの認証のページによると、ブラウザでログインした後に、認証情報がCodexへ戻る仕組みです。

作業中のファイルを保存してVS Codeを再起動する方法もありますが、再起動で必ず直るとは限りません。表示されたエラーを確認し、ネットワーク制限や組織の利用許可、拡張の有効状態を切り分けましょう。

問い合わせる場合は、VS Codeと拡張のバージョン・発生した操作・秘密情報を除いたエラー内容を整理します。

入力できないときはフォルダの状態を確認する

入力できない場合は、まず対象プロジェクトのフォルダが開いているかを確認しましょう。フォルダを開いていても入力できない場合は、認証状態・利用上限・拡張のエラーなどを調べる必要があります。原因をフォルダだけに決めつけないことが大切です。

拡張が無効になっていないかを確認し、Codexパネルに表示されている案内を読みます。認証トークンやAPIキーをエラー報告へ貼らないようにしましょう。

CodexのVS Code版とCLI版・クラウドの使い分け

CodexはVS Code版のほか、ターミナルで使うCLI版や、リモート環境で作業を進めるクラウドからも使えます。進めたい作業によって向く入口が違うため、目的に合わせて選ぶことが大切です。CodexのVS Code版・CLI版・クラウドという3つの入口の使い分けは、以下のとおりです。

  • 対話しながら作業するならVS Code版
  • スクリプトへ組み込む自動化にはCLI版
  • 長時間の重い作業はクラウド

対話しながら作業するならVS Code版

コードを見ながら少しずつ相談して進めたいなら、VS Code版が向いています。変更後の差分をエディタで確認でき、普段の操作に続けて作業できます。開いているファイルや選択範囲を参照した、短い修正依頼に使いやすい構成です。

ターミナルに不慣れな人にとっても、VS Code版は始めやすい入口です。

スクリプトへ組み込む自動化にはCLI版

決まった処理をスクリプトに組み込んだり、定期的に無人で実行したりする用途では、CLI版が向いています。

ChatGPT公式ドキュメントによると、CLI版とVS Code拡張はログイン情報と設定を共有します。同じ環境では、保存済みの認証を再利用できます。ただし、片方でログアウトすると再ログインが必要になります。別のマシンや別の認証保存先まで、常に共有されるわけではありません。

CLIには、Webやデスクトップアプリにある定期実行の管理画面はありません。スクリプト実行を組み込む用途と、アプリ内で予定を設定する機能を分けて選びましょう。

Codex CLIの導入から、日本語での依頼・変更確認までの使い方は以下の記事で解説しています。

Codexの使い方を解説!CLIの導入から日本語での依頼・変更確認まで

長時間の重い作業はクラウド

大規模な変更や時間のかかるタスクは、クラウドへの委譲が効きます。クラウドにはVS Code版から接続でき、委譲した後は手元の環境を占有せずに進捗だけを追えます。

クラウドへ送ったタスクはリモート環境で実行されます。接続先や実行結果を確認し、手元の変更と混ぜずにレビューしましょう。

CodexのVS Code利用に関するよくある質問

CodexをVS Codeで使い始める前に気になりやすい、料金・対応エディタ・CLIの要否の疑問に回答します。CodexのVS Code利用について、よくある質問は以下の3つです。

  • VS Codeで使うのにいくらかかりますか?
  • Cursorなど他のエディタでも使えますか?
  • CLIを入れないとVS Code拡張は使えませんか?

VS Codeで使うのにいくらかかりますか?

拡張機能自体は無料で、利用にはChatGPTのプランかAPIキーが必要です。ChatGPT公式ドキュメントの料金ページによると、CodexはFree・Go・Plus・Pro・Business・Enterpriseの各プランに含まれます。ChatGPTログインでは、契約プランの利用枠を使います。

追加クレジットの購入やAPI利用には、別の費用が発生します。拡張のインストール料金と実行費用は、分けて確認しましょう。

APIキーで使う場合のみ、トークン量に応じた従量課金です。Codexの料金の詳細は、以下の記事にまとめました。

Codexの料金を徹底解説!無料でできることとプランの選び方も紹介

Cursorなど他のエディタでも使えますか?

使えます。ChatGPT公式ドキュメントによると、エディタごとのCodexの使い方は以下のとおりです。

  • VS Code・VS Code Insiders・Cursor・Windsurf:Codex拡張を入れて使う
  • XcodeとJetBrains系IDE:同じ拡張機能を入れる方式ではなく、各IDEの独自の統合機能からCodexを使う

CursorやWindsurfでも、VS Codeと同じくアイコンかコマンドからCodexのサイドバーを開けます。

VS Code系のエディタを使っているなら、多くの場合そのままCodexを導入できます。使い慣れたエディタを変えずに始められる点は、大きな利点です。

CLIを入れないとVS Code拡張は使えませんか?

必須ではありません。CodexのVS Code拡張は単体でインストールでき、ターミナルのCLIを別途入れなくても動きます。まずは拡張だけで始めても大丈夫です。

CLIと拡張は、同じ環境では認証キャッシュや設定を共有します。実行環境や保存先が異なる場合は、実際の認証状態を確認することが必要です。CLIは、必要になった段階で追加すれば十分です。

まとめ

Codexの公式拡張を使うと、VS Codeで開いたファイルや選択範囲を参照して、調査や編集を依頼できます。発行元と拡張IDを確認して導入し、ChatGPTアカウントまたはAPIキーでサインインしましょう。課金先はログイン方法によって変わります。

CodexのVS Code拡張に編集を任せる前に確認する項目は、以下のとおりです。

  • 作業フォルダ
  • 現在の権限設定
  • 変更前の保存状態

作業後は差分とテスト結果を確認し、判断できない変更は詳しい担当者へ相談してください。まずはプロジェクトの説明を依頼し、対象範囲を把握するところから始めましょう。

参考リンク

この記事の監修者

中島大介(なかじ)

中島大介(なかじ)

株式会社メリル 代表取締役 / 記事監修

株式会社メリル代表取締役。SEO歴20年以上。最新AIやセキュリティについて発信するYouTube「ウェブ職TV」は登録者15万人以上。著書「ChatGPT & Copilotの教科書」は10万部突破!

プロフィールを見る

関連する記事

Cursorのプラグイン「pstack」の使い方を解説する記事のアイキャッチ
AIツール活用

pstackの使い方|Cursor・Claude Codeへの入れ方と頼み方

pstackを使ってみたい方は必見!この記事では、pstackの入れ方と/poteto-modeでの頼み方を解説します。実は、pstackで最初に覚えるコマンドは2つだけです。記事を読めば、AIに確かめさせながら作業を任せられます。

中島大介(なかじ)監修 / Touch AI編集部25 分で読めます
MetaのAIエージェント「Muse」の使い方を解説する記事のアイキャッチ
AIツール活用

Museの使い方|Meta Museの始め方・初期設定・料金を解説

Museを使い始めたい方は必見!この記事では、Meta Museの始め方・初期設定・料金を解説します。実は、Museとのやり取りをAIの学習に使う設定は最初からオンです。記事を読めば、任せる範囲を決めてから使い始められます。

中島大介(なかじ)監修 / Touch AI編集部26 分で読めます
Claude Codeで複数ファイルを一括置換する方法を解説する記事のアイキャッチ
AIツール活用

複数ファイルの文字列を一括置換するには?Claude Codeで残す語を指定

製品名の変更で複数のファイルを直したい方は必見!この記事では、Claude Codeで複数のファイルの文字を一括置換する手順を解説します。実は、残す語を決めてから置き換えられます。記事を読めば、コピーから元に戻す方法も分かります。

中島大介(なかじ)監修 / Touch AI編集部19 分で読めます

次のステップ

最新動向を学びに変える

話題のAIアップデートを、現役講師が背景と実務への影響まで解きほぐします。Touch AI の最新講座で、変化に追いつくための視点を得てください。

受講できる講座を見る