VS Code 里 Codex 报「Codex could not start its user interface」?糟心的版本 bug,回退一步就好(2026)
Codex 插件升级到 26.1021.22027 后,很多 VS Code 用户打开侧边栏看到「Codex could not start its user interface」。GitHub 上的 issue 还开着,OpenAI 没回复。对大多数人有用的办法是回退到 26.1007.21434,并关掉这个插件的自动更新。

先说结论:「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 套餐有问题?
报告里看不出跟套餐有关。同样的用户、同样的账号,只换了插件版本就恢复了。