cc-switch:AI编程工具配置管理神器
cc-switch 是一个专门为 AI 编程工具(如 Claude Code、Codex 和 Gemini CLI)设计的跨平台配置管理和一键切换工具。
简单来说,它的主要用途是帮助开发者在不同的 AI 供应商、API 节点或模型配置之间快速切换,而不需要手动修改复杂的 JSON 配置文件。
核心功能
1. 多 CLI 工具支持
它能统一管理当前最流行的几个 AI 命令行编程助手的配置:
- Claude Code (Anthropic 官方命令行)
- Codex (OpenCode)
- Gemini CLI (Google AI)
场景举例: 你习惯用
Claude Code配合本地数据库 MCP 进行开发。现在你想试试Gemini CLI的效果,通常你需要重新去查阅 Gemini 文档,学习如何为它配置同样的数据库连接和 Prompt。 使用cc-switch,你可以一键将 Claude 的 MCP 和 Prompt 配置同步给 Gemini,直接开始工作,无需重复配置环境。
2. API 供应商一键切换
如果你有多个 API 来源(例如:官方 API、第三方中转 API、自建 API 代理),你可以将它们全部保存在 cc-switch 中。
- 一键应用: 在界面上点击一下或通过系统托盘图标,即可完成配置替换,无需重启复杂的设置流程。
- 测速功能: 内置 API 延迟测试,帮你找出当前响应最快的节点。
场景举例:
- 平时开发: 使用价格低廉的第三方中转 API。
- 紧急上线: 遇到中转不稳定时,一键切换回官方 Anthropic API 直连,确保服务稳定性。
- 调试网络: 使用测速功能对比 "US-Proxy" 和 "SG-Proxy" 哪个节点的延迟更低。
3. MCP 服务管理
MCP (Model Context Protocol) 是 Claude 等工具用来连接外部数据(如 Google Search、GitHub、本地文件系统)的协议。
cc-switch允许你统一添加、启用或禁用不同的 MCP 服务器。- 它能将配置同步到所有支持的 AI 工具中,避免在每个工具里重复配置。
场景举例: 你配置了
GitHub MCP来读取仓库代码,又配置了Postgres MCP来查询数据库。
- 当你只需要写前端代码时,可以一键禁用
Postgres MCP,减少 Token 消耗和上下文干扰。- 当你需要进行数据库迁移时,再单独开启它。
4. 技能 (Skills) 与提示词 (Prompts) 管理
- Skills 管理: 方便地安装、卸载和扫描 AI 的扩展功能(Skills)。
- 系统提示词 (System Prompts): 支持多套 Prompt 模板。你可以为不同的编程任务(如“重构代码”、“编写单测”)准备不同的提示词,并一键切换。
场景举例:
- 模式 A (TDD专家): 切换到 "Always write tests first" 的系统提示词,强制 AI 在写代码前先写单元测试。
- 模式 B (代码解释器): 切换到 "Explain like I'm 5" 的提示词,用于快速理解陌生的代码库。
5. 跨平台支持
它支持 Windows、macOS (Intel/Apple Silicon) 和 Linux。对于 macOS 用户,还支持通过 brew install --cask cc-switch 快速安装。
总结:谁需要它?
如果你是 AI 编程辅助工具的重度用户,且符合以下情况,那么这个工具对你非常有用:
- 频繁切换模型: 比如在 Claude 3.5 Sonnet 和 Gemini Pro 之间切换。
- 使用多个中转 API: 需要测试哪个节点更稳、更快。
- 讨厌改 JSON 配置: 觉得手动编辑
~/.claude/settings.json太麻烦且容易出错。
项目 GitHub 地址: farion1231/cc-switch