codex-cli 怎么配置第三方 API

Codex CLI 通过 ~/.codex/config.toml 支持自定义 provider。核心是声明一个 OpenAI 兼容的 base_url 和读取 key 的环境变量。

第一步：写配置

model = "gpt-5.5"
model_provider = "relay"

[model_providers.relay]
name = "Relay"
base_url = "https://relay.example.com/v1"
env_key = "RELAY_API_KEY"

env_key 只是变量名，不要把 key 本身写进文件。

第二步：导出 key

export RELAY_API_KEY="sk-your-key"

需要长期生效时写进 shell 配置文件，注意文件权限。

第三步：验证

codex exec "reply with OK"

再跑一次需要读写文件的小任务，确认工具调用与沙箱行为正常。

常见报错

• 401：环境变量没有导出到当前 shell，或 key 前后有空格。
• 404 / model_not_found：base_url 少了 /v1，或模型名不在网关列表里。
• stream disconnected：网关不支持流式或中途断开，先关流式再试。
• permission denied：沙箱策略拦截了文件写入，调整 --sandbox 参数。

注意

• 配置文件按项目隔离时，可以放在项目根的 .codex/config.toml，但不要把 key 一起提交。
• 不同版本的配置字段可能变化，以 codex --help 和你安装版本的文档为准。