Codex CLI

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

方式一：CC Switch 导入

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

方式二：手动配置

将密钥放入环境变量：

macOS / Linux

export SPRELAY_API_KEY="sk-your-key"

Windows PowerShell

$env:SPRELAY_API_KEY = "sk-your-key"

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

model = "gpt-5.6-sol"
model_provider = "sprelay"

[model_providers.sprelay]
name = "Sprelay API"
base_url = "https://sprelaytoken.com/v1"
env_key = "SPRELAY_API_KEY"
wire_api = "responses"

将模型替换为当前分组支持且适合 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 的模型或路由；不要仅凭模型名字相似判断。

工具调用反复失败

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