TL;DR
- Codex 接中转站 = 在
config.toml里加一个model_provider（填中转站的 Base URL 和 Key），再把model指到该分组的模型名。 - 分组决定能用哪些模型和按几折计费——先看分组表再建 Key，顺序别反。
- 本文全部命令与配置在真实环境跑通，报错对照与状态码处理见文内链接。
图 1：三步接入流程——选分组建 Key、写 config.toml、重开终端验证（示意图）
什么是 Codex 中转站
Codex 官方在部分地区存在支付与网络门槛。中转站提供协议兼容的接入地址：请求格式与 OpenAI 接口一致，但 Base URL、鉴权 Key 和计费方式换成中转平台的——人民币充值、按量扣费、无需海外支付渠道。对 Codex 来说，唯一的变化就是「请求发往哪里、用什么 Key」。
第一步：选分组，建 Key
分组绑定模型范围和计费倍率两件事，先想清楚要用什么模型再建 Key。以 Shana API 为例（实录于 2026-09-13）：
| 分组 | 倍率 | 适合 |
|---|---|---|
| chat gpt · 正价稳定 pro 渠道 | ×0.2 | GPT 全系，稳定优先 |
| chat gpt · 高性价比福利池 | ×0.1 | GPT 系列，价格优先 |
| 国模专区 | ×0.6 | DeepSeek / Qwen 等 |
| claude max / kiro | ×1 / ×0.2 | Claude 系列 |
控制台「API 密钥」→ 创建密钥 → 选分组 → 拿到 sk- 开头的 Key。额度用套餐（加量但限时）或直充（灵活），价格结构详见倍率与套餐速查。
第二步：写 config.toml
Codex 的配置文件在 ~/.codex/config.toml（Windows 在 C:\Users\你\.codex\）。添加一个自定义 Provider 并指定使用它：
model = "gpt-5.6"
model_provider = "shana"
[model_providers.shana]
name = "Shana API"
base_url = "https://shana.baby/v1"
env_key = "SHANA_API_KEY"
wire_api = "responses"三个关键字段：base_url 填中转站地址（以服务方文档为准，本文示例为 Shana）；env_key 指向存放 Key 的环境变量名；wire_api 必须写 responses——新版 Codex 已废弃 chat 值（实测会直接报配置错误），且中转站需支持 responses 协议。注意 model 必须是所选分组内实际存在的模型名（我们实测把 claude max 分组的 Key 配上 gpt-5.6 会直接 404 「Model not available for this group」）。然后把 Key 写进对应环境变量：
export SHANA_API_KEY="sk-你的Key" # macOS/Linux
$env:SHANA_API_KEY = "sk-你的Key" # Windows PowerShellconfig.toml 的完整字段说明（作用域、profile、approved 命令等）在主站有更深的拆解：config.toml 配置详解。
第三步：验证第一次对话
重开终端（环境变量只对新会话生效），直接发起一次对话：
codex "用一句话说明你是什么模型"看到正常回复即接入完成。验证前也可以先用 curl 单独探一次连通性，把「网络 / 鉴权 / 模型」三层问题提前分层定位，方法见报错串对照排查。
配置好了但报错？
insufficient_quota/ 余额类提示 → 配额决策树（余额 / 额度池 / 指向 / 倍率四条叶子）429 / 502 / 530→ 状态码速查表- CC Switch 切换后不生效 → 生效排查清单
维护说明
本文配置与分组信息实测于 2026-09-13（Codex CLI 当前版 / Shana API）；config.toml 字段以 OpenAI 官方文档为准，分组与倍率以 shana.baby 站内实时页面为准，客户端大版本更新后复测并更新日期。