Skip to content

CC Switch 配置教程

CC Switch 是一款开源的跨平台工具,专为 Claude Code / Codex / Gemini CLI 设计,让你一键切换不同 API 提供商,无需手动修改环境变量或配置文件。

下载地址https://github.com/farion1231/cc-switch/releases


第一步:注册并获取 API Key

  1. 打开 aigateway.link,注册账号
  2. 登录后进入顶部菜单「令牌」页面,点击「创建新令牌
  3. 创建成功后复制 Key(格式为 sk-xxxxxxxx),妥善保存

令牌管理页面

余额不足?

在「充值」页面使用支付宝 / 微信充值,最低 10 元起充。


第二步:安装 CC Switch

前往 Releases 页面 下载:

系统安装包
Windows.exe 安装包,双击安装
macOS.dmg,拖入 Applications
Linux压缩包,解压后运行

安装完成后打开 CC Switch,主界面如下——左侧列表显示已添加的提供商,点击任意一条即可一键切换:

CC Switch 主界面


第三步:导入 AI Gateway 配置

方式一:一键导入(推荐)

AI Gateway 后台内置了 CC Switch 一键导入入口,无需手动填写任何参数

  1. 进入「令牌」页面,找到你的令牌,点击右侧 「···」 下拉菜单,选择「填入 CC Switch

令牌下拉菜单

  1. 在弹窗中完成配置:
    • 应用:选 Claude(Claude Code 用户选这个)
    • 名称:自定义,如「AI Gateway」
    • 主模型:推荐选 claude-sonnet-4-6
    • Haiku / Opus 等按需选填

CC Switch 导入弹窗

  1. 点击「打开 CC Switch」,浏览器自动唤起 CC Switch 并弹出导入确认,点「确认导入」完成。

一键导入没反应?

确认 CC Switch 已正确安装并运行中。部分浏览器会弹出「允许打开外部应用」提示,需点击「允许」。


方式二:手动添加

如果一键导入无法唤起 CC Switch,可在应用内手动添加:

  1. 点击右上角 「+」 打开添加界面

添加提供商

  1. 按如下填写各字段:
字段填写内容
名称自定义,如「AI Gateway」
Endpointhttps://aigateway.link
API Key你的令牌 Key(sk-xxxxxxxx
主模型claude-sonnet-4-6
  1. 填好后点 「添加」 完成。

自动拉取模型列表

填好 Endpoint 和 API Key 后,点模型输入框旁边的 下载图标,CC Switch 会自动从网关拉取可用模型列表,直接选择即可,无需手动输入。


第四步:在 Claude Code 中使用

在 CC Switch 主界面点击「AI Gateway」配置条目激活,然后打开终端:

bash
claude

Claude Code 启动后即通过 AI Gateway 转发所有请求。需要切换配置时,直接在 CC Switch 主界面点击对应条目即可,无需重启终端


可用模型参考

登录后在「模型定价」页面可查看全部支持的模型和价格,常用推荐:

模型适用场景
claude-sonnet-4-6综合能力强,日常编码首选
claude-haiku-4-5-20251001速度快、价格低,适合简单任务
deepseek-chat中文理解好,性价比高

常见问题

Q:提示 API Key 无效?
检查 Key 是否完整复制(含 sk- 前缀),并确认账户余额大于 0。

Q:如何查看消耗情况?
登录后台进入「使用日志」,可查看每次请求的 Token 用量和扣费明细。

AI Gateway — 聚合多家 AI 提供商的统一接入服务