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