Codex CLI · 核对于 2026-11-11

Codex 中转站

Codex 中转站的接入方式是在 ~/.codex/config.toml 里加一个 model provider 块：base_url 填 https://api.relayswitch.io/v1，密钥放进环境变量，Codex 的用法不变。18 个 GPT 模型 id 走 Responses 接口，按 token 从预付余额扣费，无倍率，每天公开验真。邮箱开通，USDT 或银行卡充值。

获取密钥分步教程
base_urlhttps://api.relayswitch.io/v1
env_keyRELAYSWITCH_API_KEY
wire_apiresponses

Codex 中转站是什么

Codex CLI 是 OpenAI 的命令行编码代理。它的配置里有一项 model_provider，默认值是 openai，请求发给 OpenAI 自己的接口。这一项可以换：在 config.toml 里定义一个自己的 provider，写明接口地址和存放密钥的环境变量，再把 model_provider 指过去。地址指向一家中转站，Codex 的命令和用法都不变，计费方换成了这家中转站，这就是“Codex 中转站”，也有人叫“Codex 中转”。

Codex 只说一种协议：OpenAI 的 Responses API。它的配置参考写明 wire_api 只支持 responses 一个值。所以挑 Codex 中转站，第一件事是确认对方提供 /v1/responses，而不只是 /v1/chat/completions。本站两条路由都有，Codex 用前一条。

计费按 token 预付：充值之后余额以美元计，每一轮按目录里的标价扣减，输入、缓存输入、输出分别计价，没有倍率。编码代理的一次任务里，绝大部分输入是重复发送的上下文，命中缓存后按缓存价计，所以下面除了价格表，还单独算了一张按任务估算的表。

01

config.toml：一个 provider 块

四个键，密钥不写进文件。

toml
1# ~/.codex/config.toml
2model = "gpt-6.1-sol"
3model_provider = "relayswitch"
4
5[model_providers.relayswitch]
6name = "RelaySwitch"
7base_url = "https://api.relayswitch.io/v1"
8env_key = "RELAYSWITCH_API_KEY"
9wire_api = "responses"
  • model_provider 按表名选中下面的块。表名要自己起：openai、ollama、lmstudio、amazon-bedrock、amazon-bedrock-runtime、gcp 是 Codex 保留的内置 id，不能覆盖。
  • base_url 填 https://api.relayswitch.io/v1，带 /v1；Codex 在后面拼 /responses。
  • env_key 是存放密钥的环境变量的名字，不是密钥本身。密钥留在环境变量里，配置文件可以放心提交或同步。
  • wire_api 只有 responses 一个可用值，也是默认值，这一行可以省略。
  • requires_openai_auth 默认是 false，不用写：自定义 provider 用 env_key 里的密钥鉴权，不走 OpenAI 的账号登录。

资料来源：Codex 的 Advanced Configuration 与 Configuration Reference（读取于 2026-11-11）。

02

三步接入

写配置，导出密钥，先用 curl 测一条再启动 Codex。

  1. 把上面的块写进 ~/.codex/config.toml。这个目录由环境变量 CODEX_HOME 决定，默认是 ~/.codex。provider 要写在用户级的这份文件里。
  2. 在运行 Codex 的那个终端里导出密钥，再启动。把 export 那一行加进 shell 的配置文件，新开的终端才会带上它。
bash
1export RELAYSWITCH_API_KEY="sk-relay-..."
2codex
  1. 启动之前，先按 Codex 的格式发一条最小的 Responses 请求，确认密钥和地址都对。-i 会打印状态行和响应头，其中 x-uplink-request-id 是这次请求的 id：
bash
1curl -i https://api.relayswitch.io/v1/responses \
2 -H "Authorization: Bearer $RELAYSWITCH_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{"model": "gpt-6.1-sol", "input": "回复 ok"}'

返回 200，再运行 codex 发第一条指令；这次请求几秒内出现在控制台的用量页，带着它的 tokens 和扣费。临时换一个模型用 codex --model gpt-6-luna。逐项的说明和推荐模型在 Codex CLI 中转配置；用 CC Switch 管理多个地址的，看 CC Switch 配置中转站。

03

GPT 系列实时价格

支持 Responses 接口的 18 个 GPT id，美元 / 百万 tokens，渲染时读取自目录；人民币为参考价（ECB 2026-11-11 汇率），计费以美元为准。

