Codex 配置第三方 API

Codex 可以通过 config.toml 连接兼容 OpenAI Responses 接口的第三方服务。选择服务商,按它文档写明的地址生成配置;API Key 放在你自己电脑的环境变量里。

按服务商生成

以下服务商的文档写明了接入地址。点开后可以直接生成配置,并看到各型号在该服务商的价格。

手动填写

服务商不在上面时,按它的文档填写接口地址和型号名。

保存到 ~/.codex/config.toml;文件已存在时合并进去
model_provider = "custom"

[model_providers.custom]
name = "第三方 API"
base_url = "https://api.example.com/v1"
env_key = "CUSTOM_API_KEY"
wire_api = "responses"

原理

Codex 在 ~/.codex/config.toml 里用 model_providers 声明自定义服务商:base_url 是接口地址,env_key 是存放 Key 的环境变量名,wire_api = "responses" 表示用 Responses 接口通信;再用 model_provider 和 model 选中它和要用的型号。

常见问题

Key 为什么放在环境变量里?

config.toml 里只写环境变量的名字,Key 本身不进配置文件,分享或同步配置时不会泄露。需要长期生效时,把 export 那一行加到 ~/.zshrc 或 ~/.bashrc。

怎么换回 OpenAI 官方?

删除 config.toml 里的 model_provider 一行,再重新启动 Codex。

Key 会经过本站吗?

不会。页面只生成配置文本,不要求填写 Key;Key 只出现在你自己电脑上的终端或环境变量里。