在 Codex CLI 中配置 AnRouter

安装 Codex、把 AnRouter 添加为 provider、验证 Responses 路由，再带密钥启动。

Codex 的 CLI、IDE 扩展和 ChatGPT 桌面端 Codex 功能共享用户级 ~/.codex/config.toml。AnRouter 应配置为独立 provider；不要修改 auth.json 去伪装 OpenAI 官方登录。

1. 安装并验证

# macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# 检查
codex --version

Windows PowerShell：irm https://chatgpt.com/codex/install.ps1 | iex

2. 获取 AnRouter API Key

在 anrouter.com 注册并登录。
进入控制台，打开 API Keys 页面。
创建密钥并复制。请像对待密码一样保管，切勿提交到代码仓库。

3. 先验证 Responses 路由

curl https://api.anrouter.com/v1/responses \
  -H "Authorization: Bearer $ANROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"glm-5.3","input":"只回复 ok"}'

4. 写入用户级配置

# ~/.codex/config.toml
model = "glm-5.3"
model_provider = "anrouter"

[model_providers.anrouter]
name = "AnRouter"
base_url = "https://api.anrouter.com/v1"
env_key = "ANROUTER_API_KEY"
wire_api = "responses"

macOS Finder 中的 .codex 文件夹与 config.toml 配置文件位置 — macOS：在 Finder 中前往 `~/.codex/`，编辑其中的 `config.toml`。Windows 对应 `%USERPROFILE%\.codex\config.toml`。点击图片可查看原图。

协议要求：responses 是 Codex 自定义 provider 唯一支持的 wire API，也是省略该字段时的默认值。所选 AnRouter 模型与渠道必须能通过 POST /v1/responses 工作。

5. 可用模型：DeepSeek、GLM、Qwen、MiniMax、MiMo 的模型名

填进 model = 的必须是准确的模型 ID。以下是 AnRouter 当前提供的 9 款模型。

DeepSeek —— deepseek-v4.1-flash-1017
Z.AI / GLM —— glm-5.2 · glm-5.3 · glm-5.3-flash
MiniMax —— minimax-m3.1-flash
Qwen —— qwen3.8-27b · qwen3.8-flash-next
Xiaomi MiMo —— mimo-v2.6-pro · mimo-v2.6-flash

换模型只需改一行，provider 配置块保持不变：

# ~/.codex/config.toml
model = "deepseek-v4.1-flash-1017"
model_provider = "anrouter"

[model_providers.anrouter]
name = "AnRouter"
base_url = "https://api.anrouter.com/v1"
env_key = "ANROUTER_API_KEY"
wire_api = "responses"

路由存在不等于任意模型都支持该能力。模型、上游渠道、请求字段三者必须兼容，换模型后请验证工具调用等功能是否正常。各模型的上下文上限与价格见模型目录。

6. 提供密钥并启动

export ANROUTER_API_KEY="your_anrouter_api_key"
codex --model glm-5.3

# 打开桌面端
codex app

桌面 App 或 IDE 扩展可能不继承 shell 变量，可把 ANROUTER_API_KEY=… 放入 ~/.codex/.env，然后完全重启应用并新建会话。

不要手动改 auth.json：auth.json 和内置 openai provider 属于 OpenAI 登录/认证流程；AnRouter 使用独立 provider 更清晰，也不会覆盖现有 OpenAI 登录。

参考：OpenAI Codex 自定义模型 provider