OpenAI Codex CLI 国内中转站接入完整教程（2026最新）

本教程面向完全零基础的新手，手把手带你完成 Codex CLI 的安装和中转站配置，支持 Windows / macOS / Linux 三平台。

目录

1. 什么是 Codex CLI？

2. 第一步：安装 Node.js

3. 第二步：安装 Codex CLI

4. 第三步：获取中转站 API Key

5. 第四步：配置环境变量（临时 & 永久）

   • macOS / Linux 配置

   • Windows 配置

6. 第五步：验证是否成功

7. 常用启动参数说明

8. 常见报错排查

9. 中转站套餐说明 & 加入社群

一、什么是 Codex CLI？

Codex CLI 是 OpenAI 官方出品的终端 AI 编程助手，可以直接在命令行里用自然语言操控代码、执行命令、读写文件。

和 Claude Code 一样，官方接口在国内无法直连，需要通过中转站来使用。

Codex 和 Claude Code 的区别：

对比项 Codex CLI Claude Code 出品方 OpenAI Anthropic 底层模型 GPT-4o / o4-mini 等 Claude 系列 接口协议 OpenAI API 格式 Anthropic API 格式 环境变量 OPENAI_API_KEY + OPENAI_BASE_URL ANTHROPIC_API_KEY + ANTHROPIC_BASE_URL

💡 中转站同时支持两种协议，一个账号可以同时用 Codex 和 Claude Code。

二、第一步：安装 Node.js

Codex CLI 通过 npm 安装，需要 Node.js v22 或更高版本。

Windows

1. 打开浏览器访问：https://nodejs.org/zh-cn/

2. 点击 "长期支持版（LTS）" 下载 .msi 安装包

3. 双击安装，全程点"下一步"，不要修改安装路径

4. 安装完成后打开 命令提示符（CMD） 验证：

node -v
npm -v

看到版本号（如 v22.x.x）说明安装成功。

macOS

打开 终端（Terminal），执行：

# 方法一：用 Homebrew 安装（推荐）
brew install node

# 方法二：没有 Homebrew 先安装它
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 然后再执行 brew install node

验证：

node -v
npm -v

Linux（Ubuntu / Debian）

# 更新包列表
sudo apt update

# 安装 Node.js 22.x
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 验证
node -v
npm -v

三、第二步：安装 Codex CLI

Node.js 装好之后，用 npm 全局安装，三个平台命令完全一样：

npm install -g @openai/codex

⚠️ 如果安装很慢或失败，先切换 npm 国内镜像源：

npm config set registry https://registry.npmmirror.com

然后再重新执行安装命令。

安装完成后验证：

codex --version

看到版本号即成功，例如：0.x.x

四、第三步：获取中转站 API Key

1. 打开中转站主页：https://api.vllmproxy.com

2. 注册账号并登录

3. 进入控制台，找到 "API 密钥" 或 "Key 管理" 页面

4. 点击 "创建新密钥"，复制生成的 Key（格式类似 sk-xxxxxxxxxxxxxxxxxx）

💡 记下两个关键信息：

• API Key：sk-xxxxxxxxxxxxxxxxxx（你的密钥）

• 接口地址（Base URL）：https://api.vllmproxy.com/v1

⚠️ 注意：Codex 使用的是 OpenAI 协议，Base URL 末尾需要加 /v1，这和 Claude Code 不同！

五、第四步：配置环境变量

Codex CLI 通过读取以下两个环境变量连接中转站：

变量名 说明 示例值 OPENAI_API_KEY 你的 API Key sk-xxxxxxxxxx OPENAI_BASE_URL 中转站接口地址（带 /v1） https://api.vllmproxy.com/v1

macOS / Linux

🔸 临时设置（当前终端窗口有效，关闭后失效）

打开终端，粘贴以下命令（把 sk-xxxxxxxxxx 替换为你实际的 Key）：

export OPENAI_API_KEY="sk-xxxxxxxxxx"
export OPENAI_BASE_URL="https://api.vllmproxy.com/v1"

然后直接运行：

codex

⚠️ 临时设置每次开新终端都要重新输入，仅用于测试验证。

🔹 永久设置（推荐，一次设置永久生效）

第一步：确认你用的是哪种 Shell：

echo $SHELL

• 输出 /bin/zsh → 编辑 ~/.zshrc（macOS 默认）

• 输出 /bin/bash → 编辑 ~/.bashrc

第二步：追加写入配置文件（以 zsh 为例）：

echo 'export OPENAI_API_KEY="sk-xxxxxxxxxx"' >> ~/.zshrc
echo 'export OPENAI_BASE_URL="https://api.vllmproxy.com/v1"' >> ~/.zshrc

bash 用户把 ~/.zshrc 换成 ~/.bashrc

第三步：让配置立即生效：

source ~/.zshrc
# bash 用户执行：source ~/.bashrc

验证是否写入成功：

echo $OPENAI_API_KEY
echo $OPENAI_BASE_URL

能看到你的 Key 和 URL 就说明永久配置成功了。

Windows

🔸 临时设置（当前 CMD 窗口有效）

打开 命令提示符（CMD），输入：

