Codex API 配置

Codex 的 Base URL、API Key 与模型 ID 应该怎样配置

Base URL 是服务入口,API Key 是访问凭证,模型 ID 决定调用哪个模型。先确定采用哪种登录与服务方式,再按对应说明配置,可以减少地址、凭证和协议混用造成的错误。

更新:2026-10-18

先确认登录方式

通过 ChatGPT 登录使用 OpenAI 模型时,通常按登录流程完成授权,无需照着自定义服务教程手动填入第三方地址。使用 OpenAI API Key 时,费用和权限由对应 API 账户管理。自定义 provider 则需要按照该服务的接入说明设置。

这几种方式的账号、费用和配置并不相同。不要把第三方 Key 填到 OpenAI 官方入口,也不要将 ChatGPT 的登录缓存当作普通 API Key。配置前确认谁提供服务、凭证属于谁,以及哪个账户承担费用。

自定义服务需要同时核对地址、模型和协议

Base URL 应来自服务商当前文档,按要求保留路径前缀;模型 ID 从该凭证可访问的目录中取得。名称相似不代表调用权限或模型能力相同。Key 的状态、所属分组、额度和模型授权也需要一致。

Codex 当前官方配置中的 wire_api 使用 responses。普通聊天接口能够返回文本,或 /v1/models 可以列出模型,都不足以确认 Codex 所需的 Responses、工具调用与会话行为可用。BlueDoAI 接入也应按当前型号和实际 Codex 验收结果确认,不能只凭“兼容 API”推定。

配置模板只保留非敏感信息

下面是配置结构示意,地址与模型均为占位值,不能直接运行。使用前核对当前 CLI 版本和服务商文档,将示例字段替换为已确认的值;保留已有配置备份,不要整份覆盖其他项目所需设置。

env_key 填环境变量的名称,实际凭证通过本机适用的安全方式提供,不写进项目仓库。该示例使用服务方环境变量认证;若另行设置 requires_openai_auth = true,官方说明指出 env_key 会被忽略,需要按对应认证流程处理。

model = "MODEL_ID_FROM_PROVIDER"
model_provider = "example_provider"

[model_providers.example_provider]
name = "Example provider"
base_url = "https://api.example.com/v1"
env_key = "PROVIDER_API_KEY"
wire_api = "responses"

验收必须包含实际工具任务

先核对配置能被解析,再按已确认的权限与预算执行一个小项目任务。应观察文件读取、工具参数、命令执行和后续结果处理,并检查输出文件与服务端用量。仅收到一句问候,无法覆盖这些环节。

排障时记录脱敏的错误、时间、CLI 版本、模型 ID 和请求标识。不要提交完整 Key、Authorization 头或 auth.json。更换地址、模型或协议时一次只调整一个因素,才能判断是哪项变化解决了问题。