CC Switch、Magpie、CCR、CLIProxyAPI 怎么选:管住各家 AI 编程 agent 的四种路线
agent 装得越多,配置越乱:换供应商要改四种格式的文件,MCP 要填四遍,订阅还只能在一家客户端里用。这篇把 CC Switch、Magpie、CCR、CLIProxyAPI 四种管理路线讲清——谁改配置、谁开网关、谁定规则、谁把订阅变 API,按场景对号入座。

装第一个 AI 编程 agent 的时候,没人会想到“管理配置”有一天会变成一个问题。等你桌上同时躺着 Claude Code、Codex、Gemini CLI 和 OpenCode,问题就来了:每一家都有自己的配置文件,格式还都不一样,有的是 JSON,有的是 TOML,有的是 YAML,还有的靠环境变量;每换一次模型供应商,就要打开文件改地址、改密钥、改模型名,改完还要记得重启终端才生效。再加上 MCP 服务器要在四个工具里各填一遍,常用的 Skills 和提示词要在四个地方各存一份——写代码的是 AI,打杂的还是你。
于是过去一年多,GitHub 上长出了一整个品类:专门替你管这些 agent 的工具。它们数量不少,光 star 过万的就有好几个,名字还都很像,第一次挑的人很容易挑花眼。这篇把其中最有代表性的四个放在一起讲清:CC Switch、Magpie、Claude Code Router(下面简称 CCR)和 CLIProxyAPI。截至 2026 年 11 月 14 日,它们在 GitHub 上的 star 分别约为 15.4 万、3.6 万、3.8 万和 5.9 万。先把结论放在前面:这四个东西名字像、活儿不像,选错了不是不能用,而是会别扭很久——有人想要的只是一个“换供应商的按钮”,却装了一个需要常驻运行的网关;有人想把订阅榨干,却选了一个老老实实只管配置文件的工具。
先分清四种路线:它们到底站在哪一层
这四个工具真正的分界线,不是功能多寡,而是它们站在哪一层动手。
第一种是改配置文件的桌面工作台,代表是 CC Switch。它的做法最直白:你点一下,它就去改每个工具自己的配置文件,把里面的服务器地址、密钥和模型名换成你选的那一家。改完之后,工具还是直连供应商,请求不经过它,关掉它也照样干活。它管的是“出厂设置”,不管“路上怎么走”。
第二种是菜单栏加本地网关,代表是 Magpie。它一半像第一种:给某个 agent 选模型时,它也只改那个配置文件里关键的一项。但它另一半是个一直开着的本地网关,所有 agent 的请求都先到它这儿报到,再由它翻译格式、挑账号、转发出去。它既管设置,也管路上。
第三种是本地路由规则控制面,代表是 CCR。它几乎不碰“换配置”这件事,而是给所有 agent 一个雷打不动的本地地址,agent 永远只连它。至于每个请求最后去哪家、用什么模型、失败了换谁,全由你在它里面写的规则说了算。它管的是“分流的规矩”。
第四种是把订阅变成 API 的代理,代表是 CLIProxyAPI。前三种管的都是“你买的 API 怎么分配给 agent 用”,它反过来:你买的明明是 Claude、ChatGPT 这类只能在官方客户端里用的订阅,它通过登录授权把订阅背后的模型包装成标准 API 接口,让任何工具、任何脚本都能像调 API 一样调你的订阅。它管的是“把不是 API 的东西变成 API”。这一条路线甜头最大,风险也最大,后面要单独说。
CC Switch:只想安安稳稳换供应商,选它

CC Switch 是这四个里资历和体量都最大的一个。用 Tauri 做的桌面应用,Windows、Mac、Linux 都有,一共管 12 个工具:Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi、MiniMax Code、Kimi Code 和 Oh My Pi。它内置了 90 多个供应商预设,从 AWS Bedrock、NVIDIA NIM 到各种社区中转都有,选预设、填密钥、点启用,三步完事。切换的时候它只动配置文件里跟连接有关的几个字段,你自己加的插件、钩子、MCP 和注释都原样留着;第一次改写某个文件之前,它还会自动留一份备份,这一点对怕改坏配置的人很友好。
它最对路的人,是“工具装了好几个、供应商也有好几家、就想有个地方统一管着、别让我再开配置文件”的人。这类需求里还有两个它做得最全:一是 MCP、Skills 和提示词的统一管理——MCP 服务器加一次,勾一下就能同步到各个工具;提示词按工具分别维护,要启用时它写进那个工具自己的提示文件。二是它有个“项目”功能,能把某个工具当前的供应商、MCP、Skills 和提示词存成一整套,换项目的时候一次切走,不用挨个重选。它甚至能直接看用量:哪个供应商花了多少钱、订阅还剩多少额度,卡片上和系统托盘里都写着。生效方式上有个小差异要知道:Claude Code 切完立刻生效,不用重启;Codex、Gemini CLI 这几个要重开一次终端。
不适合谁?你要是想“让 Claude Code 用上 GPT、让 Codex 用上 Claude”这种跨协议玩法,它其实也有本地路由和聚合模式能做,但那已经是它相对小众的附加功能,主场还是管配置。另外它没有手机端、没有无头服务器形态,纯远程服务器上用不了——那个场景它在自家说明里会把你指给社区做的命令行版 cc-switch-cli,后面场景部分会再提一句。
Magpie:想让任何 agent 跑任何模型,选它

