AONIR JOURNAL

Codex 打不开怎么办?桌面版、VS Code 插件、更新后打不开,按样子对照处理

「Codex 打不开」说的可能是三个不同的程序:ChatGPT 桌面版里的 Codex、VS Code 里的 Codex 插件、终端里的 Codex CLI。它们各装各的,一个打不开,另外两个多半还能用,用的是同一个账号、同一份额度。先对照下面的表找到你那一种,再看对应的一节。这几天问得最多的是 VS Code 插件 10 月 24 日自动更新后打不开,和 Windows 桌面版更新后弹「无法加载组织设置」。

Codex 打不开的四种情况:VS Code 插件只显示 Codex could not start、Windows 桌面版更新后打不开、Mac 桌面版白屏、终端里的 CLI 一运行就退出,各自先做的第一步点击查看大图
IMAGE VIEWER

Codex 打不开的四种情况:VS Code 插件只显示 Codex could not start、Windows 桌面版更新后打不开、Mac 桌面版白屏、终端里的 CLI 一运行就退出,各自先做的第一步

1600 × 900
FIG. 01 开始阅读
THE ESSENTIALS

先看这四件事

  1. ChatGPT 桌面版、VS Code 插件、终端里的 CLI 是三个程序,各自更新。一个打不开,先换另一个用着,同一个账号、同一份额度。

  2. VS Code 插件 10 月 24 日自动更新到 26.1021.22027 之后,很多人只看到 Codex could not start。到 10 月 30 日还没有修好的新版本,十几位用户确认退回 26.1007.21434 就好。

  3. Windows 桌面版更新后打不开,先在任务管理器里把 ChatGPT、codex.exe 和 codex-windows-sandbox-service.exe 都结束掉,再打开。弹「无法加载组织设置」的,先查一个旧的 CODEX_CLI_PATH 环境变量。

  4. 别从网盘、群文件下载所谓的 Codex 汉化版、破解版。桌面版本身就能切中文,只从官网或 Microsoft Store 安装。

AT A GLANCE

你是哪一种:样子、原因和第一步

按你看到的样子找。原因一栏是 issue 里用户查到的,官方确认过的会写明。

左右滑动查看完整表格

你看到的多半是先做什么
VS Code 侧边栏只有 Codex could not start(The extension could not start its user interface.),或一直转圈插件 10 月 24 日更新的 26.1021.22027把插件退回 26.1007.21434,关掉它的自动更新
Windows 桌面版弹「无法加载组织设置」,下面写着「应用已暂停,等待安全加载组织设置后才能恢复」,点重试没用电脑里留着旧的 CODEX_CLI_PATH 环境变量;或旧配置里的 approval_policy = "untrusted";或 Agent 设成在 WSL 里运行按顺序查这三处
Windows 更新后打不开、只有启动动画,任务管理器里还挂着 codex-windows-sandbox-service.exe上一次的进程和沙盒服务没退出,新版本装不进去在任务管理器里全部结束,再打开
Windows 应用里点「安装更新」,关掉又打开还是旧版本更新包要等应用完全退出才装得上打开 Microsoft Store,给 ChatGPT 点「重试」
Windows 任务管理器里有好几个 ChatGPT.exe,就是不出窗口Windows 用户名是中文,应用算出的用户目录路径成了乱码先用 CLI 或网页版;用户的修复办法见下文
Windows 一打开就弹「无法遍历该路径,因为它包含不受信任的装入点」开着阿里云盘,或者应用装在 C 盘以外的盘上完全退出阿里云盘;装在别的盘上的,改回 C 盘重装
Windows 登录后几十秒整个应用自己消失(闪退),没有报错登录后安装一个运行时组件时崩溃先更新;还闪退,手动装那个组件
Mac 桌面版白屏、只有启动动画多半是新版本的问题Cmd + Q 完全退出,检查更新
终端里一运行 codex 就显示 killed,或者 command not foundHomebrew 装的版本有问题,或者 PATH 里找不到brew reinstall --cask codex;查 which -a codex

先分清是哪一个打不开

Codex 有三种用法,都是 OpenAI 官方的:ChatGPT 桌面应用(打开后在顶部选 Codex;Windows 任务管理器里的进程叫 ChatGPT,旧版叫 Codex)、VS Code 或 Cursor 里的 Codex 插件(发布者 OpenAI,ID openai.chatgpt)、终端里的 Codex CLI。

三个程序各装各的、各自更新,出问题的往往只是其中一个。急着用的,先换另一个:用的是同一个 ChatGPT 账号,额度也是同一份。

另外,只是「登录页出不来、一直转圈」,多半不是程序坏了,是网络:桌面版不读终端里设的代理变量,下面最后一节有链接。

VS Code 插件打不开:Codex could not start

