Codex 接入自己的 API：Base URL、模型与 env_key 怎么填

先准备三项信息，不要急着粘贴 Key

向供应商确认 Base URL、准确的模型 ID，以及是否支持 Responses API。能在聊天工具里对话，不代表能处理 Codex 发出的请求。本文使用自定义供应商和环境变量鉴权；如果你使用官方 OpenAI Key，先看 登录与凭据。

• Base URL 是服务根地址；按供应商要求保留 /v1 等前缀。不要直接填聊天网页地址。
• 模型必须是该供应商接受的 ID，展示名称不一定能直接用于请求。
• 密钥留在本机；本站生成器只需要环境变量名。

最小用户级配置

model = "YOUR_MODEL_ID"
model_provider = "my-provider"

[model_providers.my-provider]
name = "My API provider"
base_url = "https://api.example.com/v1"
env_key = "CODEX_PROVIDER_KEY"
wire_api = "responses"

api.example.com 与 YOUR_MODEL_ID 都是占位符，不是本站提供的接口。model_provider 必须和表名中的 my-provider 一致。不要把这个表写进项目 .codex/config.toml；也不要用 openai、ollama、lmstudio 等保留名称自定义供应商。

env_key 写的是变量名

上面的 CODEX_PROVIDER_KEY 只是名称。真正的密钥应由你本机的环境或凭据工具提供给 Codex 进程。可以在当前终端中不回显地读取它，再从同一终端启动 CLI。

printf "API key: "
IFS= read -r -s CODEX_PROVIDER_KEY
printf "\n"
export CODEX_PROVIDER_KEY
codex

图形客户端从桌面图标启动时，不应假定它继承了刚才终端的 export。客户端和 CLI 表现不同时，先确认启动环境，再按客户端支持的本地凭据方式配置。偏好界面操作可使用本站 CC Switch 指南；不要同时让多个配置工具反复覆盖同一文件。

Responses 兼容需要逐项验证

当前 wire_api 只支持 responses。把值改成 chat 不能把 Chat Completions 服务变成兼容服务；需要供应商提供相应端点，或经过验证的协议适配器。也不要为了消除 404 盲目拼接多层 /v1。

用一个短任务验收

1. 备份旧配置，合并上面的供应商设置，确认环境变量存在但不打印其值。
2. 退出旧会话，重新启动客户端或 CLI，只请求阅读一个小文件并总结。
3. 在供应商日志核对请求时间、模型和端点；界面显示模型名不足以证明路由正确。
4. 如果失败，记录脱敏错误并按上表缩小范围；需要恢复时还原这次修改并重开会话。

需要生成完整模板，可用 配置生成器；遇到客户端与 CLI 不一致，继续看 配置排错清单。