VS Codeで「Codex could not start」と出るときはOpenAI.chatgptをダウングレードする

OpenAI.chatgpt 26.1007.21434をインストールして固定し、Codexサイドバーを再び読み込めるようにして、VS Codeの「Codex could not start」とservice workerエラーを解消します。

Codex Startup Fixというタイトルが入ったゴム印の線画

TL;DR: Codex の VS Code エラー Codex could not start では、最も多く報告されている回避策は、26.1021.22027 ではなく OpenAI.chatgpt@26.1007.21434 をインストールし、その拡張機能の自動更新を無効にすることです。このガイドは openai/codex#56691 のユーザー報告と共有ログに基づくもので、メンテナーが確認した根本原因に基づくものではありません。

対象: Codex VS Code 拡張機能 OpenAI.chatgpt。特に Windows の VS Code 1.143.1 上の 26.1021.22027。Linux でも類似のユーザー報告があります。最終確認日: 2026-11-03。

表示される内容参照先
Codex could not start / The extension could not start its user interface.Codex could not start
Could not register service worker / renderer_ready_timeoutCould not register service worker

Codex could not start

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

Codex サイドバーの webview の初期化に失敗すると、VS Code で Codex が Codex could not start を表示します。バージョン固有のきっかけとして可能性が高いのは、OpenAI.chatgpt 拡張機能 26.1021.22027 です。複数のユーザーが、同じ VS Code 環境で 26.1007.21434 にダウングレードするとサイドバーが復旧したと報告しているためです(openai/codex#56691 で報告)。VS Code の Activity Bar に Codex アイコンは表示されるものの、Codex サイドバーを選ぶと Codex UI ではなくエラーパネルが開く場合は、このケースに該当します。

  1. VS Code のすべてのウィンドウを閉じます。

  2. code コマンドを実行できるターミナルから、動作したと報告されている Codex 拡張機能のバージョンをインストールします。

    code --install-extension OpenAI.chatgpt@26.1007.21434 --force
  3. code コマンドが使えない場合は、ユーザーが報告している VS Code UI の手順を使います。拡張機能を開き、Codex または OpenAI.chatgpt を探し、歯車アイコンを選択して、特定のバージョンをインストール…を選び、26.1007.21434 を選択します(openai/codex#56691 で報告された回避策)。

  4. VS Code がすぐに拡張機能を 26.1021.22027 に戻さないように、Codex 拡張機能の自動更新を無効にします。拡張機能を開き、Codex または OpenAI.chatgpt を探し、歯車アイコンを選択して、その拡張機能に対する拡張機能単位の自動更新無効化オプションを選びます(openai/codex#56691 で報告された回避策)。

  5. VS Code を再起動します。

  6. Activity Bar から Codex サイドバーを開きます。

動作確認の方法: Codex could not start パネルではなく、Codex サイドバーの通常のインターフェイスが読み込まれるはずです。ユーザー報告では、同じ Windows と Linux のインストール環境で 26.1021.22027 では失敗し、26.1007.21434 をインストールした後は正常に読み込まれました(openai/codex#56691 で報告)。

それでも失敗する場合: インストールコマンドを再実行し、インストール済みの拡張機能バージョンが 26.1007.21434 であることを確認してください。報告された回避策の 1 つでは、VS Code が 26.1021.22027 に戻るのを止めるために、特に自動更新を無効化していました(openai/codex#56691 で報告)。すでにバージョンが固定されているのにサイドバーがまだ失敗する場合は、OS、VS Code のバージョン、Codex 拡張機能のバージョン、renderer_ready_timeout を含む Codex の出力行を収集し、その詳細を既存の GitHub issue または新しい openai/codex issue に追加してください。サイドバーが再び読み込まれた後は、次の設定手順として Codex model-provider setup guide を使います。

Could not register service worker

Error loading webview provided by 'openai.chatgpt':
Could not register service worker:
InvalidStateError: Failed to register a ServiceWorker:
The document is in an invalid state.

同じ VS Code サイドバー起動失敗の中で、Codex が Could not register service worker を表示することがあります。ユーザーログでは、この失敗は Codex webview レンダラーが 30 秒のタイムアウト前に準備完了にならなかったことと結び付けられていました(openai/codex#56691 で報告)。表示されるエラーに openai.chatgpt、ServiceWorker、InvalidStateError が含まれる場合、または reason=renderer_ready_timeout のような Codex ログ行がある場合は、このケースに該当します。

失敗時のログ行として報告されていたものは次のとおりです。

[CodexWebviewProvider] Webview renderer did not become ready elapsedMs=29999 extensionVersion=26.1021.22027 reason=renderer_ready_timeout receivedWebviewMessage=false role=sidebar stage=renderer timeoutMs=30000
  1. この症状の主な修正として、VS Code のキャッシュディレクトリ削除にこれ以上時間をかけないでください。最初に報告した Windows ユーザーは、%APPDATA%\Code 配下の Cache、CachedData、Code Cache、GPUCache、Service Worker データを削除した後も問題が続いたと述べています(openai/codex#56691 で報告)。

  2. 動作したと報告されている拡張機能バージョンをインストールします。

    code --install-extension OpenAI.chatgpt@26.1007.21434 --force
  3. VS Code を再起動します。

  4. 拡張機能を開き、Codex または OpenAI.chatgpt を探し、歯車アイコンを選択して、その拡張機能の自動更新を無効にします。これにより、VS Code が失敗するバージョン系列を自動的に再インストールしないようにします(openai/codex#56691 で報告された回避策)。

  5. Codex サイドバーをもう一度開きます。

動作確認の方法: service-worker エラーが消え、Codex サイドバーが表示されるはずです。Linux Mint のある報告では、手動で 26.1021.22027 に戻すと失敗が再現し、その後、回避策として 26.1007.21434 を再インストールして固定していました(openai/codex#56691 で報告)。

それでも失敗する場合: service-worker の正確なメッセージと、renderer_ready_timeout、elapsedMs、extensionVersion、timeoutMs を含む Codex の出力行をコピーしてください。ローカルの VS Code を使っているのか、Remote-SSH を使っているのかも含めてください。ある Windows の報告では、別個の .vscode-server/extensions/openai.chatgpt-26.1021.22027-win32-x64 インストールを持つ VS Code Remote-SSH ウィンドウでも、同じタイムアウトが再現したとされています(openai/codex#56691 で報告)。報告を作成する前に、general error-handling guide を使って、エラーテキスト、バージョン、再試行結果、ログを整理してください。

情報源

ドキュメント: 報告を作成する前に、general error-handling guide を使って、正確なエラーテキスト、バージョン、再試行結果、ログを整理してください。→ general error-handling guide

関連ドキュメント

よくある質問

VS Codeで「Codex could not start」を直すにはどうすればよいですか?
OpenAI.chatgptのVS Code拡張機能を26.1007.21434にダウングレードし、その拡張機能の自動更新を無効にします。複数のユーザーが、26.1021.22027では失敗し、26.1007.21434に戻すとCodexサイドバーが復旧したと報告しています。
Codexが「The extension could not start its user interface」と表示するのはなぜですか?
原因として考えられるのは、CodexのVS Code拡張機能におけるwebview起動のリグレッションで、タイムアウト前にレンダラーがreadyにならないことです。openai/codex#56691で報告されたユーザーログには、拡張機能26.1021.22027でrenderer_ready_timeoutが示されています。
openai.chatgptの「Could not register service worker」はどう直せばよいですか?
service workerのメッセージは、同じCodex webview起動失敗として扱い、まずCodex拡張機能を26.1007.21434にダウングレードします。ダウングレード後の拡張機能でも失敗する場合は、VS Codeのバージョン、OS、拡張機能のバージョン、Codexの出力ログを報告してください。