北京时间 10 月 24 日早上,VS Code 里的 Codex 插件自动更新到 26.1021.22027(预览版 26.51021.22027)之后,很多人一打开侧边栏就只有「Codex could not start / The extension could not start its user interface.」,或者一直转圈。插件日志里是 renderer_ready_timeout:后台启动了,界面 30 秒内没加载出来。

Windows、Linux、Intel Mac 都有,本机、Remote-SSH、WSL 都有。到 10 月 30 日,openai/codex 里至少 30 个 issue 在报,没有官方回复,插件市场也还没有修好的新版本。下面是 issue 里用户的办法,不是官方方案:

  • 把插件退回 26.1007.21434:扩展面板里右键 Codex 插件,选「安装特定版本...」,挑 26.1007.21434;或者用下面的命令。十几位用户确认这样就好了,也有几位退回了还是不行。有一位用户说在扩展面板里卸载再装旧版没用,用命令加 --force 才装上。
  • 装好后重新加载窗口,再右键这个插件,把「自动更新」的勾去掉,不然它过一段时间又会升回 26.1021.22027。连着 Remote-SSH、WSL 的,远程那一侧的插件也要这样退回。
  • 还不行,把 VS Code 退回 1.142.0,有三位用户这样好了。
  • 不想降级,先试一下挪位置:右键侧边栏上的 Codex 标签,选「移动到」→「面板」或「主侧边栏」,它会重新加载一次界面(两位用户确认)。
COMMAND / 01

在终端里退回 26.1007.21434

code --install-extension openai.chatgpt@26.1007.21434 --force
AONIR · 操作命令在终端中逐行执行

Windows:「无法加载组织设置」,应用已暂停

一打开就是「无法加载组织设置」(Unable to load organization settings),下面一行「应用已暂停,等待安全加载组织设置后才能恢复」,点重试、退出登录都回到这一页,修复、重置、重装都没用。用户查到三种原因,按顺序排除。

第一种:旧的 CODEX_CLI_PATH 环境变量。10 月 24 日更新到 26.1021 之后很多人遇到,三位用户查到同一个原因:电脑里有一个用户级的环境变量 CODEX_CLI_PATH,指着早先自己装或复制出来的旧 codex.exe。桌面版启动时会优先用它,旧程序对不上新版本,读组织设置这一步就失败了。官方安装方式不会设这个变量,多半是以前照着某个教程或工具设的。

  • 完全退出指的是任务栏右下角的 ChatGPT 图标也要退出。报告的人都是这样恢复的,不用重装,也不丢数据。#56716 里另有一位用户说,在 cmd 里运行一次 codex update 之后就好了(一位用户)。
  • 第二种:旧配置。不少老教程让你在 %USERPROFILE%\.codex\config.toml 里写 approval_policy = "untrusted",官方文档写明这个值已经停用。打开 config.toml 删掉这一行;想让 Codex 跑命令前先问你,改成 approval_policy = "on-request"。保存后完全退出再打开。
  • 第三种:Agent 设成在 WSL 里运行。完全退出应用,打开 %USERPROFILE%\.codex\config.toml,把 [desktop] 下面的 runCodexInWindowsSubsystemForLinux 改成 false 再打开(几位用户来回切换确认过)。改之前可以先把整个 .codex 文件夹复制一份。
  • 开着 WSL、又走代理的,换了一个 Wi-Fi 之后才开始弹这个框的:Windows 可能把新网络当成「公用网络」,挡住了 WSL 发到代理端口的连接。设置 → 网络和 Internet → Wi-Fi → 当前网络 →「网络配置文件类型」改成「专用网络」(一位用户查到并解决)。
COMMAND / 01

1. 在 PowerShell 里查(有输出、是一个 codex.exe 的路径,就是这一种)

[Environment]::GetEnvironmentVariable("CODEX_CLI_PATH", "User")
AONIR · 操作命令在终端中逐行执行
COMMAND / 02

2. 完全退出 ChatGPT 后删掉它,再重启电脑

[Environment]::SetEnvironmentVariable("CODEX_CLI_PATH", $null, "User")
AONIR · 操作命令在终端中逐行执行

Windows:更新后打不开、只有启动动画、装不上新版本

