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 窗口上继续尝试。
建议：
-
完全退出 ChatGPT；
-
打开任务管理器；
-
确认没有残留的 ChatGPT 进程；
-
重新启动 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_PATH3. 检查环境变量
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，问题就解决了。