CC Switch 是什么？一款统一管理 AI 编程工具与模型供应商的控制台
介绍 CC Switch 的核心用途、适合人群、安装方式，以及它在 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent 等工具中的模型供应商管理能力。
一、CC Switch 是什么？
CC Switch，也就是很多人说的 cc-switch，是一款开源的跨平台桌面应用。它最初给人的印象像是 Claude Code、Codex、Gemini CLI 这类 AI 编程工具的「模型切换器」，但现在已经逐渐发展成一个更完整的 AI 工具统一管理控制台。
项目地址在这里：farion1231/cc-switch。
它解决的是一个非常具体、但又非常折磨人的问题：当你同时使用多个 AI 编程工具、多个 API 服务商、多个模型和多个 key 时，不想每次都手动去改 JSON、TOML、YAML 或 `.env` 配置文件。
如果你只使用一个官方工具、一个官方账号、一个固定模型，可能暂时感觉不到它的价值。但只要你开始同时使用 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw，或者经常在 OpenAI、Anthropic、DeepSeek、OpenRouter、Kimi、千问、智谱等不同服务商之间切换，你就会发现 CC Switch 能节省大量配置和排错时间。
简单说，CC Switch 做的事情是：
text 多个 AI 工具 + 多个模型供应商 + 多个 API Key + 多种配置格式 ↓ 统一放进一个图形化管理界面
二、为什么需要它？
AI 编程工具越来越多，但每个工具的配置方式都不一样。
Claude Code 有自己的配置方式，Codex 有自己的配置方式，Gemini CLI、OpenCode、OpenClaw、Hermes Agent 也各有规则。你想换一个模型，可能就要找配置文件；你想换一个供应商，可能就要改 base_url、api_key、model；你想测试多个国产模型、中转服务或聚合平台，配置就更容易乱。
对程序员来说，这些事情不算特别难，但很烦。对非程序出身的用户来说，这件事甚至有点劝退。
我自己第一次给 Claude Code 手动接第三方模型的时候，就明显感受到这种痛苦。文档让你找到配置文件，然后手填各种字段，比如 base_url、auth_token、model name。字段本身不难，但只要填错一个字符，就可能直接报错。
更麻烦的是，有些 Agent 工具在模型切换时很容易把自己搞崩。你本来只是想试试新模型，结果配置切着切着，工具直接不可用了。这种体验非常糟糕。
CC Switch 的价值就在这里：它把这些配置文件背后的复杂性，封装成了一个可视化界面。
你不需要反复打开配置文件，不需要记每个工具的配置格式，也不用每次复制粘贴一堆 JSON。你只需要在界面里选择工具、选择供应商、填入 API Key、选择模型，然后保存启用。
三、它支持哪些工具？
按照项目 README、官方站点和更新说明，CC Switch 目前主要面向这些 AI 工具：
1. Claude Code 2. Claude Desktop 3. Codex 4. Gemini CLI 5. OpenCode 6. OpenClaw 7. Hermes Agent
也就是说，它已经不是单纯给 Claude Code 用的工具，也不只是传统意义上的 AI CLI 管理器。因为 Claude Desktop 也被纳入管理范围，所以更准确的说法是：它是一个面向 AI 编程工具和桌面端 AI 工作流的统一管理控制台。
你可以把它理解成一个专门给 AI 工具准备的「模型配置控制台」。不同工具下面可以挂不同的供应商配置，互不干扰，也可以通过系统托盘快速切换。
四、新版本值得关注的变化
如果你之前了解的是老版本 CC Switch，那么现在最值得注意的是：它的定位已经从「模型切换器」扩大到「AI 工具管理中心」。
比较重要的新变化包括：
1. Claude Desktop 被纳入独立管理面板：不仅能管理 Claude Code，也能管理 Claude Desktop 的第三方供应商配置。 2. 模型映射能力增强：可以把 Sonnet、Opus、Haiku 这类角色映射到第三方供应商真实模型 ID。 3. 本地路由能力增强：可用于代理请求、格式转换、故障转移和部分兼容性处理。 4. 用量与余额显示更直观：更适合多 key、多供应商用户做成本管理。 5. MCP、Skills、Session 管理继续完善：适合正在搭建 Agent 工作流的人。 6. 轻量模式更适合常驻后台：可以让 CC Switch 在系统托盘运行，不必一直打开主窗口。 7. Codex、Gemini、OpenCode 等工具的兼容性持续增强：不同工具之间的配置管理越来越统一。
所以，如果你过去只是把它当成 Claude Code 的供应商切换器，现在可以重新理解它：它正在变成一套 AI 编程工具生态的本地控制台。
五、它的核心功能
1. 可视化管理模型供应商
CC Switch 内置了大量供应商预设，覆盖官方 API、云厂商、聚合平台和社区服务商。随着版本更新，预设数量和支持范围也在不断扩展。
这意味着你不用从零开始手写配置。很多时候，你只需要选择一个供应商，填入 API Key，再选择模型即可。
如果你用的是智谱、DeepSeek、千问、Kimi、MiniMax、DouBaoSeed、阶跃，或者其他支持 OpenAI / Anthropic 类接口的服务商，通常都可以通过类似方式接入。
当然，不同供应商的兼容性和模型列表查询能力不完全一样。有的可以直接获取模型列表，有的需要手动填写模型名称。这个要以你实际使用的服务商为准。
2. 一键切换与托盘快速切换
配置好供应商之后，你可以在 CC Switch 里直接启用某个配置。它会把对应配置写入目标工具的配置文件。
更方便的是，它支持系统托盘快速切换。你不一定每次都要打开完整主界面，只要点击菜单栏或系统托盘里的 CC Switch 图标，就可以快速切换对应工具的供应商配置。
这一点对高频使用 AI 编程工具的人非常实用。
比如你做小任务时，用一个便宜、响应快的模型；遇到复杂重构或长上下文任务时，再切到更强的模型。以前这个过程需要手动改配置，现在基本变成点几下鼠标。
3. Claude Code 支持相对顺滑的热切换
官方 FAQ 里有一个很重要的说明：大多数工具在切换 provider 后，通常需要重启终端或 CLI 工具才能生效；但 Claude Code 当前支持 provider 数据的热切换，不一定需要重启。
这也是很多人喜欢拿 CC Switch 搭配 Claude Code 的原因。
不过这里要注意：不要在模型正在生成、工具正在执行任务的时候强行切换。
比较稳妥的做法是，等当前轮回复结束，再去切模型。否则有可能出现请求中断、会话异常或报错。
4. Claude Desktop 管理
新版 CC Switch 开始把 Claude Desktop 纳入独立管理面板。它可以帮助用户管理 Claude Desktop 的第三方推理配置，并通过本地路由和模型映射解决部分非 Claude 系列模型的兼容问题。
不过，Claude Desktop 的使用场景和 Claude Code 不同。Claude Code 更偏向命令行开发和 Agent 执行，Claude Desktop 更偏向日常对话、资料整理和桌面端使用。
所以这篇文章只把 Claude Desktop 作为新增能力介绍，不展开写接入教程。具体接入 OpenRouter、DeepSeek 等第三方供应商，可以单独写一篇专题。
5. 模型映射
模型映射是新版 CC Switch 里很重要的能力。
有些工具只识别固定的模型角色，比如 Sonnet、Opus、Haiku；但第三方供应商使用的是自己的真实模型 ID，例如 deepseek-v4-pro、deepseek-v4-flash、inclusionai/ring-2.6-1t 等。
CC Switch 可以在中间做一层映射：
text 工具侧看到的模型角色 → 第三方供应商真实模型 ID
这对 Claude Desktop、Claude Code 以及部分第三方供应商的兼容非常重要。它的意义不是让模型真的变成 Claude，而是让工具侧能够正常识别和调用。
6. 用量查询与成本统计
CC Switch 提供了用量查询和统计功能。你可以在模型列表里配置用量查询，用来查看部分 API Key 的余额、消耗情况，或者某些 token plan 的剩余额度。
这点对经常接多个供应商的人很有用。
因为很多时候，你不是不知道哪个模型好，而是不知道自己到底烧了多少钱。CC Switch 把这些信息集中放出来后，你就能更清楚地做成本管理。
比如：
- 日常小任务用低成本模型；
- 长文档整理用性价比模型；
- 复杂代码重构再切到更强模型；
- 睡前跑长任务前，先确认额度是否充足。
对重度 AI 编程用户来说，这个功能不是锦上添花，而是非常实际。
7. 本地路由、故障转移与熔断保护
CC Switch 另一个比较高级的功能，是本地路由与故障转移。
它可以在本地启动一个代理服务，接管部分工具发出的请求，并在本地做 API 格式转换、自动故障转移、熔断保护和供应商健康监控。
翻译成人话就是：你可以给同一个工具配置多个供应商，比如 GLM、DeepSeek、Kimi、MiniMax、OpenRouter 等。当某个供应商额度用完、服务异常、响应超时或暂时不可用时，CC Switch 可以尝试切到下一个可用供应商，避免任务直接失败。
这个功能特别适合那些喜欢让 Agent 长时间跑任务的人。
比如你睡前让 Claude Code 跑一个比较大的项目改造，结果半夜某个供应商额度没了。如果没有故障转移，第二天起床一看，任务可能早就中断了；如果配置了合适的备用供应商，至少有机会继续往下跑。
不过，这个功能也不是万能的。不同模型之间能力、上下文长度、工具调用兼容性和输出风格都不完全一样。故障转移能提高稳定性，但不代表所有任务都能无缝迁移。
如果你使用的是官方 Claude 模型，是否开启本地路由也要谨慎测试。我的建议是：先用小任务验证稳定性，再决定是否长期打开。
8. MCP、Skills 与提示词管理
新版 CC Switch 已经不只是模型切换器了。官方 README 和用户手册里也强调了它对 MCP、Skills、Prompts 等扩展能力的管理。
MCP 可以理解为给 AI 编程工具接外部工具和服务的协议生态；Skills 则更像是一组可复用的能力包或工作流能力；Prompts 则是可复用提示词或系统指令。
以前这些东西分散在不同工具里管理，很容易乱。CC Switch 的思路是把这些扩展能力集中到一个面板里，方便你在多个 AI 编程工具之间同步和管理。
如果你只是普通用户，前期可以先不用管 MCP 和 Skills，先把模型供应商切换用明白就够了。但如果你已经开始搭建自己的 Agent 工作流，或者经常折腾 Claude Code、Codex、OpenCode 这些工具，那么这一块后面会很有价值。
9. Session 管理
对 AI 编程工具来说，Session 管理也很重要。
很多 Agent 任务不是一次对话就结束，而是围绕一个项目持续推进。Session 里可能包含上下文、任务进度、工具调用痕迹、历史命令和当前目标。如果这些内容散落在不同工具里，后续恢复就很麻烦。
CC Switch 对 Session 管理的支持，适合那些经常在不同项目、不同工具之间切换的人。它可以帮助你更清楚地知道当前使用的是哪个工具、哪个供应商、哪个会话和哪一套配置。
10. 云同步与多设备配置同步
CC Switch 还支持云同步，可以通过 Dropbox、OneDrive、iCloud 或 WebDAV 服务器，在不同设备之间同步 provider 数据。
这个功能适合多设备用户。
比如你一台 MacBook、一台 Windows 台式机，或者公司电脑和个人电脑都要用类似配置。以前你可能要复制配置文件，现在可以通过同步服务把 provider 配置迁移过去。
不过，涉及 API Key 的同步一定要谨慎。即使工具本身是开源的，也建议你只在自己信任的设备和云服务里同步敏感配置。
六、安装方式
最直接的安装方式，是进入项目 release 页面下载对应系统的安装包：
Windows、macOS、Linux 都有对应版本。你根据自己的系统下载即可。
如果你是 macOS 用户，也可以通过 Homebrew 安装：
bash brew tap farion1231/ccswitch brew install --cask cc-switch
更新时可以使用：
bash brew update brew upgrade --cask cc-switch
卸载时可以使用：
bash brew uninstall --cask cc-switch brew untap farion1231/ccswitch
下载时建议只从官方站点或 GitHub Releases 进入。官方 Release 页面也提醒过，任何要求付款、充值或登录凭据的“CC Switch”网站或客户端，都应谨慎对待。
七、Claude Code 接入模型的基本流程
这里以 Claude Code 为例，说明它的大致使用方式。
第一步：打开 CC Switch
安装完成后，打开 CC Switch。你会看到它的主界面，并可以在不同 AI 工具之间切换。
选择 Claude Code 对应的管理页面。
第二步：添加供应商
点击添加按钮，选择你要接入的供应商。
如果是内置预设供应商，CC Switch 通常会自动帮你填好大部分字段，比如接口地址、配置结构、默认模型等。你主要需要填的是 API Key。
第三步：选择模型
填入 API Key 后，可以查看或选择模型。
如果供应商支持模型列表查询，你可以直接获取模型列表；如果不支持，就需要手动填写模型名称。
这里最容易出错的是模型名。模型名必须和供应商后台支持的调用名称一致，不能只写一个自己理解的简称。
第四步：保存并启用
确认配置无误后，点击保存。回到模型列表后，选择启用对应供应商配置。
CC Switch 会把这套配置写入 Claude Code 对应的配置文件。之后你就可以在 Claude Code 里使用这个模型。
八、本地路由与故障转移怎么理解？
如果你只是刚开始用 CC Switch，可以先不碰本地路由，把普通的 provider 切换用明白就行。
如果你已经有多个可用供应商，并且希望任务失败时自动切换备用模型，可以再研究本地路由。
大致流程是：
1. 进入设置页面； 2. 找到路由服务； 3. 启用本地路由； 4. 针对 Claude、Codex 或 Gemini 等工具启用应用路由； 5. 打开自动故障转移； 6. 添加备用供应商； 7. 在首页通过拖拽调整优先级； 8. 观察供应商健康状态和实际请求效果。
这里不要一上来就把所有重要任务都交给它跑。比较稳妥的做法是：先用几个无关紧要的小任务测试一下，比如简单代码解释、README 生成、文件改写等。确认路由、备用供应商和模型兼容性都没问题，再用于更长任务。
九、安全性与注意事项
CC Switch 是开源项目，配置主要保存在本地。官方 README 也提到，它使用 SQLite 数据库和原子写入来保护配置，减少配置文件损坏风险。
但只要涉及 API Key，就永远不能掉以轻心。
我建议注意下面几点：
1. 不要把 API Key 截图发到公开平台； 2. 不要把含 key 的配置文件提交到 GitHub； 3. 云同步前确认同步服务和设备都可信； 4. 不要随便安装来路不明的修改版安装包； 5. 下载时尽量从官方 GitHub Releases 或官方站点进入； 6. 用第三方 API 服务商时，注意看清计费规则、模型转发规则和隐私政策。
尤其是第三方中转或聚合服务，不同平台质量差异很大。它们可能很便宜，也可能存在稳定性、隐私、计费透明度和模型替换等问题。不要因为便宜就把所有重要代码、隐私数据和商业项目都直接丢进去。
十、它适合哪些人？
我觉得 CC Switch 特别适合下面几类人：
1. 经常使用 Claude Code 的人； 2. 想管理 Claude Desktop 第三方供应商配置的人； 3. 同时使用 Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent 的人； 4. 想测试多个模型供应商的人； 5. 经常在官方模型、国产模型、聚合平台之间切换的人； 6. 想做 AI 编程成本管理的人； 7. 不想手动修改配置文件的非程序员用户； 8. 正在搭建自己 Agent 工作流的人。
如果你只是偶尔用一下官方 Claude Code，而且从来不换模型、不换 key、不接第三方服务商，那它对你的帮助可能没那么大。
但如果你已经开始折腾 AI 编程工具生态，CC Switch 基本属于越早装越省心的工具。
十一、我的评价
CC Switch 最开始给人的感觉像是一个「模型切换器」，但现在它已经逐渐变成了一个 AI 工具管理中心。
它最核心的价值不是炫技，而是把原本分散、混乱、容易出错的配置流程，变成一个相对统一的图形界面。
对我这种经常测试不同模型、不同服务商、不同 Agent 工具的人来说，它最大的意义就是减少折腾成本。
以前切模型是一件很烦的事：找配置文件、改字段、查模型名、重启工具、排查错误。现在大部分情况下，就是选供应商、填 key、选模型、保存启用。
这就是它最实在的价值。
十二、总结
如果用一句话概括：CC Switch 是一个面向重度 AI 编程用户的本地管理控制台。
它不直接替代 Claude Code、Codex、Gemini CLI 或 Claude Desktop，而是在这些工具之上加了一层统一管理能力：
text 工具管理 + 模型供应商管理 + API Key 管理 + 本地路由 + 用量统计 + MCP / Skills / Session 管理
所以它最适合的人，不是只偶尔问 AI 几句话的普通用户，而是那些已经开始把 AI 当成开发工具、写作工具、自动化工具和 Agent 工作流入口的人。
参考链接
Share
评论