VS Code 里 Codex 报「Codex could not start its user interface」？糟心的版本 bug，回退一步就好（2026）

先说结论：「Codex could not start its user interface」是 Codex VS Code 插件 26.1021.22027 版本的 bug，跟你的账号和网络无关。截至 2026 年 10 月 29 日，GitHub 上的 issue 还开着，OpenAI 没有在里面回复。帖子里多数人的解决办法是把插件回退到 26.1007.21434，并关掉这一个插件的自动更新。如果旧版本也打不开，有几位用户是把 VS Code 退回 1.142 才好的。

报错长什么样

打开 Codex 侧边栏时，面板显示：

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

VS Code 右下角同时弹出「Codex could not start its user interface.」。在“输出”面板里选 Codex 频道，能看到对应的日志，比如 openai/codex 的 #56691 issue 里贴出来的这一行：

[CodexWebviewProvider] Webview renderer did not become ready elapsedMs=30004 extensionVersion=26.1021.22027 reason=renderer_ready_timeout receivedWebviewMessage=false role=sidebar stage=renderer timeoutMs=30000

如果你的日志里 reason 不是这个，那可能不是这篇说的问题。

修好了吗

还没有。发布前我们又查了一次：

• #56691 还开着，几十条评论全是用户，没有 OpenAI 成员回复。macOS（#56660）和 Remote-SSH（#56736）也有单独的报告，同样没关。
• VS Marketplace 上最新的正式版还是 26.1021.22027，北京时间 2026 年 10 月 24 日 06:04 发布，之后没有新版本。

报告来自 Windows 10/11、Ubuntu、Fedora、Linux Mint、Intel Mac 和 Remote-SSH，不只是 Windows 的问题。

修复 Codex could not start its user interface：回退到 26.1007.21434

VS Code 的 官方扩展文档 写了界面操作：右键扩展，选“Install Another Version”。

1. 按 Ctrl+Shift+X（Mac 是 Cmd+Shift+X）打开扩展面板。

2. 右键 Codex 插件，它的 ID 是 openai.chatgpt。

3. 选 Install Another Version…，再选 26.1007.21434。

4. VS Code 提示重启扩展时点确定，然后重新打开 Codex。

也可以用命令行。VS Code 命令行文档 写明，装指定版本就在后面加 @版本号：

code --install-extension [email protected] --force

有用户回复说用这条命令就好了（原评论）。也有人说回退后要重启一次电脑，旧版本才完全正常。

别让 VS Code 又自动升回去

不做这一步，VS Code 会再把 26.1021.22027 装回来。按 VS Code 文档，右键单个扩展，把“自动更新”那一项取消勾选，就只对这一个插件生效。等出了修好的版本再打开。

我们自己查到的

我们的测试机没有图形界面，跑不了 VS Code，所以没能复现这个弹窗。我们做的是：2026 年 10 月 29 日查询 VS Marketplace，把两个版本的 Linux x64 插件包都下载下来对比。

结果：

• 两个包都能正常从 Marketplace 下载，package.json 里的版本号分别是 26.1021.22027 和 26.1007.21434，说明回退用的旧版本现在还能装。
• 新包更大：22,605 个文件、解压后 1,141 MB；旧包是 19,586 个文件、964 MB。多出来的文件几乎都在 webview/assets 下面，也就是 Codex 面板要加载的那部分代码。
• 这个报错来自插件代码里写死的 30 秒计时（3e4 毫秒）：面板 30 秒内没报告“已就绪”，就弹这句话。两个版本的计时和报错文字完全一样，也没有设置项可以改。
• 新版面板的入口文件（webview/assets/app-main-*.js）里有一张 3,203 个文件的预加载清单；旧版入口文件没有这张清单，只直接引入 4 个文件。

这和一位用户实测的结果对得上：他用 2010 年的双核笔记本，新版面板要 45 到 142 秒才加载完，临时把 30 秒上限调大后就能正常用（原评论）。所以在慢一点或正忙的电脑上，这个报错可能只是启动太慢，不是插件坏了。OpenAI 没有确认原因。

回退后还是打不开

好几位用户认为 VS Code 1.143.1 也有份。一位 Windows 11 用户贴了日志表：旧插件在 1.143.1 上照样超时，退回 VS Code 1.142.0 后大约 2 秒就加载出来（带日志表的评论）。一位 Linux 用户也说退回 1.142.0 解决了（评论）。退 VS Code 动静更大，建议先试回退插件。

这期间可以先在终端里用 Codex CLI，它不走 VS Code 面板。安装看 Codex CLI 安装和登录教程，两者区别看 Codex CLI 和 Codex App 的区别。

常见问题

卸载重装插件有用吗？

单纯重装没用，装回来的还是 26.1021.22027。要专门选 26.1007.21434。

清 VS Code 缓存能解决吗？

对最早报告的那位用户没用。他回退前已经清过缓存和 Service Worker 数据、换过新的用户配置、关过 GPU 加速。

是不是我的 ChatGPT 套餐有问题？

报告里看不出跟套餐有关。同样的用户、同样的账号，只换了插件版本就恢复了。