ChatGPT Windows 客户端突然打不开?提示找不到 Codex CLI,我这样解决了

ChatGPT Windows 客户端突然打不开?提示找不到 Codex CLI,我这样解决了

最近更新 ChatGPT Windows 客户端之后,我遇到了一个比较奇怪的问题。

双击打开 ChatGPT,客户端没有正常启动,而是直接弹出错误:

复制代码
ChatGPT failed to start.

Unable to locate the Codex CLI binary.

Set CODEX_CLI_PATH or ensure the Electron resources include bin/codex.

大概就是下面这种提示:

ChatGPT 启动失败,无法找到 Codex CLI 二进制文件,需要设置 CODEX_CLI_PATH,或者确保客户端资源中包含 bin/codex。

一开始看到这个错误还有点奇怪:

我打开的明明是 ChatGPT,为什么会报 Codex CLI 找不到?

最终排查下来,问题其实并不复杂。

如果你也遇到了同样的问题,可以按照下面的方法解决。


一、先确认 Codex CLI 是否存在

首先打开 Windows 的 CMD 或 PowerShell。

执行:

复制代码
codex --version

我这里最开始返回的是:

复制代码
'codex' 不是内部或外部命令,也不是可运行的程序
或批处理文件。

这就基本说明:

当前 Windows 环境里没有可用的 Codex CLI,或者 Codex CLI 没有加入 PATH。

而新版 ChatGPT 客户端启动的时候,需要找到 Codex CLI。

找不到,自然就启动失败了。


二、安装 Codex CLI

我最后使用的是 Codex 官方提供的 Windows PowerShell 安装方式。

在 CMD 中执行:

复制代码
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

注意,这里需要能够正常访问 OpenAI 相关服务。

安装完成之后,会出现如下cli:

安装完成以后,重新打开一个 CMD。

执行:

复制代码
codex --version

这次已经正常返回:

复制代码
codex-cli 0.149.1

说明 Codex CLI 已经安装成功。


三、确认 codex.exe 的真实位置

接着执行:

where codex

我这里返回的是:

复制代码
C:\Users\Administrator\AppData\Local\Programs\OpenAI\Codex\bin\codex.exe

也就是说,Codex CLI 实际安装在:

复制代码
C:\Users\Administrator\AppData\Local\Programs\OpenAI\Codex\bin\

如果你的 Windows 用户名不是 Administrator,路径自然也会有所不同。

例如可能是:

复制代码
C:\Users\zhangsan\AppData\Local\Programs\OpenAI\Codex\bin\codex.exe

所以不要直接照抄我的完整路径。

最稳妥的方法就是自己执行:

复制代码
where codex

以你电脑实际返回的路径为准。


四、设置 CODEX_CLI_PATH

虽然此时:

复制代码
codex --version

已经能够正常执行,但为了让 ChatGPT 客户端能够明确找到 Codex CLI,我又手动配置了环境变量。

执行:

复制代码
setx CODEX_CLI_PATH "%LOCALAPPDATA%\Programs\OpenAI\Codex\bin\codex.exe"

执行成功以后,会看到:

复制代码
成功: 指定的值已得到保存。

这里需要特别注意环境变量名称:

复制代码
CODEX_CLI_PATH

不要写错。

它指向的也不是目录,而是完整的:

复制代码
codex.exe

也就是:

复制代码
%LOCALAPPDATA%\Programs\OpenAI\Codex\bin\codex.exe

五、重启 ChatGPT

环境变量配置完成以后,不要直接在原来的 ChatGPT 窗口上继续尝试。

建议:

  1. 完全退出 ChatGPT;

  2. 打开任务管理器;

  3. 确认没有残留的 ChatGPT 进程;

  4. 重新启动 ChatGPT。

如果还不行,可以直接重启一次 Windows。

我这里重新启动之后,ChatGPT 客户端就可以正常打开了。

问题解决。


整个解决过程其实只有 4 条命令

如果不想看前面的分析,直接执行下面几步即可。

第一步:检查 Codex

复制代码
codex --version

如果提示:

复制代码
'codex' 不是内部或外部命令

继续下一步。

第二步:安装 Codex CLI

复制代码
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

第三步:确认安装结果

重新打开 CMD:

复制代码
codex --version

再执行:

复制代码
where codex

正常情况下会看到类似:

复制代码
codex-cli 0.149.1

以及:

复制代码
C:\Users\你的用户名\AppData\Local\Programs\OpenAI\Codex\bin\codex.exe

第四步:配置 Codex CLI 路径

复制代码
setx CODEX_CLI_PATH "%LOCALAPPDATA%\Programs\OpenAI\Codex\bin\codex.exe"

最后重新启动 ChatGPT。


为什么 ChatGPT 会依赖 Codex CLI?

这也是这次问题比较容易让人迷惑的地方。

以前很多人对 ChatGPT 和 Codex 的理解是:

复制代码
ChatGPT
   │
   └── 聊天、文件、AI 对话

Codex
   │
   └── 编程 Agent、终端、代码操作

