问题现象

更新或重新安装 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_Installer.exe 可能只提示“已安装最新版本”，并不会修复缺失的 CLI。

原因

ChatGPT 桌面程序没有找到其所需的 Codex CLI。可安装独立 Codex CLI，并将环境变量 CODEX_CLI_PATH 指向真正的 codex.exe。

注意：环境变量名称必须是 CODEX_CLI_PATH，中间没有空格。

修复步骤

使用 Windows PowerShell 依次执行以下命令。

1. 检查 Node.js 和 npm

node --version
npm --version

如果命令不存在，先安装 Node.js LTS，然后重新打开 PowerShell。

2. 安装或更新 Codex CLI

npm install -g @openai/codex@latest
codex --version

3. 查找真正的 codex.exe

$npmRoot = npm root -g

$codexExe = (
    Get-ChildItem "$npmRoot\@openai\codex" `
        -Recurse `
        -Filter "codex.exe" `
        -ErrorAction SilentlyContinue |
    Select-Object -First 1
).FullName

$codexExe

正常情况下会输出一个以 codex.exe 结尾的完整路径。

4. 验证该文件

Test-Path $codexExe
& $codexExe --version

若分别显示 True 和 Codex CLI 版本号，说明路径有效。

5. 设置永久环境变量

[Environment]::SetEnvironmentVariable(
    "CODEX_CLI_PATH",
    $codexExe,
    "User"
)

检查设置结果：

[Environment]::GetEnvironmentVariable(
    "CODEX_CLI_PATH",
    "User"
)

6. 重启应用

完全退出 ChatGPT，并在任务管理器中结束残留的 ChatGPT 进程。随后重启电脑，再打开 ChatGPT。

注意事项

• 命令应在 PowerShell 中执行，不要在传统 CMD 中执行。
• 普通用户 PowerShell 即可，一般不需要管理员权限。
• CODEX_CLI_PATH 应指向真正的 codex.exe，不要手动指向 codex.cmd。
• 此操作不会删除原有聊天、项目、设置或 %USERPROFILE%\.codex 中的数据。
• 如果第 3 步没有输出路径，可检查：

npm root -g
npm list -g @openai/codex

官方参考

OpenAI Codex CLI 官方指南