Skip to content

CC-Switch安装使用教程

1. CC-Switch简介

统一管理Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw 和 Hermes 等多个AI工具的配置。主要解决下面这些问题:

  • 多供应商切换麻烦:使用不同的API供应商(官方、中转服务商),需要手动修改配置文件
  • 配置分散难管理:Claude Code、Claude Desktop、Codex、Gemini、OpenCode、OpenClaw、Hermes各有独立的配置文件,格式不同
  • 无法监控用量:不知道API调用了多少次,花了多少钱
  • 服务不稳定:单一供应商出问题时,整个工作流中断

2. 安装指南

CC-Switch GitHub仓库下载最新版本的可执行文件,双击运行安装程序,按照提示完成安装。推荐下载安装绿色版(免安装):
ScreenShot_2026-07-21_234547_018.png 解压绿色版安装包,双击运行CC-Switch.exe即可使用。

3. 使用CC-Switch

比如我使用Claude Code,需要添加Claude Code的大模型供应商。

3.1 添加供应商

启动CC-Switch后,选择供应商类型:Claude Code,点击添加按钮:
ScreenShot_2026-07-21_235205_186.png 进入添加供应商页面,选择常见的供应商,如果没有自己需要的供应商,也不用担心,常见的供应商里面也就预先配置接口地址而已;也可以直接点击添加自定义供应商,滚动滚轮在下方填写输入供应商名称、接口地址、和API密钥。点击保存会回到 CC-Switch首页,点击测试按钮可以测试供应商是否添加成功。 ScreenShot_2026-07-21_235924_659.png

Claude Code首次启动时提示需要登录

  1. 打开CC Switch「设置 → 通用」
  2. 开启「跳过 Claude Code初次安装确认」开关
  3. 重新启动Claude Code image20260108002626389.png

4. 切换供应商

在CC-Switch首页,点击供应商卡片的「启用」按钮,即可切换到该供应商: ScreenShot_2026-07-22_000741_770.png

切换供应商后,需要重新启动Claude Code,才能生效

应用生效方式
Claude Code✅即时生效
Codex需要关闭并重新打开终端
Gemini✅即时生效
OpenCode需要关闭并重新打开终端
OpenClaw需要关闭并重新打开终端

5. 监控用量

在CC-Switch中查看API用量,需要提前开启代理服务,否则无法查看用量。

5.1 启动代理

主界面点击设置按钮,勾选在主页面显示本地路由开关: ScreenShot_2026-07-22_001611_224.png 回到首页,点开顶部的 代理开关 按钮,即可开启代理服务。

5.2 查看用量

用了一会儿,可以在首页点击旁边的用量按钮查看API用量: ScreenShot_2026-07-22_001611_555.png