Magpie 是这四个里最年轻、跑得最快的一个:2026 年 9 月 23 日才建的仓库,不到两个月已经 3.6 万星,而且核查这天还在发新版本。它的作者就是做过知名 Neovim AI 插件 avante.nvim 的 yetone,做的东西延续了那种“一个入口管全部”的思路:菜单栏里列出你机器上装的所有 agent,每个 agent 当前用什么模型一目了然,点开下拉就能换。它的支持列表长得夸张,README 里列了 80 多个 agent 和客户端,从 Claude Code、Codex、Gemini CLI 到 Goose、Crush、Devin、Kimi Code 都在里面;当然,它只显示你真装了的那些。
它和 CC Switch 最大的不同,在那个本地网关。网关跑在本机一个固定端口上,能听懂四种接口格式——OpenAI 的两种、Anthropic 的、Gemini 的——并在它们之间互译。所以“Claude Code 跑 Kimi、Codex 跑 DeepSeek、Gemini CLI 跑 GLM”这种组合不是靠改配置硬凑的,而是请求到了网关之后被翻译和转发的结果。供应商在它这里加一次,所有 agent 共用;你手里的订阅也能当供应商使:已经登录的 Claude、ChatGPT、Copilot、Gemini 订阅,它都能拿过来给别的 agent 用。更实用的是额度管理:一个供应商有多个账号时,额度用完它会悄悄换下一个账号顶上;你还能把几个模型和账号编成一个“路由组”,让它按“哪个订阅最快到期就先用哪个”之类的策略自己分着用,尽量别让额度烂在手里过期。这套东西对“订阅买了好几家、每个月总有额度用不完、又总有某一家先爆掉”的人,几乎是精准命中。
它还有两个顺手的设计值得一提。一是“方案”:把所有 agent 当前的模型搭配存成一套起好名字的方案,比如“省钱”和“全力”,换场景的时候整套切换,不用一个个点。二是它把用量做到了网关该有的样子:每个账号还剩多少额度、花了多少钱、每次请求吃了多少上下文,它都有页面可查,订阅快到期还没用完的额度还会提前提醒你——这类细节说明作者很清楚自己的用户在心疼什么。
不适合谁?只用一个 agent、用官方订阅就很满足的人,官方自己在说明里都劝退:你不需要它。另外它毕竟是个网关,所有请求都要经过它这一跳,它要是没开着,配置指向它的 agent 就没法干活;它发现订阅的方式是读取各个 agent 的登录文件和系统钥匙串,介意这一点的,记得先去隐私设置里把这个开关关掉,它提供了现成的关闭选项。
CCR:想自己定分流规矩,选它

Claude Code Router 的年纪其实最长,2025 年 2 月就建仓了,3.8 万星。它现在的形态是一个本地网关加一个管理界面:网关默认在本机 3456 端口,Claude Code、Codex、Grok CLI、Kimi CLI、OpenCode 等 10 个具名 agent(还有其他兼容客户端)都只连这一个地址。它和 Magpie 都开网关,区别在着力点:Magpie 的聪明劲儿花在“哪个账号还有额度”上,CCR 的功夫花在“这个请求该按什么规矩走”上——你可以按请求头、请求内容设条件,指定哪类活儿去哪家、哪个模型;某个模型挂了,按你排好的顺序自动换备用模型;多个密钥放进一个凭据池轮着用;还能给不同的调用方发独立的钥匙,设过期时间和用量上限。每次请求最后到底命中了哪家、哪个模型、花了多少、花了多长时间,日志里都查得到。对“我就是想把贵模型留给硬活、杂活自动打给便宜模型,而且要能审计”的用户,它的规则粒度是四个里最细的。
不适合谁?只想点两下换个供应商的人,会觉得它重:桌面版、命令行版、Docker 版三种形态摆在那儿,概念比另外几个多,上手要花点时间。还有一件必须诚实说的事:它的活跃度最近明显放缓——最后一次代码提交停在 2026 年 10 月 10 日,到这篇核查时已经五周多没有新提交,最新版本也是 10 月初的。这不代表它不能用,但意味着如果你打算把它放进长期工作流,先去仓库看看维护状态,值得观望一小段时间。这一点上,同为网关路线的 Magpie 和 CLIProxyAPI 这阵子都还在高频更新,对比挺明显。
CLIProxyAPI:想把订阅当 API 用,先想清风险再选它

