VS Code 里 Codex 启动失败？降级 OpenAI.chatgpt 扩展来修复

TL;DR： 对于 Codex VS Code 报错 Codex could not start，目前被提到最多的绕过办法是安装 OpenAI.chatgpt@26.1007.21434，而不是 26.1021.22027，并关闭这个扩展的自动更新。本指南基于 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

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

当 Codex 侧边栏的 webview 初始化失败时，VS Code 里会显示 Codex could not start。目前看，更可能触发问题的是特定版本：OpenAI.chatgpt 扩展 26.1021.22027，因为多名用户反馈，在同一个 VS Code 环境里降级到 26.1007.21434 后，侧边栏恢复正常（见 openai/codex#56691）。如果 VS Code 活动栏里能看到 Codex 图标，但点开 Codex 侧边栏后出现的是错误面板，而不是 Codex UI，那么你遇到的就是这一类情况。

1. 关闭所有 VS Code 窗口。

2. 在能运行 code 命令的终端里，安装用户反馈可用的 Codex 扩展版本：

   code --install-extension OpenAI.chatgpt@26.1007.21434 --force

3. 如果 code 命令不可用，可以使用用户反馈的 VS Code UI 路径：打开 Extensions，找到 Codex 或 OpenAI.chatgpt，选择 gear icon，选择 Install Specific Version…，然后选择 26.1007.21434（绕过办法见 openai/codex#56691）。

4. 关闭 Codex 扩展的自动更新，避免 VS Code 立刻把扩展更新回 26.1021.22027：打开 Extensions，找到 Codex 或 OpenAI.chatgpt，选择 gear icon，然后为该扩展选择扩展级别的自动更新禁用选项（绕过办法见 openai/codex#56691）。

5. 重启 VS Code。

6. 从活动栏打开 Codex 侧边栏。

如何确认已经修好： Codex 侧边栏应该加载正常界面，而不是显示 Codex could not start 面板。在用户反馈中，同一套 Windows 和 Linux 安装环境在 26.1021.22027 上失败，安装 26.1007.21434 后可以正常加载（见 openai/codex#56691）。

如果仍然失败： 重新运行安装命令，并确认已安装的扩展版本是 26.1007.21434。因为有一条绕过办法特别提到，需要禁用自动更新，防止 VS Code 回到 26.1021.22027（见 openai/codex#56691）。如果版本已经固定，但侧边栏仍然失败，请收集操作系统、VS Code 版本、Codex 扩展版本，以及任何包含 renderer_ready_timeout 的 Codex 输出行，然后把这些信息补充到现有 GitHub issue，或新建一个 openai/codex issue。侧边栏恢复加载后，下一步配置可以参考 Codex 模型提供方设置指南。

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 秒超时前进入 ready 状态（见 openai/codex#56691）。如果可见错误里出现了 openai.chatgpt、ServiceWorker、InvalidStateError，或 Codex 日志行里有类似 reason=renderer_ready_timeout 的内容，那么你遇到的就是这一类情况。

一条用户反馈的失败日志是：

[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. 打开 Extensions，找到 Codex 或 OpenAI.chatgpt，选择 gear icon，并关闭该扩展的自动更新，避免 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 反馈称，在 VS Code Remote-SSH 窗口中也能复现超时，而且当时有一份单独的 .vscode-server/extensions/openai.chatgpt-26.1021.22027-win32-x64 安装（见 openai/codex#56691）。提交报告前，可以用通用错误处理指南整理错误原文、版本、重试结果和日志。

来源

• GitHub issue：openai/codex#56691 — Codex 26.1021.22027 fails to start UI in VS Code 1.143.1 on Windows
• 反馈者列出的相关 GitHub issue：openai/codex#56617

站内文档： 提交报告前，用通用错误处理指南整理准确的错误文本、版本、重试结果和日志。→ 通用错误处理指南

相关文档

• Codex 模型提供方设置
• 通用错误处理指南