share

更新日 

  • ChatGPT

CodexはVSCodeで使える?できることやインストール手順、使い方を徹底解説!

CodexをVSCodeで使いたいものの、「インストール方法がわからない」「どのプランが必要なのかわからない」と悩んでいませんか。

Codexは、VSCode上で利用できるOpenAIのAIコーディングエージェントです。

コード生成・バグ修正・テスト実行までを、日本語で指示しながらエディタ上で進められます。

一方で、CLI版との違いや必要なプラン、VSCode拡張機能の設定方法がわかりづらく、導入でつまずきやすい点もあります。

本記事では、Codex VSCode拡張機能のインストール手順から、3つのモードの使い方、実際にできること、利用時の注意点まで詳しく解説します。

VSCode上でCodexを活用し、コード作成や修正作業を効率化しましょう。

監修者

SHIFT AI代表 木内翔大

(株)SHIFT AI 代表取締役 / GMO AI & Web3株式会社AI活用顧問 / 生成AI活用普及協会(GUGA)協議員 / Microsoft Copilot+ PCのCMに出演 / AI活用コミュニティ SHIFT AI(会員20,000人超)を運営。
『日本をAI先進国に』実現のために活動中。Xアカウントのフォロワー数は15万人超え(5/21時点)。

SHIFT AIでは、ChatGPTやGeminiなどの生成AIを活用した「AI副業の始め方」や「収入を得るまでのロードマップ」を学べる無料セミナーを開催しています。

また、参加者限定で、「今日から使えるプロンプト100選」「新時代のAI×デザイン活用ガイド」「Nano Banana Pro 徹底解説」など、全12個の資料を無料で配布しています。

「これからAIを学び始めたい」「AIを使って副業収入を得たい」という方は、ぜひ以下のボタンからセミナーに参加してみてください。

スキルゼロから始められる!

無料AIセミナーに参加する

CodexをVSCodeで使うとできること

CodexをVSCodeで使うと、コード生成から修正・テストまでをエディタ上で効率化できます。主にできることは、以下の3つです。

CodexをVSCodeで使うとできること3つ(ワークスペースのファイル構成を読み込んでコード生成できる・DiffビューでAcceptまでエディタ上で完結できる・統合ターミナルでテスト実行まで一貫してエディタ上で完結できる)

3つの機能を理解した上で使い始めると、Codexをより効果的に活用できます。それぞれ詳しく解説します。

以下の記事では、ChatGPTのCodexの特徴や使い方、実際の活用事例を紹介しているので、Codexの概要を知りたい方はぜひ参考にしてみてください。

ワークスペースのファイル構成を読み込んでコード生成できる

CodexをVSCodeで使うと、ワークスペース内のファイル構成を踏まえたコード生成が可能です。

Agentモードでは、VSCode上のワークスペース内にあるファイルを参照できるため、既存のコード構成や命名規則、ディレクトリ構造に合わせたコードを生成できます。

具体的には、以下のようなプロンプトで指示できます。

既存のサービス層のパターンに合わせてユーザー認証のロジックを実装して
Codex Agentモードが既存のuser_service.pyを参照してauth_service.pyを生成している画面

プロジェクト全体の構造を踏まえてコードを生成できるため、既存コードとの整合性を保ちながら開発を進めやすくなります。

また、手作業で構成を確認する手間を減らせる点も特徴です。

DiffビューでAcceptまでエディタ上で完結できる

Codexは、VSCode上で開いているファイルの修正内容をDiffビューで確認し、そのままエディタへ適用できます。

Agentモードでは、ワークスペース内のファイルを直接参照しながら変更を提案できるため、コードエディタを切り替えることなく修正作業を進められます。

実際の流れは以下のとおりです。

  1. 「このファイルのエラーを直して」とチャットに入力する
  2. CodexがファイルのバグをDiff形式で表示する
  3. 内容を確認してAcceptをクリックするとエディタ上のコードが修正される
CodexがDiffビューでorder_service.pyの3箇所のバグ修正内容を表示している画面

変更前と変更後を比較しながら確認できるため、修正内容を把握した上で安全にコードを適用しやすくなります。

また、エラー調査から修正反映までをVSCode上で一貫して進められる点も特徴です。

統合ターミナルでテスト実行まで一貫してエディタ上で完結できる

