CC Switch 接入
从 Orbis 导入 Claude Code 或 Codex 的线路配置,启用后核对真实模型与调用记录。
CC Switch 帮你管理客户端的服务商配置。本文只讲 把 Orbis 接到 Claude Code 或 Codex;安装、备份和第一次切换见 CC Switch 入门图文教程。
1. 选对客户端与线路
在 模型广场 选模型,为所选线路创建 Key,再打开该线路的 快速接入。
| 客户端 | 线路所需协议 | 地址示例 | 模型示例 |
|---|---|---|---|
| Claude Code | Anthropic Messages | https://api.orbiorbi.com | claude-haiku-5-5 |
| Codex CLI | OpenAI Responses | https://api.orbiorbi.com/v1 | gpt-6.1-sol |
Key 绑定线路;Claude 与 GPT 若选了不同线路,应分别获取 Key。不能把一枚 Key 与任意模型随意组合。
2. 一键导入并启用
- 安装并打开 CC Switch,保留当前客户端配置备份。
- 在 Orbis 接入页选择 Key,进入 工具接入 → Claude Code 或 Codex CLI → CC Switch 一键导入。
- 点击 填入 CC Switch,在客户端核对地址、模型和 Key 后确认导入。
- 启用刚导入的 Orbis 服务商,再重新打开对应客户端;仅保存供应商不代表已切换。
导入链接包含 Key,不要分享或贴进聊天。界面未唤起时,确认 CC Switch 已安装,也可按下面的字段手动配置。
手动配置时检查哪些字段
- Claude Code:
ANTHROPIC_BASE_URL为根地址,ANTHROPIC_AUTH_TOKEN为 Key。ANTHROPIC_MODEL填主模型,后台小模型也应在当前线路可用范围内。Haiku 示例可把ANTHROPIC_DEFAULT_HAIKU_MODEL同设为claude-haiku-5-5。 - Codex:按 CC Switch 对应版本的编辑器填写 Key(通常为
OPENAI_API_KEY)、模型 ID、带/v1的地址,wire_api为responses。 - 本文使用基础地址,保持 完整 URL 关闭,不再拼接
/messages或/responses。先使用普通启用流程,聚合模式单独见 CC Switch 聚合接入。
3. 验证切换结果
在客户端用 /status 看模型与服务商,发送“只回复 OK”,再到 使用日志 核对 Key、模型和线路。请求会使用 API 额度;不要只凭供应商卡片的选中状态或模型自报身份判断。
| 现象 | 检查什么 |
|---|---|
| 导入后仍走原服务 | 是否启用,是否重开客户端,有无手动 profile 或环境配置覆盖 |
| 401 / 无可用渠道 | Key 所属线路、精确模型 ID 和协议 |
| 404 | Claude 用根地址,Codex 用 /v1,不要叠加请求路径 |
| 想恢复原服务 | 在 CC Switch 启用原供应商,重开客户端并再次核对状态 |
不使用 CC Switch 也可以手动配置:Claude Code 接入 / Codex 接入。完整界面操作见 图文教程。