Codex 更新与升级失败排错
更新前先确认你正在使用哪一个程序：ChatGPT/Codex 桌面应用、Codex CLI 或 Code8 Manager。它们有各自的版本号和更新渠道，更新其中一个不会自动更新另外两个。
先记录当前版本
Codex CLI 可以运行：
codex --version
桌面应用和 Code8 Manager 的版本应从各自的“设置”“关于”或安装信息中查看。排错时把更新前后的版本号和完整错误提示一起记录下来。
先确认安装来源
| 程序 | 常见安装来源 | 更新方式 |
|---|---|---|
| Codex CLI | 官方脚本 | 重新运行当前官方安装脚本 |
| Codex CLI | npm 全局包 | npm install -g @openai/codex@latest |
| Windows 桌面应用 | Microsoft Store / 组织部署 | 由商店或管理员维护 |
| Code8 Manager | Code8 下载入口 | 下载当前安装器覆盖安装 |
同一程序混用多个安装来源，最容易出现“更新成功但版本没变”。先用 Get-Command codex -All 找出实际执行文件，再更新对应来源。
Codex CLI 怎么更新
使用内置更新入口
部分 Codex CLI 版本支持自更新命令。先查看帮助：
codex --help
如果当前版本列出了 update，再运行：
codex update
没有该命令时，应按最初的安装渠道更新，不要混用多个渠道覆盖同一个可执行文件。
npm 安装的 CLI
npm install -g @openai/codex@latest
codex --version
如果更新后仍显示旧版本，检查系统中是否存在多个 codex：
Get-Command codex -All
官方脚本安装的 CLI
重新运行当前官方安装文档提供的脚本，然后打开一个新终端验证版本。安装命令应以 Codex CLI 官方文档 为准。
Windows 桌面应用怎么更新
从 Microsoft Store 安装的应用通常由商店维护更新。也可以先查看 winget 能否识别升级：
winget upgrade --id 9PLM9XGG6VKS -s msstore
如果企业设备由管理员集中部署，应使用组织指定的更新渠道，不要自行安装另一个来源的副本。
Code8 Manager 怎么更新
先在 Manager 中查看版本或更新提示。如果没有内置更新入口，可以从本站固定入口下载当前安装器并覆盖安装：Code8 Manager Windows 下载。
更新前不要删除 API Key 或配置文件。覆盖安装后先确认 Manager 能正常启动，再检查 Codex 状态。
Codex 更新失败
按顺序检查：
- 更新命令对应的安装渠道是否正确。
- 是否有 Codex、终端或安装器进程正在占用文件。
- 当前用户是否有安装目录写入权限。
- 代理、公司网络或安全软件是否拦截下载。
- npm、Microsoft Store 或
winget自身是否能正常工作。 - 磁盘空间是否足够。
不要因为一次网络失败就立即删除配置目录。先重试下载并保留完整日志。
更新后打不开
- 完全退出 Codex 和 Manager，再重新启动。
- 重启 Windows，排除旧进程仍占用组件。
- 用
codex --version判断 CLI 是否真的完成更新。 - 检查安全软件是否隔离了新版本文件。
- 如果只有桌面应用失败，CLI 仍正常，问题更可能在应用安装层。
- 如果新旧版本冲突，按 Codex 卸载干净与重新安装 处理，但先备份配置。
更新后配置不见了
Windows 原生 Codex 通常使用 %USERPROFILE%\.codex，WSL 内的 CLI 默认使用 Linux 用户的 ~/.codex。更新后“配置消失”经常是切换了运行环境或 CODEX_HOME，不一定是文件被删除。
配置位置说明见：config.toml 与 auth.json。
查看更新内容
新功能、修复和行为变化以 Codex 官方更新日志 为准。看到第三方标题中的“最新版”时，仍应以本机版本号和官方日志核对。
建议记录三个信息：当前版本、目标版本、安装来源。更新日志说明“发生了什么”，本机 codex --version 才能证明“是否已经更新到该版本”。