它是什么，成绩怎样？
magpie 是 yetone（ChatGPT-Next-Web 的作者）9 月 23 日开源的 macOS 工具，MIT 协议，安装包不到 15 MB，常驻菜单栏。它管的是你和模型之间的那一层：手上的订阅、API key、base URL，以及每个 Agent 该用哪个模型。
1、订阅、API 全部转化成 Provider，任何 Agent 都可以调用
把「用哪个模型」从每个 Agent 自己的配置文件里抽出来，收进一张菜单。README 里列了 59 个支持的 Agent：Claude Code、Codex、Gemini CLI、OpenCode、Cursor CLI、Hermes Agent 都在里面。换模型以前是去改 ~/.claude/settings.json 的 JSON、~/.codex/config.toml 的 TOML、或者 opencode.jsonc 里带注释的 JSON，三个格式三个不同的键，改错一个就起不来。现在点一下菜单。
2、统一接口，减少多 Agent 多处配置
在你自己机器上起一个网关，默认地址 127.0.0.1:3425。任何能填 base URL 的工具都能走它。你已经登录过的订阅（Claude、ChatGPT、Copilot、Gemini、Grok）它读成 provider，交给别的 Agent 用；你自己的 OpenAI / Anthropic / Gemini 兼容地址也接得进来。
上线 21 天，12,756 star、874 fork、60.6 万次下载，支持 59 个 Agent。
同一个 21 天里，它发了 1,221 个版本，平均 11.7 分钟一个，issue 区累积到 2,277 条。今天早上有人在 issue 里报告，macOS 托盘版 90 分钟内存涨到 85.1 GB（16 GB 机器，swap 用到 23 GB），换成 magpie serve 之后稳定在 86 到 116 MB。这是单条报告，跑的是托盘应用不是网关，本机同时段实测在 97 MB 到 176 MB 之间波动。把这两个数字放在 11.7 分钟一个版本的节奏旁边，能不能接受由你自己判断：你会一直装着一个中间态。
一、它到底替你解决什么
1、你买的额度，被锁在它自家的客户端里
Claude 的订阅只能在 Claude Code 和 Claude.ai 里花，ChatGPT 的订阅只能在 Codex 里花。手上有几个订阅不是问题，问题是哪个模型干哪个活不由你定，由客户端定。想拿便宜的模型跑个简单任务，做不到：客户端不提供这个入口。
magpie 把已经登录的订阅读成 provider，于是 Claude Code 里能选 codex/gpt-…，Codex 里能选 claude/…。
2、换模型要手改配置，每个 Agent 格式还不一样
同一个动作要在三种格式里找三个不同的键。magpie 的逻辑是把所有 Agent 的配置统一管理了，在 magpie 中一处维护，多处调用；这跟我之前的 Freerouter 逻辑原理类似，都是为了方便多模型的管理，以及模型矩阵的构建更方便。
3、额度在睡觉，你在等
magpie 可以配置轮询切换，当你一个账号的额度用完后，会自动切换到下一个账号，你在 Agent 窗口体验是无感知，你的任务执行也不会中断。
magpie 还有一个非常好用的功能：每日预热，这个能把额度窗口设定在你高频使用的时间段，不至于被额度窗口牵制改动你的工作时间。
- 窗口从第一次发请求才开始计时：如果你早上 9 点没有发请求，直到下午 2 点才发第一条消息，那么你的 5 小时额度窗口就是
14:00 - 19:00，白白浪费了上午的时间槽。 - 多账号错峰/提前开窗：若挂载了多个账号，如果不能提前开窗，等你集中编程写代码时，几个账号可能在同一时间段被耗尽，无法形成无缝轮替。
4、key 和 base URL 散在各处
一处加 provider，所有 Agent 共用。任何能填 base URL 的工具都能接这个网关：OPENAI_BASE_URL=http://127.0.0.1:3425/v1，key 填 magpie。同时在跑好几个供应商的人，省掉的是每个月都要重做一遍的那份配置活。
图 2｜左边是你现在的日常，右边是装上之后。
二、会不会被封号
这条问得最多，因为它能把前面省下的钱一次赔回去。
总结大概的结论，订阅的反代是 OpenAI、Claude 规则条款明文禁止的，但根据我自己的使用体验，通过 ACP、CLI 等官方路径接入到第三方 Agent 使用，相对是比较安全的。magpie 的作者也对此做了回应，但也无法 100% 保证。大家使用时要注意。
作者本人在 issue #26 里给出了回答：
风险没法保证为零。是否允许通过第三方工具使用订阅，最终由各家的服务条款和风控决定，magpie 替不了它们做担保。
他同时说清了 magpie 具体怎么做的：Claude 订阅由本机的 Claude Code 官方程序去发请求（claude -p），不拿 OAuth token 自己拼；Cursor、Grok 同样走它们自己的官方 CLI；Codex、Copilot 用各自 CLI 的登录。凭据只在本机读，不上传、不共享、不转卖。
中文讨论里一个常见的混淆，是把 magpie 和「把 OAuth token 抠出来自己重放」的反代当成一回事。它们不一样。被打得最狠的是 CLIProxyAPI 那一类：从官方客户端里取走 token，自己重放成一个 OpenAI 兼容接口，还能多账号池化、对外转卖，它自己的 issue 里就有真实的封号原文，「Your account has been disabled after an automatic review of your recent activities」。Anthropic 今年 1 到 2 月收紧时，打的是伪装成 Claude Code 客户端的第三方 harness。magpie 走的是另一条路，它是真的去启动 Claude Code 这个程序。这不是替谁免责，两件事得分开看。
按用法分级：
| 你怎么用 | 风险 | 依据 |
|---|---|---|
| 自己用；订阅只喂官方客户端 | 低 | 条款允许「未经修改的 Claude Code 二进制 + 你自己的订阅」 |
| 用多个账号轮流分摊额度 | 高 | 作者原话（issue #2111）：这正是 Anthropic 条款明确针对的用法 |
| 共享给多人、或对外提供服务 | 明确违规 | 条款禁止代他人转发订阅请求、禁止中介凭据；作者也称这是最易触发风控的用法 |
三、大家还在问的四个问题
1、用了是不是更费额度
会。而且这笔额外开销有明确的来源，账能算清。
有人做了实测和定位。作者确认的机制是：每开一个新的会话，首轮要把整段历史当新消息发出去，冷写 15 到 20 万个 token 的 1 小时缓存；同时开 4 个 Agent，就是 4 次这种写入。另外三个放大来源：系统提示词叠加（外层 Claude Code 套内层 Claude Code 就是两份）、缓存接不上的轮次整段重写、以及一个已经修掉的模型误路由缺陷。
作者给了一个自查法：去用量页看那些「缓存写入很大、缓存读取很小」的调用，那就是没接上的轮次。
省下的是买 key 的钱，多花的是订阅额度，两边都要算。
2、它会不会读你别的工具的登录凭据
会，默认就是开着的。
它读 Claude Code / Codex 的登录文件和钥匙串，把订阅识别成 provider。可以关：设置 → 隐私 → 订阅账号，或者 magpie accounts discovery off（MAGPIE_NO_ACCOUNTS=1 只对这一次运行生效）。但换句话说，用这个工具就是为了方便，把这个关掉，其实有点因噎废食了。
3、它会不会偷偷上报
配置里有一个按天打点的统计机制。本机配置目录里有 install-id 和 stats-sent（内容是 2026-10-15），设置里的 otel 是空的，OpenTelemetry 关着。magpie 为你调用模型时，请求内容仍会发往你配置的模型提供商；这与发给 PostHog 的每日统计是两回事。如果不愿发送后者，在设置 → 隐私 → Count me as a user 关闭即可。
4、网关只开在你自己那台机器上吗
默认只开在你自己那台机器上，但可以不是。
源码的规则是：开着「局域网共享」就监听全部网卡，否则只监听回环。默认只回环，而本机设置里 "lan": true，netstat 显示 tcp46 *.3425 LISTEN，也就是它现在开在全部网卡上。
这不是漏洞。源码里来自其他机器的请求必须带网关 key。但本机回环调用不做校验，源码注释的原话是「Loopback clients may still use any token」。局域网里的其他设备要用，得有你的 key；而你这台机器上的任何进程都不用 key，就能用你挂进去的凭据花额度。一个人自己用是设计，多人或者多服务共用，这是必须先知道的事。
（这一条由监听地址、源码规则、本机设置三项推得，没有做跨机验证。）
四、那该不该装
官方的标准最简单，我认同：
如果你用不止一个 Agent、不止一个 provider 或不止一个账号，它就适合你。如果你只用一个 Agent、只用它自家的订阅，而且够用，那就不需要 magpie。
套到具体情况：手上有两个以上 Agent、有睡着的订阅额度、或者想在 Claude Code 里用别家的便宜模型，装。只有一个 Agent、一份订阅、也不嫌手动改配置，不用装。
要装的话，这几步先做。把 ~/.claude/settings.json、~/.codex/config.toml、opencode.jsonc 连注释存一份原文，安装后 diff 一遍。不需要订阅复用，就把「订阅账号发现」关掉。先用一把 API key 的 provider 跑通，再决定要不要把订阅接进来。
#AI工作流 #Agent #AI成本 #效率工具 #magpie