Codex 版本检查、升级和界面变化处理

Codex 更新较快。教程截图、命令、配置字段或界面按钮与当前版本不一致时，先确认版本，不要直接判断是自己操作错了。

本站当前教程基线：Codex CLI v0.147.0。 这是 2026 年 8 月 7 日查询 npm 官方 latest 标签得到的稳定版本；桌面版与 IDE 扩展采用独立发布节奏，本站同时按同期 OpenAI 官方 Codex 文档核对能力和界面说明。

官方依据：OpenAI Codex Manual 的安装、CLI、桌面 App、配置和更新说明。

教程目标

完成后，你能记录当前版本、安全升级，并判断变化来自版本、配置还是项目本身。

开始前准备

• 保存当前任务对话、错误信息和必要截图。
• 备份 ~/.codex/config.toml 和项目级 .codex/ 配置。
• 确认工作区没有未说明的文件改动。

第 1 步：记录当前状态

CLI 中运行：

codex --version

桌面版和 IDE 扩展在设置或扩展详情中查看版本。记录操作系统、入口、版本号和问题出现时间。

第 2 步：从原始渠道确认更新

• CLI：以官方安装说明中的包名和升级命令为准。
• 桌面版：使用 App 内更新或 OpenAI 官方下载入口。
• IDE：使用编辑器官方扩展市场中的 OpenAI 发布项。

不要从搜索广告、网盘或陌生镜像下载所谓“优化版”。

第 3 步：升级 CLI

如果你使用 npm 安装 CLI，先让 Codex 核对当前官方命令：

请根据 OpenAI Codex 官方文档确认当前 CLI 升级方式。
请只给出官方包名、升级命令、版本检查命令和回滚建议，不要立即执行。

确认后再升级，并重新运行 codex --version。本站将版本号集中维护在 src/data/codex-version.json，并通过自动检查比较 npm latest 标签。发现新稳定版时，应先核对变更、完成教程回归，再更新站点基线，不能只替换数字。

第 4 步：升级后做最小验证

1. 启动空白会话，确认可以正常响应。
2. 打开练习项目，执行一次只读项目分析。
3. 检查当前模型、审批和沙箱设置。
4. 检查 MCP、Hooks、Skills 和项目配置是否仍被正确加载。
5. 运行 git status，确认验证没有产生意外文件。

界面与教程截图不一致怎么办

我当前使用的是【入口和版本】。
教程截图显示【旧界面元素】，我现在看到【当前界面元素】。

请先根据当前官方文档解释：
1. 这个功能是否改名或移动。
2. 当前入口和前置条件是什么。
3. 哪些步骤仍然有效。
4. 哪些旧步骤不应该继续执行。
5. 如果不能确认，请明确写不能确认。

验收结果

1. 升级前后版本号、配置备份和变化记录都已保存。
2. 最小对话、项目只读任务和配置加载均已验证。
3. 发现差异时能区分版本变化、配置问题和项目问题。

下一篇看：Codex 常见问题。