开源工具CC Switch：让Agent一键切换所有模型，支持用量追踪

上周我一连发了好几篇模型评测的文章。 特别是上周五，直接化身鸡排哥一天三连发。 然后，很多朋友就在下面问我。 其实说实话，上周一我已经写了一篇超级详细的Claude Code使用教程，里面就有很大的篇幅，写的就是如何在Claude Code里接国产模型这件事。 不过说实话，其实大家都懂，就是那么长的教程文，其实看的后面的真的没几个。 所以，我也觉得，得把这个我自己真的用的非常多也超级好用的小工具，单独拎出来详细的写一篇，分享给大家。 毕竟，这个工具在我看来，他目前确实不仅是Claude Code里接国产模型，也还是其他的各种Agent产品比如OpenClaw、Hermes等等里面，切换模型最方便、*用的一个。 他就是开源的大名鼎鼎的cc switch，至今在github上已经50k的星标了。 链接在此： https://github.com/farion1231/cc-switch 它的工作原理也超级简单，就是直接帮你去改模型配置文件。 因为大家要知道其实要给Claude Code、OpenClaw之类的Agent产品，改你的背后的模型，其实对于非程序出身的绝大多数的普通人来说，是有一点麻烦的。 因为，你是真的要懂一点代码，知道啥叫配置文件，才能去手动修改的。 在Claude code里，这玩意就是settings.json文件。 你只要自己手动改过一次Claude Code的settings.json，你就知道这事到底有多烦。 我到现在还记得，当初GLM-5刚发布的时候，我想试一下，把它接到Claude Code里面去用。 当时看文档，他让我找到Claude Code的settings.json，开始手填各种东西。 base_url、auth_token、model name各种字段。。。 我人直接炸了，真的，感觉这事太蠢了。 之前玩小龙虾的时候也是一样，每次出了新模型想试试，我就直接让它自己去给自己改模型。 结果我相信玩过小龙虾的都知道了，小龙虾GG的最常见的原因，基本就是换模型，经常就是模型切着切着，然后自己就崩了。 简直太呆逼了。。。 直到后面我实在忍无可忍，就去问了下Claude，有没有类似的可以便捷切换Agent产品模型的开源项目，当时还真挖到了。 从那以后，我再也没为切模型这事烦恼过。 回到CC Switch本身。 它是一个桌面App，全平台也就是Windows、Mac、Linux都可以用。 目前一共6个Agent工具，Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw，前几天最新版还把 Hermes也加进来了。基本上你电脑上在跑的这类Agent工具，它都用得上。 因为是个纯粹的开源产品，所以信息啥的还是比较安全的，所有相关的数据都存在你本地的一个SQLite数据库里，路径是~/.cc-switch/cc-switch.db。 包括你添加的供应商配置，全局配置，模型定价之类的等等的东西。 你在用他切换供应商的时候，它会从这个数据库里读出对应配置，再帮你写到各家Agent的配置文件里，从而帮你无痛切模型。 直接进入项目的github，下滑找到Assets。 https://github.com/farion1231/cc-switch/releases 根据自己的系统找到对应的文件进行下载安装。 比如Mac，我们下载好红框中的文件。 直接双击运行，然后在App中我们就能看到这个logo和Claude极其相似，但颜色不一样的东西了。 安装好后，我们主要再来非常非常详细的说说他怎么用。 先来看怎么在Claude Code里接模型。 我们双击打开CC Switch。 在Claude图标下面点击右侧的加号。 它内置了40+家供应商的预设，智谱、MiMo、DeepSeek、千问、Kimi、MiniMax、DouBaoSeed、阶跃等等等等，反正国内主流的他基本都有。 我们这里以GLM为例，选Zhipu GLM，你想用哪个模型就点哪一家就行。 没选供应商的话，所有的配置都是空的。 选好供应商之后，除了API Key，剩下的字段它都帮你预填好了，完全不用你操心。 API Key填进去之后，可以下拉看一眼CC Switch自动给你配的模型版本，不喜欢可以改。 你要是不清楚模型名字的话，就点右上角的获取模型列表。 然后你就可以看到厂商提供的所有可以调用的模型了。 这里需要注意一下，并不是每个供应商都支持查询列表，不支持的话就需要你手动填一下模型名。 模型修改后，你能看到他给你写的配置文件代码是随你同步的。 这里的配置json文件，就是CC Switch会写进Claude code的settings.json里面的内容，但其实我们根本不用管。 从头到尾我们做的就三步，选供应商、填API Key、选模型就行了。 格式啊兼容啊七七八八的问题，你都不用操心。 最后，点击右下角的保存。 这样，我们就能在首页的模型列表看见他了，直接点启用，就能在Claude code里用上了。 其他家的模型，也可以同样的操作加进来。 甚至切换的时候我们都不用再点开主页面。 直接点击桌面右上方的图标，你想换哪个就点哪个，每个工具下面挂着自己的一套供应商列表，互不干扰。 这玩意装上以后有一个很爽的点就是，在Claude Code里面，热切换模型的操作变得*简单。 热切换，就是你不用重启终端，不用关掉Claude Code当前会话。 比如你正跑着东西，觉得这个模型不太聪明，你只需要等他回复之后，在菜单栏点一下CC Switch的小图标，选一个别的模型，切完就立刻生效。 下一轮对话直接就是新模型在回你了。 但是注意，你千万不要犯傻，非要在模型正在干活的时候切，那...必然会报下面的错。 这个功能用来做成本管理，贼爽。 因为其实我知道，很多朋友做一些日常任务，还有大项目里的部分小活儿，其实没必要上最贵最强的模型，挂个性价比高的模型，真的又快又便宜。 而做这个成本管理的操作成本，有了他几乎为零了。 但光是切模型这一个功能还只是基操，CC Switch里还做了很多功能。 比如，他还做了个用量追踪，可以快速看到，API key接入的余额，和coding plan的额度。 打开用量配置的操作也不复杂。 在模型列表点击配置用量查询。 打开启用用量查询。 如果你是走的API，这里点击官方，再点击保存配置。 如果你是买的token plan的话。这里我们不点官方，而是点token plan。 选择对应的模型供应商，点击保存配置。 首页列表就能看到实时的消耗或者余额了。 除了用量，CC Switch还提供了更详细的使用统计，可以更直观地看到每个时间段的成本消耗。 能明显的看到，过去一天我的用量高峰，基本都是下了班以后的凌晨，夜深人静，适合Coding。。。 就这个统计，真的非常的好用。 最后一个，也是一个非常实用的功能，特别适合一些使用多个国产模型搭配使用的用户。 就是，有的时候，你可能会睡前给agent派个大活，让他抓紧我睡觉的时候猛猛干活。 但是呢，你可能会遇到额度突然用完，或者魔法不稳定中断的情况，第二天起床一看，活儿压根没干完。 这种事用CC-Switch的本地代理带故障转移就能解决。 CC-Switch可以在你本地起一个代理服务，拦住你的CLI工具发出去的请求，帮你做API格式转换、故障转移和熔断保护。 翻译成人话就是。 你给同一个工具配了三家Claude Code供应商，比如GLM、MiMo、DeepSeek。 某天，某一家突然宕机了，或者额度用完了，或者请求半天没响应。 CC Switch会自动切到下一家继续跑，无痛迁移，不让你的等待变成白等。 详细的操作我也写在这里了。 我们点进左上角的设置。 找到路由服务，先打开本地路由的开关，把本地代理服务跑起来。 然后在应用路由区域启用Claude路由，把Claude Code的请求接到本地代理上。 这里建议也点开在主页面显示本地路由开关。这样我们在主页就能快速打开或关闭路由。 然后我们打开自动故障转移，选择Claude，再点添加供应商，把你要做备用的几家加进队列。 但是这里需要注意，如果你用的是Claude的官方模型，那就别开路由，问题还是有点多的 最后我们可以在首页列表通过拖拽给他们排序。 这样CC Switch会优先列表上面的供应商进行路由，碰到故障就自动往下一家切。每个供应商卡片上会显示一个健康状态徽章。 要关闭的话，直接在主页把这两个按钮关闭就行。 除了上面说的这些，CC Switch还有挺多其他功能可以细挖，比如会话管理。 还有模型配置云同步等等，这里就不一一展开了。 官方提供了一份非常全面的用户手册，写得很详细，地址放在这里，有兴趣的朋友可以去翻翻。 https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/README.md 感谢每一位可以看到这里的朋友。 说实话，这篇文章，我自己读下来是有点枯燥的。 但是作为一篇工具介绍的文章，我也确实写不出什么花来。 这类文章的完读率也一向比较低。 但如果能帮到其中，哪怕一个人。 那我觉得，这篇文章也就有价值了。 希望能对大家有那么一点点用。 剩下的，就交给屏幕前的你自己折腾了。 祝各位，创作愉快。 相关作者 数字生命卡兹克 努力分享一些很新、很酷的AI干货，愿我们永远对世界保持好奇。 + 关注 打开投资界APP  阅读全文 【本文由投资界合作伙伴微信公众号：数字生命卡兹克授权发布，本平台仅提供信息存储服务。】如有任何疑问题，请联系（editor@zero2ipo.com.cn）投资界处理。 Claude CodeCC SwitchGLM本地代理 AI行业