Codex 怎么接自定义 API 网关：三种方法全解，配完即用

OpenAI Codex 默认将 API 请求发送到官方端点，但在实际使用中，国内网络不稳定、需要多模型聚合服务、企业审计流量等场景，往往需要将请求路由到自定义网关。Codex 原生支持这一功能，配置入口在 ~/.codex/config.toml 中，也可以使用环境变量临时覆盖。下文将按照 「最快上手 → 最推荐 → 最灵活」 的顺序，介绍三种方法，每种方法均附有完整可复制的配置示例。

为什么要接自定义网关

Codex 默认将 API 请求发送到 api.openai.com，但在以下场景中会遇到问题：

• 国内网络
  ：api.openai.com 在大陆无法直接访问，需要通过国内可访问的第三方 API 端点

• 多模型切换
  ：想在 Codex 里使用非 OpenAI 的模型（DeepSeek、Claude、Kimi 等），需要一个兼容 OpenAI 协议的聚合入口

• 企业审计
  ：需要将 LLM 流量经过内部网关，记录 token 消耗或进行内容审查

• 成本控制
  ：不同网关对不同模型的定价不同，切换网关是降本的直接手段

Codex 支持所有兼容 OpenAI Chat Completions 或 Responses API 的第三方端点，核心原理是：将 base_url 指向你的网关地址，将 API Key 换成对应服务商的 Key。

方法一：环境变量（临时 / CI 场景首选）

最快的方式，无需修改任何配置文件，适合临时测试或 CI/CD 环境。

# 自定义 provider 名称（大写），任意字符串
export MYGATEWAY_API_KEY="your-api-key-here"
export MYGATEWAY_BASE_URL="https://your-gateway-api-base-url/v1"

# 调用时用 --provider 指向这个名称
codex --provider MYGATEWAY "帮我写一个 Python 爬虫"

• _API_KEY 和 _BASE_URL 中的 必须一致（都大写，下划线分隔）
• 这种方式只对当前终端会话生效，关闭终端后失效
• 如果只想替换 Key、不换地址，单独 export OPENAI_API_KEY="xxx" 即可覆盖官方 Key