Codex CLI 接入第三方 API：config.toml 自定义 model provider 完整配置

披露：LLM API Guide 由 SeedRouter 团队维护，本文以 SeedRouter 为示例。配置方法同样适用于其他支持 OpenAI Responses 协议的网关。

适用场景

• 想让 Codex CLI 使用更便宜或更稳定的模型线路，而不是只用官方账号额度。
• 团队统一采购 API，用一个 Base URL 和 API Key 管理用量和账单。
• 想在官方登录和第三方网关之间随时切换，而不是改来改去。

第一步：准备三项信息

注意核对网关域名。名称相近的网站很多，Base URL 填错域名，相当于把请求发给了另一家服务。SeedRouter 的官方域名只有 seedrouter.net，详见官方渠道说明。

第二步：编辑 ~/.codex/config.toml

配置文件位置：

• macOS / Linux：~/.codex/config.toml
• Windows：C:\Users\<用户名>\.codex\config.toml

文件不存在时直接新建。写入以下内容：

model = "gpt-6.1-sol"
model_provider = "seedrouter"

[model_providers.seedrouter]
name = "SeedRouter"
base_url = "https://seedrouter.net/v1"
env_key = "SEEDROUTER_API_KEY"
wire_api = "responses"
requires_openai_auth = false

每个字段的作用：

第三步：设置 API Key 环境变量

macOS / Linux（zsh 或 bash）：

echo 'export SEEDROUTER_API_KEY="sk-你的密钥"' >> ~/.zshrc
source ~/.zshrc

用 bash 的话把 ~/.zshrc 换成 ~/.bashrc。

Windows PowerShell：

setx SEEDROUTER_API_KEY "sk-你的密钥"

setx 只对新开的终端生效，执行后请关闭并重新打开 PowerShell。

第四步：验证连接

先用 curl 确认 Key 和地址可用，返回模型列表即说明认证通过：

curl https://seedrouter.net/v1/models \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

然后启动 Codex：

codex

随便问一个问题，能正常回答就完成了。在 SeedRouter 控制台的用量日志里也能看到这次请求。

在官方登录和第三方网关之间切换

推荐用 profile，把两套配置都留在同一个文件里：

[profiles.seedrouter]
model = "gpt-6.1-sol"
model_provider = "seedrouter"

需要时用 codex --profile seedrouter 启动走网关，不带参数则使用文件顶层的默认设置。如果更习惯图形界面，也可以用 CC Switch 管理多个供应商，SeedRouter 有一份CC Switch 配置 Codex 的完整指南。

常见报错

更多报错见Codex / Claude Code 接入第三方 API 常见报错排查。

小结

Codex 接第三方网关只需要三件事：在 config.toml 里定义 provider，用环境变量提供 Key，用 wire_api = "responses" 走 Responses 协议。如果你还没有网关账号，可以在 SeedRouter 官网注册，新账号有 2 次热门模型免费试用，首页列有当前各模型与官方价格的对比。