CC Switch：开源跨平台 AI 编程配置管理工具

CC Switch 是什么

CC Switch 是一款面向 AI 编程场景的开源配置管理工具，支持 macOS、Windows 和 Linux 三大桌面平台。官方将其定位为一站式 AI 编程工具 Hub，目标是在单一界面内管理多个 Agent 应用。

官网公开资料显示，CC Switch 可统一管理的应用包括 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw 与 Hermes Agent 七大应用。另一段官方介绍还提及 Grok Build、Pi 和 MiniMax Code，说明其覆盖范围仍在持续扩展。

核心功能

供应商统一管理

通过一个界面管理多个 Agent 应用的模型供应商、认证信息与 API 端点，支持热切换与备份恢复。

本地智能路由

内置熔断器、健康监控与故障转移队列。当主 Provider 出现异常时，可自动切换到备用节点，尽量不中断当前工作流。

用量与成本追踪

可实时查看请求数、Token 消耗、缓存命中、订阅额度与费用，并按应用和 Provider 分类筛选。

安全本地存储

配置与 API Key 存放在本地 SQLite 数据库，支持完整 Schema 迁移，数据不出境。

MCP / Skills / 提示词管理

统一管理 MCP 服务、Skills 技能包、Prompts 模板与 Hermes Memory，支持跨应用同步与软链接部署。

会话集中管理

汇聚各 Agent 的本地会话记录，支持搜索、恢复与删除，从而打破应用间的会话孤岛。

模型映射与协议转换

可将 Claude 官方角色 ID 或 Codex 的 GPT 模型名映射到第三方供应商的实际模型，并自动完成 Responses API 与 Chat Completions API 的协议转换。

如何使用 CC Switch

以下是基于官方资料整理的典型使用流程：

1. 下载安装：访问官网 https://ccswitch.io/ 下载对应系统安装包，安装后启动 CC Switch。
2. 选择管理目标：在主界面勾选需要管理的 Agent 应用，激活工具栏监控。
3. 添加供应商：在供应商配置页填写第三方 API 端点地址与认证令牌，保存后系统会自动检测连通性。
4. 开启本地路由：针对 Codex 或 Claude Desktop 等应用，启用“需要本地路由映射”开关，并保持代理常驻。
5. 配置模型映射：在映射设置中为 Sonnet/Opus/Haiku 或 GPT 系列指定实际请求的第三方模型名称。
6. 同步 Skills：在 Skills 管理页导入已有技能包，或从 ZIP 安装，通过软链接方式实时同步到各 Agent 的配置目录。
7. 监控用量：在用量统计面板查看实时请求日志、Token 消耗与成本曲线，并可设置额度预警。

核心优势

• 全应用覆盖：业界唯一同时支持 Claude 双端、Codex、Gemini、OpenCode、OpenClaw、Hermes 的统一管理器。
• 零侵入接入：无需修改 Agent 源码，仅通过环境变量指向本地代理即可使用第三方模型。
• 高可用路由：内置熔断与故障转移，主线路异常时毫秒级切换备用 Provider，保障开发连续性。
• 成本透明化：细粒度用量追踪可帮助开发者识别高消耗环节，据官方实测可节省约 30% 的 API 开支。
• 开源免费：基于 MIT 协议完全开源，社区驱动迭代，无商业授权门槛。

项目地址

• 官方网站：https://ccswitch.io/
• GitHub 仓库：https://github.com/farion1231/cc-switch

官方网站还提供了 GitHub 官方仓库、官方文档与更新日志入口，建议以官网最新信息为准。

适用场景

• 多模型 A/B 测试：在同一个项目中快速对比 Claude、GPT、DeepSeek、GLM 等模型的代码生成效果。
• 企业级 API 容灾：通过主备 Provider 自动切换，避免单一供应商限流或故障导致开发中断。
• 成本精细化管控：团队负责人可按项目或成员维度追踪 Token 消耗，优化模型调用策略。
• Skills 资产沉淀：将自定义 MCP 工具与 Prompt 模板集中管理，新成员可一键同步到所有 Agent。
• 跨应用会话续接：在 Claude Code 与 Codex 之间切换时保留上下文会话，减少重复沟通成本。

相关的开源生态项目

在公开资料中，还可见到两个 Skill 类开源项目，它们与 CC Switch 的配置管理定位不同，属于 AI 编程生态中的技能包：

• 开源 AI 前端设计技能包 Skill：用于解决千篇一律的 AI 审美问题。
• 开发者一泽 Eze 开源的 Agent Skill：用于思考如何上网。

如果你在寻找与 CC Switch 同类的工具，官方页面的“同类竞品对比”章节可作为进一步查阅的入口。

价格核验提示

CC Switch 目前是开源免费项目，采用 MIT 协议。不过，开源项目的能力边界、系统要求与支持范围可能随版本迭代而变化；文中涉及的模型映射、路由策略与成本节省比例等数据均来自公开资料，请以官网最新版本为准。涉及任何付费供应商或 API 费用时，也请直接咨询对应服务商。

FAQ

CC Switch 支持哪些操作系统？

支持 macOS、Windows 和 Linux，可从官网下载对应系统安装包。

CC Switch 支持哪些 AI 编程应用？

官方介绍涵盖 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw 与 Hermes Agent；公开资料还提到支持 Grok Build、Pi 和 MiniMax Code，具体以官网最新说明为准。

CC Switch 需要付费吗？

不需要。项目基于 MIT 协议开源免费，社区驱动迭代。

使用 CC Switch 要改源码吗？

不用。它采用零侵入接入方式，只通过环境变量指向本地代理即可使用第三方模型。

配置数据存在哪里？

所有配置与 API Key 存储在本地 SQLite 数据库，支持完整 Schema 迁移，数据不出境。