一个桌面工具，管六个 AI Agent：Claude Code、Codex、Gemini CLI、OpenClaw、Hermes 全部一站式切换
同时在用 Claude Code、Codex、Gemini CLI、OpenClaw、Hermes Agent 的人，大概都有一个共同的痛点：每次切工具就像切人格。
不同的 API Key、不同的配置文件、不同的 Skills 目录、不同的 MCP 服务器。改一个参数要去翻对应的文档，切一个供应商要手动改环境变量。烦不胜烦。
cc-Switch 的解决思路很直接：把所有 Agent 的配置和管理集中到一个桌面工具里。 不改你习惯的工具，只是帮你把钥匙串、插件柜、会话记录统一管理起来。
一、cc-Switch 是什么
cc-Switch 是一个跨平台桌面应用，一个界面管六个 Agent：
| Agent | 状态 |
|---|---|
| Claude Code | ✅ 支持 |
| Codex | ✅ 支持 |
| Gemini CLI | ✅ 支持 |
| OpenCode | ✅ 支持 |
| OpenClaw | ✅ 支持 |
| Hermes Agent | ✅ 支持 |
跨平台： Windows（便携版 + 安装版）、macOS、Linux。
二、五大核心功能
1. 供应商管理：一键切模型
这是 cc-Switch 最核心的功能。
不同的大模型 API 经常搞活动——DeepSeek 有优惠、某家赠送 Token、另一个出了新模型想试试。以前的做法是手动改配置文件里的 API Key、Base URL、Model Name。每次切换都像在做手术。
cc-Switch 做的事：
- 新建供应商 — 预设模板自动填充常见配置（DeepSeek、通义千问、月之暗面等）
- 一键切换 — 主界面点一下就切过去，终端里的 Agent 自动用新配置
- 用量查询 — 实时看剩余额度、多套餐显示
- 排序与复制 — 拖拽排序优先级，复制一个供应商改 Key 就是新配置
底层原理： cc-Switch 会直接修改各个 Agent 的配置文件，但只改你需要的部分，保留其他配置不变。
2. Skills 管理：装、卸、开、关
每个 Agent 都有自己的 Skills 系统，装多了会互相干扰。
cc-Switch 提供统一的 Skills 管理面板：
- 发现技能 — 浏览可用的 Skills 列表
- 安装/卸载 — 下载 zip 直接导入，不用手动找目录
- 仓库管理 — 管理 Skill 来源仓库
⚠️ 注意：Hermes 不识别软连接的 Skills。在 cc-Switch 设置里需要把 Skills 方式从"软连接"改为"复制"。
3. MCP 服务器管理
MCP（Model Context Protocol）是 Agent 调用外部工具的标准协议。每个 Agent 的 MCP 配置格式不同，手动改 JSON 容易出错。
cc-Switch 的 MCP 管理：
{
"type": "stdio",
"command": "uvx",
"args": ["java-decompile-mcp"],
"env": {
"CFR_PATH": "/path/to/cfr.jar"
},
"disabled": false
}
- 图形界面填写参数，不用手写 JSON
- 一键启用/禁用
- 应用绑定 — 指定 MCP 服务器给哪个 Agent 用
4. Prompts 提示词管理
系统提示词直接影响 AI 的行为和回复风格。cc-Switch 提供提示词预设功能：
- 创建预设 — 不同场景用不同的系统提示词
- 一键激活 — 切换预设不需要重启 Agent
- 智能回填 — 切换时自动填入 Agent 的配置
5. 会话管理器
可以查看 Agent 的历史会话记录：
- 浏览所有历史对话
- 搜索过滤特定内容
- 恢复中断的会话（resume）
- 点击文件夹名复制路径，跳转继续
三、进阶功能：本地路由与故障转移
本地路由
有些大模型不支持 Claude 格式的 API 请求，只支持 OpenAI 风格。cc-Switch 提供本地路由功能：
Claude Code 请求 → http://127.0.0.1:15721/v1/messages → 转发到目标 API
开启本地路由后，Claude Code 以为自己在跟 Anthropic 对话，实际上 cc-Switch 在中间做协议转换，把请求转发给任何兼容 OpenAI 格式的模型。
使用场景：
- 某家大模型便宜量大但只支持 OpenAI 格式
- 有赠送的 Token 想在 Claude Code 里用
- 想用本地 Ollama 跑的模型
⚠️ 注意：开启本地路由后，不要用 cc-Switch 的"打开终端"按钮，要自己开一个终端输入
claude。因为 cc-Switch 的按钮会用原始的ANTHROPIC_BASE_URL，而不是本地路由地址。
故障转移
- 故障转移队列 — 主供应商挂了自动切到备选
- 熔断器 — 连续失败的供应商自动冷却
- 健康状态 — 实时显示各供应商的可用性
用量统计
- 趋势图表展示消耗趋势
- 定价配置 — 不同模型的单价设定
- 多套餐显示 — 区分免费额度和付费额度
四、安装
从 GitHub Releases 下载最新版。
Windows： 有便携版（.exe）和安装版，按需选择。
macOS： 下载 .dmg 安装。
Linux (Ubuntu)：
sudo dpkg -i CC-Switch-v3.13.0-Linux-x86_64.deb
# 如果报错，修复依赖
sudo apt install -f -y
# 重新执行
sudo dpkg -i CC-Switch-v3.13.0-Linux-x86_64.deb
大模型和 Agent 日新月异，建议下载最新版并及时更新。
五、用户手册完整目录
cc-Switch 的文档体系很完整，按模块组织：
| 模块 | 子模块 |
|---|---|
| 快速入门 | 软件介绍、安装指南、界面概览、快速上手、个性化配置 |
| 供应商管理 | 添加、切换、编辑、排序复制、用量查询 |
| 扩展功能 | MCP 服务器、Prompts 提示词、Skills 技能、会话管理器、工作区文件 |
| 代理与高可用 | 代理服务、应用接管、故障转移、用量统计、模型检查 |
| 常见问题 | 配置文件说明、FAQ、深度链接协议、环境变量冲突 |
完整手册：https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/README.md
六、与同类工具对比
| 维度 | cc-Switch | 各 Agent 自带配置 |
|---|---|---|
| 供应商切换 | 点一下 | 手动改配置文件 |
| Skills 管理 | 统一面板 | 每个 Agent 各自的目录 |
| MCP 管理 | 图形化 | 手写 JSON |
| 多 Agent 统一 | ✅ 6 个 Agent | ❌ 各管各的 |
| 故障转移 | 自动 | 无 |
| 用量统计 | 可视化图表 | 看 API 后台 |
cc-Switch 不改变你用的 Agent，只是让管理从"手动挡"变成"自动挡"。
七、适用人群
| 适合 | 不适合 |
|---|---|
| 同时用 2+ 个 Agent 的人 | 只用一个 Agent |
| 经常换模型/换供应商 | API Key 固定不变 |
| 需要管理大量 Skills 和 MCP | 不用 Skills/MCP |
| 想把配置集中管理 | 享受手动改配置的掌控感 |
如果你只用 Claude Code 且 API Key 不变，可能不需要 cc-Switch。但如果你同时在玩 Codex、Gemini CLI、OpenClaw，又经常因为各家 API 的活动换供应商——这个工具值得装。
项目地址： https://github.com/farion1231/cc-switch
用户手册： https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/README.md