CC Switch 使用教程

01 / 下载安装

从 GitHub Releases 下载

官方仓库 github.com/farion1231/cc-switch,根据系统选择对应安装包。

macOS · 通用

CC-Switch-v3.15.0-macOS.dmg

Windows · 安装版

CC-Switch-v3.15.0-Windows.msi

Windows · 免安装

CC-Switch-v3.15.0-Windows-Portable.zip

Linux

.deb / .rpm / .AppImage

macOS双击 dmg,拖入应用程序

首次打开如果提示"无法验证开发者",在 系统设置 → 隐私与安全性 底部点 仍要打开。

也可以用 Homebrew:brew install --cask cc-switch

Windows双击 msi,按提示完成

SmartScreen 提示"Windows 已保护你的电脑"时,点 更多信息 → 仍要运行。

02 / 注册中转站

注册并登录 xingwan.store

打开 xingwan.store,完成注册并登录,以便后续创建 API 令牌。

03 / 账户充值

三种充值方式,任选其一

登录后进入 账户充值 页面。

方式	说明
支付宝充值	选择充值数量与支付方式,扫码支付即时到账
兑换码兑换	在底部"兑换码兑换"区域输入兑换码即可入账
邀请奖励	复制专属邀请链接给朋友,对方充值后你获得返利余额

站内额度以"美金 $"为单位,后续创建令牌时的"金额"用同一单位。

04 / 创建 API 令牌

建一条 sk- 开头的密钥

4.1进入令牌管理

左侧菜单点 令牌管理,再点右上角 添加令牌。

4.2填写令牌信息

弹出"创建新的令牌"窗口,按下面的建议填:

名称:便于自己辨认,例如 claude-code-日常
令牌分组:决定走哪个模型池(对比见下表)
金额(额度上限):推荐 $10~$20,泄漏时损失可控
模型限制 / IP 白名单:不熟悉就留空

分组	适合场景
ccmax / 正价纯 Pro 号池	稳定优先,直连官方 Claude Pro 配额
plus 池	性价比高,日常足够用
国产模型	DeepSeek / Kimi / Qwen 等,价格最低

填完点右下角提交。

令牌只完整显示一次。关闭弹窗后只能看到末几位,务必当场复制,或直接走下一节的"填入 CC Switch"按钮。

05 / 导入到 CC Switch

一键 deeplink,无需复制粘贴

5.1在中转站点"填入 CC Switch"

回到令牌列表,找到刚创建的令牌,点 填入 CC Switch。

弹窗里需要选三件事:

应用:Claude Code 选 Claude / Codex CLI 选 Codex / Gemini CLI 选 Gemini
名称:在 CC Switch 里显示的名字,例如 My Codex
主模型:从下拉框里选,要和"应用"匹配

点 打开 CC Switch。

5.2浏览器唤起客户端

浏览器提示"是否允许网页打开 CC Switch",点允许。CC Switch 弹出"确认导入供应商配置"窗口,核对应用类型、API 端点、密钥与模型,点右下角导入。

06 / 在客户端中验证

导入后必须重启客户端

Claude Code/exit 后重新启动

退出当前会话(/exit 或 Ctrl+C),重新执行 claude。看右下角状态栏,模型应显示为刚导入的那条。

Codex CLI关闭所有会话后重启

关闭所有 Codex 会话,重新启动 codex,发"你好"测试。

Gemini CLI同上

关闭后重新启动,发一条测试消息。

切换不同分组,只需在中转站再建一条新令牌选目标分组,再次导入即可。

常见问题

遇到问题先看这里

问题	排查方向
浏览器点"打开 CC Switch"没反应	确认 CC Switch 已安装并至少启动过一次,刷新中转站重试
导入后客户端仍走旧模型	没重启客户端;或导入时"应用"选错
报 401 / Invalid API Key	令牌被禁用或额度上限耗尽,回中转站查看
报余额不足但充值已到账	检查令牌的"金额上限"是否设小了
macOS 提示"无法验证开发者"	系统设置 → 隐私与安全性 → 仍要打开
Windows 被 SmartScreen 拦截	更多信息 → 仍要运行
同时管理多个分组	建多条令牌,每条对应一个分组,分别导入
换电脑要不要重建令牌	不用,同一令牌可在多机使用

安全提示:sk- 密钥等同于钱包,不要外发。每条令牌都设额度上限,泄漏立刻在中转站禁用 / 删除并重建。