Codex 第三方 API 直连配置

本页说明如何直接配置 Codex。需要在一个桌面应用中切换 Codex 和 Claude 服务商时，请使用 CC Switch 教程。

开始前

• 安装 Codex，并确认 codex 命令可以运行。
• 创建一个允许使用目标模型的 Relyven Key。
• 从控制台复制准确的模型 ID。

添加 Relyven 服务商

编辑用户级 ~/.codex/config.toml，不要放在项目的 .codex/config.toml：

model = "YOUR_MODEL_ID"
model_provider = "relyven"

[model_providers.relyven]
name = "Relyven"
base_url = "https://api.relyven.com/v1"
env_key = "RELYVEN_API_KEY"
wire_api = "responses"

将 Key 放入环境变量：

export RELYVEN_API_KEY="YOUR_API_KEY"
codex

Base URL 必须包含 /v1。Codex 会在其后请求 /responses，不要把完整端点写进 base_url。

验证服务商

先验证接口：

curl https://api.relyven.com/v1/responses \
  -H "Authorization: Bearer $RELYVEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_ID","input":"只回复 OK。"}'

随后新建一个需要工具调用的 Codex 任务。Relyven 同时支持 /v1/responses 和历史兼容路径 /responses。

Relyven 不主动修改 tools、推理字段、service tier、会话字段、上下文或指定模型；所选模型仍可能拒绝不支持的参数组合。

常见问题

结果	检查项
401	启动 Codex 的终端是否已导出 RELYVEN_API_KEY
403	当前 Key 是否允许使用配置中的模型
400	wire_api = "responses"、模型 ID 和请求字段
找不到模型	从鉴权模型列表或控制台复制模型 ID
修改后未生效	完全退出 Codex，再新建会话

请求字段见 Responses API，重试规则见 API 错误码与排障。