模型输入缓存输入输出官方价 输入 / 输出相当于官方价
GPT-6.1 Solgpt-6.1-sol$0.582≈ ¥3.96$0.0582≈ ¥0.396$2.91≈ ¥19.80$2.00 / $10.003 折
GPT-6 Lunagpt-6-luna$0.0625≈ ¥0.425$0.0125≈ ¥0.0851$0.20≈ ¥1.36$0.10 / $0.50输入 6.3 折 · 输出 4 折
GPT-6 Solgpt-6-sol$0.60≈ ¥4.08$0.12≈ ¥0.816$3.00≈ ¥20.41$2.00 / $10.003 折
GPT-6 Astragpt-6-astra$3.00≈ ¥20.41$0.30≈ ¥2.04$15.00≈ ¥102.06$10.00 / $50.003 折
GPT-5.6 Lunagpt-5.6-luna$0.12≈ ¥0.816$0.012≈ ¥0.0816$0.72≈ ¥4.90$0.20 / $1.206 折
GPT-5.6 Solgpt-5.6-sol$1.20≈ ¥8.16$0.12≈ ¥0.816$3.00≈ ¥20.41$4.00 / $20.00输入 3 折 · 输出 1.5 折
GPT-5.6 Terragpt-5.6-terra$1.20≈ ¥8.16$0.12≈ ¥0.816$3.60≈ ¥24.49$2.00 / $12.00输入 6 折 · 输出 3 折
GPT-5.5gpt-5.5$1.80≈ ¥12.25$0.16≈ ¥1.09$9.00≈ ¥61.24$5.00 / $30.00输入 3.6 折 · 输出 3 折
GPT-5.4 Minigpt-5.4-mini$0.75≈ ¥5.10$0.075≈ ¥0.51$4.50≈ ¥30.62$0.75 / $4.50同官方价
GPT-5.3-Codexgpt-5.3-codex$1.75≈ ¥11.91$0.18≈ ¥1.22$14.00≈ ¥95.26$1.75 / $14.00同官方价
GPT-4o minigpt-4o-mini$0.15≈ ¥1.02$0.075≈ ¥0.51$0.60≈ ¥4.08$0.15 / $0.60同官方价
GPT-4ogpt-4o$2.50≈ ¥17.01$1.25≈ ¥8.51$10.00≈ ¥68.04$2.50 / $10.00同官方价
GPT 5 Nanogpt-5-nano$0.10≈ ¥0.68$0.01≈ ¥0.068$0.80≈ ¥5.44——
GPT 5.4 Nanogpt-5.4-nano$0.40≈ ¥2.72$0.04≈ ¥0.272$2.50≈ ¥17.01——
GPT 5.6gpt-5.6$0.7682≈ ¥5.23$0.0941≈ ¥0.64$3.8412≈ ¥26.14——
GPT 6.1 Terragpt-6.1-terra$0.2941≈ ¥2.00$0.0294≈ ¥0.2$1.4706≈ ¥10.01——
gpt-oss-120bgpt-oss-120b$0.20≈ ¥1.36$0.04≈ ¥0.272$1.80≈ ¥12.25——
gpt-oss-20bgpt-oss-20b$0.16≈ ¥1.09按输入价$0.72≈ ¥4.90——

无倍率：表中价格即扣减价格。官方价为 OpenAI 公布的标价；“折”是本站价占官方价的十分之几，向上取整。

04

一次 40 轮的 Codex 任务多少钱

假设：每轮发送 80,000 tokens 的已有上下文、2,000 新输入 tokens，返回 1,500 输出 tokens。大小是假设，控制台的用量页显示你的真实数字。

模型上下文命中缓存完全不命中缓存$10 够几次任务
GPT-6 Lunagpt-6-luna$0.057≈ ¥0.388$0.217≈ ¥1.48175
GPT-6.1 Solgpt-6.1-sol$0.4074≈ ¥2.77$2.08≈ ¥14.1824
GPT-5.3-Codexgpt-5.3-codex$1.56≈ ¥10.59$6.58≈ ¥44.776
GPT-6 Astragpt-6-astra$2.10≈ ¥14.29$10.74≈ ¥73.084

