Cursor Codex拡張でモデルが出ない時の確認と導入手順

Cursor Codex拡張とは何か

Cursor Codex拡張は、Cursorの画面にCodexの会話と変更確認を置くためのIDE拡張です。OpenAI公式のCodex IDE拡張の案内は、エディタで開いているファイルや選択範囲を会話へ追加し、コードの説明、編集、レビューを同じ画面で進める使い方を示しています。ファイルを別の画面へ貼り付ける量を減らし、変更前後を見比べながら依頼できることが中心的な価値です。

OpenAIは2025年9月のCodexアップデートで、IDE拡張がVS Code、Cursor、その他のVS Code派生エディタに対応すると説明しました。2026年8月12日に確認したIDE公式ページでも、対応先としてVisual Studio Code、Cursor、Windsurfが並びます。したがって、CursorでCodexを使う方法は、ターミナルだけを使う方法に限られません。

IDE拡張とCodex CLIは同じ製品群でも入口が違う

IDE拡張では、開いているファイル、選択したコード、会話の履歴をそのまま依頼の材料にできます。変更が提示されたら、エディタの差分を読み、残す変更と戻す変更を判断します。一方、Codex CLIはプロジェクトのルートをターミナルから扱う入口で、シェル操作や複数ファイルの調査を中心に組み立てます。Cursorの画面でCodex CLIを使う記事と、サイドバーの拡張を使う記事は、似ていても準備と確認場所が異なります。

拡張を入れたのにターミナルへコマンドを入力し続けているなら、使っている入口が違います。反対に、CLIが使えるからといって拡張のサイドバーが表示されるとは限りません。まず「エディタ内のCodexを使うのか」「統合ターミナルのCodexを使うのか」を決めると、モデルやサインインの確認を必要な範囲に絞れます。

2026年8月12日に確認した更新点

今回の確認で重要なのは、OpenAIの現行IDEページがCursorを単なるVS Code互換先としてではなく、セットアップ手順の選択肢として明記していることです。ページには、拡張を有効にする、Codexアイコンを開く、最初の会話を始めるという順序が示され、アイコンが見えない場合はコマンドパレットからCodexのサイドバーを開く方法も案内されています。古い説明だけを見て、Cursorでは使えないと判断する必要はありません。

ただし、Cursor内蔵エージェントがOpenAIのCodexモデルを扱う話と、OpenAIのCodex IDE拡張をCursorへ入れる話は別です。Cursor公式のCodexモデル対応に関する記事は、Cursor側のエージェントがCodexモデルに合わせてツールや指示の扱いを調整した経緯を説明しています。製品名と入口が似ているため、どの画面で何を選んだかを記録することが、今の導入では特に重要です。

導入前にそろえる条件

導入の失敗は、拡張ファイルの問題よりも、対応先、アカウント、利用枠、モデル設定の取り違えから起きます。CursorはVS Codeを土台にしていますが、すべての派生エディタが同じ版番号、同じ拡張配布方式、同じ権限の扱いになるとは限りません。先に自分が使うCursorの版とOS、開きたいプロジェクト、Codexへ接続するアカウントを控えておくと、表示されないときの比較材料になります。

OpenAIのCodex利用ヘルプでは、ChatGPTアカウントでサインインしてCodexを使う流れと、CLIやIDE拡張の既定モデルが版や設定に依存することが説明されています。つまり、拡張をインストールした時点で、モデル候補や利用枠がすべて確定するわけではありません。条件を三つに分けて確認するのが安全です。

対応エディタと配布元を確認する

OpenAI公式ページでは、VS Codeと互換エディタはCodex拡張を使うと案内され、Cursorも選択肢に含まれています。配布元を確かめるときは、Visual Studio MarketplaceのCodex拡張ページで提供元がOpenAIであることと、拡張名を確認します。検索結果の似た名前だけで判断せず、Cursor側の拡張詳細と公式ページを照合してください。

Cursorの版が古い場合や、拡張の読み込み方式が変わった場合は、アイコンの場所や設定名が画面例と違うことがあります。その場合は無理に古い手順を再現せず、Cursorを更新した日、拡張の版、表示された警告を記録します。版をそろえた後に同じプロジェクトで再確認すれば、環境差と設定差を切り分けやすくなります。

サインインと利用枠を確認する

Codex IDE拡張をChatGPTの契約で使う場合は、拡張の案内に従ってChatGPTアカウントへサインインします。OpenAIヘルプは、FreeやGoを含むChatGPTの各プランでCodexを利用できる一方、利用上限はプランによって異なると説明しています。画面にCodexが出るかどうかと、長い作業をどれだけ使えるかは別の確認項目です。

