文档目录
CODEX CLI
接入 Codex CLI
将 Codex 的模型提供方指向 TokenSupply。默认使用稳定、兼容范围更广的 Responses HTTP 模式；需要时再启用 WebSocket。
准备工作
- 安装可正常运行的 Codex CLI。
- 在 TokenSupply 控制台创建 API Key，并将它分配到可用模型分组。
- 调用 GET /v1/models 确认该 Key 可以看到目标模型。
建议使用普通HTTPWebSocket 不是使用 Codex 的前提。普通 Responses HTTP 模式配置更少，遇到代理或网络设备兼容问题时也更容易排查。
配置文件位置
| 系统 | Codex 配置 | 鉴权文件 |
|---|---|---|
| macOS / Linux | ~/.codex/config.toml | ~/.codex/auth.json |
| Windows | %USERPROFILE%\.codex\config.toml | %USERPROFILE%\.codex\auth.json |
如果目录不存在，请先创建目录。修改前建议备份已有配置，避免覆盖其他模型提供方。
标准 HTTP 配置
下面配置使用 Responses API，并关闭响应存储。模型名称应替换为当前 Key 从模型列表获得的 ID。
model_provider = "TokenSupply"
model = "gpt-5.6-sol"
review_model = "codex-auto-review"
model_reasoning_effort = "high"
disable_response_storage = true
network_access = "enabled"
[model_providers.TokenSupply]
name = "TokenSupply"
base_url = "https://www.tokensupply.net/v1"
wire_api = "responses"
requires_openai_auth = true{
"OPENAI_API_KEY": "sk-your-key"
}
切勿泄漏 auth.json将
~/.codex/auth.json 排除在同步、备份分享之外。怀疑泄露时立即在控制台禁用旧 Key 并创建新 Key。
选择模型与推理强度
先查询当前 Key 的模型列表：
curl https://www.tokensupply.net/v1/models \
-H "Authorization: Bearer $TOKENSUPPLY_API_KEY"model_reasoning_effort 常用值包括 low、medium、high、xhigh 和 max。可用等级由模型决定；如果上游不支持指定值，请降低等级或移除该项。
可选：Responses WebSocket
当客户端版本、API Key 分组和上游账号都支持 WebSocket 时，可以在提供方和功能开关中同时启用：
[model_providers.TokenSupply]
name = "TokenSupply"
base_url = "https://www.tokensupply.net/v1"
wire_api = "responses"
supports_websockets = true
requires_openai_auth = true
[features]
responses_websockets_v2 = true如果出现 HTTP 426，通常表示请求访问了 WebSocket 路径，但没有完成 Upgrade 握手。关闭上述两个 WebSocket 选项即可回到普通 HTTP。
验证与回滚
- 重新启动 Codex CLI，使配置重新载入。
- 发起一个简短任务，确认能收到首段输出。
- 在 TokenSupply 控制台查看对应 API Key 的调用记录和扣费。
- 若配置失败，先移除 WebSocket 选项，再检查 Base URL、Key 和模型 ID。