Codexは、VSCodeのワークスペースを参照しながらテストコードを生成し、統合ターミナルで実行結果を確認するところまで自動で対応できます。

Agentモードでは、VSCode内の統合ターミナルでコマンドを実行できるため、テストコードの作成から動作確認までをエディタ上で一貫して進められます。

実際の流れは以下のとおりです。

  1. 「このファイルのユニットテストを書いて実行して」とチャットに入力する
  2. Codexが実装コードに対応したテストコードを自動生成する
  3. 統合ターミナルでテストを自動実行し、結果が表示される
Codexが統合ターミナルでpytestを自動実行し6 passedと表示された画面

テストコードの作成から実行結果の確認までをVSCode内で完結できるため、ファイル移動やコマンド入力の手間を減らしながら開発を進めやすくなります。

【3ステップ】Codex VSCode拡張機能のインストール手順

Codex VSCode拡張機能は、3ステップで簡単に導入できます。インストールの流れは以下のとおりです。

  • VSCode Marketplaceから拡張機能をインストールする
  • ChatGPTアカウントでサインインする
  • プロジェクトフォルダを開いてチャットを起動する

事前にポイントを確認しながら進めることで、スムーズにCodexを使い始めやすくなります。

以下の記事では、CodexをCLI版やデスクトップアプリ版でCodexを使いたい方はぜひ参考にしてみてください。

関連記事: 【Mac・Windows】Codexのインストール方法を紹介!CLIとアプリ版の違いも解説

VSCode Marketplaceから拡張機能をインストールする

まず、VSCode(Visual Studio Code)が最新バージョンに近い状態であることを確認します。

バージョンが古い場合、Codex拡張機能を正常にインストールできない可能性があります。

バージョンは、VSCodeのメニューから「ヘルプ→バージョン情報」で確認できます。現時点では「1.121」が最新のバージョンです。

VSCodeのヘルプメニューからバージョン情報を開き1.121と表示された画面

バージョン確認後、VSCode MarketplaceからCodex拡張機能をインストールします。

Ctrl + Shift + X(Macの場合は Cmd + Shift + X)を押して、VSCode Marketplaceを開きます。

Ctrl+Shift+XでVSCode Marketplaceを開いた画面

検索ボックスに「Codex」と入力し、OpenAI公式の拡張機能を選択して「インストール」をクリックします。

VSCode Marketplaceで「Codex」と検索しOpenAI公式の拡張機能が表示された画面

インストールが完了すると、右上にCodexのアイコンが追加されます。

Codex拡張機能のインストール完了後にVSCode右上にアイコンが表示された画面

アイコンが表示されない場合は、右クリックをして「新しいテキスト」を選択すると表示されます。

それでも表示されない場合は、VSCodeを一度再起動してみてください。

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

拡張機能をインストールした後は、ChatGPTアカウントで認証を行います。

まず、右側のアクティビティバーに追加されたCodexアイコンをクリックして、Codexパネルを開きます。

続いて、「Sign in with ChatGPT」をクリックし、ブラウザ上でChatGPTアカウントにログインします。

ログインと認証が完了すると、自動的にVSCodeへ戻り、Codexを利用できる状態になります。

アクティビティバーのCodexアイコンをクリックしてCodexパネルを開いた画面

また、初回起動時にはCodexの機能説明が数画面表示されます。「Next」を押して進めれば問題ありません。

認証後に画面が切り替わらない場合は、VSCodeを再起動してみてください。

プロジェクトフォルダを開いてチャットを起動する

Codexを利用するには、VSCodeでプロジェクトフォルダを開いた状態にする必要があります。

フォルダを開いていない状態では、Codexがワークスペース内のファイルを参照できないため、チャット入力欄や送信ボタンが無効になる場合があります。

まず、メニューバーの「ファイル」から「フォルダーを開く」を選択します。

VSCodeのファイルメニューからフォルダーを開くを選択した画面

フォルダを開いた後にCodexパネルを表示すると、チャット入力欄が有効になります。

入力欄へ「このファイルのエラーを修正して」や「Reactのログイン画面を作成して」など、日本語で指示を入力してEnterを押すと、Codexが処理を開始します。

Codexでプロンプトを実行した画面

ワークスペースを開いた状態で利用すると、Codexが既存ファイルやフォルダ構成を参照しながら、コード生成や修正を進められます。