会社や学校のワークスペースでは、個人の契約だけでなく管理者設定も影響します。拡張が表示されても、利用できるモデル、利用枠、変更の範囲が個人設定と異なる場合があります。まず個人アカウントか組織アカウントかを確認し、必要なら管理担当者に「拡張の表示」「モデル候補」「利用上限」を分けて尋ねると話が早くなります。

公式のモデル名と手元の表示を分ける

Codexのモデル紹介ページに名前が載っていても、Cursorの拡張に同じ名前が出るとは限りません。OpenAIヘルプが示すように、既定モデルはCLIまたはIDE拡張の版、設定、利用できる範囲によって変わります。確認するときは、公式ページのモデル名、拡張の選択欄に見える名前、実際に実行した作業の三つを別々に記録してください。

特に「Custom」「Auto」のような選択肢は、特定モデルを固定した結果とは分けて扱います。モデル名が表示されない場合も、提供停止と断定する前に、版番号、アカウント、管理設定を見直します。日付を添えて記録しておけば、後日の更新で表示が変わったときにも再確認できます。

Cursorへインストールして初回起動する手順

Cursorでの導入は、プロジェクトを開く、拡張を入れる、サインインする、サイドバーを開く、短い依頼で動作を見るという順序にすると迷いにくくなります。最初から大きな改修を依頼すると、拡張の問題なのか、モデルの応答なのか、プロジェクトの設定なのかが分からなくなります。OpenAI公式のIDEクイックスタートにある画面の順序も参考にしながら、小さな変更で接続を確かめます。

1. Cursorを起動し、対象リポジトリのルートに近いフォルダを開きます。単一ファイルだけを開いた状態より、プロジェクト全体の構成を確認できる状態の方が、文脈の渡し方を試しやすくなります。
2. 拡張一覧でCodexを検索し、OpenAIの拡張ページと名前を照合してインストールします。すでに入っている場合は、拡張の版と更新日を控えてから有効になっているかを確認します。
3. Cursorを再読み込みし、Codexの案内からChatGPTアカウントへサインインします。別のアカウントを使っていると、利用枠や表示モデルが想定と違うことがあるため、アカウント名を確認します。
4. サイドバーのCodexアイコンを開きます。アイコンが見えない場合はコマンドパレットを開き、Codex: Open Codex Sidebarを実行します。
5. ファイルを一つ開き、選択範囲を指定して「この処理の役割を説明し、変更はまだ加えないでください」のような短い依頼を送ります。回答が確認できたら、次に小さな修正を依頼し、差分と戻す操作を確認します。

Step 1: プロジェクトの位置を固定する

最初の確認では、Cursorで開いたフォルダと、実際に変更してよいプロジェクトが一致しているかを見ます。別の階層を開いていると、Codexが参照するファイルが少なくなったり、想定外の場所を対象にしたりします。ルートにある設定、テスト、READMEを軽く確認し、作業対象を一つに固定してから会話を始めると、表示の問題と文脈の問題を混同しません。

Step 2: 小さな依頼で差分の読み方を覚える

初回は、コメントの説明、テスト名の提案、表示文言の一箇所変更など、結果を短時間で読める内容を選びます。Codexの返答が来たら、変更ファイル、追加行、削除行、確認結果の順に見ます。これでサイドバーの表示、選択範囲の送信、差分の確認という拡張固有の機能を一度に確かめられます。

モデルが出ない・拡張が見えないときの切り分け

「CursorにCodexを入れたのにアイコンがない」「拡張はあるのにモデル欄が空」「CLIでは選べるモデルが拡張にはない」という現象は、同じ原因とは限りません。拡張の存在、サイドバーの表示、サインイン、利用枠、モデル設定、版番号の順番で分けて見ると、やみくもな再インストールを避けられます。OpenAIヘルプも、版と設定によって既定モデルが変わると説明しているため、モデル名だけを手掛かりにしないことが大切です。

Step 1: アイコンがないときはコマンドパレットを使う

まず拡張一覧でCodexが有効かを確認し、次にCursorを再読み込みします。それでもアイコンが見えなければ、コマンドパレットでCodex: Open Codex Sidebarを実行します。公式手順にあるコマンドが動くなら、拡張そのものではなく、サイドバーの配置や表示設定の問題である可能性が高まります。コマンドが見つからない場合は、拡張名、提供元、版番号を再確認します。

