CC Switch

如果你用过 Claude Code,大概率经历过这种场景:为了接第三方模型,你得手动改一堆环境变量、复制 API Key 到配置文件、搞清楚每家的请求格式;某天主供应商宕机,你得临时切换备用节点,然后再逐个改回;你写好的 Skills 和 Prompt 模板,在不同 Agent 之间没法共享,每次都要复制粘贴一遍。更别说用量统计这种”明明应该有却怎么也找不到”的功能。

【金句】当一个开发者的本地环境里同时跑着 Claude Code、Codex、Gemini CLI、OpenCode 四五个 Agent 时,他真正需要的不是”再装一个 AI 工具”,而是一个能把它们统一管理起来的”控制中心”。

【金句】AI 编程工具的下一站,不是”模型更强”,而是”工具链更整齐”。

CC Switch 想解决的就是这一类问题。它是一个开源的跨平台 AI 编程配置管理工具,基于 Tauri 构建,支持 macOS、Windows、Linux 三大平台,据其官网披露,可以统一管理 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent 七大应用的供应商配置、本地路由、用量追踪、Skills 同步及跨应用会话恢复。

【金句】把零散的 AI 编程工具收纳进同一个控制台,让”多 Agent 工作流”第一次有了工业化的形态。

它的最大特点是”零侵入”:开发者不需要修改任何一个 Agent 的源码,只需要让它们的环境变量指向 CC Switch 的本地代理,就可以让所有 Agent 自动使用第三方模型,同时保留原本的功能。这种”中间层 + 转发器”的思路,和当年 OpenClaw、Cursor 用统一入口接管多种 AI 模型的方式如出一辙,但更聚焦在”多 Agent 并存”的开发场景。

【金句】好的工具不在于”做出新功能”,而在于”把已有功能拼整齐”。

对个人开发者来说,CC Switch 把繁琐的配置切换变成图形界面点几下;对团队来说,它的用量追踪与 Skills 同步,让”团队 AI 资产沉淀”成为可能。

工具简介

CC Switch 是开源的跨平台 AI 编程配置管理工具,基于 Tauri 框架开发,据其官网披露,可以在一个统一界面中管理 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent 七大主流 Agent 应用的供应商配置、本地路由、用量追踪、Skills 同步与跨应用会话恢复。

【金句】AI 编程工具的”基础设施”,不是新的 Agent,而是让已有 Agent 更好用的连接器。

平台采用本地优先设计:所有配置、API Key、会话记录都存储在本地 SQLite 数据库中,数据不出境,支持完整 Schema 迁移。对重视数据安全的开发者与企业来说,这种”本地存、云端不用”的模式更可控。

【金句】工具的安全性,不是”加多少把锁”,而是”数据根本不离开你的电脑”。

CC Switch 通过本地代理的方式,把 Agent 的请求转发到第三方 Provider,同时提供熔断器、健康监控、故障转移队列,在主 Provider 异常时毫秒级切换到备用节点,不需要中断工作流。这种”对 Agent 透明、对开发者可控”的设计,让它成为多 Agent 重度开发者的效率工具。

核心功能

供应商统一管理

CC Switch 提供一个图形界面管理七大 Agent 应用的模型供应商、认证信息与 API 端点,支持热切换与备份恢复。开发者可以在同一窗口中切换 Claude、GPT、DeepSeek、GLM、Qwen 等不同供应商,不需要逐个修改各 Agent 的配置文件。

【金句】配置管理的本质,不是”能改配置”,而是”改一次,所有 Agent 同步生效”。

本地智能路由

平台内置熔断器、健康监控与故障转移队列。主 Provider 异常时,系统自动把请求切换到备用节点,无需中断工作流。对追求高可用的在线服务、关键开发场景来说,这种”毫秒级容灾”是必备能力。

用量与成本追踪

CC Switch 实时统计请求数、Token 消耗、缓存命中、订阅额度与费用,支持按应用、按 Provider 二维度筛选。开发者可以一眼看出”哪个 Agent 在哪个模型上花了多少钱”,识别高消耗环节,优化模型调用策略。

【金句】AI 编程的成本可视化,是控制预算的第一步。

安全本地存储

所有配置与 API Key 存储在本地 SQLite 数据库,支持完整 Schema 迁移,数据不出境。对企业用户来说,这种本地优先的存储模式比”云端存密钥”更让人放心,也更容易通过内部安全审计。

MCP/Skills/Prompts 统一管理

CC Switch 统一管理 MCP(Model Context Protocol)服务、Skills 技能包、Prompts 模板与 Hermes Memory,支持跨应用同步与软链接部署。开发者可以在一个地方管理所有 Agent 的工具集与提示词,新成员一键同步到所有 Agent,避免重复维护。

会话集中管理

