跳到主要内容

cc-switch:AI编程工具配置管理神器

cc-switch 是一个专门为 AI 编程工具(如 Claude CodeCodexGemini 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