CC-Switch 下载、安装与使用配置指南【2026.5.29】

一、CC‑Switch 简介

CC‑Switch是开源跨平台桌面工具，一键管理 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenClaw 等 AI 工具的 API 配置，支持多供应商密钥快速切换、用量统计、会话管理，彻底告别手动改配置文件。

二、官方渠道

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

三、下载（全平台）

1. Windows

• 安装版（MSI）：下载CC-Switch-v{版本}-Windows.msi
• 绿色便携版：下载CC-Switch-v{版本}-Windows-Portable.zip，解压即用

2. macOS

• Homebrew（推荐）：

brew tap farion1231/ccswitch brewinstall--caskcc-switch

• 手动 DMG：下载CC-Switch-v{版本}-macOS.dmg，拖入应用程序

3. Linux

• Debian/Ubuntu：.deb包sudo dpkg -i
• AppImage：chmod +x后直接运行

四、安装步骤

Windows（MSI）

1. 双击.msi→ 同意协议 → 选路径 → 完成
2. 便携版：解压后运行CC-Switch.exe

macOS（DMG）

1. 双击 DMG → 将CC Switch.app拖入应用程序
2. 首次打开提示“无法验证开发者”：系统设置 → 隐私与安全性 → 仍然打开

Linux（Debian）

sudodpkg-iCC-Switch-v{版本}-Linux.deb

五、使用教程（核心流程）

1. 首次启动

打开后自动扫描已安装的 AI 工具（Claude Code、Codex 等），界面左侧为工具列表，右侧为配置区。

2. 添加 API 供应商（以小麦API为例）

1. 点击「添加供应商」→ 填写：

   • 名称：自定义（如“小麦API”）
   • API 地址：https://api.xiaomai.win/v1
   • API Key：你的密钥
   • 模型映射：按默认或自定义

2. 保存后，在工具下拉菜单中选择该供应商即可一键切换。

3. 一键切换供应商

1. 左侧选择目标工具（如 Claude Code）
2. 顶部供应商下拉 → 选已添加的供应商 → 自动写入配置并生效

4. Claude Desktop 特殊配置（v3.15+）

• 内置路由转发，解决新版第三方 API 封锁
• 直接在 CC‑Switch 中配置模型映射，无需额外代理

5. 常用功能

• 用量统计：查看各供应商/工具的调用次数与额度
• 会话管理：保存/切换会话，支持恢复历史对话
• 故障切换：主供应商失效时自动切换到备用

六、常见问题

1. macOS 打开提示“无法验证开发者”
   系统设置 → 隐私与安全性 → 下滑点「仍然打开」

2. Windows 杀毒误报
   加信任/白名单，官方开源无恶意代码

3. 切换后不生效
   重启对应 AI 工具；检查 API Key 与地址是否正确

七、安全提醒

• 仅从GitHub Releases下载，拒绝付费/充值/登录要求
• 所有配置本地存储，不上传服务器