CC-Switch v3.16.1 完整下载+安装+配置教程

CC-Switch 是开源免费跨平台工具，统一管理 Claude Code、Claude Desktop、Codex、Gemini CLI 等AI编程工具，一键切换多API供应商密钥，v3.16.1发布于2026-06-01。

一、下载 v3.16.1（官方渠道优先）

1. 国内高速备用（GitHub下载慢时用）

---

全平台v3.16.1安装包：https://pan.quark.cn/s/d6152047213b

安全提醒：任何收费、充值的CC-Switch均为山寨，软件完全免费开源。

---

Windows（Win10+ 64位）

• 安装版（推荐，自带自动更新）：CC-Switch-v3.16.1-Windows.msi
• 便携绿色版（免安装、无注册表）：CC-Switch-v3.16.1-Windows-Portable.zip

macOS（macOS 12+，Intel/M芯片通用）

CC-Switch-v3.16.1-macOS_Universal.dmg
也可Homebrew一键安装：

brew tap farion1231/ccswitch
brew install --cask cc-switch

Linux

• Debian/Ubuntu：cc-switch_3.16.1_amd64.deb
• Fedora/RHEL：.rpm包
• 通用免安装：.AppImage

二、分平台安装步骤

Windows 方案1：MSI安装版（推荐）

1. 双击 .msi 文件，弹窗点是允许权限
2. 点击 Next 下一步，同意协议
3. 默认C盘路径，点 Change 改到D盘（不要中文路径）
4. 勾选创建桌面快捷方式，一路Next
5. 等待安装完成，勾选 Launch CC Switch → Finish 自动启动

Windows 方案2：便携绿色版

1. 解压 Portable.zip 到D盘文件夹（不要桌面/下载文件夹）
2. 直接双击目录内 CC-Switch.exe 运行
3. 所有配置保存在解压文件夹，可U盘随身携带，不写注册表

macOS 安装

1. 双击 .dmg，将 CC Switch.app 拖入「应用程序」文件夹
2. 首次打开提示无法验证开发者：
   系统设置 → 隐私与安全性 → 下滑找到「仍要打开」即可启动

Linux 安装

1. Debian/Ubuntu：

sudo dpkg -i cc-switch_3.16.1_amd64.deb

2. AppImage通用包：

chmod +x CC-Switch-3.16.1.AppImage
./CC-Switch-3.16.1.AppImage

三、核心配置教程（新手必看）

前置准备

提前准备好你的API服务商信息（如DeepSeek、Kimi、中转API等）：

• API密钥（sk-xxxx）
• API接口Base URL（服务商控制台复制）

步骤1：首次启动自动扫描AI工具

打开软件后，会自动识别本地已装：Claude Code、Claude Desktop、Codex等，顶部显示工具分类标签。

步骤2：添加API供应商（两种方式）

1. 点击界面右上角 + 添加供应商

方式A：预设供应商（推荐，自动填充地址）

下拉Preset选择大厂：DeepSeek、智谱、Kimi、Anthropic官方等，仅需填入API Key，自动填充接口地址。

方式B：自定义第三方中转API

选择「自定义Custom」，完整填写：

• 名称：自定义（如「小麦API-Claude」）
• Base URL：服务商接口地址（末尾不能带/，否则请求报错）
• API Key：你的密钥
• 模型映射：下拉选择可用模型
  点击「Add」保存供应商。

步骤3：一键切换启用API配置

1. 顶部选中目标工具（Claude Code / Claude Desktop）
2. 在供应商列表，点右侧 Enable（启用）
3. 状态变为Active，代表已自动写入AI工具本地配置文件
4. 关闭VS Code/Claude客户端重新打开，新API立即生效

步骤4：关键优化设置（解决常见报错）

左上角打开「设置」→ 通用：

1. ✅ 勾选跳过Claude Code登录确认弹窗（避免强制登录官方账号）
2. ✅ 开启托盘常驻，右下角右键快速切换供应商
3. Claude Desktop用户：开启内置路由转发，解决第三方API拦截问题

四、常用进阶功能

1. 用量统计：查看各API调用额度、消耗记录
2. 会话管理：多套提示词/会话存档，一键切换工作场景
3. MCP服务管理：统一配置Claude扩展工具服务
4. 故障自动切换：主API失效自动切备用供应商
5. 托盘快捷操作：无需打开主窗口，右下角右键快速换Key

五、常见问题排查

1. API调用404：Base URL末尾多了斜杠 /，删掉重新保存
2. Claude Code仍走官方API：启用供应商后重启VS Code
3. macOS打不开：系统隐私设置放行未知开发者
4. GitHub下载失败：使用国内夸克备用网盘
5. 便携版配置丢失：不要解压到系统临时目录，固定存放D盘工具文件夹