软件介绍
CC Switch 是一款基于 Tauri 的开源桌面工具,专为管理 AI 编程助手(Claude Code、Codex、Gemini CLI)的 API 配置而设计。它支持一键切换供应商、可视化 MCP 服务器管理、Skills 自动化安装,并提供 OpenAI→Anthropic 协议转换,可直接调用国产模型及 NVIDIA 免费额度,将 API 成本降低 70% 以上。轻量、安全、跨平台。
在AI编程工具爆发的时代,Claude Code、Codex、Gemini CLI等终端智能体已成为开发者的效率利器。但你是否也遇到过这样的烦恼:公益站的额度用完了要切换到另一个站,每次切换都要手动打开配置文件,小心翼翼地修改API地址和Key,确保JSON格式没错,保存后重启工具——这一套流程下来3-5分钟就没了,一天切个5次半小时就这样浪费了。
如果你正在寻找解决方案,那么CC Switch绝对值得关注。这款基于Rust + Tauri框架开发的桌面应用,在GitHub上已收获12.4K Star,被开发者誉为「API配置切换管家」。
软件简介:从供应商切换器到AI CLI管理平台
CC Switch是一款跨平台的桌面应用程序,专门用于管理Claude Code、Codex和Gemini CLI的API配置。它的本质是一个「终端智能体的配置文件管理工具」,可以让你在多个API提供商之间一键切换。
软件体验:Mac安装与上手
安装前提准备
在开始安装之前,请确保你的Mac满足以下条件:
- 系统要求:macOS 10.15及以上版本(支持Intel芯片与Apple Silicon芯片)
- 依赖环境:已安装Node.js 18+(用于Claude Code CLI运行,可选但推荐)
两种安装方式
方式一:Homebrew命令安装(推荐)
这是作者最推荐的安装方式,只需在终端依次执行以下命令:
添加CC-Switch的Homebrew仓库
brew tap farion1231/ccswitch
安装CC-Switch
brew install --cask cc-switch
安装完成后,在启动台就可以看到CC Switch的图标,直接点击即可启动。
更新也很简单:
brew upgrade --cask cc-switch
方式二:手动下载安装
- 访问GitHub官方Release页面:https://github.com/farion1231/cc-switch/releases
- 下载Mac版本安装包(格式为.zip或.tar.gz,无需区分芯片类型)
- 解压安装包,将CC Switch拖拽至「应用程序」文件夹
首次启动设置
首次安装后,若提示「无法打开,因为它来自身份不明的开发者」,需要进行以下设置:
- 打开「系统设置」→「隐私与安全性」
- 找到「安全性」模块,点击「仍要打开」
- 在弹出的确认窗口中选择「打开」
如果提示文件损坏,可以执行命令:xattr -d com.apple.quarantine /Applications/CC-Switch.app
快速上手配置
启动CC Switch后,界面非常简洁。默认Claude分类下没有供应商,需要先添加配置:
-
添加官方供应商:点击右上角黄色加号,选择「Claude Official」点击添加。官方线路的本质是一个占位符,启动它相当于删除第三方的API配置。
-
添加第三方供应商:继续点击加号,从预设供应商中选择你需要的(如Zhipu GLM、DeepSeek、Kimi等),粘贴API Key即可。
-
一键切换:在供应商列表找到目标配置,点击「使用」按钮,提示「切换成功」即可。
-
快速切换:点击Mac菜单栏的CC Switch图标,可以直接选择目标供应商,无需打开主窗口。
核心功能点:不止于切换
一键切换与供应商管理
CC Switch的核心功能是管理多个AI服务提供商配置,支持一键切换。与传统手动编辑方式相比,切换耗时从3-5分钟缩短至1-2秒,效率提升95%。
内置的预设配置开箱即用:
- 官方登录:Claude/Codex官方登录、Google官方
- 合作伙伴:OpenRouter、AIGoCode、PackyCode、DMXAPI、Cubence等
- 通用模型:GLM(智谱)、DeepSeek、MiniMax、通义千问、Kimi等
格式转换功能
v3.10.3 最关键的更新是新增了 OpenAI chat -> Anthropic messages 格式转换功能。它通过内置的“本地代理”模块,在 Mac 本地实时将 Claude Code 的专有请求“翻译”成通用的 OpenAI 格式。这意味着你不再被昂贵的 Anthropic 官方接口锁定,可以灵活接入市面上大量高性价比的第三方 API。
通过这个新功能,你可以轻松接入 NVIDIA 免费 API 额度(已集成预设模板),并实测可稳定调用 Kimi 2.5、MiniMax M2.1、GLM-4.7 等国产模型。对于高频开发者来说,这套方案的综合成本据说可以 降低 70% 以上。
MCP服务器可视化管理
MCP(Model Context Protocol)服务器管理是CC Switch的重要功能。它可以统一管理Claude/Codex/Gemini的MCP服务器,支持三种传输类型:stdio、HTTP、SSE。
通过CC Switch,你可以:
- 使用内置模板快速添加(如mcp-fetch、mcp-filesystem、mcp-github)
- 通过配置向导填写表单,无需手动编写JSON
- 一键启用/禁用服务器,自动同步到对应应用的配置文件中
Skills管理系统
v3.7.0引入的Claude Skills管理功能,可以自动扫描GitHub上的Claude Skills仓库,一键安装到~/.claude/skills/。v3.9.0开始支持Claude Code和Codex的多应用Skills。
Prompts预设管理
可以创建多套系统提示词预设(如架构师、测试员、文档工程师),支持Markdown编辑器实时预览。切换预设后,AI编程工具会自动适配对应角色的工作模式。
API速度测试与用量查询
在供应商列表点击「Test Speed」,可以测试不同供应商的响应时间、连接质量和可用性状态。国内用户实测选择国内节点比海外节点快3-5倍。
CC Switch还提供了用量查询功能,配置完成后,不用打开对应的平台也可以时刻查询用量信息。
多设备云同步
通过将配置目录指向云盘同步文件夹(坚果云/OneDrive/iCloud等),可以实现多设备自动同步。配置一次之后,公司电脑、家用电脑、Windows平台、WSL环境全部自动同步。
配置排序与导入导出
CC Switch提供了配置排序功能,点击「编辑」可以拖动配置进行排序,调整使用率较高的配置。同时支持一键导出配置分享给团队,自动备份最近10个版本。
应用特点:技术优势与亮点
轻量高效的技术架构
CC Switch采用Tauri 2框架,前端React + TypeScript,后端Rust。相比Electron轻量得多,安装包仅6M左右,基于Tauri框架实现原生性能,启动速度快且资源占用低。
安全可靠的数据设计
- SQLite + JSON双层存储:可同步的数据存SQLite,本地设备信息存JSON,为未来云同步打基础
- 原子写入与事务回滚:配置写入用临时文件+重命名模式,不怕写到一半崩溃导致配置损坏
- 并发安全:数据库连接有Mutex保护,多线程操作不会撕裂
- 自动备份:遇到旧版结构会自动生成备份文件,确保数据安全
深度链接与冲突检测
支持ccswitch://协议,别人分享一个链接你就能一键导入配置。同时自动发现跨应用的环境变量冲突,还会给解决建议。
跨平台完美支持
完美适配macOS(含M1/M2芯片)、Windows 10+、Linux(Ubuntu 22.04+ / Debian 11+ / Fedora 34+)。Apple Silicon芯片用户如果遇到兼容性问题,可安装Rosetta 2:softwareupdate --install-rosetta。
写在最后:效率提升的关键不止于工具本身
CC Switch的核心价值不在于创造新功能,而在于通过优秀的工程设计,解决了AI编程工具使用中的「隐性效率损耗」。对于需要同时使用多个AI模型的开发者来说,它不仅简化了配置流程,更通过云同步、技能管理等功能构建了完整的工作流生态。
搭配「规划用Claude官方模型,执行用国产模型」的省钱技巧,既能享受顶尖模型的理解能力,又能利用国产模型的高性价比和无时间限制优势,实现效率与成本的双重优化。
如果你同时使用Claude Code + Codex + Gemini中的两个以上,经常切换不同的API供应商,需要管理MCP服务器配置,或者想方便地管理Claude Skills和系统Prompts,那么CC Switch确实值得一试。
应用截图
安装说明
- 点击上方"下载"按钮下载 .dmg 安装包
- 双击下载的 .dmg 文件打开安装镜像
- 将 CC Switch 拖拽到 Applications 文件夹
- 从 Launchpad 或 Applications 文件夹启动应用
系统要求
- >= macOS 11.0














