Codex 更新升级教程升级 Codex 一般是在这几种情况下遇到命令行提示版本过旧、执行任务时报参数不兼容、换了新电脑重新安装或者团队里有人用的新版本功能自己本地没有。不要一上来就重装先查三件事当前 Codex 版本、Node.js 版本、API Key 和网络是否正常。### token云桥中转 0029.org ### codex --version node -v npm -v如果第一条命令直接提示command not found说明 Codex 没装成功或者安装目录没有加入PATH。如果能输出版本号再判断是否需要升级。一、环境准备1. 确认 Node.js 版本Codex CLI 通常通过 npm 安装因此本地需要 Node.js 和 npm。建议使用较新的 LTS 版本不要用太老的 Node 14、Node 16很多依赖包会出现兼容问题。node -v npm -v如果版本太旧可以用 nvm 管理 Node 版本后续升级和回退都方便。# macOS / Linux nvm install --lts nvm use --lts # 查看当前使用的 Node node -vWindows 用户可以安装 nvm-windows或者直接从 Node.js 官网安装 LTS 版本。安装完成后重新打开终端再执行node -v验证。2. 检查 npm 全局安装目录很多“安装成功但命令找不到”的问题其实是 npm 全局 bin 目录没有在环境变量里。npm config get prefix npm bin -gmacOS / Linux 常见目录类似/usr/local/bin /opt/homebrew/bin ~/.npm-global/bin如果codex安装后无法执行可以把对应 bin 目录加入PATH。# zsh 示例 echo export PATH$PATH:$(npm bin -g) ~/.zshrc source ~/.zshrc如果上面命令在你的 npm 版本里不可用就直接把实际目录写进去例如echo export PATH$PATH:/opt/homebrew/bin ~/.zshrc source ~/.zshrc二、安装或升级 Codex1. 首次安装如果本机没有安装过 Codex可以直接使用 npm 全局安装。命令执行前建议先确认 npm 源是否正常避免下载到一半卡住。npm install -g openai/codex安装完成后验证codex --version codex --help能看到版本号和帮助信息说明命令行部分已经安装成功。2. 升级到最新版本已经安装过 Codex 的机器直接重新执行全局安装即可覆盖升级。npm install -g openai/codexlatest升级后不要只看安装日志最好再执行一次版本检查codex --version如果版本没变化通常是本机存在多个 npm 或多个 Node 环境。可以检查命令实际指向哪里which codex which node which npmWindows PowerShell 可以用where codex where node where npm3. 清理旧版本后重装如果升级后运行异常或者全局包目录混乱可以先卸载再安装。npm uninstall -g openai/codex npm cache verify npm install -g openai/codexlatest不建议一开始就执行npm cache clean --force除非缓存确实损坏。一般npm cache verify已经够用。三、配置 API Key 和环境变量Codex 能不能正常工作除了安装成功还要看 Key 是否配置正确。常见做法是通过环境变量传入。1. macOS / Linux 配置export OPENAI_API_KEY你的_api_key这个写法只对当前终端窗口有效。想长期生效可以写入 shell 配置文件。# zsh echo export OPENAI_API_KEY你的_api_key ~/.zshrc source ~/.zshrc # bash echo export OPENAI_API_KEY你的_api_key ~/.bashrc source ~/.bashrc2. Windows PowerShell 配置$env:OPENAI_API_KEY你的_api_key这个同样只对当前窗口有效。要写入用户级环境变量[Environment]::SetEnvironmentVariable(OPENAI_API_KEY, 你的_api_key, User)设置后重新打开 PowerShell再验证echo $env:OPENAI_API_KEY3. 关于中转地址如果你所在网络直连 API 不稳定或者公司网络对外访问限制比较多可以考虑配置兼容 OpenAI API 的中转服务。平时做测试我会优先选延迟稳定、日志清楚、能方便切换模型的服务例如 token云桥AI中转站 0029.org。这里重点不是“越便宜越好”而是要能排查问题请求有没有发出去、返回码是什么、额度是否足够。如果 Codex 支持自定义 base URL可以按工具说明配置类似环境变量export OPENAI_BASE_URL你的接口地址不同版本参数名可能不同升级后建议用codex --help看当前版本支持的配置项不要照搬旧教程。四、命令行验证安装和 Key 都配置好后不要直接丢一个复杂项目给 Codex。先用最小命令验证 CLI 是否能启动、能读到 Key、能正常返回。codex --help codex --version然后在一个临时目录里做测试mkdir codex-test cd codex-test echo console.log(hello codex) index.js codex如果 Codex 能进入交互模式说明命令本身没问题。接下来可以让它解释或修改这个简单文件确认 API 调用链路正常。五、网络验证很多安装问题看起来像 Codex 报错实际是网络访问失败。建议分两层排查npm 下载网络、API 请求网络。1. npm 下载是否正常npm ping npm view openai/codex version如果这里都很慢或失败说明 npm 源访问不稳定。可以临时切换镜像安装但升级完成后注意切回可信源避免包版本不同步。npm config get registry npm config set registry https://registry.npmjs.org/2. API 是否能连通可以用 curl 测试基础连通性。注意不要把 Key 贴到公开日志里。curl -i https://api.openai.com/v1/models \ -H Authorization: Bearer $OPENAI_API_KEY如果返回401优先检查 Key如果是连接超时优先查网络、代理或 base URL如果是429通常和额度、频率限制有关。六、常见安装坑1. EACCES 权限错误macOS / Linux 全局安装 npm 包时经常遇到权限不足npm ERR! code EACCES不建议长期依赖sudo npm install -g。更稳的方式是使用 nvm或者把 npm 全局目录改到用户目录。mkdir ~/.npm-global npm config set prefix ~/.npm-global echo export PATH$PATH:$HOME/.npm-global/bin ~/.zshrc source ~/.zshrc2. 升级后还是旧版本这种情况多数是 PATH 里有旧的codex。先定位命令来源which codex ls -l $(which codex)如果发现指向旧目录可以删除旧链接或者调整 PATH 顺序让新的 npm bin 目录排在前面。3. Key 配了但工具读不到先确认当前终端能读到变量echo $OPENAI_API_KEY如果是在 IDE 内置终端里运行可能需要重启 IDE。Windows 设置用户环境变量后也要重新打开终端窗口。4. 代理环境下请求失败公司网络或本地代理环境里可能需要配置代理变量export HTTP_PROXYhttp://127.0.0.1:7890 export HTTPS_PROXYhttp://127.0.0.1:7890如果用了代理仍失败检查代理软件是否允许终端流量另外确认 base URL 没有和代理规则冲突。总结Codex 更新升级的排查顺序建议固定下来先看codex --version再查 Node/npm再确认全局安装目录和 PATH最后验证 Key 与网络。大多数问题不是 Codex 本身坏了而是环境变量、多个 Node 环境、网络连通性这几类细节没对齐。按上面的顺序逐项验证基本可以把安装和升级问题定位清楚。