Skip to content

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
Windowscc-switch-win32-x64-Setup.exe
Linuxcc-switch-linux-x86_64.AppImage

添加 Shuro Provider

  1. 启动 CC Switch
  2. 点右上角 ➕「添加供应商
  3. 填表:
字段
名称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
}
  1. 保存。

切换

点列表里的 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 只是个图形化工具,没做任何"魔法"。

链接

内容采用 CC BY-NC-ND 4.0 协议 · 禁止商业使用 / 禁止改编 / 禁止训练 AI 模型