CC Switch 聚合接入
将已接通的 Orbis 配置加入聚合名单，设置默认服务，刷新客户端模型列表并验证调用。
已经通过 CC Switch 接入 Orbis，想在同一客户端选择多个模型或供应商，再使用聚合。完整截图、安装与两家服务切换练习见 聚合模式图文教程。
1. 先确认每条配置可用
- 使用支持聚合的 CC Switch 4.x；本文涉及 Claude Code 和 Codex。Claude Code 至少为
2.1.243。 - 聚合经过本机路由服务，使用期间保持 CC Switch 运行。两个客户端的供应商与聚合名单分别配置。
- 为每条 Orbis 线路创建对应 Key；按普通模式分别验证地址、协议、精确模型 ID 与调用记录。
- Claude 官方订阅暂不支持这一聚合方式。Codex 的官方账号只能作为默认供应商，不能作为普通成员加入。
| 客户端 | Orbis 接入信息 |
|---|---|
| Claude Code | Anthropic Messages；https://api.orbiorbi.com；例如 claude-haiku-5-5 |
| Codex | OpenAI Responses；https://api.orbiorbi.com/v1；例如 gpt-6.1-sol |
实际协议与模型以所选线路的接入页为准。
2. 加入名单，再开启聚合
- 在 CC Switch 对应客户端顶部进入 聚合。
- 编辑 Orbis 卡片的 模型列表，获取并选中可用模型；列表接口不可用时手动添加真实模型 ID。Claude 用 ★ 指定该供应商的启动与后台默认模型，确保它也在 Key 授权范围内。
- 在 可添加 区域点击 添加，选好默认供应商，再点击 切换到聚合模式。
- 核对确认框中的默认供应商与模型数；开启后应显示 聚合生效中。
保存供应商、加入名单、开启聚合是三件事。 只进入聚合页或保存模型列表，不会自动启用。
3. 刷新客户端并核对调用
| 客户端 | 名单或模型配置变化后 |
|---|---|
| Codex 桌面版 | 彻底退出再打开 |
| Codex CLI | 按提示重启守护进程，再打开 CLI；可能打断其他任务 |
| Codex 编辑器扩展 | 重开编辑器窗口 |
| Claude Code | 按提示重新选择模型，列表通常立即生效 |
在客户端的模型选择器中按供应商标注选择模型，发送一条短消息，再到 使用日志 检查请求。切换到另一个条目后再次核对。每次请求都会使用对应服务额度，不要自行编写 ccs- 模型前缀。
常见问题与退出
| 现象 | 怎么处理 |
|---|---|
| 只看到旧模型 | 确认已加入名单并开启，按上表重载客户端 |
| 普通请求走错服务 | 检查聚合默认供应商，而非只看最后编辑的卡片 |
| 主对话正常，小任务失败 | 检查后台小模型是否被该 Key 授权 |
| 一家服务失败 | 手动选已验证可用的另一家；聚合不等于自动故障转移 |
| 官方额度耗尽，第三方也不能发送 | 切回直连，在 CC Switch“设置 → 应用配置 → Codex”关闭“非接管切换时保留官方登录”，再切换第三方并彻底重启；旧会话可能需要新开 |
| 想退出聚合 | 在聚合页点击“回到直连”，启用原供应商，重载客户端并核对状态 |
Orbis 的 Key 仍然决定线路：CC Switch 聚合不会让一枚 Key 自动跨线路调用。更详细的模型列表、默认项与恢复操作见 图文教程。
跨供应商子 agent、官方额度限制及版本差异见 CC Switch 官方聚合手册。