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 找不到？

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

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

首先打开 Windows 的 CMD 或 PowerShell。

执行：

codex --version

我这里最开始返回的是：

'codex' 不是内部或外部命令，也不是可运行的程序
或批处理文件。

这就基本说明：

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

而新版 ChatGPT 客户端启动的时候，需要找到 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 已经安装成功。

接着执行：

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 --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 窗口上继续尝试。

建议：

1. 完全退出 ChatGPT；

2. 打开任务管理器；

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

4. 重新启动 ChatGPT。

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

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

问题解决。

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

第一步：检查 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 的理解是：

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，问题就解决了。