平台汇聚各 Agent 的本地会话记录,支持搜索、恢复与删除,打破应用间的会话孤岛。当你在 Claude Code 和 Codex 之间切换项目时,不需要重新描述上下文,CC Switch 可以把会话历史集中归档。

【金句】会话连续性是 AI 编程工作流被低估的”软资产”。

模型映射与协议转换

CC Switch 可以把 Claude 官方角色 ID(Sonnet/Opus/Haiku)或 Codex 的 GPT 模型名,自动映射到第三方供应商实际模型。同时支持 Responses API 与 Chat Completions API 的协议转换,解决了不同 Agent 使用不同协议带来的对接成本。

跨应用会话恢复

平台支持跨应用会话恢复,在不同 Agent 之间切换时,保留上下文会话,减少重复沟通成本。这一能力对同时使用多个 Agent 的开发者尤其有价值。

使用场景

【金句】AI 编程工作流的真正门槛,不是”用哪个模型”,而是”在不同模型间切换的成本”。

多 Agent 并存的开发者:很多资深开发者的本地环境同时运行 Claude Code、Codex、Gemini CLI 等多个 Agent,每个 Agent 都需要独立配置供应商、API Key、Skills。CC Switch 把这些配置集中管理,一次配置、全员生效。

多模型 A/B 测试:开发者在同一项目中需要对比 Claude、GPT、DeepSeek、GLM 等模型的代码生成效果。CC Switch 让切换变成点击几下,几小时内就能完成一轮完整对比。

【金句】AI 编程的工具栏里,真正缺的从来不是新模型,而是”切换模型的快捷方式”。

企业级 API 容灾:通过主备 Provider 自动切换,避免单一供应商限流或故障导致开发中断。对依赖 AI 编程的团队来说,这是保持开发节奏的关键。

成本精细化管控:团队负责人按项目或成员维度追踪 Token 消耗,优化模型调用策略。CC Switch 的二维统计(应用 × Provider)让成本归因更直观。

Skills 资产沉淀:将自定义的 MCP 工具与 Prompt 模板集中管理,新成员一键同步到所有 Agent。团队的”AI 资产”第一次有了沉淀的载体。

跨应用会话续接:在 Claude Code 与 Codex 之间切换时,保留上下文会话,减少重复沟通成本。这一能力对复杂项目的多 Agent 协作尤其关键。

个人开发者的统一面板:对个人用户来说,CC Switch 把分散在多个 Agent 中的配置、Skills、用量集中管理,让”AI 编程”从”散点工具”升级为”集成工作台”。

收费方案

【金句】开源工具的真正价值,不是”免费”,而是”代码透明、可定制、不被锁定”。

CC Switch 目前为开源项目,核心功能完全免费。后续是否推出商业版、以何种形式收费,以官方公告为准。

功能特点 / 同类对比

【金句】多 Agent 管理工具的真正差异,不在”管了多少 Agent”,而在”管得有多深”。

全应用覆盖:据其官网披露,CC Switch 是业界唯一同时支持 Claude 双端、Codex、Gemini、OpenCode、OpenClaw、Hermes 七大 Agent 的统一管理器。这一覆盖广度在同类工具中较为罕见。

零侵入接入:无需修改 Agent 源码,仅通过环境变量指向本地代理,即可使用第三方模型。这种”中间层转发”的方式,让开发者随时回滚,不需要担心改坏 Agent。

高可用路由:内置熔断与故障转移,主线路异常时毫秒级切换备用 Provider,保障开发连续性。

成本透明化:细粒度用量追踪帮助开发者识别高消耗环节,据其官方资料,合理使用可帮助开发者节省约 30% 的 API 开支。

【金句】AI 编程成本的优化,从来不是”用更便宜的模型”,而是”看清账本再决定”。

开源免费:MIT 协议完全开源,社区驱动迭代,无商业授权门槛。

相比 LiteLLM(自托管网关)、ChatWise(多模型对话客户端)等同类产品,CC Switch 的差异化在于”聚焦多 Agent 编程场景”:LiteLLM 偏企业级 LLM 运维,ChatWise 偏个人对话体验,CC Switch 则填补了”多 Agent + 编程工作流”这一中间地带的空白。

优缺点

【金句】工具的好与坏,取决于它和你的工作流是不是”对的搭档”。

优点:

• 覆盖 7 大主流 Agent 应用,管理范围广
• 零侵入接入,不需要修改 Agent 源码
• 内置熔断与故障转移,工程稳定性强
• 本地存储 API Key,数据不出境,安全性高
• 开源免费,代码透明,可深度定制
• 二维用量统计,成本归因清晰

缺点:

