第一步：安装 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"