CC Switch

CC Switch 工具简介

CC Switch 是一款开源的跨平台 AI 编程配置管理工具，全面支持 macOS、Windows 和 Linux 系统。作为一个一站式的 AI 编程工具 Hub，它能够在单一界面中统一管理 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw 与 Hermes Agent 七大应用。用户无需修改代码即可接入第三方模型，实现供应商配置、本地路由、用量追踪、Skills 同步以及跨应用会话恢复的集中化管理。

核心功能特性

• 供应商统一管理：通过单一界面集中管理七大 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 的协议转换。

使用指南

1. 下载安装：访问官网下载对应操作系统的安装包，完成安装后启动 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 协议完全开源，由社区驱动迭代，无商业授权门槛。

同类竞品对比

• CC Switch：跨平台桌面应用（Tauri），管理 7 大 Agent 应用及本地路由，支持自动 Responses 与 Chat Completions 协议转换，具备内置熔断器、健康监控与队列，统一管理并跨应用同步 Skills/MCP，按应用与 Provider 二维统计用量，采用 MIT 协议，面向多 Agent 重度开发者。
• LiteLLM：Python 后端/代理服务，作为通用 LLM API 网关，支持 100+ 模型统一接口，支持负载均衡与 Fallback，Skills/MCP 需自行配置，提供企业级计费与观测，采用 MIT 协议，面向企业级 LLM 运维。
• ChatWise：跨平台桌面客户端，作为多模型对话客户端，依赖官方客户端，无故障转移功能，部分支持 MCP，提供基础 Token 统计，属于闭源商业软件，面向个人 AI 对话用户。

应用场景

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

项目地址

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