SHIFT AIでは、ChatGPTやGeminiなどの生成AIを活用して、副業で収入を得たり、昇進・転職などに役立つスキルを学んだりするためのセミナーを開催しています。

また、参加者限定で、「今日から使えるプロンプト100選」「新時代のAI×デザイン活用ガイド」「Nano Banana Pro 徹底解説」など、全12個の資料を無料で配布しています。

「これからAIを学び始めたい」「AIを使って副業収入を得たい」「AIで業務を効率化したい」という方は、ぜひ以下のボタンからセミナーに参加してみてください。

スキルゼロから始められる!

無料AIセミナーに参加する

Codex VSCodeの使い方

Codex VSCodeの基本操作は、主に6つのポイントに分かれます。

  • 画面の見方
  • モードの切り替え
  • 推論精度を調整する
  • モデルを変更する
  • コンテキストやプランモードを利用する
  • スキルの呼び出し方

それぞれの操作を理解しておくと、コード生成・修正・テスト実行までをより効率的に進めやすくなります。それぞれ詳しく見てきましょう。

画面の見方

Codexのパネルは、「履歴エリア」「チャット入力エリア」「設定アイコン」の3つで構成されています。

それぞれの役割を把握しておくと、Codexをスムーズに操作できます。

エリア役割
履歴エリア(上部)過去のチャット履歴を表示します。履歴をクリックすると、以前の会話を再開できます
チャット入力エリア(下部)Codexへの指示を入力する欄です。「+」ボタンからファイル追加などの補助機能も利用できます
設定アイコン(歯車マーク)Reasoning Effort(推論精度)などの詳細設定を変更できます

また、Codexが生成したコード変更はDiff形式で表示されます。

Codexパネルの履歴エリア・チャット入力エリア・設定アイコンを示した画面

変更内容を確認しながらAcceptやUndoを選択できるため、修正内容を管理しやすい点も特徴です。

モードの切り替え

CodexのVSCode拡張機能では、目的に応じて実行権限を切り替えられます

権限ごとに、Codexが実行できる操作範囲が異なるためです。

用途に応じて適切なモードを選択しましょう。

各モードの違いは以下のとおりです。

モードできる内容向いている用途
デフォルト権限操作ごとに確認を行いながら実行初めて利用する場合、安全に試したい場合
自動レビューCodexが変更内容を確認しながら実行ある程度自動化したい場合
フルアクセスファイル編集やコマンド実行を広範囲で許可上級者、自動化を重視したい場合

モードの切り替えは、チャット入力欄の左下にある「デフォルト権限」を選択すると変更できます。

チャット入力欄左下でモードをデフォルト権限から切り替えている画面

初めて利用する場合は、変更内容を確認しながら操作しやすいAgentモードから始めると安心です。

推論精度を調整する

Codexでは、「インテリジェンス(推論量)」を変更することで、AIがどれだけ深く考えて処理するかを調整できます。

推論量を高くすると、複雑なコード解析や設計判断に強くなる一方で、回答速度は遅くなります。

各レベルの使い分けは以下のとおりです。

設定特徴向いている用途
高速・軽量単純なコード補完、軽い質問
速度と精度のバランス型通常の開発タスク全般
深い推論を行う複雑なバグ修正、リファクタリング
非常に高い最大レベルの推論大規模設計、原因調査、難易度の高い解析

インテリジェンス設定は、チャット入力欄右下のモデル設定から変更できます。

チャット入力欄右下からインテリジェンス(推論精度)を設定している画面

単純な修正は「低」、通常の実装は「中」、原因調査や設計判断が必要な作業は「高」を選ぶと、速度と精度のバランスを調整できます。

モデルを変更する

Codexでは、用途に応じて使用するAIモデルを切り替えられます

モデルごとに「得意な作業」「速度」「思考力」が異なるため、タスクに合わせて使い分けることが重要です。

現在よく利用される主なモデルは以下のとおりです。

モデル特徴向いている用途
GPT-5.5現在の標準モデル。精度・推論・コード理解のバランスが非常に高い・普段使い
・複雑な開発
・設計
・リファクタリング
GPT-5.4高い推論能力を持つ旧世代上位モデル・長文解析
・大規模コードベース
・慎重な設計
GPT-5.4-Mini軽量・高速モデル・軽い修正
・補完
・簡単な質問
GPT-5.3-Codexコーディング特化モデル・CLI操作
・自律実行
・長時間タスク
GPT-5.3-Codex-Spark超高速レスポンス特化・試行錯誤
・リアルタイム編集
GPT-5.2旧世代モデル・軽量作業、
・古いワークフロー

