Codex「could not start」の対処｜VS Code拡張が開かない時の確認順

01「Codex could not start」は、画面の起動に失敗した表示

この記事が扱うのは、VS CodeのCodex拡張を開いたときに、次の文が出るケースです。

Codex could not start
The extension could not start its user interface.

意味は「Codexを起動できませんでした。拡張機能のユーザーインターフェースを起動できませんでした」です。アイコンがあるのに会話画面が出ない場合もあります。この文だけで、PCの故障・契約不足・アカウントの停止と判断することはできません。

公式の操作：VS Code Extension Marketplace。ユーザー報告：Issue #56691、#57344、#56992。利用者の報告は個別環境での観測です。Issue #56655の11月11日の担当者コメントには修正版と更新後の再読み込みが案内されています。

Xにも同じ画面の報告があります

次の投稿は利用者の体験です。端末や更新チャンネルが異なるため、原因の確定や全環境での復旧保証には使いません。埋め込みが表示されない場合は、投稿リンクから確認できます。

投稿の要約：「Codex could not start」「The extension could not start its user interface.」というエラーの報告。

@osp_ojisan の元投稿

この投稿への返信にある回復例は 26.51007.21434 です。プレリリース系列の番号で、安定版の 26.1007.21434 と混同しないでください。

投稿の要約：Ubuntu環境でCodexのUI起動に失敗し、前の版で暫定運用したという報告。

@tnkmasayuki の元投稿

後者はUbuntu 26.04、VS Code 1.143.1、Codex 26.1021.22027の報告です。投稿中の「VS Code 1.143.2ならよいかもしれない」という見通しは未確認であり、本記事の推奨手順にはしていません。

02版を記録して修正版へ更新し、再読み込みする

注意履歴や認証ファイルを先に消さないでください。.codex フォルダ全体の削除、認証の初期化、セキュリティ機能の無効化は、この確認手順には含めません。会社・学校の管理端末では、版変更前に管理者へ確認します。

拡張の版と、VS Code本体の版を分けて控える

1. 編集中のファイルを保存し、動いているCodexの作業があれば区切りをつけます。
2. VS Codeの拡張機能を開き、@installed codex で探します。発行元がOpenAI、拡張IDが openai.chatgpt であることを確認します。
3. 表示される拡張のバージョンを控えます。プレリリースを使っている場合は、その表示も記録します。VS Code本体やCodex CLIの番号とは混ぜません。
4. VS Code本体の版、OS、ローカル／WSL／Remote-SSHなどの作業場所も控えます。複数のプロファイルや接続先がある場合は、問題が出るウィンドウで確認してください。

アイコン自体が見当たらない場合は、コマンドパレットから Codex: Open Codex Sidebar を実行します。コマンドもない場合の導入・有効化の確認は、Codex IDE拡張機能の使い方へ進んでください。本記事では、その初期設定を繰り返さず、エラーが出る場合を扱います。

根拠：Codex IDE extension、OpenAIのCodex拡張、拡張の検索・管理。

修正版へ更新し、問題のウィンドウを再読み込みする

1. 拡張機能一覧でOpenAIのCodexを開き、現在のバージョンと安定版／プレリリースを確認します。
2. 利用中のチャンネルで更新が表示される場合は「Update」を選びます。11月11日に担当者が案内した修正版は、安定版 26.1106.51428、プレリリース版 26.51106.51428 です。後継版が提供されている場合は、その案内も確認してください。管理端末では所属先の方針に従います。
3. 更新後、エラーが出たVS Codeウィンドウで表示される再読み込みの案内に従います。必要に応じて、コマンドパレットから Developer: Reload Window を実行します。
4. Codexの画面、既存の会話、秘密情報を含まない短い依頼への応答を分けて確認します。再読み込み前に、必ず作業内容を保存してください。

修正版の公開は、今回確認したリポジトリの担当者コメントに基づく情報です。更新後も同じエラーが続く利用者の報告があるため、表示される版と自分の環境での結果を確認します。更新が表示されない場合は拡張の更新確認を行い、管理端末では管理者に相談してください。

根拠：Codex公開リポジトリ：担当者による修正版と再読み込みの案内、VS Code：拡張機能を手動更新する。

更新後も開かない場合：パネルの移動を試す

Codexのタブを右クリックし、Move to → Primary Side Bar または Panel が出る場合は、移動して画面が開くか確認します。元の位置を覚えておき、改善しなければ戻します。見当たらないメニューを無理に探して、ほかの設定まで変更する必要はありません。

VS Codeがビューの移動を提供していることは公式に確認できます。一方、この移動でCodexが起動したという結果は利用者の報告です。改善したら、すぐに版を変更せず、会話表示と再起動後の状態を確かめます。

操作の一般仕様：VS Code Custom Layout。回避結果：Issue #56682の2026年10月26日のコメント（ユーザー報告。原因を推定する記述は公式見解ではありません）。

03直らなければ、前の版を一時的に試す

修正版への更新・再読み込みやパネル移動を試しても改善しない場合、拡張だけを以前の版へ戻す方法が一時的な候補です。修正版を含まない古い版になるため、管理者の方針を確認し、ほかの対応と比較して判断します。報告例の 26.1007.21434 を、すべての人の推奨版や恒久的な安全版とは扱いません。

注意旧版には、11月11日に案内された起動問題の修正を含め、その後の修正や機能が入りません。必要なファイルを保存し、現在の版と設定を記録してから試します。重要な会話が旧版で表示されない場合も、消失と決めつけて初期化せず、追加操作を止めて確認してください。

