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 只出现在你自己电脑上的终端或环境变量里。