最近在 Windows 上使用 ChatGPT / Codex Desktop 的同学可能突然遇到这样一个问题昨天还用得好好的今天打开客户端直接启动失败。最典型的提示是ChatGPT failed to start. Unable to locate the Codex CLI binary. Set CODEX_CLI_PATH or ensure the Electron resources include bin/codex.翻译成人话就是客户端启动的时候需要调用 Codex CLI但是突然找不到 Codex CLI 了。我一开始还以为是自己的 Windows 环境变量或者 Node.js 被搞坏了后来排查了一圈才发现这并不完全是个人电脑的问题。截至2026 年 8 月 27 日OpenAI 官方 Codex GitHub 仓库已经出现了多条 Windows 用户反馈。有人在更新到 Windows Codex Desktop26.820.x后直接启动失败报错内容基本就是上面的Unable to locate the Codex CLI binary而且相关 Issue 是2026 年 8 月 26 日刚提交的。所以如果你也是最近突然遇到这个问题先别急着重装 Windows。这篇文章把我的排查过程以及 Windows 下 Codex CLI 最容易遇到的几个问题一次整理清楚。一、这个问题到底是什么先简单解释一下 Codex Desktop 和 Codex CLI 的关系。Codex 不只是一个图形界面程序。它真正执行很多 Agent、Shell、代码操作的底层组件之一是Codex CLI你平时可以直接在 Windows PowerShell 里面运行codex也可以查看版本codex--version而 Codex Desktop 启动的时候也需要找到对应的 Codex CLI 可执行文件。正常情况下这一步应该由客户端自己处理。问题就在这里某些 Windows 版本更新之后Codex Desktop 没有正确找到或者执行自己的codex.exe。于是整个客户端甚至连界面都启动不了。二、先判断你是不是这个问题打开 PowerShell执行codex--version如果正常例如codex-cli 0.147.0说明你的 Codex CLI 本身大概率是存在的。接着执行where.exe codex或者Get-Commandcodex再详细一点Get-Commandcodex|Format-ListSource,Path,CommandType你可能会看到类似C:\Users\你的用户名\AppData\Local\Programs\OpenAI\Codex\bin\codex.exe也有可能看到C:\Users\你的用户名\AppData\Roaming\npm\codex C:\Users\你的用户名\AppData\Roaming\npm\codex.cmd这里非常关键。因为codex.exe和codex.cmd并不是一回事。这也是这次很多人修复失败的原因。三、我的解决方案重新安装 Codex CLI我比较推荐现在 Windows 用户优先使用 Codex 官方提供的独立安装脚本。打开 PowerShellpowershell-ExecutionPolicy ByPass-cirm https://chatgpt.com/codex/install.ps1 | iex这是目前 Codex 官方仓库给出的 Windows 安装方式之一。除此之外官方仍然支持 npmnpm install-g openai/codex安装结束以后关掉当前 PowerShell重新打开一个终端。执行codex--version然后where.exe codex如果看到类似C:\Users\xxx\AppData\Local\Programs\OpenAI\Codex\bin\codex.exe说明 CLI 已经安装成功。四、关键一步设置 CODEX_CLI_PATH如果 CLI 明明存在但 Windows 客户端还是提示Unable to locate the Codex CLI binary那么可以暂时手动告诉 Codex Desktop我的 CLI 就在这里。假设你的路径是C:\Users\xxx\AppData\Local\Programs\OpenAI\Codex\bin\codex.exe执行[Environment]::SetEnvironmentVariable(CODEX_CLI_PATH,C:\Users\xxx\AppData\Local\Programs\OpenAI\Codex\bin\codex.exe,User)然后关闭CodexChatGPTPowerShell重新打开客户端。你也可以先验证$env:CODEX_CLI_PATH如果当前 PowerShell 没刷新环境变量可以新开一个 PowerShell 再执行。还可以直接测试$env:CODEX_CLI_PATH--version如果正常输出版本号codex-cli x.x.x说明这个路径至少是可以正常执行的。五、千万不要把 CODEX_CLI_PATH 指向 codex.cmd这是这次问题里一个非常容易踩的坑。比如很多人运行where.exe codex可能看到C:\Users\xxx\AppData\Roaming\npm\codex C:\Users\xxx\AppData\Roaming\npm\codex.cmd于是直接写setx CODEX_CLI_PATHC:\Users\xxx\AppData\Roaming\npm\codex.cmd看起来完全没问题。但重新启动 Codex Desktop 后又出现spawn EINVAL为什么因为codex.cmd本质上只是 Windows 的一个命令包装脚本。而当前部分 Codex Desktop 版本会尝试直接把它当可执行程序启动。于是失败。2026 年 8 月 26 日提交的一条 Codex 官方仓库 Issue 正好复现了这个问题设置CODEX_CLI_PATH指向codex.cmd后出现spawn EINVAL而改为指向真正的底层原生codex.exe后可以正常启动。所以记住❌ codex.cmd ✅ codex.exe六、如果我是 npm 安装的 Codex真正的 codex.exe 在哪如果你以前执行的是npm install-g openai/codex先查看 npm 全局目录npm root-g例如输出C:\Users\xxx\AppData\Roaming\npm\node_modules然后进入openai\codexWindows x64 下真正的原生 Codex 二进制通常位于平台依赖包里面。可以用 PowerShell 搜索$root npm root-gGet-ChildItem$root-Recurse-Filtercodex.exe-ErrorAction SilentlyContinue|Select-ObjectFullName你应该会找到类似...\openai\codex-win32-x64\vendor\ x86_64-pc-windows-msvc\bin\codex.exe目前的 Windows Desktop 故障案例中也有人通过把CODEX_CLI_PATH直接指向这个底层codex.exe成功绕过了spawn EINVAL。七、为什么不要直接使用 WindowsApps 里的 codex.exe这也是一个坑。有些人会去C:\Program Files\WindowsApps寻找 Codex。例如C:\Program Files\WindowsApps\ OpenAI.Codex_xxxxx\ app\resources\codex.exe文件明明在那里。于是你可能会想那我直接把 CODEX_CLI_PATH 指过去不就行了不一定。因为C:\Program Files\WindowsApps是 Windows 的受保护应用目录。目前已经有用户遇到Access denied也就是拒绝访问官方 Codex Issue 中就有人确认resources\codex.exe实际存在但是直接从 PowerShell 执行时出现程序“codex.exe”无法运行: 拒绝访问因此我不推荐大家去折腾C:\Program Files\WindowsApps更不要为了运行 Codex 随便修改 WindowsApps 所有者修改整个 WindowsApps ACL给目录 Everyone 完全控制删除 WindowsApps 下的文件这样非常容易把 Microsoft Store 应用权限体系搞乱。更稳妥的方案还是额外安装一份用户目录下可正常执行的 Codex CLI。然后让CODEX_CLI_PATH指向它。八、问题 1PowerShell 提示 codex 不是内部或外部命令例如codex : The term codex is not recognized首先运行where.exe codex如果什么都没有npm list-g openai/codex如果同样没有可以直接重新安装powershell-ExecutionPolicy ByPass-cirm https://chatgpt.com/codex/install.ps1 | iex安装以后记得重新打开 PowerShell。因为安装程序更新 PATH 后已经打开的终端未必会立即读取新的环境变量。九、问题 2npm install -g openai/codex 报错例如npm ERR!或者404 Not Found甚至Access token expired or revoked先查看 registrynpm config get registry正常一般应该是https://registry.npmjs.org/如果你以前改过镜像可以先恢复npm configsetregistry https://registry.npmjs.org/然后npm cache verify重新安装npm install-g openai/codexCodex 官方 Issue 里确实有 Windows 用户遇到 npm Token 失效、404 等安装异常。不过现在 Windows 下我更推荐直接使用官方 PowerShell 安装脚本减少 Node/npm 环境带来的额外变量。十、问题 3安装成功但是还是 spawn EINVAL如果你看到spawn EINVAL先检查$env:CODEX_CLI_PATH如果结果是xxx\codex.cmd很可能问题就在这里。找到真正的codex.exe然后重新设置[Environment]::SetEnvironmentVariable(CODEX_CLI_PATH,你的codex.exe完整路径,User)重新启动 Codex Desktop。十一、问题 4Access is denied / 拒绝访问如果执行$env:CODEX_CLI_PATH--version出现Access is denied首先看看这个路径是不是C:\Program Files\WindowsApps\...如果是我建议直接放弃这条路径。重新安装独立 Codex CLIpowershell-ExecutionPolicy ByPass-cirm https://chatgpt.com/codex/install.ps1 | iex然后使用where.exe codex寻找用户目录中的 CLI。十二、问题 5电脑上同时存在三四个 CodexWindows 用户很容易出现这种情况。比如以前npm install-g openai/codex安装过一次。后来又运行irmhttps://chatgpt.com/codex/install.ps1|iex又装了一次。同时 Microsoft Store 里的 Codex Desktop 自己还带一份。如果你还使用 WSLUbuntu 里面可能又装了一份。结果就是Windows npm Codex Windows standalone Codex Windows Desktop bundled Codex WSL Codex四套同时存在。这时候第一件事情不是继续安装。而是where.exe codex以及Get-Commandcodex-All看看系统到底在运行哪个。再检查$env:CODEX_CLI_PATH一个很典型的问题就是PATH 使用的是新 Codex而 CODEX_CLI_PATH 还死死指着旧 Codex。十三、问题 6以前设置过 CODEX_CLI_PATH现在反而启动不了可以先删除变量。PowerShell[Environment]::SetEnvironmentVariable(CODEX_CLI_PATH,$null,User)如果以前设置成系统级[Environment]::SetEnvironmentVariable(CODEX_CLI_PATH,$null,Machine)Machine 级修改通常需要管理员权限。然后重新打开 PowerShellGet-ChildItemEnv:|Where-Object{$_.Name-matchCODEX}确认没有错误的旧路径。重新启动 Codex Desktop 看看能不能自动识别。十四、问题 7切换到 WSL 后突然打不开这个问题现在也比较常见。如果你之前在 Codex Desktop 里面把Agent Environment从Windows改成WSL那么问题会复杂很多。因为这时候会涉及Windows codex.exe以及WSL Linux codex甚至 Codex Desktop 自己生成的 WSL Wrapper。已经有多条 Codex Issue 反馈切换到 WSL Agent Environment 后出现Unable to locate the Codex CLI binary所以如果你根本不需要 WSL建议暂时使用Windows Native减少一层环境映射。如果必须使用 WSL则分别检查 Windowswhere.exe codex以及 WSLwhichcodex codex--version不要默认认为Windows 能执行 codexWSL 就一定能执行。这是两个不同的环境。十五、问题 8Windows Sandbox 初始化失败有些人解决完启动问题后又会遇到codex-windows-sandbox-setup.exe not found或者windows sandbox failed甚至CreateProcessWithLogonW failed这属于另外一类 Windows Codex 问题。最近的官方 Issue 里也出现过独立安装器安装成功但是 Sandbox Helper 没有正确放到运行时预期目录的问题。可以先运行codex doctor--summary--ascii查看runtime bin resources install consistent到底是否正常。如果只是为了先确定 Codex CLI 能否运行可以先测试codex--version启动问题和 Sandbox 问题不要混在一起排查。十六、问题 9客户端更新以后突然坏了如果昨天正常今天更新 Codex Desktop 后突然打不开。那我反而建议不要第一时间删除 Node、重装 Git、重装 WSL。因为这次确实出现了明显的 Windows Desktop 回归案例。例如26.820.60940和26.820.7780.0都有人报告启动阶段无法正确定位 Codex CLI。最好的排查顺序应该是客户端 ↓ CODEX_CLI_PATH ↓ Codex CLI ↓ PATH ↓ npm / Node ↓ WSL而不是直接把整个开发环境删掉。十七、问题 10重装客户端为什么还是没用因为真正的问题可能根本不在客户端配置文件。例如CODEX_CLI_PATH属于环境变量。你卸载 Codex Desktop环境变量依然存在再重新安装它又读到了原来的错误 CODEX_CLI_PATH所以你感觉怎么重装三遍都一样这时候应该检查$env:CODEX_CLI_PATH以及[Environment]::GetEnvironmentVariable(CODEX_CLI_PATH,User)十八、我推荐的一套完整修复流程如果你不想研究上面的原理可以直接按照下面这一套走。第一步检查 Codexcodex--version第二步检查路径where.exe codex第三步如果没有 Codex重新安装powershell-ExecutionPolicy ByPass-cirm https://chatgpt.com/codex/install.ps1 | iex第四步重新打开 PowerShell然后codex--version第五步获取真正的 exe(Get-Commandcodex).Source最好得到类似C:\Users\xxx\AppData\Local\Programs\OpenAI\Codex\bin\codex.exe第六步测试 exe$codex(Get-Commandcodex).Source $codex--version第七步设置 CODEX_CLI_PATH$codex(Get-Commandcodex).Source[Environment]::SetEnvironmentVariable(CODEX_CLI_PATH,$codex,User)第八步重启 Codex Desktop这里要真正退出程序以后重新打开。十九、可以直接复制的 PowerShell 排查脚本如果你想一次查看关键环境可以直接运行Write-Host Codex Version try{codex--version}catch{Write-HostCodex command not found}Write-Hostn Where Codex where.exe codex 2$nullWrite-Hostn Get-Command Get-Commandcodex-All-ErrorAction SilentlyContinue|Format-ListSource,Path,CommandTypeWrite-Hostn CODEX_CLI_PATH Write-Host$env:CODEX_CLI_PATHWrite-Hostn User CODEX_CLI_PATH [Environment]::GetEnvironmentVariable(CODEX_CLI_PATH,User)Write-Hostn Node node--versionWrite-Hostn npm npm--versionWrite-Hostn npm root npm root-g很多 Codex Windows 环境问题跑完这一段基本就能看出端倪。二十、最后总结这次 Windows 上出现ChatGPT failed to start以及Unable to locate the Codex CLI binary不一定是你的 Windows 坏了。目前已经有多个用户在 Codex 官方 GitHub 仓库反馈相似问题而且集中出现在近期 Windows Desktop 版本更新之后。我建议优先记住三个原则。第一先确认 codex.exe 能不能单独运行。第二CODEX_CLI_PATH 尽量指向真正的 codex.exe 不要指向 codex.cmd。第三不要随便修改 C:\Program Files\WindowsApps 权限。我这次最终采用的处理方式就是重新安装一份 Windows 原生 Codex CLI ↓ 确认 codex.exe 可以运行 ↓ 找到真正的 codex.exe ↓ 设置 CODEX_CLI_PATH ↓ 重新启动 Codex Desktop如果只是这次典型的Unable to locate the Codex CLI binary问题这套方式是目前比较值得优先尝试的临时解决方案。不过需要说明的是截至2026 年 8 月 27 日相关 Windows Issue 仍然处于 Open 状态因此这更准确地说是一个绕过当前客户端问题的恢复方案后续客户端版本仍可能由 OpenAI 从根本上修复。参考资料OpenAI Codex 官方 GitHubWindows Codex CLI 安装方式。Codex Windows Desktop26.820.60940启动失败及spawn EINVAL问题。Codex Windows Desktop26.820.7780.0无法执行内置 CLI 问题。Codex Windows / WSL CLI 路径问题。Codex Windows Sandbox Helper 相关问题。