Windows 11 更新 ChatGPT / Codex 后提示 Unable to locate the Codex CLI binary 或者 打开无界面但有进程的解决方法

问题现象在 Windows 11 上更新新版 ChatGPT / Codex Desktop 后部分用户会遇到 Codex 无法正常启动的问题并出现如下提示Unable to locate the Codex CLI binary. Set CODEX_CLI_PATH or ensure the Electron resources include bin/codex.这个问题有一个比较明显的特点卸载、重装、清理.codex、删除 npm 版本 Codex 等操作很多情况下都无法解决。目前 OpenAI Codex GitHub 仓库已经有多个类似问题报告。2026 年 8 月 26 日也有用户反馈 Windows 11 更新 Desktop App 后直接出现相同错误并且重新安装不能从根本上解决。一、为什么卸载重装可能没用这个错误看起来像Codex CLI 没安装。但实际上很多情况下codex.exe已经存在于 ChatGPT / Codex Desktop 的安装目录中。例如 Microsoft Store / MSIX 版本通常位于C:\Program Files\WindowsApps\OpenAI.Codex_xxx\app\resources\codex.exe也就是说codex.exe实际上存在但新版 Desktop App 在更新之后没有正确定位或启动这个 CLI。GitHub 上已经有案例确认app\resources\codex.exe明明存在但 Desktop App 仍然提示Unable to locate the Codex CLI binary因此单纯卸载重装并不一定有效。二、先确认自己的 Codex 安装位置打开PowerShell执行$pkg Get-AppxPackage OpenAI.Codex $pkg | Select-Object Version, InstallLocation例如我的电脑输出Version InstallLocation ------- --------------- 26.820.7780.0 C:\Program Files\WindowsApps\OpenAI.Codex_26.820.7780.0_x64__2p2nqsd0c76g0说明当前安装目录是C:\Program Files\WindowsApps\OpenAI.Codex_26.820.7780.0_x64__2p2nqsd0c76g0三、确认codex.exe是否存在继续在 PowerShell 执行Test-Path $($pkg.InstallLocation)\app\resources\codex.exe如果返回True说明 Windows 版本的 Codex CLI 实际已经包含在安装包中。还可以顺便检查 WSL/Linux 版本Test-Path $($pkg.InstallLocation)\app\resources\codex如果也是True说明安装包同时包含codex.exe和codex两个版本。其中codex.exe是 Windows CLI。而没有扩展名的codex主要用于 Linux / WSL 环境。四、解决方法手动设置CODEX_CLI_PATH目前社区中比较简单、有效的临时解决方案是直接告诉 Desktop Appcodex.exe到底在哪里。首先动态获取自己电脑上的路径$pkg Get-AppxPackage OpenAI.Codex $codexPath Join-Path $pkg.InstallLocation app\resources\codex.exe $codexPath例如可能得到C:\Program Files\WindowsApps\OpenAI.Codex_26.820.7780.0_x64__2p2nqsd0c76g0\app\resources\codex.exe然后设置 Windows用户环境变量[Environment]::SetEnvironmentVariable( CODEX_CLI_PATH, $codexPath, User )实际上也可以直接一次完成$pkg Get-AppxPackage OpenAI.Codex $codexPath Join-Path $pkg.InstallLocation app\resources\codex.exe [Environment]::SetEnvironmentVariable( CODEX_CLI_PATH, $codexPath, User )这样不用自己填写版本号。五、验证环境变量是否设置成功执行[Environment]::GetEnvironmentVariable( CODEX_CLI_PATH, User )正常应该输出类似C:\Program Files\WindowsApps\OpenAI.Codex_26.820.7780.0_x64__2p2nqsd0c76g0\app\resources\codex.exe然后继续执行Test-Path ( [Environment]::GetEnvironmentVariable( CODEX_CLI_PATH, User ) )如果返回True说明CODEX_CLI_PATH已经设置成功指向的文件确实存在。六、重新启动 ChatGPT / Codex设置环境变量后不要直接在原来的进程里测试。建议完全退出 ChatGPT / Codex打开任务管理器确认 ChatGPT、Codex 等相关进程已经结束重新打开 ChatGPT。如果仍然读取不到环境变量可以直接重启 Windows再启动 ChatGPT。因为已经启动的 Electron 进程不一定能够读取后续新增的用户环境变量。七、也可以通过 Windows 图形界面设置如果不想使用 PowerShell按Win R输入sysdm.cpl然后进入高级 → 环境变量 → 用户变量 → 新建变量名CODEX_CLI_PATH变量值填写自己电脑实际的...\app\resources\codex.exe例如C:\Program Files\WindowsApps\OpenAI.Codex_26.820.7780.0_x64__2p2nqsd0c76g0\app\resources\codex.exe保存以后重新启动 ChatGPT。八、不要把CODEX_CLI_PATH指向codex.cmd这一点比较重要。如果电脑之前通过 npm 安装过npm install -g openai/codex执行where.exe codex可能看到D:\nvm4w\nodejs\codex D:\nvm4w\nodejs\codex.cmd不建议把CODEX_CLI_PATH设置成D:\nvm4w\nodejs\codex.cmdGitHub 上已经有报告表明Electron 直接启动.cmdwrapper 时可能出现spawn EINVAL因此应当直接指向真正的codex.exe而不是codex.cmd。九、如果使用 WSL需要额外注意如果之前在 ChatGPT / Codex 中开启了Agent Environment → WSL那么这个问题可能还涉及另外一个 Windows/MSIX Bug。可以执行$pkg Get-AppxPackage OpenAI.Codex (Get-Item $($pkg.InstallLocation)\app\resources\codex).Attributes如果返回Archive, Encrypted那么你很可能遇到了目前社区已经确认的Windows MSIX / Application Protected 文件复制失败问题。Codex Desktop 在 WSL 模式下需要把app\resources\codex复制到类似%USERPROFILE%\.codex\bin\wsl\的位置。但因为 WindowsApps 中的文件被标记为Encrypted复制过程中可能触发ERROR_ENCRYPTION_FAILED 0x80071770最终 Desktop App 却只显示Unable to locate the Codex CLI binary这也是目前 OpenAI Codex GitHub 上已经确认存在的问题。因此CODEX_CLI_PATH...\codex.exe目前更适合作为Windows Desktop 能够启动的临时 workaround。如果高度依赖真正的 WSL Agent 环境需要注意它不一定彻底解决 WSL 二进制 relocation 问题。