CC Switch

Sprelay API 控制台支持生成 CC Switch 导入链接，可以把地址、密钥和模型映射一次写入 Claude、Codex 或 Gemini 配置。

一键导入

1. 安装并打开 CC Switch。
2. 登录 Sprelay，进入API 密钥。
3. 找到要使用的密钥并打开操作菜单。
4. 选择“导入到 CC Switch”。
5. 选择应用：Claude、Codex 或 Gemini。
6. 填写配置名称并选择主要模型。
7. Claude 配置可按需要指定 Haiku、Sonnet 和 Opus 的模型映射。
8. 点击“打开 CC Switch”，确认导入。

地址规则

站内导入会按应用生成不同地址：

• Codex：https://sprelaytoken.com/v1
• Claude：https://sprelaytoken.com
• Gemini：https://sprelaytoken.com

这一区别是为了适配各工具自动拼接的原生路径，不建议导入后随意修改。

模型如何选择

主要模型必须选择。模型下拉列表来自当前账户可用模型；如果找不到目标模型，先检查密钥分组和模型广场。

Claude 的可选模型映射用于让不同任务档位路由到不同模型：

映射	常见用途
Haiku	快速、低成本任务
Sonnet	日常编码与分析
Opus	更复杂的推理任务

具体映射应使用当前可用模型，不要照抄过期教程里的模型名称。

导入后验证

1. 在 CC Switch 中确认新 Provider 已启用。
2. 检查 Endpoint 和主要模型。
3. 切换到目标应用并重新打开终端或客户端。
4. 发起一个简短请求。
5. 回到 Sprelay 使用日志确认请求到达。

常见问题

浏览器没有打开 CC Switch

确认 CC Switch 已安装，并允许浏览器打开 ccswitch:// 自定义协议。企业浏览器策略可能会拦截外部应用跳转。

导入后仍使用旧配置

确认目标应用已切换到新 Provider。关闭并重新打开终端，避免旧进程继续使用之前加载的环境变量。

API 密钥显示不完整

控制台表格默认可能脱敏显示。执行导入时应使用密钥的完整值；若无法获取，创建一枚新的专用密钥，而不是猜测被遮盖部分。