下面给你一套最简、完整、可直接照着做的 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
brew install --cask cc-switch

• 手动：.dmg 或 .zip

4）Linux 选择

• Debian/Ubuntu：.deb
• 通用：AppImage（chmod +x 后直接运行）

---

三、安装步骤（Windows 最详细）

1. 下载 .msi，双击运行。

2. 弹出 SmartScreen → 点更多信息 → 仍要运行。

3. 一路 Next → Install → Finish。

4. 从开始菜单启动 CC‑Switch，托盘出现图标。

macOS 首次打开拦截

系统设置 → 隐私与安全性 → 仍要打开；或终端执行：

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

---

四、首次配置（核心：添加国内可用模型，DeepSeek 为例）

1）打开界面

顶部默认是 Claude Code（先配这个），主区域是「提供商列表」（空）。

2）添加提供商（5 步）

1. 右上角点 +（添加提供商）。
2. 预设列表选 DeepSeek（国内直连，无需代理）。
3. 填写：
   • 名称：DeepSeek-Coder（随便写，好认）
   • API Key：sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx（DeepSeek 官网申请）
   • Base URL：默认 https://api.deepseek.com（不改）
   • 模型：选 deepseek-coder-v2（代码最强）
   • API 格式：默认 OpenAI Chat Completions
4. 点添加 → 列表出现该提供商。
5. 点右侧启用（Enable） → 状态变 Active（自动写入 Claude Code 配置）。

3）健康检查（验证是否可用）

点提供商旁健康检查 → 提示 Success 即正常。

---

五、日常使用：一键切换模型

1. 打开 CC‑Switch → 列表点任意提供商 → 启用 → 立即生效。
2. 终端直接运行：

claude

自动用当前启用的 Key 与模型。

托盘快速切换（不用开主窗口）

右键托盘 CC‑Switch 图标 → 直接选提供商 → 秒切。

---

六、国内常用预设（2026 可直连）

• DeepSeek：deepseek-coder-v2，代码强，国内直连。
• 阿里百炼：通义千问、通义代码。
• 47code / 小麦API：中转 Claude 3.5 / GPT‑4o（需注册充值）。

---

七、常见问题

1. Claude Code 提示无 API Key

   • 确认 CC‑Switch 中已启用提供商。
   • 重启终端（环境变量缓存）。
   • 健康检查是否 Success。

2. Windows 被杀毒拦截

   • 加入白名单，或用 Portable.zip 绿色版。

3. macOS 提示“无法验证开发者”

   • 系统设置 → 隐私与安全性 → 仍要打开。