但现在桌面端正在逐渐把 Chat、Codex、Agent 等能力整合到一个客户端体系中。

所以本地 ChatGPT 在启动或者初始化 Codex 能力时,需要能够访问本机的:

复制代码
codex.exe

如果这个二进制文件不存在,或者客户端无法定位,就可能出现:

复制代码
Unable to locate the Codex CLI binary

所以这个错误虽然显示在 ChatGPT 上,真正出问题的却是:

复制代码
Codex CLI

如果安装以后还是不行怎么办?

还可以继续排查下面几个地方。

1. 检查 Codex 是否真的安装成功

执行:

复制代码
codex --version

只要能正常出现版本号,比如:

复制代码
codex-cli 0.149.1

就说明 CLI 本身没有问题。


2. 检查 PATH

执行:

复制代码
where codex

如果能够找到:

复制代码
...\OpenAI\Codex\bin\codex.exe

说明 Windows PATH 基本正常。

如果:

复制代码
codex --version

可以执行,但 ChatGPT 依然找不到,那么重点检查:

复制代码
CODEX_CLI_PATH

3. 检查环境变量

CMD 中执行:

复制代码
echo %CODEX_CLI_PATH%

正常应该返回类似:

复制代码
C:\Users\Administrator\AppData\Local\Programs\OpenAI\Codex\bin\codex.exe

如果为空,可以重新设置:

复制代码
setx CODEX_CLI_PATH "%LOCALAPPDATA%\Programs\OpenAI\Codex\bin\codex.exe"

然后重新登录 Windows,或者直接重启电脑。


4. 不要把变量指向错误文件

需要指向的是:

复制代码
codex.exe

例如:

复制代码
C:\Users\Administrator\AppData\Local\Programs\OpenAI\Codex\bin\codex.exe

而不是:

复制代码
C:\Users\Administrator\AppData\Local\Programs\OpenAI\Codex\bin

也不是:

复制代码
codex.cmd

环境变量的最终值应该是一个完整的可执行文件路径。


最后总结

这次的问题表面上看是:

ChatGPT Windows 客户端无法启动。

但真正的报错核心只有一句:

复制代码
Unable to locate the Codex CLI binary

所以排查思路也很简单:

复制代码
ChatGPT 无法启动
        ↓
检查 codex --version
        ↓
Codex 不存在
        ↓
安装 Codex CLI
        ↓
where codex
        ↓
找到 codex.exe
        ↓
配置 CODEX_CLI_PATH
        ↓
重启 ChatGPT
        ↓
恢复正常

最终我实际使用的核心命令就是:

复制代码
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

安装完成后确认:

复制代码
codex --version

返回:

复制代码
codex-cli 0.149.1

然后:

复制代码
where codex

返回:

复制代码
C:\Users\Administrator\AppData\Local\Programs\OpenAI\Codex\bin\codex.exe

最后配置:

复制代码
setx CODEX_CLI_PATH "%LOCALAPPDATA%\Programs\OpenAI\Codex\bin\codex.exe"

重新启动 ChatGPT。

恢复正常。

如果你最近更新 ChatGPT Windows 客户端之后,也突然遇到了相同的 Codex CLI binary 报错,可以优先检查这个地方。

很多时候,不需要卸载 ChatGPT,也不需要反复重装客户端。

把 Codex CLI 装好,并让 ChatGPT 找到 codex.exe,问题就解决了。

相关推荐
观察员15 小时前
告别频繁锁屏:5行 PowerShell 脚本实现 Windows 自动防休眠
windows·命令行
Funlang16 小时前
在 Windows 95 上写前端
前端·javascript·windows
一切皆有可能!!21 小时前
【SoduWork测评】本机跑源码,找到并修了7个Bug
windows·开源·bug·ai编程·soduwork
xx z21 小时前
打开游戏提示 d3dx9_43.dll 缺失怎么办(DirectX 修复步骤)
windows·游戏·工具·软件
如夏倾城1 天前
五大远程桌面协议:RDP、SSH、VNC/RFB、Citrix ICA/HDX 与 VMware Blast Extreme
运维·windows·网络协议·安全·自动化·ssh·远程工作
bryant_meng1 天前
ChatGPT Desktop Model Evolution (2025): From GPT-4.1 to GPT-5.1
gpt·chatgpt·gpt4·gpt4o·gpt5
Vex2une2 天前
JDK 8 下载安装与环境变量配置完整指南(Windows新手图文教程)
java·windows·环境配置·环境变量·jdk8·jdk下载安装·java入门教程
星空孤辰2 天前
【camera 008】android camera id 注册、状态监控等状态变化 全流程梳理
android·windows
一缕82年的清风2 天前
OpenAI 突发 GPT-6.2:Sol 提速 8 倍跑分追平旗舰,但这 1 处暗改会让缓存直接失效!
gpt·chatgpt
全方位办公软件2 天前
Windows音频服务架构解析:AudioSrv与AudioEndpointBuilder排障
windows·命令行·powershell·音频服务·驱动修复·mmdevices·audiosrv