上图是 CLIProxyAPI 的官方桌面客户端 EasyCLIProxyAPI——CLIProxyAPI 本体是无界面的代理服务,日常管理都靠这类客户端。
CLIProxyAPI 的路子最野,star 也冲到了 5.9 万,还在当天更新。它是个代理服务器:你用官方账号登录授权一次——Codex、Claude Code、Grok Build 这些 CLI 的登录态它都接——它就把这些订阅背后的模型,包装成 OpenAI、Gemini、Claude、Grok 四种兼容格式的 API 接口。从此你的订阅不再只属于某一个官方客户端:别的 agent、你自己的脚本、任何支持标准接口的程序,都能拿它当普通 API 调。它还支持多账号轮流上阵做负载均衡,一个账号额度紧了,请求自动摊到下一个头上;普通买来的 API 密钥也能接进来当上游。说它解决了一个真问题不为过:很多人订阅和 API 是重复付费的——订阅在客户端里用不完,API 那边又在按量烧钱,它就是冲着这份额外支出来的。
但这一节必须把话说透:它转发的不是你买的 API 额度,而是订阅的登录态。各家订阅的通行规则是“权益在官方客户端里用”,把订阅包装成 API 给其他程序调,踩的是服务条款的边线。同类的 CC Switch 在自己的说明里对“把订阅当供应商”这个功能写了明文提醒:这可能违反厂商的服务条款,风险自担。CLIProxyAPI 的仓库里没有对等的风险提示,所以更要自己心里有数:轻则功能被封、接口失效,重则账号被风控甚至封禁。真要试,别用主力账号,别把团队的活压在上面,把它当一个随时可能断掉的便利,而不是基础设施。
不适合谁?只是想在几个 agent 之间换模型的人,完全用不着它——那是前三个的活,它掺和进来纯属杀鸡用牛刀,还白担风险。它适合的是明确知道自己在干什么、且能承受账号代价的进阶玩家。
四种路线对照表
| 路线 | 代表 | 管什么 | 支持的 agent | 主要风险点 |
|---|---|---|---|---|
| 改配置文件的桌面工作台 | CC Switch(约 15.4 万星) | 各工具配置文件里的供应商、密钥、模型,外加 MCP、Skills、提示词与用量 | 12 个 | 风险最低;切换后部分工具要重启终端才生效 |
| 菜单栏 + 本地网关 | Magpie(约 3.6 万星) | 每个 agent 用什么模型、请求经网关翻译分发、账号额度轮换 | 80 多个 | 网关需常驻,关掉则指向它的 agent 断线;会读取登录文件发现订阅(可关) |
| 本地路由规则控制面 | CCR(约 3.8 万星) | 一个固定本地地址背后的分发规则、重试与备用队列、凭据池 | 10 个具名 + 兼容客户端 | 概念多、上手重;近期提交放缓,先看维护状态 |
| 订阅转 API 的代理 | CLIProxyAPI(约 5.9 万星) | 把订阅登录态包装成标准 API,供任意客户端和脚本调用 | 不挑客户端,认接口格式 | 服务条款灰色地带,可能触发风控或封号 |
(star 数为 2026 年 11 月 14 日 GitHub 数据,支持数量按各仓库 README 的列表口径。)
按场景对号入座
只是偶尔换供应商。别折腾网关,CC Switch 就是答案:预设多、切换干净、改坏了有备份。你的需求本质上是“少开几次配置文件”,为这个需求常驻一个网关属于过度配置。
想把 MCP 和 Skills 在几个工具间统一。优先 CC Switch,它的 MCP 面板和 Skills 同步是成系统的,还能按工具勾选分发范围。Magpie 也有类似的资料库功能、写一次按各家格式分发,可以作为备选;两者选一即可,别叠着装,配置会被两边轮流改写,反而乱套。
想让任何 agent 跑任何模型。这是网关的活,Magpie 和 CCR 二选一:账号多、订阅多、总为额度发愁,选 Magpie,它的额度轮换和路由组就是为此而生;更在乎请求级的分流规则和事后审计,选 CCR,条件规则、备用队列和日志是它的强项。
想把订阅当 API 用。只有 CLIProxyAPI 正面干这件事,上手之前重读一遍上面的风险段。用小号、控规模、别接生产活,是这条路线的基本纪律。
主要在远程服务器或无头环境里干活。四个主角里三个半是桌面形态,先看社区的 cc-switch-cli——它是 CC Switch 的命令行版,同一套配置思路搬进了终端,SSH 进服务器就能用;非要网关的话,Magpie 和 CCR 都能用 Docker 或命令行方式跑,部署前先各自看一遍文档。
能不能几个一起装?配置面和数据面各选一个,理论上可以搭配,比如用 CC Switch 管 MCP 和提示词、用 Magpie 做网关。但两边都会改同一批配置文件,谁最后写谁说了算,切换顺序乱了很容易互相覆盖。真要搭配,先想清楚哪一类设置归谁管,写下来贴在显示器边上;嫌麻烦就只装一个,大多数人的痛点一个工具就够解决了。
动手之前的三句提醒
第一,先备份,再让任何工具碰你的配置文件。CC Switch 会在首次改写前自动备份,其他工具未必有这个动作;稳妥做法是先把那几个配置目录整个拷一份出来,出问题十分钟就能回滚。第二,订阅相关的功能先看条款。凡是“把订阅拿给别的工具用”的玩法——不管是 CLIProxyAPI 的整体路线,还是 Magpie、CC Switch 里的订阅当供应商——都先想一遍最坏结果是不是自己能承受的,别等账号出事了才第一次读条款。第三,看一眼仓库的最近提交再做长期决定。这个品类变化快,一个工具五周没动静(比如 CCR 眼下的状态)未必是弃坑,但值得你把“它停更了怎么办”提前想好:好在这一类工具大多只是改配置或做转发,迁移成本主要是重配一遍供应商,不算伤筋动骨。
最后说个判断
把这四个工具摆在一起看,能看清这个品类正在分化成两层:一层是“配置面”,管的是你有哪些工具、哪些供应商、哪些 MCP 和 Skills,CC Switch 是这层的完成形态,拼的是覆盖全、动作稳;另一层是“数据面”,管的是每一个请求实际怎么走、走谁家、超额了怎么办,Magpie、CCR 和 CLIProxyAPI 都在这一层,只是分工从“分额度”到“分规则”再到“换来源”一路越走越激进。配置面会越来越像基础设施,人人都需要、但很难再有新意;真正的变数在数据面,尤其是“订阅和 API 的边界”这一段——CLIProxyAPI 的 5.9 万星说明需求真实存在,但这条路能走多远,最终不取决于技术,而取决于各家厂商对订阅条款的执行尺度。所以我的建议很实际:先用 CC Switch 把配置面安顿好,这是稳赚不赔的一步;数据面按你的真实痛点选一个就好,额度痛选 Magpie,规则痛选 CCR,订阅痛——先想清楚,再碰 CLIProxyAPI。
评论 (0)
相关文章
Flexbox 一次只排一个方向,排对了,导航栏、卡片墙、购物车行都听话。本文按 MDN 的《Basic concepts of flexbox》《Aligning items in a flex container》《Controlling ratios of flex items along the main axis》三篇官方文档讲清楚:两根轴、容器与项目、方向与换行、剩余空间、flex 三件套、两根轴上的对齐、间距与自动边距。
一张点单就是一个对象:桌号、菜品、总价、付没付钱,全按标签收在一起。本文按 MDN 的《Working with objects》《JSON》《Object》三篇官方文档讲清楚:对象字面量、点号与方括号、增删改查、for...in 配 hasOwn、方法与 this、getter 与 setter、引用与复制、Object.assign 等工具箱、空白原型对象、JSON 的严规矩,以及 stringify 与 parse 和数字精度的坑。
2026 年 11 月 17 日,微软发布 MAI Code 2 和 Code 2 Flash:大模型 770 亿激活参数、100 万上下文,四项基准平均通过率 63.2%,与 GPT-6.1 Sol、Claude Opus 5.5 咬得很紧,但每任务成本只有 0.309 美元。先看清三处“但是”:价格是推广价、分数是三者最低、长周期任务不在舒适区。