这类问题大多出在新版本本身,很多人同时遇到,一般要等官方发修复版。动手之前,先按这个顺序试:

  • 完全退出再打开:在任务管理器里结束 ChatGPT(旧版叫 Codex)的所有进程,后台残留的 codex.exe 一起结束。「详细信息」里还有 codex-windows-sandbox-service.exe 的,也结束掉。一位用户说近一个月每次更新后都要这样做才进得去,他的安装日志里新版本几次没装上,报错是 0x80073CF9(有程序没关)。
  • 应用里点「安装更新」,关掉又打开还是旧版本、更新图标没了:10 月 23 日起有六位用户在 26.1016、26.1023 上报过,安装日志里是 0x80073CF9、0x800700E9,意思是 ChatGPT 还在运行,新版本装不进去。报告人的办法是打开 Microsoft Store,给 ChatGPT 点「重试」,就装上了。
  • 重启电脑,再到 Microsoft Store 里看有没有更新。
  • 设置 → 应用 → 已安装的应用 → ChatGPT → 高级选项:先点「修复」(不删数据);不行再点「重置」(会清掉应用自己的数据,要重新登录)。
  • 一直停在启动画面、以前登过公司或拼车的 Team 工作空间的:保存的登录可能指着一个已经停用的工作空间。完全退出,把 %USERPROFILE%\.codex\auth.json 改名成 auth.json.bak,再打开重新登录(好几位用户确认管用)。

Windows:有进程没窗口、装入点报错、登录后自己退出

任务管理器里有好几个 ChatGPT.exe,就是不出窗口,重装没用:一位中文用户查到,Windows 用户名是中文时,应用算出的用户目录路径成了乱码,日志里是 Desktop network requirements prevented startup 和 Failed to get 'appData' path,没有官方回复。他用管理员 PowerShell 建了一个目录联接,把乱码路径指回真实的用户目录。这是用户的办法,动手之前看清楚每条命令;不急的话先用 CLI 或网页版。

一打开就弹「无法遍历该路径,因为它包含不受信任的装入点」:用户报告了两种情况。一是开着阿里云盘,从任务栏右下角的图标里完全退出阿里云盘再打开就好;二是应用装在了 C 盘以外的盘上,把「设置 → 存储 → 新内容的保存位置」里的新应用改回 C 盘,卸载 ChatGPT 再从 Microsoft Store 重新安装。

登录后几十秒整个应用自己消失(闪退),没有任何提示,不登录就一直正常:10 月 7 日那一版之后有人遇到。发帖人查到,登录后应用会在后台安装一个约 528 MB 的运行时组件,安装这一步让主进程崩溃退出,所以重装没用。先在 Microsoft Store 更新到最新版;还闪退,完全退出后到 %LOCALAPPDATA%\Packages\OpenAI.Codex_2p2nqsd0c76g0\LocalCache 里找 codex-windows-runtime-framework-* 文件夹,双击里面的 OpenAI.CodexPrimaryRuntime 安装包手动装上,再打开。这是用户自己查出来的办法(LINUX DO 上一位用户的做法),OpenAI 社区的帖子里有更稳妥的 PowerShell 做法,其中一步是确认安装包的签名是 OpenAI 的。

Mac 桌面版打不开、白屏

  • 按 Cmd + Q 完全退出(只关窗口不算),再打开。
  • 点顶部菜单 ChatGPT →「检查更新…」,已知问题一般靠新版本修。
  • Mac 桌面版白屏的 issue 9 月以来一直开着,没有官方回复。白屏一直不好,先用 CLI 或网页版。
  • 想自己看原因,日志在 ~/Library/Logs/com.openai.codex/ 里。

终端里的 Codex CLI 打不开

  • 一运行就是 killed:10 月 28 日有两位用户在 Mac 上从 Homebrew 装了 0.165.0 之后遇到,其中一位运行 brew reinstall --cask codex 就好了。30 日 Homebrew 上已是 0.166.0,先 brew upgrade --cask codex,还是 killed 再重装。
  • command not found,或者更新了版本号还是旧的:多半是电脑里装了两份,或者 PATH 里找不到。macOS / Linux 用 which -a codex,Windows 用 where codex,看看运行的是哪一份。
  • Windows 上报 start the Windows daemon from a non-elevated terminal:别用管理员终端,换一个普通终端打开;或者这一次先用 codex --no-daemon。
  • 不知道是哪一类,运行一次 codex doctor,它会检查安装、配置、登录和网络;CLI 0.166.0 起,只想查网络可以用 codex doctor --network-only。

都不行的时候

这一页只收「打不开」。能打开、但登录跳不回来、发不出消息、断线重连、额度用完这些问题,按报错原文排好的完整列表在我们的 GitHub 教程里,跟着 openai/codex 的 issue 持续更新。

  • 先用另外两个入口干活:桌面版打不开就用 CLI 或网页版,插件打不开就用桌面版。
  • 到 openai/codex 的 issue 里搜你的版本号和报错原文,看是不是已知问题、有没有修好的版本。
  • 在 Codex 里输入 /feedback 提交,记下反馈 ID,找 OpenAI 客服时带上。
  • 别下载所谓的「中文版」「破解版」:CLI 是开源的,桌面版本身就能切中文,来路不明的安装包可能偷走你的登录凭证。
A FEW MORE THINGS

你可能还想知道

