Codex CLI 更新教程：升级前检查与版本验证

TL;DR：先记录版本，再升级，再验证真实任务

Codex CLI 更新前先记录当前版本、安装位置和项目状态；升级后重新运行版本、帮助和一个只读任务。官方帮助中心给出了 codex --upgrade 和 npm 安装方式，但具体命令和可用参数会随版本变化，应以当前官方说明为准。

第一步：记录当前环境

codex --version
which codex
node --version
npm --version
git status --short

Windows PowerShell 可以使用：

codex --version
Get-Command codex
node --version
npm --version
git status --short

把输出中的版本号、安装路径和当前分支记录下来。不要把包含密钥的环境变量直接复制到记录文件。

第二步：选择一种升级方式

如果当前版本支持自更新，可以先执行官方帮助页推荐的命令：

codex --upgrade

如果你的安装来源是 npm，也可以按官方文档重新安装：

npm install -g @openai/codex

不要在同一台机器上混用多个 Node.js 版本管理器、系统包管理器和 npm 全局目录。升级后如果 which codex 指向旧路径，优先解决 PATH 顺序，而不是重复安装很多次。

第三步：完成升级后的验证

codex --version
codex --help
codex "只读取当前项目的 README，说明测试命令，不要修改文件"

若项目有固定的质量检查，再运行项目已有命令：

npm run typecheck
npm test

上面两条命令只是示例，必须根据项目的 package.json 和 README 替换。升级工具不应自动改变项目依赖或生产配置。

团队项目的升级策略

| 场景 | 建议 | | --- | --- | | 个人本地使用 | 记录版本，升级后做一次只读任务 | | 多人协作 | 在规则文件中记录推荐版本和验证命令 | | CI 或自动化脚本 | 固定版本并在变更记录中说明升级原因 | | 升级后出现异常 | 保存版本和错误文本，先回到 网络排错 或 401 排错 |

常见报错与解决

| 现象 | 常见原因 | 处理方式 | | --- | --- | --- | | codex --version 没变化 | 终端仍解析旧路径 | 比较 which codex 或 Get-Command codex 的路径 | | npm 报权限错误 | 全局目录属于其他用户 | 优先使用 Node 版本管理器，不要直接用 sudo 掩盖问题 | | 升级后参数不存在 | CLI 参数发生变化 | 先运行 codex --help，以当前帮助输出为准 | | 升级后登录失效 | 本地认证状态或账号路径变化 | 重新确认登录路径，必要时查看 CLI 登录教程 |

FAQ：Codex CLI 更新前后怎么检查

Codex CLI 需要每次都更新到最新版吗？

不需要。个人环境可以跟随稳定版本，团队和自动化环境更适合记录并固定经过验证的版本。

codex --upgrade 和 npm 安装能同时使用吗？

不建议混用。先确认当前安装来源，再选择一种升级方式，避免多个全局目录互相覆盖。

升级会修改我的项目代码吗？

升级 CLI 本身不应直接修改项目代码，但升级后的任务可能产生不同的修改结果，所以仍应在 Git 分支中验证。

升级后出现 429 怎么办？

先暂停重复请求，记录版本、任务规模和错误时间，再按 429 排错指南 检查频率、并发和额度边界。

升级完成后，建议重新阅读 Codex 第一次任务教程 和 Codex 官方工作流。