为什么会出现这个问题？

ChatGPT Windows 客户端打不开：Unable to locate the Codex CLI binary / 找不到 Codex CLI

Q: 会遇到什么问题？

更新 ChatGPT Windows 客户端后双击打不开，直接弹错误： ChatGPT failed to start. Unable to locate the Codex CLI binary. Set CODEX CLI PATH or ensure the client resources include bin/codex. 打开的是 ChatGPT，报的却是 Codex CLI 找不到——新版 ChatGPT 客户端启动时依赖 Codex CLI 二进制。 本文路径： 快速修复 （30 秒一段命令）→ 一步步排查 （可跳读）→ 原理与变体 （症状/原因/证据）。赶时间直接跳到「快速修复」。

Q: 怎么快速修复？

1. 检查是否已装（返回版本号 = 已装） codex version 2. 没装：用官方 PowerShell 安装脚本（需能访问 chatgpt.com） powershell ExecutionPolicy ByPass c "irm https://chatgpt.com/codex/install.ps1 | iex" 3. 以真实路径为准设置 CODEX CLI PATH（不要照抄网上的完整路径） where codex setx CODEX CLI PATH "<where codex 返回的完整路径 " 4. 完全退出 ChatGPT 客户端（不是最小化）再重开

Q: 怎么确认修好了？

codex version 正常返回版本号；ChatGPT 客户端能正常打开、不再弹 Unable to locate the Codex CLI binary。

Q: 其它环境的表现？

快速修复

# 1. 检查是否已装（返回版本号 = 已装）
codex --version

# 2. 没装：用官方 PowerShell 安装脚本（需能访问 chatgpt.com）
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

# 3. 以真实路径为准设置 CODEX_CLI_PATH（不要照抄网上的完整路径）
where codex
setx CODEX_CLI_PATH "<where codex 返回的完整路径>"

# 4. 完全退出 ChatGPT 客户端（不是最小化）再重开

你会遇到什么

更新 ChatGPT Windows 客户端后双击打不开，直接弹错误：

ChatGPT failed to start.
Unable to locate the Codex CLI binary.
Set CODEX_CLI_PATH or ensure the client resources include bin/codex.

打开的是 ChatGPT，报的却是 Codex CLI 找不到——新版 ChatGPT 客户端启动时依赖 Codex CLI 二进制。

本文路径：快速修复（30 秒一段命令）→ 一步步排查（可跳读）→ 原理与变体（症状/原因/证据）。赶时间直接跳到「快速修复」。

为什么会这样

客户端启动时要定位 codex 二进制：先找 PATH，再找 CODEX_CLI_PATH 指向的路径，都没有就拒绝启动。常见三种情况：

情况	说明
没装 Codex CLI	`codex --version` 报「不是内部或外部命令」
装了但不在 PATH	安装后未刷新 PATH / PATH 被改
`CODEX_CLI_PATH` 指向错误	变量名写错、路径照抄他人（不同机器安装布局不同）

客户端定位 CLI 二进制是「PATH → 环境变量覆盖」的两级寻址：先在 PATH 里按名字找 codex，找不到再看 CODEX_CLI_PATH 指向的具体路径，两级都落空才拒绝启动。

这个顺序决定了三种失败的语义不同：PATH 没有 = 没装或没刷新 PATH；PATH 有但 CODEX_CLI_PATH 指错 = 变量覆盖了正确寻址（变量优先于 PATH，指向不存在就整体失败）；变量名写错 = 等于没设，退回 PATH 查找。

确定性推论：报「找不到 codex」先 codex --version 直接验证二进制在不在，再 echo $CODEX_CLI_PATH 看变量是否残留；配置里写死路径前先确认 which codex 的输出与机器布局一致（别人的路径不能照抄）；修复顺序：装/刷 PATH 解决 ①②，unset CODEX_CLI_PATH 或改正路径解决 ③。

一步步来

1. 检查 Codex CLI 是否存在 — 排查

codex --version

'codex' 不是内部或外部命令 → 没装或不在 PATH，进第 2 步；返回版本号 → 已装，进第 3 步。

2. 安装 Codex CLI — 必做

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

装完再 codex --version 确认。

3. 配置 CODEX_CLI_PATH（按本机实际路径） — 必做

where codex
setx CODEX_CLI_PATH "C:\Users\<你的用户名>\...\codex.exe"   # 以 where codex 输出为准

路径不要照抄：不同机器/不同安装器版本布局不同（文章默认是 %LOCALAPPDATA%\Programs\OpenAI\Codex\bin\codex.exe，本机实测是 %LOCALAPPDATA%\OpenAI\Codex\bin\<hash>\codex.exe）。变量名必须是 CODEX_CLI_PATH，别写错。

4. 重开客户端 — 必做

环境变量只对新进程生效：完全退出 ChatGPT 客户端（托盘/任务管理器确认无残留）再启动。

怎么确认修好了

codex --version 正常返回版本号；ChatGPT 客户端能正常打开、不再弹 Unable to locate the Codex CLI binary。

其它环境的表现

环境	说明
codex 已在 PATH、未设 CODEX_CLI_PATH	客户端同样正常（本机实测：0.151.0-alpha.7.1 在 PATH，CODEX_CLI_PATH 未设，客户端正常启动）——PATH 满足即可，CODEX_CLI_PATH 是显式兜底
安装脚本	https://chatgpt.com/codex/install.ps1 校园网直连超时（http=000），需网络窗口/代理，本机未实测
未实测	完整「客户端打不开」场景本机未复现（本机客户端正常），修复步骤来自原文实测

症状

ChatGPT Windows 客户端打不开：ChatGPT failed to start. Unable to locate the Codex CLI binary. Set CODEX_CLI_PATH or ensure the client resources include bin/codex.；codex --version 可能报「不是内部或外部命令」。

原因

新版 ChatGPT 客户端启动依赖 Codex CLI 二进制：PATH 里没有 codex，且 CODEX_CLI_PATH 未设置或指向错误 → 客户端拒绝启动。

解法

codex --version 确认是否已装；
未装 → 官方脚本安装：powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"；
where codex 拿真实路径，setx CODEX_CLI_PATH "<真实路径>"（变量名别写错、路径别照抄）；
完全退出客户端（非最小化）再重开。

验证证据

本机验证（2026-08-30，Windows 11）：codex-cli 0.151.0-alpha.7.1 在 PATH（where codex → %LOCALAPPDATA%\OpenAI\Codex\bin\<hash>\codex.exe），CODEX_CLI_PATH 未设但客户端正常启动 → PATH 满足即可、CODEX_CLI_PATH 是显式兜底；实际安装布局与文章默认路径不同（以 where codex 为准）。证据：实测复现日志（2026-08-30）。
未实测：安装脚本（chatgpt.com 校园网直连超时 http=000，需网络窗口）；「客户端打不开」完整场景（本机未复现，步骤来自原文）。

适用工具（1）

本问题方案已挂到下列工具的方案页——从工具页也能回到这里，双向可达。

codex · 外部工具

来源与证据

收录 2026-08-30验证 ✓ 实测验证适用 1 工具

方案含本地实测或来源可复核的解法；未实测项已在文中如实标注。

素材来源：https://blog.51cto.com/kaigejava/14886935

← 编码代理与终端问题域｜问题货架｜遇到其它问题？去问题空间提交求助卡