Codex CLI 接入

Codex CLI 的推荐配置由 ~/.codex/config.toml 和 ~/.codex/auth.json 组成。QuotaAPI 控制台的“使用 Key”弹窗会生成同样的文件结构。

查看 Codex CLI API 接入概览，了解适用场景和兼容能力。

前置条件

1. 在 API Key 页面创建一个 Key。
2. Key 绑定的分组必须包含你准备使用的模型。
3. Responses API 不支持 DeepSeek 分组；此类 Key 应改用 Chat Completions 客户端。

配置 config.toml

macOS 和 Linux 使用 ~/.codex/config.toml，Windows 使用 %userprofile%\.codex\config.toml：

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://quotarouter.ai"
wire_api = "responses"
requires_openai_auth = true

model 和 review_model 只是示例。请使用 Key 所属分组当前开放的模型名称。

配置 auth.json

macOS 和 Linux 使用 ~/.codex/auth.json，Windows 使用 %userprofile%\.codex\auth.json：

{
  "OPENAI_API_KEY": "YOUR_QUOTAAPI_KEY"
}

WARNING

auth.json 包含凭据。不要提交到 Git、上传到工单或放进公开截图。

验证模型与 Responses

Codex 会使用带 client_version 的模型列表请求刷新选择器。可以先检查普通模型列表：

curl "https://quotarouter.ai/v1/models?client_version=1.0.0" \
  -H "Authorization: Bearer YOUR_QUOTAAPI_KEY"

再验证 Responses：

curl https://quotarouter.ai/v1/responses \
  -H "Authorization: Bearer YOUR_QUOTAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": "Return one short Codex test sentence.",
    "max_output_tokens": 80
  }'

部分推理模型会先消耗 reasoning tokens。真实任务应设置足够的 max_output_tokens，不要依赖极低的输出上限。

环境变量兼容方式

只有在旧工具明确读取环境变量时，才使用：

export OPENAI_BASE_URL="https://quotarouter.ai/v1"
export OPENAI_API_KEY="YOUR_QUOTAAPI_KEY"

Codex CLI 本身应优先使用上面的两个配置文件，避免工具版本升级后忽略环境变量。

常见错误

• 401：检查 auth.json 中的 Key 是否完整、已启用。
• 404：检查 base_url 是否误写成重复的 /v1/v1，或分组是否不支持 Responses。
• 模型选择器为空：先用模型列表请求确认 Key、分组和模型映射。
• WebSocket 无法建立：Responses WebSocket 只适用于 OpenAI/Grok 兼容目标。
• 修改后未生效：完全退出 Codex CLI 后重新启动。