CC-Switch下载、CC-Switch安装、配置教程（2026最新v3.16.1）

CC-Switch v3.16.1 完整下载、安装、配置教程（2026最新）

一、软件基础说明

CC-Switch 是MIT开源免费跨平台工具，用于统一管理 Claude Code、Codex、Gemini CLI、OpenCode 等AI编程工具的API密钥、多模型服务商切换、本地路由、用量统计、MCP服务统一管理，所有API密钥本地AES加密存储，不上传云端，无收费捆绑。
v3.16.1 发布时间：2026-06-01，适配 Win10+/macOS12+/Ubuntu22.04+。

二、官方安全下载渠道（仅以下渠道可信）

1. 国内高速备用（GitHub访问慢时）

---------

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

---------

2. v3.16.1 各平台安装包清单

三、分系统详细安装步骤

（一）Windows系统

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

1. 下载.msi文件，双击启动安装向导

2. 弹出Windows SmartScreen拦截：点击更多信息 → 仍要运行

3. 同意协议，点击Next；

4. 自定义安装路径：点击Change改为D盘/非系统盘（推荐）

5. 持续Next，等待写入文件，最后勾选Launch CC Switch，点击Finish完成

6. 开始菜单打开软件，托盘常驻图标。

方案2：便携绿色版（免写入注册表）

1. 下载Portable.zip压缩包，解压到纯英文无空格文件夹（如D:\Tools\CCSwitch）
2. 直接双击CC-Switch.exe启动，无需安装，删除文件夹即卸载。

（二）macOS系统

方案1：Homebrew一键安装（最稳定）

打开终端，依次执行两行命令：

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

安装完成后启动台直接打开CC Switch。

方案2：DMG手动安装

1. 下载.dmg镜像双击打开，将CC Switch.app拖拽到「应用程序」文件夹
2. 首次打开提示「无法验证开发者」拦截：
   • 方式A：系统设置 → 隐私与安全性 → 下滑找到「仍要打开」
   • 方式B：终端执行命令放行：

     xattr -cr "/Applications/CC Switch.app"

3. 重新启动软件即可正常使用。

（三）Linux系统

Debian/Ubuntu（deb包）

sudo dpkg -i cc-switch_3.16.1_amd64.deb # 依赖缺失执行修复 sudo apt -f install

AppImage通用包（所有发行版）

# 添加执行权限 chmod +x CC-Switch-v3.16.1-linux-x86_64.AppImage # 直接运行 ./CC-Switch-v3.16.1-linux-x86_64.AppImage

四、首次启动核心配置教程（必看）

前置准备

提前准备好任意兼容OpenAI格式的API密钥（DeepSeek、Kimi、字节方舟、Anthropic官方、MiniMax等均可）。

步骤1：识别本地AI工具

软件打开后自动扫描电脑已安装工具：Claude Code、Codex、Gemini CLI等，左侧工具栏会显示识别到的工具图标。

步骤2：添加API服务商（以DeepSeek国内直连为例）

1. 右上角点击+ 添加提供商
2. 服务商预设列表选择对应厂商（DeepSeek、OpenAI、Anthropic、自定义中转）
3. 填写配置参数：
   • 名称：自定义备注（如DeepSeek-Coder）
   • API Key：官网申请的sk开头密钥
   • Base URL：厂商官方地址（DeepSeek默认https://api.deepseek.com，中转API填写服务商提供地址）
   • API格式：默认OpenAI Chat Completions（绝大多数模型通用）
   • 模型：下拉选择代码专用模型（deepseek-coder-v2、claude-3.5-sonnet等）
4. 点击「添加并保存」，服务商列表生成条目。

步骤3：绑定AI工具，一键切换模型

1. 左侧选中需要配置的工具（如Claude Code）
2. 顶部下拉框选择刚才添加的服务商，软件自动接管本地配置文件
3. 开启「本地路由」开关（核心功能）：自动拦截工具API请求，转发到你配置的服务商，无需手动修改环境变量/配置JSON。

步骤4：高级功能配置

1. 多服务商故障转移
   添加多个服务商后，拖动排序优先级；主服务商超时/报错时自动切换备用密钥。
2. Token用量&成本统计
   侧边栏「用量面板」实时统计消耗Token、请求次数、预估费用，支持自定义模型单价。
3. 统一MCP/Skills/提示词管理
   右侧图标栏：Skills、MCP服务、系统提示词、会话历史，所有AI工具共用一套提示词与插件，无需重复配置。
4. 托盘快捷切换
   最小化后软件驻留系统托盘，右键可快速切换服务商、开启/关闭路由、导出配置备份。

五、常见问题解决

1. Windows打开提示安全拦截
   弹窗点「更多信息-仍要运行」；便携版右键exe→属性→勾选「解除锁定」。
2. macOS无法打开未知开发者
   终端执行放行命令xattr -cr "/Applications/CC Switch.app"。
3. Claude Code不生效、模型未切换
   确认「本地路由」已开启；重启Claude Code终端/IDE插件；检查Base URL与API Key正确性。
4. GitHub下载缓慢
   使用国内夸克网盘备用链接下载全平台包。
5. 卸载备份配置
   设置面板导出.ccswitch-backup备份文件；卸载后重装可一键导入恢复所有密钥与服务商。

六、安全提醒

1. 仅使用本文官方渠道下载，第三方修改安装包存在密钥泄露风险；
2. 不使用不知名小众中转API，优先大厂官方API（DeepSeek、字节方舟、MiniMax等）；
3. CC-Switch密钥仅本地加密存储，不会上传网络，可放心填入API Key；
4. 第三方中转API存在跑路、限流风险，充值小额测试为主。