Codex custom provider：model_provider、Base URL 与 wire_api

​

简短答案

​

什么时候需要理解它

• 你在配置自定义 OpenAI-compatible provider
• Codex 提示 provider 找不到或模型请求失败
• 你不确定 model_provider 和 model 的区别
• 你在把 BetterToken、OpenAI 或其他 provider 放进同一份 config.toml
• 你想区分 Base URL、API Key、Model ID 三个字段

​

字段关系

​

推荐配置方式

model_provider = "custom"
model = "gpt-5.5"

[model_providers.custom]
name = "BetterToken"
base_url = "https://bettertoken.ai/v1"
env_key = "MODEL_PROVIDER_API_KEY"
wire_api = "responses"
requires_openai_auth = false

export MODEL_PROVIDER_API_KEY="YOUR_API_KEY"

$env:MODEL_PROVIDER_API_KEY="YOUR_API_KEY"

​

如何确认配置生效

1. 确认 model_provider = "custom" 与 [model_providers.custom] 完全一致。
2. 确认 Base URL 为 https://bettertoken.ai/v1，其中包含 /v1。
3. 从模型广场复制 GPT 提供商中当前可用的 Model ID。
4. 完全退出 Codex，在已设置环境变量的新终端中重新启动。
5. 发送一个小型代码解释任务，确认能收到完整响应。

​

常见错误与解决方法

​

Related docs

• 如何配置 Codex CLI 的 config.toml？
• Codex 接入 BetterToken 指南
• Codex CLI sandbox 和 approval mode 是什么？
• OpenAI-compatible API 和 Anthropic-compatible API 有什么区别？

​

References

• Codex configuration reference
• Codex sample config
• Codex advanced configuration