一、CC‑Switch 简介
CC‑Switch 是开源跨平台桌面工具，一键管理 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenClaw 等 AI 工具的 API 配置，支持多供应商密钥快速切换、用量统计、会话管理，彻底告别手动改配置文件。
二、官方渠道
三、下载（全平台）
1. Windows
- 安装版（MSI）：下载
CC-Switch-v{版本}-Windows.msi - 绿色便携版：下载
CC-Switch-v{版本}-Windows-Portable.zip，解压即用
2. macOS
- Homebrew（推荐）：
bash
brew tap farion1231/ccswitch
brew install --cask cc-switch- 手动 DMG：下载
CC-Switch-v{版本}-macOS.dmg，拖入应用程序
3. Linux
- Debian/Ubuntu：
.deb包sudo dpkg -i - AppImage：
chmod +x后直接运行
四、安装步骤
Windows（MSI）
- 双击
.msi→ 同意协议 → 选路径 → 完成 - 便携版：解压后运行
CC-Switch.exe
macOS（DMG）
- 双击 DMG → 将
CC Switch.app拖入应用程序 - 首次打开提示"无法验证开发者"：系统设置 → 隐私与安全性 → 仍然打开
Linux（Debian）
bash
sudo dpkg -i CC-Switch-v{版本}-Linux.deb五、使用教程（核心流程）
1. 首次启动
打开后自动扫描已安装的 AI 工具（Claude Code、Codex 等），界面左侧为工具列表，右侧为配置区。
2. 添加 API 供应商（以小麦API为例）
-
点击「添加供应商」→ 填写：
- 名称：自定义（如"小麦API"）
- API 地址：
https://api.xiaomai.win/v1 - API Key：你的密钥
- 模型映射：按默认或自定义
-
保存后，在工具下拉菜单中选择该供应商即可一键切换。
3. 一键切换供应商
- 左侧选择目标工具（如 Claude Code）
- 顶部供应商下拉 → 选已添加的供应商 → 自动写入配置并生效
4. Claude Desktop 特殊配置（v3.15+）
- 内置路由转发，解决新版第三方 API 封锁
- 直接在 CC‑Switch 中配置模型映射，无需额外代理
5. 常用功能
- 用量统计：查看各供应商/工具的调用次数与额度
- 会话管理：保存/切换会话，支持恢复历史对话
- 故障切换：主供应商失效时自动切换到备用
六、常见问题
-
macOS 打开提示"无法验证开发者"
系统设置 → 隐私与安全性 → 下滑点「仍然打开」
-
Windows 杀毒误报
加信任/白名单，官方开源无恶意代码
-
切换后不生效
重启对应 AI 工具；检查 API Key 与地址是否正确
七、安全提醒
- 仅从 GitHub Releases 下载，拒绝付费/充值/登录要求
- 所有配置本地存储，不上传服务器