• 需要本地常驻代理进程,占用少量系统资源
• 部分新发布的 Agent 模型需要等待版本更新支持
• 二进制分发依赖 Tauri 框架,部分小众 Linux 发行版可能需要自行编译
• 跨应用会话恢复能力依赖各 Agent 的本地存储格式,实际兼容性需以最新版本为准
• 企业级 SSO、审计日志等高级特性,据其官网披露需通过商务对接

使用教程

【金句】好的工具,应该让”上手”和”放弃”同样简单。

1. 下载安装:访问 CC Switch 官网 `ccswitch.io/` 或 GitHub Release 页面,根据操作系统下载对应安装包(macOS / Windows / Linux)。完成后启动 CC Switch。
2. 选择管理目标:在主界面勾选需要管理的 Agent 应用(如 Claude Code、Codex、Gemini CLI 等),激活工具栏监控。
3. 添加供应商:进入供应商配置页,填写第三方 API 端点地址与认证令牌(如 DeepSeek、GLM、OpenRouter 等),保存后系统会自动检测连通性。
4. 开启本地路由:针对 Codex 或 Claude Desktop 等应用,启用”需要本地路由映射”开关,保持 CC Switch 代理常驻。
5. 配置模型映射:在映射设置中为 Sonnet/Opus/Haiku 或 GPT 系列指定实际请求的第三方模型名称。例如让 Claude Code 的”claude-sonnet-4″指向”deepseek-chat”。
6. 同步 Skills:在 Skills 管理页导入已有技能包或从 ZIP 安装,通过软链接方式实时同步到各 Agent 的配置目录。
7. 监控用量:在用量统计面板查看实时请求日志、Token 消耗与成本曲线,设置额度预警,避免超额。
8. 备份与恢复:定期通过导出功能备份本地配置,换设备或重装系统时可以一键恢复。

常见问题

【金句】工具的真正门槛,不是”会不会用”,而是”出问题时怎么救场”。

CC Switch 是免费的吗?
是的,据其官网披露,CC Switch 采用 MIT 协议完全开源,核心功能对个人和商业用途均免费。后续如推出商业版本或企业级服务,以官方公告为准。

支持哪些 Agent?
据其官网披露,目前支持 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent 七大应用。具体支持列表以最新版本为准。

API Key 安全吗?会泄漏吗?
所有 API Key 存储在本地 SQLite 数据库,数据不出境。但本地存储不等于绝对安全,建议用户使用操作系统级的全盘加密(如 FileVault、BitLocker),并避免在公共电脑使用 CC Switch。

需要一直开着代理吗?
对需要本地路由映射的应用(如 Codex、Claude Desktop),需要保持 CC Switch 代理常驻;对只使用配置文件切换的应用,可以在切换时启动代理,完成后关闭。

支持哪些第三方供应商?
理论上兼容所有提供 OpenAI 兼容接口的供应商,包括 DeepSeek、GLM、Qwen、Moonshot、OpenRouter 等。具体兼容性以实际测试为准。

跨应用会话恢复可靠吗?
这一功能依赖各 Agent 的本地存储格式,实际兼容性可能因 Agent 版本而异。建议把 CC Switch 作为辅助手段,关键会话仍需手动备份。

和小火箭、Surge 等代理工具有冲突吗?
CC Switch 的本地代理是 HTTP/HTTPS 协议,与一般代理工具共存,具体配置需根据本地网络环境测试。

🔗 官网与下载链接

• 项目官网:https://ccswitch.io/
• GitHub 仓库:https://github.com/farion1231/cc-switch
• 下载页:见 GitHub Release 或官网首页
• 文档与使用指南:见 GitHub 仓库 docs 目录

行动建议

【金句】工具的本质不是”越多越好”,而是”越少越对”。

如果你是单 Agent 轻度用户:可能暂时不需要 CC Switch,直接使用对应 Agent 的官方配置即可。等你开始用第二个 Agent,或开始频繁切换模型时,再考虑引入。

如果你是多 Agent 重度开发者:CC Switch 是值得立刻尝试的工具,特别是当你在 Claude Code、Codex、Gemini CLI 之间频繁切换时。建议先按官方文档完成基础配置,再逐步启用路由、Skills 同步等高级功能。

如果你是团队负责人:可以评估 CC Switch 在以下场景的适用性:团队 Skills 资产统一管理、用量统计与成本归因、新成员快速上手。如果团队对数据安全敏感,本地存储 + 开源的组合会更可控。

如果你是企业 IT:据其官网披露,如需私有部署、定制开发、企业级技术支持,可以联系 CC Switch 团队对接。建议先在内部小范围试点,验证兼容性与稳定性,再决定是否推广。

如果你是 AI 编程创业者:CC Switch 提供了一个观察多 Agent 生态的窗口。可以从它的功能设计里看到开发者真正痛的需求点,反过来指导自己的产品方向。