CC-Switch_下载安装_配置流程_2026.4.28
下面给你一套最简、完整、可直接照着做的 CC‑Switch 下载 → 安装 → 配置 → 切换模型流程（Windows 为主，macOS/Linux 附关键命令）。
—## 一、CC‑Switch 是什么（一句话）
可视化管理 Claude Code / Codex / Gemini CLI 等 AI 编程工具的多厂商 API Key 与模型，一键切换，不用改配置文件。
二、下载（官方开源，2026‑04 最新 v3.12+）
1）官方地址
- 下载地址：https://pan.quark.cn/s/a6061ebad324
2）Windows 选择（推荐）
- 安装版：
CC-Switch-vxxx-Windows.msi（推荐，开始菜单快捷方式） - 便携版：
CC-Switch-vxxx-Windows-Portable.zip（解压即用，不写注册表）
3）macOS 选择
- 推荐 Homebrew：
brew tap farion1231/ccswitch brewinstall--caskcc-switch- 手动：
.dmg或.zip
4）Linux 选择
- Debian/Ubuntu：
.deb - 通用：
AppImage（chmod +x 后直接运行）
三、安装步骤（Windows 最详细）
下载
.msi，双击运行。弹出 SmartScreen → 点更多信息 → 仍要运行。
一路Next → Install → Finish。
从开始菜单启动CC‑Switch，托盘出现图标。
macOS 首次打开拦截
系统设置 → 隐私与安全性 → 仍要打开；或终端执行：
xattr-cr"/Applications/CC Switch.app"四、首次配置（核心：添加国内可用模型，DeepSeek 为例）
1）打开界面
顶部默认是Claude Code（先配这个），主区域是「提供商列表」（空）。
2）添加提供商（5 步）
- 右上角点+（添加提供商）。
- 预设列表选DeepSeek（国内直连，无需代理）。
- 填写：
- 名称：
DeepSeek-Coder（随便写，好认） - API Key：
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx（DeepSeek 官网申请） - Base URL：默认
https://api.deepseek.com（不改） - 模型：选
deepseek-coder-v2（代码最强） - API 格式：默认OpenAI Chat Completions
- 名称：
- 点添加→ 列表出现该提供商。
- 点右侧启用（Enable）→ 状态变Active（自动写入 Claude Code 配置）。
3）健康检查（验证是否可用）
点提供商旁健康检查→ 提示Success即正常。
五、日常使用：一键切换模型
- 打开 CC‑Switch → 列表点任意提供商 →启用→ 立即生效。
- 终端直接运行：
claude自动用当前启用的 Key 与模型。
托盘快速切换（不用开主窗口）
右键托盘 CC‑Switch 图标 → 直接选提供商 → 秒切。
六、国内常用预设（2026 可直连）
- DeepSeek：
deepseek-coder-v2，代码强，国内直连。 - 阿里百炼：通义千问、通义代码。
- 47code / 小麦API：中转 Claude 3.5 / GPT‑4o（需注册充值）。
七、常见问题
Claude Code 提示无 API Key
- 确认 CC‑Switch 中已启用提供商。
- 重启终端（环境变量缓存）。
- 健康检查是否 Success。
Windows 被杀毒拦截
- 加入白名单，或用Portable.zip绿色版。
macOS 提示“无法验证开发者”
- 系统设置 → 隐私与安全性 → 仍要打开。