最快更新：一行命令
# 更新到最新版（推荐）
$ npm install -g @openai/codex@latest
# 确认版本已更新
$ codex --version$ brew upgrade codex
$ codex --version升级完成后，配置文件 ~/.codex/config.toml 和认证信息 ~/.codex/auth.json 不会被修改——通常无需重新配置或重新登录。
查看当前版本
# 查看 codex 版本
$ codex --version
# 查看 npm 全局安装版本（更详细）
$ npm list -g @openai/codex
# 查看 npm 仓库上的最新版本（对比当前）
$ npm view @openai/codex version锁定特定版本
有时你需要使用特定版本——比如某个新版本引入了破坏性变更，或者 CI/CD 环境需要版本确定性：
# 安装特定版本（替换 x.x.x 为目标版本号）
$ npm install -g @openai/[email protected]
# 查看可用版本列表
$ npm view @openai/codex versions --json
# CI 中锁定版本（确保可重复性）
$ npm install -g @openai/[email protected] --exactCI/CD 中的版本管理
在 GitHub Actions 或 GitLab CI 中安装 Codex CLI 时，建议明确指定版本而非用 latest，以确保流水线稳定可重复：
steps:
- name: Install Codex CLI
run: npm install -g @openai/[email protected]
# 或者用 latest 接受自动升级
# run: npm install -g @openai/codex@latest2026 年重要版本变更速查
| 时间 | 变更内容 | 影响 |
|---|---|---|
| 2026 年 2 月 | 移除 Chat Completions API 支持 | 所有 provider 必须改用 wire_api = "responses"；使用自定义第三方 API 的用户需更新 config.toml |
| 2026 年 Q1 | 新增 codex-mini-latest (o4-mini) 作为默认模型 |
旧版配置中写死的 model ID 可能失效，建议检查 config.toml 中的 model 字段 |
| 2025 年下半年 | AGENTS.md /init 命令上线 |
新功能，可运行 /init 生成项目默认 AGENTS.md |
| 2025 年 4 月 | 初始开源发布 | 基础功能建立 |
使用自定义 provider 的用户注意：如果你在 config.toml 中配置了自定义 [model_providers]，升级跨越 2026 年 2 月这个里程碑后，需要在每个 provider 配置中添加 wire_api = "responses"，否则会报配置错误。详见 config.toml 配置指南。
升级后遇到问题？
升级后仍然显示旧版本号
# 确认 npm 全局安装路径是否在 PATH 里
$ npm root -g
# 查看哪个 codex 在被执行
$ which codex
# 如果有多个版本，重启终端或强制重新 hash
$ hash -r # bash/zsh升级后 Reconnecting
升级本身不会导致 Reconnecting——如果升级后出现连接问题，通常是同一类代理或网络问题。参考：Reconnecting 完整排查指南。
升级后 config.toml 报错
跨大版本升级时，config.toml 的某些字段可能已变更。遇到配置报错时：
- 先暂时重命名 config.toml（
mv ~/.codex/config.toml ~/.codex/config.toml.bak） - 用默认配置运行 codex，确认基本功能正常
- 再逐项把旧配置迁移到新格式
查看官方发布记录了解每个版本的完整变更内容：GitHub Releases ↗。
常见问题
如何更新 Codex CLI 到最新版？
运行 npm install -g @openai/codex@latest，升级完成后用 codex --version 确认。Homebrew 用户：brew upgrade codex。
如何查看当前版本号？
运行 codex --version 或 npm list -g @openai/codex。
升级后需要重新配置吗？
通常不需要。~/.codex/config.toml 和 auth.json 在升级时不会被修改。但如果跨越了重大版本变更（如 2026 年 2 月的 wire_api 变更），需要检查 config.toml 的兼容性。
能不能自动检测并更新 Codex？
可以把升级命令加入 cron 或 shell 别名。比如在 ~/.zshrc 中加一个别名：alias codex-update="npm install -g @openai/codex@latest && codex --version"，需要更新时直接输入 codex-update。