第一步：安装 Node.js 环境（要求 v22+）

Codex CLI 依赖 Node.js 22 或更高版本。国内直接去官网下载可能较慢，推荐使用 nvm（Node 版本管理器） 配合国内镜像安装。

Windows 用户：

1. 下载 nvm-windows 安装包（国内推荐去 nvm中文官网 或 Gitee镜像 下载）。

2. 傻瓜式安装后，找到 nvm 的安装目录（如 D:\nvm），打开 settings.txt 文件，在末尾添加以下两行配置国内镜像源

   node_mirror: https://npmmirror.com/mirrors/node/
   npm_mirror: https://npmmirror.com/mirrors/npm/

3. 打开 CMD 或 PowerShell，执行安装并使用 Node 22：

   nvm install 22
   nvm use 22

第二步：使用国内镜像安装 Codex CLI

Node.js 安装成功后，自带的 npm 默认使用的是国外源，直接安装会一直卡住或报错。我们需要指定淘宝 npmmirror 镜像源。

在终端中执行以下命令：

# 方式一：临时指定镜像源安装（推荐，不污染全局配置）
npm install -g @openai/codex --registry=https://registry.npmmirror.com

# 方式二：如果你平时开发也用国内源，可以先全局切换，再安装
npm config set registry https://registry.npmmirror.com
npm install -g @openai/codex

注：如果安装过程中提示某些 C++ 编译依赖报错（如 node-gyp），请忽略或确保系统已安装基础的构建工具（Windows 可运行 npm install --global windows-build-tools，macOS 需安装 Xcode Command Line Tools）。

---

第三步：验证安装

安装完成后，在终端输入以下命令验证：

codex --version

如果能正常输出版本号（如 codex-cli 0.x.x），说明安装成功。

第四步：国内网络使用的核心（配置 API）

这是国内用户最重要的一步！ Codex CLI 默认连接 api.openai.com，国内网络无法直连，且官方 API 需要外币信用卡。因此，你必须将其配置为国内的第三方中转 API 或兼容的国产大模型（如 DeepSeek、通义千问、Moonshot 等）。

1. 编辑 Codex 配置文件：打开或创建 ~/.codex/config.toml 文件，写入以下内容

# 1. 全局配置  以deepseek为例
model = "模型名"
model_provider = "模型提供方"

# 2. 提供商详细配置
[model_providers.模型提供方]
name = "模型提供方"
base_url = "模型api url"
wire_api = "responses"

# 3. 填入你的API Key
api_key = "你的API-Key"