set OPENAI_API_KEY=sk-xxxxxxxxxx
set OPENAI_BASE_URL=https://api.vllmproxy.com/v1

然后在同一个 CMD 窗口中运行：

codex

⚠️ 关闭 CMD 后设置失效，仅用于测试。

🔹 永久设置方法一：图形界面（小白推荐）

1. 按 Win + S 搜索："编辑系统环境变量"，点击打开

2. 点击右下角 "环境变量" 按钮

3. 在 "用户变量" 区域点击 "新建"

4. 添加第一个变量：

   • 变量名：OPENAI_API_KEY

   • 变量值：sk-xxxxxxxxxx（你的 Key）

5. 再点 "新建" 添加第二个：

   • 变量名：OPENAI_BASE_URL

   • 变量值：https://api.vllmproxy.com/v1

6. 点 "确定" 保存，重新打开 CMD 窗口生效

🔹 永久设置方法二：PowerShell 命令（进阶）

以管理员身份打开 PowerShell，执行：

[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-xxxxxxxxxx", "User")
[System.Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://api.vllmproxy.com/v1", "User")

重新打开 PowerShell 或 CMD 验证：

echo $env:OPENAI_API_KEY
echo $env:OPENAI_BASE_URL

六、第五步：验证是否成功

环境变量配置完成后，打开终端（或 CMD），进入任意目录，执行：

codex

成功后会出现交互界面，输入一句话测试：

帮我写一个读取当前目录所有文件名的 Python 脚本

能正常返回代码就完全成功了 🎉

也可以非交互式直接运行

# 直接传入任务描述
codex "解释一下这个目录里有哪些文件"

# 指定模型（使用 o4-mini，消耗更低）
codex --model o4-mini "帮我优化这段代码"

# 指定审批模式（auto 模式无需每步确认，更流畅）
codex --approval-mode auto "帮我重构 index.js"

七、常用启动参数说明

参数 说明 示例 --model 指定使用的模型 --model o4-mini --approval-mode 操作审批模式 --approval-mode auto --quiet 静默模式，减少输出 --quiet --no-project-doc 不自动读取项目文档 --no-project-doc

审批模式说明

Codex 有三种审批模式，控制它执行命令时是否需要你确认：

模式 说明 适用场景 suggest（默认） 每步操作都需手动确认 新手、谨慎使用时 auto-edit 文件修改自动执行，命令需确认 日常开发推荐 auto 全部自动执行，无需确认 熟悉项目、快速迭代时

推荐日常使用：

codex --approval-mode auto-edit

八、常见报错排查

❌ 报错：401 Unauthorized / Invalid API Key

原因：API Key 填写有误

解决方案：

1. 检查 Key 是否完整复制（包括 sk- 前缀）

2. 检查是否有多余的空格或换行

3. 回到中转站控制台确认 Key 是否有效、余额是否充足

# 重新设置 Key
export OPENAI_API_KEY="sk-你的完整Key"

❌ 报错：404 Not Found / The model does not exist

原因一：Base URL 末尾忘记加 /v1

# ❌ 错误
export OPENAI_BASE_URL="https://api.vllmproxy.com"

# ✅ 正确
export OPENAI_BASE_URL="https://api.vllmproxy.com/v1"

原因二：指定的模型名称不对，中转站支持的模型名以实际控制台为准

❌ 报错：请求超时 / 响应很慢

解决方案：

1. 确认网络正常（可以访问 https://api.vllmproxy.com 主页）

2. 稍等片刻重试

3. 加入社群询问当前节点状态

❌ 报错：codex: command not found

原因：npm 全局安装路径未加入 PATH

macOS / Linux 解决：

# 查看 npm 全局 bin 路径
npm bin -g

# 将该路径加入 PATH（以 zsh 为例）
echo 'export PATH="$(npm bin -g):$PATH"' >> ~/.zshrc
source ~/.zshrc

Windows 解决：以管理员身份重新运行 CMD，或重新安装 Node.js

❌ 报错：Node.js version too low

Codex CLI 要求 Node.js v22+，升级方法：

# macOS
brew upgrade node

# Linux
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# Windows：重新去 nodejs.org 下载最新 LTS 版本安装即可

九、中转站套餐说明 & 加入社群

💰 Codex 相关套餐价格

套餐 说明 倍率 Codex Plus 号池 性价比最高，适合轻度使用 0.1 : 1 Codex 正价稳定 Pro 号池 稳定性更强，适合日常开发 0.3 : 1 Claude 官方 Max 最高质量直连 1.5 : 1 aws bedrock高质量 2.2 : 1

倍率说明：0.1 : 1 表示消耗官方 $1 用量，只需付 $0.1，极大降低使用成本。

🔗 加入社群获取技术支持

• 中转站主页：https://api.vllmproxy.com

• 主页上有 加入交流群 的入口，群内提供：

  • 实时技术答疑

  • 节点状态播报

  • 最新优惠活动

📝 小提示：同一个 Key 可以同时用于 Codex CLI 和 Claude Code，只需根据工具切换不同的环境变量名即可。两个工具一起用，AI 编程效率翻倍！