画面から「Install Another Version」を使う

1. 問題が出るVS Codeウィンドウの拡張機能一覧で、OpenAIのCodexを開きます。
2. 拡張を右クリックし、Install Another Version を選びます。日本語の表示名は版や言語設定で異なる場合があります。
3. 一覧に 26.1007.21434 がある場合に選びます。見つからなければ、第三者サイトのVSIXを探して入れるのではなく、公式の提供状況を確認します。
4. VS Codeに表示される再起動・再読み込みの案内に従い、拡張の版が変更されたか確認します。
5. Codexの画面、既存の会話、入力欄を確認します。必要なら秘密情報を含まない短い依頼で応答を確認し、ファイル変更は指示しません。

画面が開くこと、以前の会話を読めること、新しい依頼に応答することは別々の確認です。画面だけ戻った段階で、すべて復旧したと判断しないでください。

公式の版指定操作：Install Another Version。回復例と履歴表示の留意点：Issue #57344（ユーザー報告）。

ターミナルに慣れている場合の代替手順

VS Codeの code コマンドが使える環境では、次のように版を指定できます。これはCodex CLIの更新コマンドではありません。別のプロファイルや接続先を使っている場合は、画面から対象を確認する方法を優先してください。

code --install-extension [email protected]

code が見つからない場合や、変更を拒否された場合は、むやみに管理者権限を足さず、画面の操作へ戻ります。確認を省く --force は、この例には付けていません。

根拠：VS Code Command Line Interface（拡張IDへの @version 指定）。

プレリリース版の番号を取り違えない

26.51021.22027 でも起動失敗の報告があります。安定版の 26.1021.22027 と同じ文字列ではありません。手元がプレリリースなら、版とチャンネルを両方控えてください。数字を手で削って別の版を推測したり、プレリリースへ切り替えれば直ると決めたりしないことが大切です。

ユーザー報告：Issue #56655。公式の修正版案内ではありません。

04Codexだけの自動更新を確認し、戻す条件を決める

旧版で作業できるようになっても、自動更新で新しい版へ更新されると、環境によっては動作が変わる可能性があります。一時的に旧版を維持する必要がある場合だけ、拡張一覧のCodexを右クリック → Auto Updateの状態を確認し、Codex個別の自動更新をオフにします。すべての拡張の更新を止める必要はありません。

管理者によって更新が制御されている場合は、設定を回避せず相談してください。自動更新を止めたことと、確認日をメモに残しておきます。

新しい版が出たら、同じ条件で確認する

1. 公式の変更履歴や関連Issueを確認します。11月11日に案内された修正版や後継版を、利用中のチャンネルで確認してください。
2. 作業を保存し、いま動いている版を控えます。Show Extension Updatesで更新の有無を確認し、CodexのUpdateから更新します。
3. 同じプロファイル・接続先で、画面の起動、会話の表示、短い依頼への応答を確認します。通常使う複数ウィンドウがあれば、その条件も確認します。
4. 問題なく使えることを確認できたら、CodexのAuto Updateをオンへ戻します。再発したら結果を記録し、戻せる版の提供状況と管理方針を確認して判断します。

画面の復旧だけを確かめた場合は「UI表示のみ確認」と残します。再起動後や別ウィンドウで未確認の状態を、完全復旧と混ぜないようにします。

公式の更新設定・手動更新：Extension auto-update／Update an extension manually。更新情報：ChatGPT & Codex changelog。

05直らないときは、変更を増やさず報告する

同じ版の再インストールを繰り返すより、どの操作で何が変わったかを残します。旧版に戻しても別ウィンドウでは再発するという報告もあり、版変更だけで原因を特定できるわけではありません。

複数の場所で同時に使えないときは、発生時刻とOpenAI Statusを照合します。Statusに障害がないことだけで、手元の問題を否定しないでください。

相談に使える記録を残す

公開Issueへ報告する場合、ログからメールアドレス、APIキー、トークン、個人のパス、機密コードを取り除きます。ログ全体や auth.json をそのまま貼らないでください。不明な項目は「不明」で構いません。

症状：Codex could not start / The extension could not start its user interface.
発生日時・タイムゾーン：
OS・CPU：
VS Codeのバージョン：
Codex拡張ID・バージョン：
安定版／プレリリース：
使用場所：ローカル／WSL／Remote-SSH／その他
プロファイル・開いていたウィンドウ数：
直前の変化：更新後／設定変更後／不明
パネル移動の結果：未実施／改善／変化なし
版を戻した場合の変更前→変更後：
確認結果：画面／既存の会話／新しい依頼／再起動後
自動更新：オン／一時オフ／管理者管理／不明
秘密情報を除いたエラーの要点：
次に更新を確認する日：
未実施・未確認の項目：

このボタンはコピーだけで、問い合わせを送信しません。管理端末なら管理者へ、アカウントの個別相談はOpenAI Help Centerへ。公開の不具合報告を使う場合は、関連Issueの現在の状況と案内を読んでください。

急ぎの作業は、使える環境へ分ける

すでに利用できるCodex CLIやデスクトップ環境があり、必要なファイルにアクセスできるなら代替候補です。ただし、拡張の会話・未保存ファイルが自動的に移るわけではありません。同じファイルを複数のCodexから同時編集させず、作業を止めて変更内容を確認してから切り替えます。

症状・再発の報告：Issue #56682（ユーザー報告）。製品ごとの入口：Codex IDE extension。代替環境で今回の症状が回避できることを実機検証したものではありません。

06よくある質問