01Codex 打不开了怎么办?

先分清是哪一个:ChatGPT 桌面版、VS Code 插件,还是终端里的 CLI。VS Code 插件只显示 Codex could not start 的,退回 26.1007.21434 并关掉自动更新;Windows 桌面版更新后打不开的,先在任务管理器里结束 ChatGPT、codex.exe 和 codex-windows-sandbox-service.exe 再打开,弹「无法加载组织设置」的查旧的 CODEX_CLI_PATH 环境变量;Mac 按 Cmd + Q 退出后检查更新。

02Codex 一打开就闪退、崩溃怎么办?

Windows 上登录后几十秒整个应用自己消失、没有报错的,发帖人查到是登录后安装一个约 528 MB 的运行时组件时崩溃:先在 Microsoft Store 更新到最新版,还闪退就手动装那个组件(步骤见上文)。更新后一打开就退出的,先在任务管理器里结束 ChatGPT、codex.exe 和 codex-windows-sandbox-service.exe,再打开。VS Code 里是插件打不开、不是闪退的,看插件那一节。

03Codex 更新后打不开,要重装吗?

先别重装。issue 里的这类问题,重装大多没用:「无法加载组织设置」是电脑里一个旧的环境变量或旧配置引起的,删掉就好;更新后没反应多半是旧进程或沙盒服务没退出。按上面的顺序查完还不行,再用「修复」「重置」。

04「应用已暂停,等待安全加载组织设置后才能恢复」是什么意思?

这是「无法加载组织设置」下面那一行。桌面版启动时要先读一次组织策略,读不到就停在这里。用户查到的原因有三种:旧的 CODEX_CLI_PATH 环境变量、config.toml 里停用的 approval_policy = "untrusted"、Agent 设成在 WSL 里运行;开着 WSL 走代理的,还可能是 Windows 把新网络当成公用网络、挡住了代理端口。

05VS Code 里的 Codex 插件什么时候修好?

到 2026 年 10 月 30 日,OpenAI 没有在 issue 里回复,插件市场也没有修好的新版本,最新的还是 10 月 24 日的 26.1021.22027。先退回 26.1007.21434 并关掉自动更新,等官方出新版本后再打开自动更新。

06桌面版打不开,能先用别的吗?

能。CLI、VS Code 插件和网页版都用同一个 ChatGPT 账号登录,额度是同一份。CLI 可以用 npm 国内镜像安装:npm install -g @openai/codex --registry=https://registry.npmmirror.com。

BEHIND THIS GUIDE

有据可查,方便追溯

编辑说明

核对日期:2026 年 10 月 30 日(北京时间)。原因和办法来自 openai/codex 的 issue、OpenAI 社区和 ChatGPT Learn 官方文档,每条写明是官方说法还是用户试出来的办法、有几位用户确认。界面文字取自 ChatGPT 桌面版 26.1023 自带的中文语言包。

  1. openai/codex #56655:插件 26.51021.22027 打不开,退回 26.1007.21434 后恢复
  2. openai/codex #56691:26.1021.22027 在 VS Code 1.143.1 里打不开
  3. openai/codex #56655:用命令加 --force 才退回成功
  4. openai/codex #56620:删掉旧的 CODEX_CLI_PATH 后恢复
  5. openai/codex #48324:同一原因的第二位用户
  6. openai/codex #57051:同一原因的第三位用户
  7. openai/codex #56716:一位用户运行 codex update 之后恢复
  8. ChatGPT Learn:Migrate from the retired untrusted approval policy
  9. openai/codex #54478:Agent 在 WSL 里运行时无法加载组织设置
  10. LINUX DO:换 Wi-Fi 后 WSL 连不上代理端口(10 月 18 日)
  11. openai/codex #56532:每次更新后要结束沙盒服务才进得去
  12. openai/codex #57611:应用内更新装不上,Microsoft Store 点「重试」成功
  13. openai/codex #56428:更新包因应用还在运行而装不上
  14. openai/codex #54322:Windows 用户名是中文,有进程没窗口
  15. openai/codex #54322:用户的目录联接办法
  16. openai/codex #39449:开着阿里云盘就打不开
  17. openai/codex #46277:装在 C 盘以外的盘上打不开
  18. OpenAI 社区:Windows 登录后几十秒自己退出
  19. LINUX DO:双击安装包手动装运行时组件
  20. openai/codex #19075:登录指着已停用的工作空间(402 deactivated_workspace)
  21. openai/codex #46641:Mac 桌面版白屏
  22. openai/codex #57681:Homebrew 装的 0.165.0 运行就是 killed
  23. openai/codex #48043:管理员终端里后台服务起不来
  24. ChatGPT Learn:ChatGPT desktop app
  25. Codex 国内使用与报错速查(GitHub)