Codex 配置指南：API Key、Base URL、模型与 Provider

准备四项信息

从服务后台复制 API Key、API Base URL 和真实模型名，并确认接口是否支持 Responses API。不要凭印象手写模型名或地址。

• API Key：保存在本机凭据文件或环境变量中。
• API Base URL：使用后台提供的基础地址，不要擅自追加具体接口路径。
• 模型名：必须与后台模型列表完全一致。
• Provider 名称：顶层 model_provider 与配置块名称保持一致。

config.toml 参考结构

不同 Codex 版本的可用字段可能调整，以下结构用于说明字段关系；实际值以本机配置和服务后台为准。

model_provider = "custom"
model = "后台显示的真实模型名"

[model_providers.custom]
name = "Custom API"
base_url = "后台显示的 API Base URL"
wire_api = "responses"

按顺序验证

保存配置后完全退出并重新启动 Codex。先运行一个最简单的请求，确认鉴权、路由和模型可用，再进入真实项目。

• 先检查 Key 是否有效。
• 再检查 Base URL 层级。
• 然后核对模型名。
• 最后核对 provider 名称和 Responses API。

保护凭据

API Key 不应写入公开仓库、截图或宣传文章。提交配置文件前检查忽略规则；怀疑泄露时立即在后台撤销并重新生成。