Codex 中转站：国内用 Codex CLI 的接入方法

Codex 中转，就是让 Codex CLI 把请求发到中转站，而不是官方地址。CCSub 提供 Codex 需要的 Responses 接口（https://www.ccsub.net/api/v1/responses），在 config.toml 里加一个自定义 provider 就能用：国内不需要梯子，也不需要登录 OpenAI 账号，支付宝 / USDT 充值，按量计费 1 元 = 1 美元额度。

为什么 Codex 要接中转

国内网络直接访问官方接口不稳定，Codex 长任务中途断开很常见。
官方计费需要海外支付方式；中转站支持支付宝、USDT，按量付费，余额不过期。
一个 Key 同时兼容 OpenAI 和 Anthropic 两种接口，Codex 和 Claude Code 可以共用同一个余额。

三步接入

1. 创建 API Key
注册 CCSub，在控制台「API 密钥」页面创建一把 sk- 开头的 Key，然后把它放进环境变量 OPENAI_API_KEY（macOS / Linux 写进 ~/.zshrc，Windows 用 PowerShell 写入用户环境变量）。
macOS / Linux
```
echo 'export OPENAI_API_KEY="sk-你的密钥"' >> ~/.zshrc
source ~/.zshrc
```
2. 在 config.toml 里加一个自定义 provider
编辑 ~/.codex/config.toml（Windows 是 %USERPROFILE%\.codex\config.toml）。base_url 必须带 /api/v1，wire_api 只能写 responses；model 和 model_provider 要写在第一个 [表] 之前。
~/.codex/config.toml
```
model = "gpt-5.5"
model_provider = "ccsub"

[model_providers.ccsub]
name = "CCSub"
base_url = "https://www.ccsub.net/api/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"
```
3. 启动并核对
在项目目录执行 codex，发一句话确认有回复，再到 CCSub 控制台的「使用记录」里核对这次请求。

旧版本的环境变量写法、Windows 配置和更多坑，见 Codex CLI 接入教程。

Codex 中转需要支持什么

Codex 和普通对话工具不一样，选中转站时要确认这几点：

Responses 接口：新版 Codex 只走 /responses，旧教程里的 wire_api = "chat" 已经不支持。CCSub 提供 /api/v1/responses。
流式输出：Codex 全程用流式，长任务对连接稳定性要求高。断流时的处理见下面的报错排查。
工具调用：执行命令、改文件都是工具调用，接入后先用一个小任务试一下能不能正常执行命令、修改文件。
Key 走环境变量：自定义 provider 通过 env_key 读 Key，不会弹出登录界面。

费用怎么算

Codex 是 Agent，一个任务会连续发很多轮请求，每一轮都带上之前的上下文和工具输出，所以费用主要看任务有多长。
model_reasoning_effort 调得越高，模型思考产生的输出 Token 通常越多；日常小改动用 low 或 medium 就够了。
换任务时新开会话，或者用 /compact 压缩历史，能明显减少每一轮的输入 Token。
按量付费 1 元 = 1 美元额度、永不过期，按型号单价扣费（见型号列表）；月卡先扣当天额度，北京时间 0 点重置。鉴权失败（401）和上游 503 / 504 的请求不扣费。

查看型号列表和单价·充值与月卡

常见报错

常见问题

Codex 中转和直接用官方有什么区别？

区别在请求发去哪里、用谁的 Key 计费。接中转后，Codex 的请求发到中转站，用中转站的 Key 按量计费；配置上只改 ~/.codex/config.toml，不需要海外账号和海外支付方式。

设置了 OPENAI_BASE_URL 为什么不生效？

Codex 从 0.119 版本起不再读取 OPENAI_BASE_URL（0.118 会提示已弃用）。用 codex --version 看版本，新版本请改用 config.toml 里的自定义 provider。

启动 Codex 还是让我登录账号？

说明 Codex 还在用内置的 openai 提供方。按上面写一个自定义 provider，并设置 model_provider = "ccsub"，就不会再弹登录界面。

model 填什么？

model 可以填 gpt-5.5 等，全部可用的型号 ID 见 CCSub 型号列表页。改 config.toml 里的 model，或者在 Codex 里用 /model 切换。

能和 Claude Code 共用一个 Key 吗？

可以。一个 Key 同时兼容 OpenAI 和 Anthropic 两种接口，余额共用。Claude Code 的地址写法不同（不带 /api/v1），见 Claude Code 接入教程。

Claude Code 接入教程·用 CC Switch 管理 Codex 和 Claude Code 的配置

开始用 Codex 中转

注册后创建 Key，按上面三步改好 config.toml 就能用。首充任意金额额外送 $5。