第一步安装 Node.js 环境要求 v22Codex CLI 依赖 Node.js 22 或更高版本。国内直接去官网下载可能较慢推荐使用nvmNode 版本管理器配合国内镜像安装。Windows 用户下载nvm-windows安装包国内推荐去 nvm中文官网 或 Gitee镜像 下载。傻瓜式安装后找到 nvm 的安装目录如D:\nvm打开settings.txt文件在末尾添加以下两行配置国内镜像源node_mirror: https://npmmirror.com/mirrors/node/ npm_mirror: https://npmmirror.com/mirrors/npm/打开 CMD 或 PowerShell执行安装并使用 Node 22nvm install 22 nvm use 22第二步使用国内镜像安装 Codex CLINode.js 安装成功后自带的npm默认使用的是国外源直接安装会一直卡住或报错。我们需要指定淘宝 npmmirror 镜像源。在终端中执行以下命令# 方式一临时指定镜像源安装推荐不污染全局配置 npm install -g openai/codex --registryhttps://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-toolsmacOS 需安装 Xcode Command Line Tools。第三步验证安装安装完成后在终端输入以下命令验证codex --version如果能正常输出版本号如codex-cli 0.x.x说明安装成功。第四步国内网络使用的核心配置 API这是国内用户最重要的一步Codex CLI 默认连接api.openai.com国内网络无法直连且官方 API 需要外币信用卡。因此你必须将其配置为国内的第三方中转 API 或兼容的国产大模型如 DeepSeek、通义千问、Moonshot 等。编辑 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