下午三点,Claude 的额度用完了。

你打开配置文件,把 key 换成另一个账号的。半小时后 Codex 也见底,再换一个。Gemini CLI 那边还挂着一个早就过期的 key,你懒得管了。

这是同时用好几个 AI 编程工具的人,每天都在干的事。问题不在工具不好用,在于工具之间那层管理,一直没人管。

版本提示: 截至 2026 年 11 月 8 日,Magpie 最新 Release 为 v0.1.3327。项目迭代很快,安装命令和界面可能变化,请以官方文档为准。

安全提示: 安装脚本会下载并运行程序,也会改写 Agent 配置;执行前先审查脚本,并备份相关配置文件。订阅账号发现功能会读取登录文件和系统钥匙串,敏感环境建议关闭。API key 和订阅凭据不要发给不可信网关。

CC Switch 解决的是“改配置”

CC Switch 试过管这件事。思路很直接:把 Claude Code 的配置文件接过来,界面上点一下就能换 provider,不用自己动手改 JSON。

好用,这点得承认。但它的天花板也摆在那儿。

它管的其实是配置文件本身。Claude Code 是 Claude Code 的配置,Codex 是 Codex 的配置,格式不同、key 各管各的,你还是在几个文件之间打转。而且它的思路是“让你改配置更快”,不是“让你不用再改配置”。下午三点换 key 这件事,它没帮你取消,只是让你换得顺手一点。

Magpie 把网关插了进来

最近冒出来的 Magpie 走了另一条路。它不管“怎么改配置”,而是在所有 Agent 和所有模型中间,插了一层本地网关。

过去的路径是:Agent → 各自的配置文件 → 绑定的模型。现在变成:Agent → Magpie → 任意厂商 → 任意模型。

Magpie 在本地跑一个网关,地址 127.0.0.1:3425,只监听本机回环,外网碰不到。然后它把每个 Agent 的配置改成指向这个地址:Claude Code 的 ANTHROPIC_BASE_URL 变成 http://127.0.0.1:3425,原来填 key 的位置,直接写一个词,magpie。

看着有点怪,但重点在这儿:真正的 API key 不上桌。所有厂商的 key 都存在 Magpie 自己的配置里,Agent 拿到的只是一个指向本机网关的地址加一个占位符。你的 key 不会再散落在七八个配置文件里。

更值钱的部分:订阅不再是孤岛

如果只是统一了入口,那还只是省事。Magpie 真正有意思的,是它能把你的订阅盘活。

你买的 Claude 订阅,以前只能在 Claude Code 里用;ChatGPT 的订阅,锁死在 Codex 里。每个订阅都是一座孤岛。

Magpie 的做法是去读这些 Agent 自己的登录状态,Claude Code 和 Codex 的配置文件、系统的钥匙串,读到之后就把这个订阅变成网关里的一个 provider。于是 Claude Code 可以调用你的 ChatGPT 套餐,Codex 也能反过来用你的 Claude 订阅,不用再为每个工具单独买一份 API。

隐私这块留了开关。不想被读到登录信息,设置里关掉 Subscription accounts,或者跑一句 magpie accounts discovery off,单次运行用 MAGPIE_NO_ACCOUNTS=1。API key 类型的 provider 不受影响,照常能用。

不同 Agent 说的是不同的话。Claude Code 说 Anthropic Messages,Codex 说 OpenAI Responses,Gemini CLI 说 Gemini。同一个模型,接口形状不一定一样。Magpie 的网关把这四套协议都实现了,请求进来之后按需翻译,流式输出、工具调用、推理过程都跟着转。所以 Codex 也能用上只提供 Anthropic 接口的模型,反过来也一样。

配额也被接管了。你可以把几个账号或几个模型编成一个“路由组”,设置好策略:优先用哪个、用完怎么轮、按用量怎么分。额度耗尽的瞬间,请求自动落到下一个账号,Agent 那边完全无感,不弹错误。官方管这叫“静默切换”。

剩下的是一些顺手的设计。Profiles 能把每个 Agent 当前的配置存成一个名字,比如“省钱模式”“猛干模式”,一键整体切回来。Import 能从 CC Switch 直接导入已有的 provider,迁移不用重头填。它本身是一个轻量的 Go 程序,macOS、Linux、Windows 都能跑,还支持 Docker 和 NAS。支持的 Agent 列表很长,Claude Code、Codex、Gemini CLI、OpenCode、Cursor CLI、Copilot、Cline、Devin 这些常见的都在里面,任何能接受 base URL 的工具也能手动接进来。

一条命令,三步上手

装起来就一条:

1
curl -fsSL https://usemagpie.ai/install.sh | sh

也可以用 go install github.com/yetone/magpie@latest 或者 Docker 镜像(ghcr.io/yetone/magpie)。装完三步:打开 Magpie 加一个 provider,选预设粘贴 key 或者用订阅登录;到 Agents 页面给每个工具选模型;开个新会话就生效。命令行党也有对应的命令,比如 magpie claude deepseek/deepseek-v4-pro,就是把 Claude Code 的模型切到 DeepSeek。

有几个坑先说清楚

最容易被忽略的一点是,它对你可能根本没用。如果你只用一个 Agent,而那个 Agent 带着厂商自己的套餐,多装一个后台常驻的网关纯属负担。它是给同时用好几个工具、还攒了一堆订阅的人准备的。

另外 Codex 的模型列表是启动时读的,通过 Magpie 切完模型,得重启它才认。

隐私上有个细节:它每天上报一次使用统计,介意的话在设置里关掉,或者设 DO_NOT_TRACK=1。

最后,这个仓库不收 PR,只有维护者能提交,想反馈问题得走 Discord。

说到底,CC Switch 和 Magpie 不是谁替代谁。一个是你顺手打开的桌面工具,把配置改得更快;一个是常驻在后台的网关,把“改配置”这件事直接从流程里拿掉了。站位不同,解决的问题也就不一样。

你电脑里现在挂着几个 AI 编程工具?有没有过额度用完、手忙脚乱切 key 的时候?评论区聊聊。

项目地址:https://github.com/yetone/magpie