Codex CLI

Codex CLI 适合使用 Responses 协议的模型。建议通过 CC Switch 一键导入；需要手动配置时，使用独立 Provider。

方式一：CC Switch 导入

按照 CC Switch 教程操作，应用选择 Codex。站内会把 Endpoint 设置为 https://sprelaytoken.com/v1，并写入你选择的主要模型。

方式二：手动配置

将密钥放入环境变量：

macOS / Linux

# 只替换引号内的占位密钥；变量名需要和 TOML 中的 env_key 一致。
export SPRELAY_API_KEY="sk-your-key"

Windows PowerShell

# 当前 PowerShell 窗口中的 Codex 会读取这个变量。
$env:SPRELAY_API_KEY = "sk-your-key"

在 Codex 配置文件中新增 Provider。不同 Codex 版本的字段可能调整，下面展示当前常用结构：

# Codex 实际请求的模型；必须是当前分组支持的 Responses 模型。
model = "gpt-5.6-sol"
# 指向下面 [model_providers.sprelay] 这一节。
model_provider = "sprelay"

[model_providers.sprelay]
# 只用于界面和日志识别，可以自定义。
name = "Sprelay API"
# Codex 会自动追加 /responses，因此这里只填到 /v1。
base_url = "https://sprelaytoken.com/v1"
# Codex 从同名环境变量读取密钥，不把真实值写入配置文件。
env_key = "SPRELAY_API_KEY"
# 必须使用 Responses 协议，而不是 Chat Completions。
wire_api = "responses"

TOML 使用 # 添加注释。复制时可以保留这些注释；不要缩进节标题 [model_providers.sprelay]，也不要给真实密钥新增一个配置字段。

将模型替换为当前分组支持且适合 Responses 的模型。

验证顺序

1. 先使用Responses 最小请求验证密钥和模型。
2. 启动 Codex 并确认日志中使用的是 sprelay Provider。
3. 执行一个小型只读任务。
4. 在 Sprelay 使用日志中核对请求。

常见问题

启动后仍访问默认服务商

检查顶层 model_provider 是否为 sprelay，以及配置文件是否位于当前 Codex 版本实际读取的位置。

返回 404

base_url 应为 https://sprelaytoken.com/v1，由 Codex 拼接 /responses。不要直接填写完整 /v1/responses。

模型支持 Chat 但 Codex 失败

Chat Completions 和 Responses 是不同协议。选择支持 Responses 的模型或路由；不要仅凭模型名字相似判断。

工具调用反复失败

先关闭复杂工具，只验证文本响应，再查看工具调用和流式响应。