Step 2: 拡張のモデルとCursor内蔵モデルを混同しない

Cursor内蔵エージェントのモデル選択欄にGPTやCodexの名前が見えても、Codex拡張のモデル候補が同じになるとは限りません。前者はCursorのサービス入口、後者はOpenAIのCodex入口です。比較するときは、画面の見出し、アイコン、サインイン先、表示されたモデル名を一緒に記録し、「Cursorで選べた」だけでCodex拡張でも使えると判断しないようにします。

Cursor公式が説明するCodexモデル向けの調整は、Cursor側のエージェントに関する情報です。OpenAI公式のIDE拡張ページにある対応先と、Cursor内蔵機能のモデル一覧は別の出典として読む必要があります。この区別を付けるだけで、モデルの提供状況を誤って断定する場面が減ります。

Step 3: サインイン・プラン・管理設定を確認する

拡張は表示されるのに会話が始まらない場合、ChatGPTアカウントが意図したものかを確認します。Free、Go、Plus、Proなどの表示や組織への所属が違えば、利用枠や選べるモデルが変わり得ます。会社のワークスペースでは、個人アカウントでサインインしているつもりでも、管理側の利用条件が優先される場合があります。アカウント、プラン、組織の三項目をスクリーンショットではなく文字で控えると、問い合わせにも使いやすくなります。

Step 4: 版番号と再読み込みをそろえる

Cursor、Codex拡張、必要ならCLIの版番号を別々に控えます。拡張の更新後だけ症状が出た場合は、更新日時、再読み込みの有無、エラー表示を記録し、同じプロジェクトで再現するかを確かめます。拡張の版を戻す判断は、公式の配布ページやサポート情報を確認してから行い、出所が不明なファイルを追加しないことが重要です。版番号を揃えてから一度だけ再読み込みすると、変化を評価しやすくなります。

Step 5: WindowsではCLIを別の入口として確認する

WindowsのCursorで拡張の表示や動作が安定しない場合、OpenAIヘルプが案内する「他のIDEでは統合ターミナルからCodex CLIを使う」方法を代替入口として試せます。これは拡張の不具合を直す手順ではなく、エディタを閉じずにCodexへ接続できるかを確かめる切り分けです。CLIで動き、拡張だけが動かないなら、プロジェクトやアカウントよりも拡張側の版と表示設定を重点的に確認できます。

Cursor内蔵エージェントとCodex拡張の違い

Cursorにはもともとコードの補完、会話、編集を行う機能があり、そこへOpenAIのCodex拡張を追加できます。二つを同じものとして比べると、どの契約を使っているか、どのモデルを選んだか、どこへファイルを送ったかが曖昧になります。比較の軸を入口、文脈、モデル、料金、変更確認に分ければ、両方を同じプロジェクトで使う場合も判断しやすくなります。

この表の違いは、どちらが優れているかを決めるものではありません。Cursorの画面に密着した補完や短い編集なら内蔵機能が自然で、OpenAIのCodexとして開いているファイルを指定し、差分や作業結果を確認したいなら拡張が自然です。依頼の入口を変えたら、同じモデル名だと思い込まず、利用条件も改めて確認します。

短い編集は選択範囲から始める

変数名の整理、エラーメッセージの言い換え、テスト名の改善のような小さな作業では、修正したい範囲を選んでCodex拡張へ渡します。「この範囲だけ」「動作は変えない」「確認するテストはこれ」と書くと、変更の境界が読みやすくなります。結果は必ず差分で確認し、依頼にないファイルが変わっていないかを見てから残します。

複数ファイルの調査は終わりの条件を置く

原因調査や移行のように対象が広い作業では、最初に調査してよい範囲、変更してよい範囲、確認する結果を伝えます。たとえば「まず関連ファイルを列挙し、原因候補を三つまで説明し、変更は承認後に行う」と書けば、調査と編集を分けられます。Codexの回答が長くなったときも、どの条件を満たせば一度止めるかが明確になります。

料金・データ・権限を先に読む

Cursorの内蔵機能とCodex IDE拡張は、同じウィンドウで使えても料金やデータの扱いが一つになるわけではありません。CodexをChatGPTアカウントで使う場合はOpenAI側の契約と利用枠、Cursor内蔵機能を使う場合はCursor側の契約とモデル条件を確認します。OpenAIの利用ヘルプは、プランごとに利用上限が異なること、企業向けでは管理設定が関係することを案内しています。

