如何升级 Codex：CLI 更新、编辑器扩展升级与常见问题排查

想升级 Codex，首先需要确认自己用的是哪个入口：终端里的 Codex CLI、编辑器中的 Codex 扩展，还是桌面应用或网页服务。它们的更新入口不同。

如果你在终端里输入 codex 开始工作，本文的 CLI 部分适用；如果你从 VS Code 侧边栏打开 Codex，还需要检查扩展版本。本文介绍客户端更新，模型选择和账号套餐需要另外处理。

一、先记录版本，确认正在更新哪一份程序

在系统终端中执行：

codex --version

然后检查程序路径。

macOS、Linux、WSL：

type -a codex

Windows PowerShell：

Get-Command codex -All
where.exe codex

这些结果可以帮助区分原生安装、npm 全局安装，以及多份副本造成的路径冲突。若使用 npm，还可以查询当前环境安装的包：

npm list -g @openai/codex --depth=0

这条命令只反映当前 npm 环境，不代表系统中没有其他安装来源。尤其使用 Node.js 版本管理器时，切换 Node.js 版本可能同时切换全局包目录。

升级前保存项目改动，结束正在执行的任务，并备份自行修改过的配置。若在公司统一部署的环境中使用，先遵循团队规定的更新渠道。

二、Codex CLI 的四种更新路径

当前 OpenAI 官方 CLI 文档列出了独立安装脚本、npm 和 Homebrew 的安装及更新方法。下面按原有安装来源选择一项执行。来源：Codex CLI 官方文档

1. npm 安装：更新全局包

如果你最初通过 npm 安装，可以执行：

npm install -g @openai/codex@latest

官方文档使用 npm install -g @openai/codex 作为更新命令；这里显式指定 @latest 标签，便于表达要安装的发布标签。

安装结束后，重新打开终端并检查：

codex --version

这里的 -g 表示全局安装。若只在某个项目中安装依赖，更新到的包不一定是平时直接运行 codex 时调用的那一份。

2. Homebrew 安装：更新 cask

如果是在 macOS 上通过 Homebrew 安装，执行：

brew update
brew upgrade --cask codex

第一条刷新包索引，第二条更新 Codex。完成后关闭旧会话，再运行 codex --version。

3. macOS、Linux、WSL 独立安装：重新运行官方脚本

当前官方文档对独立安装提供相同的安装与更新命令：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

这条命令下载并执行官方安装脚本，适用于对应的独立安装方式。已有 npm 或 Homebrew 安装时，继续使用各自的更新路径，便于明确程序由谁管理。

4. Windows 独立安装：在新的 PowerShell 窗口更新

官方文档要求从新的 PowerShell 窗口启动，命令为：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

这是 Windows 独立安装脚本的更新方式。若当前 Codex 来自 npm，就使用 npm 分支。公司设备有脚本执行或软件部署策略时，沿用管理员允许的方式。

Windows 与 WSL 内的安装需要分别维护：你在哪个环境执行 codex，就在哪个环境核对版本和安装来源。来源：官方安装与更新命令

三、VS Code 中的 Codex 扩展怎样升级？

如果主要使用编辑器侧边栏中的 Codex，建议在编辑器里检查扩展更新：

1. 打开扩展面板，找到已安装的 Codex 扩展。
2. 确认它对应 OpenAI 官方文档链接的扩展，避免选错同名产品。
3. 在扩展详情页检查可用更新；有更新时执行更新。
4. 按编辑器提示重新加载窗口，必要时完全退出后重新打开。
5. 查看扩展详情中的版本，重新打开 Codex 面板验证。

这是编辑器内的操作建议；具体按钮和自动更新设置以所用编辑器界面为准。OpenAI 文档说明，VS Code 及兼容编辑器使用 Codex 扩展，而 Xcode、JetBrains 有各自的集成方式。来源：Codex IDE 官方文档

codex --version 检查的是终端当前调用的 CLI，不能用这个结果代替扩展详情页的版本信息。桌面应用也应从其自身的分发和更新入口处理。

四、升级失败，按现象定位

提示安装成功，版本号没变：重新检查程序路径，确认更新目标与实际执行目标一致；重开终端，核对当前 Node.js 环境。

提示没有新版本：查看包管理器是否已刷新索引，以及当前安装是否采用固定版本或团队管理的发布渠道。本文不写死“最新版本号”，因为不同渠道的分发进度可能不同。

出现下载或权限错误：记录是 npm、Homebrew 还是官方脚本报错，分别检查对应下载源和安装目录权限。错误发生在软件安装阶段时，应先解决安装问题。

程序已经更新，但没有某个模型或功能：核对当前登录方式、服务提供方、模型配置和该功能的适用条件。客户端更新与账号权限是两项检查，不能仅从版本号推断可用范围。

五、使用 DDS Hub 时，把版本检查与接入检查接起来

对于通过 DDS Hub（呆呆兽 Hub）使用 Codex 的开发者，升级后可以先确认 CLI 或扩展版本，再核对原有服务配置。

DDS Hub 当前文档提供 Codex 安装配置章节，涉及服务提供方、接口地址、认证与模型设置。已有可用配置时，先保留它并核查当前教程要求，避免直接用整段示例覆盖自己的配置。DDS Hub 使用教程

如果版本确认完成后仍然调用失败，再检查令牌、分组、额度和完整错误信息；排错入口可参考 DDS Hub FAQ。DDS Hub 属于第三方接入服务，其令牌权限与 OpenAI 官方账号权限需要分别理解。

最后，在熟悉的项目中发起一个小范围任务，观察响应、文件读取和工具执行是否符合预期。确认版本与连接后，再继续日常开发。实际模型和调用信息应结合客户端配置及服务记录核对，单凭模型在聊天中的自述不足以完成验证。

本文依据于 2026 年 10 月 22 日访问的 OpenAI 官方文档及 DDS Hub 公开资料整理，未执行安装、升级或付费 API 调用。