Codex command not found 的典型现象这个问题一般出现在刚装完 Codex CLI或者换了新终端、新机器之后。你在命令行里执行### token云桥中转 0029.org ### codex --version结果提示类似下面这样zsh: command not found: codex或者在 Linux 里看到bash: codex: command not foundWindows PowerShell 里可能是codex : The term codex is not recognized as the name of a cmdlet这类错误的核心意思很简单当前终端找不到名为codex的可执行命令。优先不要怀疑接口、账号或者模型配置先查安装是否成功、命令是否在 PATH 里。先判断到底是没安装还是 PATH 没生效1. 查看当前系统能不能找到 codexmacOS / Linux 执行which codex如果没有任何输出说明系统当前 PATH 里找不到它。Windows PowerShell 执行Get-Command codex如果提示找不到命令也基本可以确定不是 Codex 本身运行报错而是命令入口没有被识别。2. 确认 Node.js 和 npm 是否正常很多 Codex CLI 是通过 npm 全局安装的所以先确认 Node 环境node -v npm -v如果这里都报错先安装 Node.js。建议使用 LTS 版本不要用太旧的 Node否则后面即使装上了 CLI也可能因为运行时版本不兼容继续报错。常见原因和修复步骤原因一根本没有安装 Codex CLI如果你是按照 npm 方式安装可以重新执行一次全局安装npm install -g openai/codex安装结束后再验证codex --version如果还是提示 command not found不要重复安装很多遍继续看 npm 全局 bin 路径。原因二npm 全局 bin 目录不在 PATH查看 npm 全局命令安装位置npm bin -g部分 npm 版本可能不支持这个命令可以用npm config get prefixmacOS / Linux 下全局命令通常在类似这些目录/usr/local/bin /opt/homebrew/bin ~/.npm-global/bin ~/.nvm/versions/node/v20.x.x/bin如果codex已经安装在某个目录里但这个目录不在 PATH就会出现 command not found。查看当前 PATHecho $PATH假设你的 npm 全局 bin 是~/.npm-global/bin可以把它加入 shell 配置。zsh 用户编辑~/.zshrcexport PATH$HOME/.npm-global/bin:$PATHbash 用户编辑~/.bashrc或~/.bash_profileexport PATH$HOME/.npm-global/bin:$PATH然后让配置立即生效source ~/.zshrc或者source ~/.bashrc原因三使用 nvm 后切换 Node 版本导致命令丢失如果你用的是 nvmCodex CLI 是安装在某个 Node 版本下面的。切换 Node 版本后全局包不一定还在。nvm current npm list -g --depth0如果列表里没有openai/codex在当前 Node 版本下重新安装npm install -g openai/codex另外建议设置默认 Node 版本避免每次打开终端版本不一致nvm alias default 20原因四Windows 环境变量没有刷新Windows 上 npm 全局路径一般类似C:\Users\你的用户名\AppData\Roaming\npm安装完成后如果当前 PowerShell 仍然找不到命令先关闭终端重新打开。还不行的话检查系统环境变量 Path 中是否包含上面的 npm 路径。可以用下面命令查看 npm prefixnpm config get prefix正常情况下npm 全局可执行文件所在目录需要加入 Path。改完环境变量后建议重新打开 PowerShell 或 Windows Terminal 再测试。接口配置问题不要和 command not found 混在一起command not found只说明命令没找到还没到调用接口那一步。等codex --version能正常输出后再去处理 API Key、Base URL、网络代理等问题。如果你在公司网络、国内服务器或者多工具共用 API 的环境里折腾 Codex建议把接口转发和 Key 管理单独整理好。我自己排查这类工具时会优先选一个稳定的中转入口做测试比如 token云桥AI中转站 0029.org主要是方便快速判断问题到底在本地 CLI、网络还是上游接口配置不用每次都把排错范围拉得很大。修复后的验证方式建议按下面顺序验证不要只测最后一步which codex codex --versionWindows 用Get-Command codex codex --version如果版本号能输出说明命令入口已经正常。接着可以查看帮助信息codex --help帮助信息能正常显示基本可以确认 CLI 本身可执行。后续如果再报认证失败、请求失败、模型不可用那就是另一个层面的配置问题了。避免以后再次出现不要频繁混用系统 Node、nvm、Homebrew Node容易导致全局包装到不同位置。安装 CLI 后顺手执行一次which codex或Get-Command codex记录实际路径。团队环境里建议固定 Node LTS 版本并在项目文档里写清楚安装方式。修改 PATH 后一定要重开终端很多 command not found 只是旧会话没有刷新。CI、服务器、容器环境中不要假设本地装过全局依赖要在部署脚本里显式安装。总结Codex command not found的排查顺序很固定先确认 Node/npm再确认 Codex CLI 是否安装然后检查 npm 全局 bin 是否进入 PATH。能执行codex --version之后再去处理 API Key、代理和接口地址。不要一上来就改模型配置这个错误大多数时候只是本地命令路径问题。