CC-Switch 下载、安装与使用全指南（2026最新v3.14.1）

CC-Switch 是跨平台AI API一键切换管理器，统一管理 Claude Code、DeepSeek、Kimi、智谱、MiniMax 等模型，不用改环境变量、不用手动改配置文件，VS Code/终端一键切换AI服务商。

一、官方下载渠道（唯一安全）

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

系统要求

• Windows：Win10+ x64
• macOS：12 Monterey+（Intel/M芯片通用）
• Linux：Ubuntu 22.04+/Debian 11+

各平台安装包

1. Windows

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

2. macOS：.dmg / .zip / Homebrew 一键安装
3. Linux：.deb / .AppImage 通用包

二、分平台详细安装教程

Windows 安装

1. MSI 标准版（新手首选）

• 双击下载 .msi → 下一步一路默认安装
• 开始菜单/桌面打开 CC-Switch，自动后台托盘常驻

2. 便携绿色版

• 解压 .zip → 直接运行 CC Switch.exe
• 无安装、无残留，公司电脑/U盘随身可用

macOS 安装

1. Homebrew 一键（推荐）

brew tap farion1231/ccswitch
brew install --cask cc-switch
# 更新
brew upgrade --cask cc-switch

2. 手动安装

• 下载 .dmg → 拖入「应用程序」
• 首次打开：系统设置→安全性与隐私→允许运行

Linux 安装（Ubuntu/Debian）

sudo dpkg -i CC-Switch-xxx.deb
sudo apt-get install -f # 修复依赖
# AppImage通用
chmod +x CC-Switch-xxx.AppImage
./CC-Switch-xxx.AppImage

三、首次配置&基础使用（5分钟上手）

1. 添加AI模型服务商（核心步骤）

1. 打开 CC-Switch 主界面，点右上角 + 添加供应商
2. 选择国内预设模型：DeepSeek、Kimi、智谱GLM、MiniMax、字节方舟等
3. 软件自动填充API地址，只需要粘贴你的API Key
4. 点击「添加」，服务商进入列表

API Key 获取：对应AI平台控制台→API密钥管理→新建密钥、复制保存

2. 一键切换模型

• 主界面：点对应卡片启用，显示「使用中」即生效
• 托盘快捷（Windows右下角/macOS顶部菜单栏）：右键图标→直接点服务商，不用开主窗口

3. VS Code / 终端生效规则

• Claude Code：热切换立即生效，无需重启
• Codex/Gemini/终端CLI：关闭重启终端即可

4. VS Code 联动设置

1. VS Code 安装 Claude Code 插件
2. CC-Switch 开启「跳过Claude首次引导」
3. 插件自动读取CC-Switch当前配置，无缝切换模型

四、进阶实用功能

1. 多配置存档：同时保存多个API、多套餐，随时切换
2. 自动版本更新：设置→检查更新，一键升级无重装
3. MCP服务统一管理：AI工具扩展协议一站式配置
4. 后台常驻：最小化托盘，开机自启不占用前台资源

五、常见问题&排查

1. 打不开/闪退：关闭杀毒拦截、更新到最新版、Windows以管理员运行
2. API连接失败：核对Key正确性、余额充足、端点地址无误
3. macOS提示无法打开：放行系统安全权限
4. 旧版本升级异常：卸载旧版→重装最新MSI包

六、安全提醒

• 只从GitHub Releases下载，拒绝第三方破解/修改版
• API Key不要泄露、不要公开分享，定期轮换密钥
• 国内优先用合规国内模型，无需额外网络工具即可稳定使用