Codex CLI

Codex 是 OpenAI 推出的编程智能体，包括命令行工具和 VS Code 插件，二者共用同一份配置。Codex 使用 Responses 接口（/v1/responses）。

准备工作

创建一个提供新版 GPT 模型的分组的令牌。当前提供 GPT-5.5 及更新模型的分组：

支持 Codex 常用模型的分组

特价azure¥0.3/刀2 个模型codex¥0.3/刀7 个模型default¥0.3/刀2 个模型azure¥0.44/刀3 个模型codex-pro¥0.6/刀4 个模型AZ¥1/刀10 个模型AZ2¥2/刀7 个模型Azure正价¥5.5/刀11 个模型

安装

# 需要 Node.js 18 及以上
npm install -g @openai/codex

配置

编辑 Codex 配置文件（macOS / Linux：~/.codex/config.toml，Windows：C:\Users\你的用户名\.codex\config.toml，不存在就新建）：

model_provider = "vip"
model = "gpt-5.5"
model_reasoning_effort = "high"

[model_providers.vip]
name = "ZEN-AI VIP站"
base_url = "https://vip.zen-ai.top/v1"
env_key = "VIP_API_KEY"
wire_api = "responses"

然后设置环境变量 VIP_API_KEY：

macOS / Linux

# 写入 ~/.zshrc 或 ~/.bashrc 后执行 source 使其生效
export VIP_API_KEY="sk-xxxxxxxx"

Windows

# 永久写入用户环境变量，重新打开终端后生效
setx VIP_API_KEY "sk-xxxxxxxx"

另一种写法：把密钥放在 auth.json

如果 IDE 插件读取不到终端里的环境变量，可以改用 Codex 自带的认证文件：

1. 在 [model_providers.vip] 中删除 env_key 一行，改为 requires_openai_auth = true。
2. 新建 ~/.codex/auth.json（Windows 为 C:\Users\你的用户名\.codex\auth.json）：

{
  "OPENAI_API_KEY": "sk-xxxxxxxx"
}

启动与验证

cd your-project
codex

进入后输入 /status 查看当前 provider 和模型，输入 /model 可切换模型与推理强度。

当前可用于 Codex 的模型（点击复制）：

常见问题

401 Unauthorized 当前终端没有读到 VIP_API_KEY。Windows 使用 setx 后需要重新打开终端；也可以改用上面的 auth.json 写法。

wire_api = "chat" 报错或不再支持 新版 Codex 只支持 Responses 接口，请确保 wire_api = "responses"，并使用支持该接口的模型。

stream disconnected / 长时间无输出 高推理强度时模型会先思考较长时间。网络不稳定时可尝试 其他线路，只需替换 base_url 的域名部分（保留 /v1）。

提示模型不可用 检查 model 是否在令牌分组内，参考上方的分组与模型列表。