安装 Node.js 与 Codex CLI

前提条件：请先完成 安装包安装，确保 Codex 主界面可以正常打开。 主界面会协助你安装 Codex CLI，并帮你处理 Node.js 环境变量配置。

为什么需要安装 Codex CLI

Codex 安装包提供了主界面，可以正常使用大部分功能。 安装 Codex CLI（命令行版本）可以让 Codex 获得完整的终端能力， 实现代码执行、文件操作等高级功能。

整个过程中，Codex 主界面会协助你完成安装—— 包括 Node.js 的下载安装以及环境变量的配置，你只需要按照指引操作即可。

步骤 1：安装 Node.js

Codex CLI 基于 Node.js 运行。请先前往官网下载并安装 LTS（长期支持）版本。

步骤 2：验证 Node.js 安装

安装完成后，打开 命令提示符（按 Win + R，输入 cmd，回车）， 运行以下命令确认安装成功：

# 检查 Node.js 版本
node --version

# 检查 npm 版本
npm --version

正确安装后会分别输出版本号，例如 v22.14.0 和 10.9.2。 如果提示"不是内部或外部命令"，请参考下一步配置环境变量。

步骤 3：配置环境变量

Node.js 安装后需要正确的环境变量才能在终端中使用。 Codex 主界面可以协助你完成环境变量配置——打开 Codex， 它会自动检测并引导你完成设置。

如果需要手动配置，步骤如下：

1. 右键点击 此电脑 → 属性 → 高级系统设置。
2. 点击 环境变量 按钮。
3. 在 "系统变量" 中找到 Path，双击打开。
4. 点击 新建，添加以下两个路径：

C:\Program Files\nodejs\
%APPDATA%\npm

添加完成后点击 确定，然后关闭并重新打开命令提示符窗口， 再次运行 node --version 验证。

步骤 4：安装 Codex CLI

Node.js 和 npm 确认可用后，在命令提示符中运行以下命令全局安装 Codex CLI：

npm install -g @openai/codex

安装过程大约 1-2 分钟。安装完成后，验证是否成功：

codex --version

如果输出版本号（如 0.1.x），说明安装成功。 Codex 主界面将自动识别已安装的 CLI，解锁完整终端能力。

如果提示权限错误，请用管理员身份打开命令提示符再试： 右键点击"命令提示符" → "以管理员身份运行"。

安装完成

Node.js 和 Codex CLI 安装完成后，重新打开 Codex 主界面， 即可使用完整功能。终端版 Codex CLI 与主界面共享配置文件， 无需重复替换。

如果启动后提示认证失败，请确认 auth.json 已正确放到 %userprofile%\.codex\ 目录中。 详见 安装包安装 中的配置替换步骤。

常见问题

npm install 报网络错误

如果公司网络有限制，可以设置 npm 镜像源后重试：

# 设置淘宝镜像源
npm config set registry https://registry.npmmirror.com

# 然后重新安装
npm install -g @openai/codex

node 命令找不到

打开 Codex 主界面，它可以帮你自动配置环境变量。 也可以手动回到步骤 3，将 Node.js 路径添加到系统 Path 中， 然后重新打开命令提示符。

codex 命令找不到

确认 %APPDATA%\npm 在系统 PATH 中。运行以下命令查看 npm 全局安装路径：

npm config get prefix

将输出的路径添加到系统 PATH 环境变量中即可。

安装包和 CLI 版可以同时存在吗

可以，而且推荐这样做。安装包提供图形主界面，CLI 提供终端能力， 两者共享配置文件，互相配合使用。