モデル名が同じでも、請求先、上限、応答速度、選択できる推論の強さが同じとは限りません。導入前に「どの入口で」「どのアカウントを使い」「どの画面のモデルを選んだか」をメモし、月額料金だけで結果を比べないことが大切です。料金の数字は変更される可能性があるため、記事や社内の案内には確認日と公式ページのURLを添えます。

料金は同じ画面でも別に考える

Cursorの料金ページはCursor内蔵機能のプランと利用枠を説明し、Codexの利用ヘルプはChatGPT側の契約と利用条件を説明します。CursorにCodex拡張を入れたからといって、Codexの利用分がCursorのプランへ合算されると決めつけないでください。実際に表示されるアカウント名、契約名、利用量の画面をそれぞれ確認し、必要ならCursorの料金案内とOpenAIのヘルプを分けて参照します。

データとファイルの範囲を確認する

OpenAIヘルプは、Codexへ渡される内容に関するデータ設定がChatGPTの管理項目と関係することを説明しています。Cursor側にもプライバシーやコードベースの扱いに関する設定があります。拡張を試す前に、開いているファイル、選択範囲、会話に添付した内容を確認し、不要な設定ファイルや個人情報を開いたまま送らないようにします。プロジェクトごとに共有してよい範囲を決めておけば、機能確認と情報管理を両立できます。

変更の承認と差分確認を省略しない

OpenAI公式のCodexアップデートは、IDE拡張でローカルの変更をプレビューして編集できることと、作業の確認を人が行うことを説明しています。承認の表示が出たら、対象ファイル、実行内容、変更の目的を読みます。依頼した範囲を超える変更、テスト結果が書かれていない変更、元に戻す方法が分からない変更は、その場で受け入れず、追加説明を求めるか差し戻します。

導入後に残す確認表

一度動いたからといって、次の更新後も同じ条件で使えるとは限りません。導入日、Cursorの版、Codex拡張の版、サインイン先、表示モデル、実施した小さな作業、差分確認の結果を短く残しておくと、問題が再発したときに比較できます。確認は長い改修で行わず、同じ小さなファイルと同じ依頼文を使うと、環境の差を見つけやすくなります。

1. Cursorの版番号とOSを記録し、対象プロジェクトを同じフォルダから開く。
2. Codex拡張の提供元、版番号、サイドバーの表示状態を記録する。
3. ChatGPTアカウント、プラン、組織設定の有無と、拡張に表示されたモデル名を記録する。
4. 開いているファイルまたは選択範囲を一つだけ添えて、説明依頼と小さな修正依頼を順に試す。
5. 変更されたファイル、テストや確認の結果、戻した変更の有無、再現した警告を記録する。

この確認表は、問題が起きたときだけでなく、CursorやCodexの版を更新した直後にも使えます。以前と同じ入力で結果が変わった場合、モデル、拡張、Cursor、アカウント条件のどれが変わったかを一つずつ比較できます。記録を残す目的は更新を追いかけることではなく、使える条件を自分の環境で再現することです。

まとめ

Cursor Codex拡張は、Cursorの統合ターミナルからCodex CLIを呼ぶ方法とは別の、エディタ内のCodex入口です。OpenAI公式のIDE案内はCursorを対応先に含め、開いているファイルや選択範囲を会話へ渡し、サイドバーで差分を確認する導入手順を示しています。まず拡張を正しい配布元から入れ、ChatGPTアカウントでサインインし、短い依頼で表示と差分を確かめます。

モデルが出ないときは、モデルページの名前だけで利用可否を判断せず、拡張の版、Cursorの版、サインイン、プラン、管理設定、画面に出たモデル名の順番で確認します。Cursor内蔵エージェントのモデル欄とCodex拡張のモデル欄も分けて読み、料金や利用枠を同じものとして扱わないことが重要です。

Windowsで拡張に問題が残る場合は、OpenAIヘルプが案内する統合ターミナルのCodex CLIを別の入口として試すと、プロジェクトやアカウント側の問題か、拡張側の問題かを切り分けられます。最後は小さな差分、確認結果、元に戻す方法を人が読む。この基準を守れば、CursorとCodexを同じ画面で使いながら、導入後の判断も安定します。

出典

• Codex IDE拡張（OpenAI公式）
• Codexアップデート（OpenAI公式）
• ChatGPTプランでCodexを使う方法（OpenAIヘルプ）
• Codex拡張（Visual Studio Marketplace）
• Codexモデル対応に関するCursor公式記事
• Cursor料金案内（Cursor公式）