40 轮，按目录实时价计算；没有缓存价的模型，缓存 tokens 按输入价计。实际费用以每次请求的回执为准。

两列的差距就是缓存的作用。Codex 每一轮都把会话和工具输出重新发一遍，这些 tokens 命中缓存时按缓存价计，响应里会报告缓存 tokens 的数量。能不能命中取决于模型和请求本身，所以两列都列出来，实际花费落在两者之间。

省钱的办法因此很具体：日常修改用便宜的型号，难的评审和重构再切到贵的；一个任务做完就开新会话，不要让上下文一直变长；给 Codex 单独建一把密钥，设美元预算和每日消费上限，到了上限网关返回 402，这把密钥停下，账户里其余的余额不动。

每个模型一个 profile 文件

profile 是一个名为 ~/.codex/<name>.config.toml 的文件，里面只写和 config.toml 不同的键，用 codex --profile <name> 启动时叠加在上面。Codex 0.134.0 起，写在 config.toml 里的 [profiles.<name>] 表不再被读取，顶层的 profile = 选择器也取消了；在这之前写的教程还是旧写法，照抄不会生效。

toml
1# ~/.codex/relay-fast.config.toml
2model = "gpt-6-luna"
3model_reasoning_effort = "medium"
bash
1codex --profile relay-fast

model_reasoning_effort 的取值以所选模型支持的档位为准，Codex 随每次请求发送，网关原样转给模型。

/model 菜单别用

用自定义 provider 时，Codex 里的 /model 菜单列出的仍是它内置的 OpenAI 模型，不是你这个 provider 的。选中一项会改写当前的 profile 文件：模型变了，provider 没变。写进去的 id 如果目录里有，会按那个模型的价格继续跑；没有就返回 404。换模型用 --profile 或 --model。

常见报错

  • 401：密钥不对或已吊销，或者启动 Codex 的那个终端里 RELAYSWITCH_API_KEY 是空的。重新 export 后再启动。
  • 402：余额不足，或这把密钥的预算用完了。充值或调高预算后立即恢复。
  • 404：模型 id 不在目录里，多半是 /model 菜单改写了 profile。把 model 一行改回来。
  • 429：密钥到了速率上限。等响应头 retry-after 给出的秒数，或在控制台调高这把密钥的每分钟请求数。
  • provider 块没生效：表名用了保留 id，或者 model_provider 写的不是这张表的名字。
  • profile 没生效：它还是 config.toml 里的 [profiles.<name>] 表，把里面的键挪进单独的文件。

401 到 404 在请求到达模型之前返回，429、502、503 没有内容返回，都不扣费。按状态码排查的完整对照在 GPT / OpenAI API 中转站 的错误码一节。

Codex 之外

Codex 围绕 GPT 模型和 Responses 接口设计，所以本页的价格表只列 GPT。想在终端里用 Claude 写代码，用 Claude Code；想让一个终端代理在 Claude、DeepSeek、Kimi 之间切换，用 OpenCode。三者用的是同一把密钥、同一个余额。

05

国内开发者接入：四件事

本站只提供 API 和计费，不提供任何网络接入服务。下面是接入时问得最多的四件事。

事项本站的做法详情
账户一个邮箱填邮箱、收验证码即可登录。不要手机号，不要身份证件，也不需要在模型开发商那里开户。要什么，不要什么
付款USDT 或银行卡，最低 $10余额以美元计，不过期，没有订阅和月费。页面上的人民币是按欧洲央行汇率折算的参考价，不参与计费。充值方式与到账
配置一个 provider 块，一个环境变量provider 写进用户级的 ~/.codex/config.toml，密钥用 export 放进环境变量；换模型用 --model 或 profile 文件。Codex CLI 中转配置
发票与支持国际 PDF 发票在控制台填公司抬头、地址和税号，每次充值生成一张带编号的发票；不开中国增值税发票。支持渠道是邮箱 hello@relayswitch.io。交付与退款条款
相关页面
常见问题

常见问题

配置、账号、/v1、降智与花费。

打开控制台

一分钟内拿到密钥

获取密钥

或发邮件至 hello@relayswitch.io

一个 provider 块，一个环境变量

base_url = "https://api.relayswitch.io/v1"，GPT 系列按实时标价计费，无倍率，每天公开验真。

分步教程获取密钥