Codex 接 OpenAI 兼容中转站 Base URL 配置教程

安装 OpenAI Codex CLI，并配置 API Key、Base URL、config.toml 和 provider 切换来接入 OpenAI 兼容中转站。

安装和启动

Codex CLI 是 OpenAI 的本地编程代理,官方安装方式是:

npm i -g @openai/codex
codex

第一次运行时,Codex 会让你登录 ChatGPT 账号或使用 API Key。用中转站时,通常走 API Key 和 OpenAI 兼容接口。

先确认服务商支持什么

Codex 不是普通聊天壳。它会读代码、改文件、跑命令,所以中转站最好明确支持 OpenAI Responses API 或 Codex 可用的 OpenAI 兼容接口。

你需要向服务商确认:

  • Base URL 是不是 OpenAI 兼容地址
  • 是否支持 Responses API
  • 模型名应该填什么
  • 是否支持流式输出和工具调用
  • 是否有特殊 Header 或 query 参数

如果你还没选好服务商，可以先看 Codex 中转服务对比。想扩大到所有 OpenAI 兼容接口，再看 OpenAI API 中转服务商 对比页。对价格敏感的配置，也可以参考 便宜 OpenAI API 服务商，或直接浏览完整的 AI API 服务商目录。

配置方式

临时测试时,可以优先用环境变量:

export OPENAI_API_KEY="你的中转站 API Key"
export OPENAI_BASE_URL="https://你的中转站地址/v1"
codex

长期使用时,再考虑写进 ~/.codex/config.toml,用不同 profile 区分官方 OpenAI、中转站、本地模型或团队网关。

排障顺序

  1. 先确认 codex --version 是最新版。
  2. 再确认 OPENAI_API_KEY 和 OPENAI_BASE_URL 当前终端确实生效。
  3. 让服务商确认 Codex 需要的接口类型,不要只问“支不支持 OpenAI 格式”。
  4. 如果你用了 config.toml,先回到环境变量临时配置排查,减少变量。

Codex 版本变化比较快,配置项也会继续演进。写教程时最好把“可验证的最小配置”和“高级 profile 配置”分开,避免读者照抄一段复杂 TOML 后不知道错在哪里。

Codex OpenAI config.toml

相关错误

Claude Code / Codex 503 No available accounts：中转站账号池不可用排查 先不要盲目换 Key。这个错误通常说明账号池、供应商、分组或模型路由暂时不可用。先测最小请求、确认模型和分组，再判断是等待恢复、降低上下文，还是换 provider。 Codex: Selected model is at capacity. 模型容量已满排查 报错：Selected model is at capacity. Please try a different model. 先把它当作模型级容量、Admission 或流式中断问题处理。它可能出现在官方 ChatGPT 登录态 Codex CLI，也可能来自中转站账号池或 Sub2API 上游 overloaded 透传。 Error 401 Unauthorized：AI API 中转站认证排查 401 是认证失败信号。先检查当前加载的是哪一个 Key、请求打到哪个 Base URL、header 格式是否正确，以及这个 Key 是否仍然在对应 provider 中有效。 Error 429 Too Many Requests：AI API 中转站限流排查 报错：exceeded retry limit, last status: 429 Too Many Requests, request id: <request-id>。AI 中转站里连续 429 多半是上游账号池限流、冷却或额度耗尽，先让服务商换号、换线路或换模型。