モデルの選択は、チャット入力欄右下のモデル名から変更できます。

チャット入力欄右下のモデル選択メニューで使用するAIモデルを変更している画面

初心者の場合は、まず「GPT-5.5 × 中インテリジェンス」で始めると、速度と精度のバランスを取りやすくなります。

以下の記事では、CodexでGPT-5.5を使う方法や特徴、実際の活用事例を紹介しているので、最新モデルを使ってコーディングや業務自動化を効率化したい方はぜひ参考にしてみてください。

関連記事: CodexにGPT-5.5が登場!料金や使い方、GPT-5.4との違いを徹底解説

コンテキストやプランモードを利用する

Codexでは、チャット時に追加機能を有効化することで、より高度なサポートを受けられます

用途に応じてON/OFFを切り替えることで、コード理解やタスク実行の精度を高められる点が特徴です。主な機能は以下のとおりです。

機能できる内容向いている用途
IDEコンテキストを含める開いているファイルやコード内容を参照して回答既存コードを修正・解析したい場合
プランモード実装前に手順や設計を整理して提案いきなり変更せず計画を確認したい場合
目標を目指すゴール達成を意識して複数ステップで処理大きめの開発タスクを進めたい場合
プラグインGoogle Docsやスプレッドシートなどと連携外部サービスと連携したい場合

各機能は、チャット入力欄左下の「+」ボタンから表示できます。

チャット入力欄左下の+ボタンからIDEコンテキストとプランモードを有効化している画面

とくに初めて利用する場合は、「IDEコンテキストを含める」と「プランモード」を有効にすると、変更前に実装方針を確認しながら進めやすくなります。

スキルの呼び出し方

Codexには、「Skills(スキル)」という繰り返し使う作業指示を管理できる機能があります。

スキルを登録しておくと、毎回同じ指示を書かなくても、Codexが定義済みのルールや作業内容を参照しながら処理を進められます。

また、必要なタイミングだけコンテキストへ読み込まれる仕組みのため、トークン消費を抑えながら安定した生成品質を維持しやすい点も特徴です。

スキルを設定する流れは以下のとおりです。

  1. プロジェクト直下に .agents/skills/ フォルダを作成する
  2. スキルごとにサブフォルダを作成し、その中に SKILL.md を配置する
  3. SKILL.mdname(スキル名)と description(スキルの説明)を記述する
CodexのスキルフォルダにSKILL.mdファイルを配置した画面

Codex起動時に「Read SKILL.md」と表示されれば、スキルが正常に読み込まれています。

一度登録しておくと、コーディング規約やレビュー手順などを毎回入力する手間を減らしながら、同じ品質で作業を進めやすくなります。

Codex VSCodeを使うときの注意点

Codex VSCodeを利用する際は、事前に把握しておきたい注意点があります。主な注意点は以下の2つです。

  • 出力されたコードは必ず確認してから使う
  • プランによって利用できる上限が異なる

これらを理解せずに使い始めると、予期しないエラーや不要なコード変更につながる可能性があります。それぞれ詳しく解説します。

出力されたコードは必ず確認してから使う

Codexが生成したコードは、そのまま適用せず、自分で内容を確認した上で利用する必要があります。

AI生成コードには、バグや不要な変更、セキュリティ上の問題が含まれる可能性があります。

とくに、Diffビューでは以下のポイントを確認しておくと安心です。

  • 変更されたファイルが意図したものか確認する
  • 追加されたコードにセキュリティ上の問題がないか確認する
  • 削除されたコードが本当に不要か確認する

コードレビューを挟みながら利用すると、AIによる開発効率化とコード品質を両立しやすくなります。

プランによって利用できる上限が異なる

Codexは、契約しているChatGPTプランによって利用できる回数や処理量が異なります

長時間のコード生成や複数タスクを並行して実行すると、プランによっては短時間で利用上限へ達する場合があります。

そのため、自分の利用頻度や開発規模に合ったプラン選びが重要です。

各プランの特徴は以下のとおりです。

