问题现象: 在运行 Codex CLI 相关命令时,系统提示 CODEX_CLI_PATH 环境变量不存在或无效,导致 ChatGPT 桌面应用无法正常调用 Codex 功能。本文提供两套修复方案,适用于 Windows 系统。

方案一:手动重建环境变量(推荐优先尝试)
此方案适用于您之前已安装过 Codex CLI,且本地仍保留有 codex.exe 可执行文件的情况。
前置操作:
在Windows设置中,选择安装的应用,找到ChatGPT并点击高级选项,先点击“修复”按钮(该操作会尝试自动恢复路径,但若失败,则需手动干预)。

步骤 1:定位 codex.exe 的准确路径
打开 PowerShell(以管理员身份运行非必须),执行以下命令递归搜索:
Get-ChildItem "$env:LOCALAPPDATA" -Recurse -Filter codex.exe -ErrorAction SilentlyContinue | Select-Object -ExpandProperty FullName
系统会输出类似路径:
C:\Users\你的用户名\AppData\Local\OpenAI\Codex\bin\某个随机名称\codex.exe
请完整复制该路径,后续步骤会用到。
步骤 2:查看当前环境变量值(可选,用于诊断)
在 PowerShell 中输入:
$env:CODEX_CLI_PATH
若返回空或错误路径,说明变量确实丢失或损坏。
步骤 3:通过 PowerShell 永久设置用户环境变量
将上一步获得的真实路径填入以下命令(注意路径中的反斜杠需正确转义或直接使用单引号括起):
[Environment]::SetEnvironmentVariable(
"CODEX_CLI_PATH",
"C:\Users\你的用户名\AppData\Local\OpenAI\Codex\bin\xxx\codex.exe",
"User"
)
执行后,变量即被写入当前用户的注册表项。
步骤 4:重启 ChatGPT 桌面应用
完全退出程序并重新启动,此时 Codex 功能应恢复正常。
若问题依旧,请转用方案二。
方案二:通过 NPM 重新安装并配置 Codex CLI
当本地文件损坏或路径无法找回时,建议完全重装。
1. 全局安装 Codex CLI
在 PowerShell 中执行:
npm install -g @openai/codex
2. 查找新安装的 codex.exe 完整路径
Node.js全局模块通常位于 node_global 目录下。请根据您的 Node.js 实际安装位置修改搜索根路径(示例为 D:\Develop\Nodejs\node_global):
Get-ChildItem "D:\Develop\Nodejs\node_global\node_modules\@openai\codex" -Recurse -Filter "codex.exe" -ErrorAction SilentlyContinue | Select-Object -ExpandProperty FullName
记录输出路径。
3. 设置环境变量
将上一步得到的路径填入(以实际路径为准):
[Environment]::SetEnvironmentVariable(
"CODEX_CLI_PATH",
"D:\Develop\Nodejs\node_global\node_modules\@openai\codex\bin\codex.exe",
"User"
)
4. 重启 ChatGPT,验证是否正常。
验证是否修复成功
重新打开 PowerShell,执行:
$env:CODEX_CLI_PATH
若返回正确的 .exe 路径,且 ChatGPT 中 Codex 功能可用,则修复完成。
注意事项
- 若您的 Node.js 安装在
C:\Program Files等受保护目录,请务必以管理员身份运行 PowerShell 来执行设置命令。 - 修改环境变量后,建议注销并重新登录 Windows 或重启资源管理器,以确保所有应用加载新变量。
- 若同时安装了多个版本的 Codex,请确保
CODEX_CLI_PATH指向您期望使用的那个版本。

Comments NOTHING