主题
CC Switch
CC Switch 是个多 Provider 切换工具,让你在 Claude 官方、Shuro、其他中转之间一键切换,不用反复改环境变量。
适合谁
- ✅ 同时用 Claude 官方订阅 + Shuro 中转
- ✅ 需要快速对比多个上游的延迟/质量
- ✅ 不想动手敲
export ANTHROPIC_BASE_URL=...
安装
去 CC Switch Releases 下载对应平台的安装包。
| 平台 | 文件 |
|---|---|
| macOS (Apple Silicon) | cc-switch-darwin-arm64.dmg |
| macOS (Intel) | cc-switch-darwin-x64.dmg |
| Windows | cc-switch-win32-x64-Setup.exe |
| Linux | cc-switch-linux-x86_64.AppImage |
添加 Shuro Provider
- 启动 CC Switch
- 点右上角 ➕「添加供应商」
- 填表:
| 字段 | 值 |
|---|---|
| 名称 | Shuro |
| 网址 | https://shuro.vip |
| 配置 (JSON) | 见下方 |
json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "<您的 API Key>",
"ANTHROPIC_BASE_URL": "https://shuro.vip"
},
"includeCoAuthoredBy": false,
"permissions": {
"allow": [],
"defaultMode": "acceptEdits"
},
"model": "claude-opus-4-7",
"skipDangerousModePermissionPrompt": true
}- 保存。
切换
点列表里的 Shuro 那一行使其高亮 → CC Switch 会自动改写 ~/.claude/settings.json。
切换后重启 claude,配置即生效。
常见误报
启动时弹窗:Shuro 检查被拒: Auth rejected (401)
CC Switch 自带的健康检查发的是简化探活请求,new-api 类网关一般对 model 字段必填,所以可能返回 401。
弹窗自己也注明 "检查失败不代表实际不可用"。忽略即可,实际 claude 会话能正常用。
启动时弹窗:Shuro 检查被拒: Service unavailable (503)
503 表示上游服务暂时不可用,不是 CC Switch 误报。
待验证(TODO/VERIFY)
旧平台实测(2026-06)的 503 原因为「号池暂时空了 / 1M 通道无号」,尚未在 Shuro 复测,仅供参考。
- 等 1-5 分钟后再切
- 或临时切到「Claude Official」用官方账号顶上
- 详见 503 排查
关掉烦人的检查弹窗
CC Switch → 设置 → 关闭「启动时健康检查」。
⚠️ 关于 "model": "opus[1m]" 的坑
很多教程让你写:
json
"model": "opus[1m]"[1m] 是 Claude Code 的内部别名,会让请求带 anthropic-beta: context-1m-2025-08-07 头激活 1M 上下文。
Shuro 的 Claude 模型目录标注原生 1M 上下文,理论上无需 [1m] 别名。
待验证(TODO/VERIFY)
以下内容基于旧平台实测(2026-06),尚未在 Shuro 复测,仅供参考:旧平台号池里部分账号没 1M 权限,带 [1m] 的请求路由到那些账号会返 503 Service unavailable,或 400 user agent not allowed(误判为 UA 问题,实际是 1M 通道缺号)。
如遇类似报错,可保守写成 "model": "claude-opus-4-7"(不带 [1m])排查。
多 Provider 切换最佳实践
CC Switch 最强的地方是并存多个 Provider:
配置列表:
├─ Claude Official (官方订阅, $200/月 Max 20x)
├─ Shuro (中转)
├─ Backup (备用中转)
└─ Local (临时关闭,恢复原样)切换策略建议:
- 日常编码 → 官方(旧平台实测命中率 90%+,未在 Shuro 场景复测)
- 批量任务 / 套餐用完 → 切 Shuro
- 官方挂了 / 区域问题 → 切备用中转
配套:直接编辑 settings.json
如果不想用 CC Switch,可以直接编辑 ~/.claude/settings.json —— 配置文件结构完全一样。CC Switch 只是个图形化工具,没做任何"魔法"。
