CC-Switch 下载+全平台安装+详细配置教程

CC-Switch：Claude Code多API密钥管理切换工具，开源免费，统一管理官方/第三方中转API、一键切换密钥，适配Windows/macOS/Linux。

一、官方下载地址

---

| 下载 | ：https://pan.quark.cn/s/d6152047213b

---

区分：桌面GUI版（主流）、Cargo命令行CLI版

1.Windows安装（2种）

1）安装版MSI（推荐）：下载CC-Switch-xxx.msi→双击一路下一步，开始菜单启动
2）便携免安装ZIP：下载Windows-Portable.zip→解压，直接运行cc-switch.exe

2.macOS安装（2种）

# Homebrew一键安装（首选）
brew tap farion1231/ccswitch
brew install --cask cc-switch

手动：Releases下载.dmg→拖入应用程序；打不开：设置→隐私与安全性→仍要打开

3.Linux（Ubuntu/Debian）

# 下载deb包后安装
sudo dpkg -i cc-switch_amd64.deb
sudo apt install -f #补全依赖

通用：AppImage包→chmod +x xxx.AppImage && ./xxx.AppImage运行

4.命令行CLI版（Cargo安装）

# 已装rust环境执行
cargo install cc-switch

基础命令：

cc-switch add 别名 sk-xxx 接口地址 #新增密钥
cc-switch list #查看全部配置
cc-switch #交互式切换密钥

二、首次启动基础配置（GUI桌面版，最常用）

步骤1：通用设置（必做，解决Claude Code报错）

1.打开软件→左上角设置→通用
✅勾选：跳过Claude Code初次登录校验、自动接管本地Claude配置文件（~/.claude.json），保存

软件默认本地端口：18789，自动监听Claude Code请求

步骤2：添加API服务商（密钥配置）

1.左侧【密钥管理】→右上角**+Add Provider（新增服务商）**

• ①选官方Anthropic：
  Name：自定义（如Claude官方）
  BaseURL：https://api.anthropic.com
  APIKey：自己在Anthropic官网获取的sk密钥→保存
• ②选自定义Custom（第三方中转，小麦/ZenMux等）：
  |配置项|填写示例|
  | ---- | ---- |
  |名称|ZenMux/小麦API（自定义）|
  |BaseURL|中转服务商提供地址（如https://zenmux.ai/api/anthropic）|
  |API Key|服务商后台生成sk-xxxx密钥|
  |模型|claude-sonnet-4/haiku等（可选）|

软件内置几十种预设：Kimi、DeepSeek、OpenRouter等，直接选中填Key即可，不用手动填URL

步骤3：启用/切换密钥

服务商列表→选中配置→Enable设为Active（激活），自动写入Claude本地配置，新开终端使用claude code自动生效
多密钥：随时点不同服务商的启用，一键切换API来源。

三、进阶实用配置

1. 模型档位映射（Claude三档：Haiku/Sonnet/Opus）
   选中服务商→高级设置→模型映射，分别绑定对应模型名称，适配claude code快慢调用
2. 全局代理/重试预设
   设置→预设模式：一键开启【低网速自动重试、全局代理路由、负载均衡】，新手直接一键全启用
3. 导入原有Claude配置
   首次弹窗→Import导入本地已有.claude.json，自动生成默认配置，不用重复填密钥

四、使用验证

终端执行：

claude chat hello

请求走CC-Switch当前激活的API，软件主界面可查看调用日志、用量统计。