プラン月額料金Codexの利用枠向いている人
Free無料ごく少量まず試したい人
Go1,400円Plusより少なめたまに使う人
Plus3,000円標準的個人開発・副業
Pro16,800円Plusの約5倍本業エンジニア
Business3,050円〜 / 人基本枠+拡張可能チーム利用
Enterprise要問い合わせ柔軟対応大企業・教育機関

まずはFreeプランで試して、必要に応じて有料プランを検討してみてください。

以下の記事では、Codexの料金プランや無料で使う方法、用途別のおすすめプランを紹介しているので、自分に合ったプランを選んでCodexを使いたい方はぜひ参考にしてみてください。

関連記事: Codexの料金は?プラン別の費用や無料で使う方法、API料金も徹底解説

CodexをVSCodeで使うときによくある質問

Codex VSCodeに関する質問は以下の2つです。

  • Codex CLIとVSCode拡張機能の違いは何ですか?
  • CursorやGitHub Copilotとの違いは何ですか?

質問に対する回答を確認して、Codex VSCode導入の参考にしてみてください。

Codex CLIとVSCode拡張機能の違いは何ですか?

Codex CLIとVSCode拡張機能は、同じCodexエンジンを使いながらも操作環境が異なります

CLIはターミナル上で動作し、VSCode拡張機能はエディタに統合された形で使えるためです。

2つの違いは以下のとおりです。

Codex CLIVSCode拡張機能
操作環境ターミナルVSCodeのサイドパネル
ファイル参照カレントディレクトリワークスペース全体
変更の確認テキスト出力DiffビューでAccept/Reject
向いている人ターミナル中心の開発者VSCodeユーザー

すでにVSCodeを使っている場合はVSCode拡張機能が、ターミナル中心の開発スタイルにはCLIが向いています。

CursorやGitHub Copilotとの違いは何ですか?

3つのツールは役割が大きく異なります

ツールによって設計思想とアーキテクチャが根本的に異なるためです。

ツール種別主な特徴
Codex(VSCode拡張)エージェント型指示を渡すとコード生成・実行・テストまで自律的に完結させる
CursorスタンドアロンIDEAI統合を中心に設計されたVSCodeフォーク。補完・チャット・編集を一体的に提供
GitHub Copilotアシスタント型コーディング中にリアルタイムでコード候補を提示する補完ツール

すでにVSCodeを使っている場合は、CodexをAIエージェントとして活用しながら、細かいコード補完にはGitHub Copilotを組み合わせると効果的です。

VSCodeでCodexを利用して開発効率を上げよう!

CodexをVSCodeで使えば、コード生成・バグ修正・テスト作成を日本語の指示だけで進められるため、開発作業を効率化できます。

VSCode拡張機能として導入すると、エディタ上でコードを確認しながらAIに作業を依頼できるため、ファイルの移動やコマンド操作の手間を減らせます。

また、Agentモード・Askモードなどを使い分けることで、コードを直接修正したい場面と、まず相談したい場面を分けて活用できます。

まずはインストール手順に沿ってCodexをVSCodeに導入し、Agentモードで動作を確かめてみてください。

SHIFT AIでは、ChatGPTやGeminiなどの生成AIを活用して、副業で収入を得たり、キャリアアップで年収を高めたりするノウハウをお伝えする無料セミナーを開催しています。

セミナーでは、主に以下の内容を学習できます。

  • AIを使った副業の始め方・収入を得るまでのロードマップ
  • おすすめの副業案件と獲得方法
  • AIスキルを高めて昇進・転職などに役立てる方法
  • 実際に成果を出しているロールモデルの紹介
  • これから使うべきおすすめのAIツール

無料セミナーは、AI初心者〜中級者の方を対象としています。

「これからAIを学習したいけど、何から始めていいのか分からない」「AIの独学に限界を感じてきた」という方にとくにおすすめです。

また、参加者限定で、「初心者が使うべきAIツール20選」や「AI副業案件集」「ChatGPTの教科書」など全12個の資料を無料で配布しています。

完全無料で参加できるため、ご興味のある方は、ぜひセミナーに申し込んでみてください。

スキルゼロから始められる!

無料AIセミナーに参加する

目次

執筆者

西啓汰

フリーランスのSEO/AIライターとして活動。

生成AIツールを実際に検証し、その知見をもとに実務で活用できる情報発信を行っている。

AI関連の最新動向や活用ノウハウを、初心者にもわかりやすく伝えるコンテンツ制作が強み。

趣味は野球観戦とラジオ聴取。