手上同时装着 Claude Code、Codex 和 Cursor CLI，每家套餐各有各的额度，想把这边的额度用在那边的客户端上，就得翻出配置文件、改 base URL、填另一个 key，还得记住自己动过哪一行。几个项目来回切，配置越改越乱，额度却各自为战：一个账号刚跑满，另一个躺在那里没人用。magpie 把这件事收拢到一个本地网关和一个菜单栏面板上：登记一次 key 或已登录的套餐，每个 agent 就能从同一份列表里挑模型，配置由它改写，额度不够时自己换下一个账号。它由 yetone 开发，2026 年 9 月下旬开源，一个多月攒下两万多颗 Star。下面按定位、功能、适用人群、上手步骤、平台与收费讲清它解决的是哪一类麻烦。
magpie 是什么？
它由两部分组成：跑在本机 127.0.0.1:3425 的网关，和一层管理界面。网关同时说 OpenAI Chat、OpenAI Responses、Anthropic Messages 与 Gemini 四套协议，并在它们之间双向翻译，流式输出、工具调用与推理内容都在翻译范围内——只会说 Responses 的 Codex 因此也能用别家的模型。管理界面负责另一件事：改掉每个 agent 配置里那一个关键的键，注释、顺序与缩进原样保留，写入是原子的。它只列出本机真正装了的 agent，官方给出的支持名单有六十多个；点开某一项的模型值，就是一个按「供应商/模型」排列的可搜索清单，选中后开个新会话即生效。项目用 Go 写成，MIT 协议，Mac 安装包约 15 MB，界面走系统 webview，没有内嵌 Chromium，也就不必为一个配置工具再带一份浏览器内核。
核心功能
它解决的是”agent 多、供应商多、账号多”这三件事叠在一起时的调度问题，重点不在聊天体验，而在配置、额度与密钥。
- 一次配置处处生效——模型值点开是可搜索清单，选中只改写那一个配置键；Profiles 把整套 agent 设置存成一个名字（比如”省钱””专注”）一键整体切换，Library 则把 instructions、MCP server、skills、subagents 写一次，按各 agent 的格式分别落盘，拆除时只删自己写的那部分。
- 把订阅变成供应商——已登录的 Claude、ChatGPT（Codex）、GitHub Copilot、Gemini Code Assist、Antigravity、Grok 套餐都能当 provider 供别的 agent 调用，不用复制 key；其中 Claude 走的是本机真实的 claude 二进制，工具调用经 MCP 桥接过去。
- 五种路由策略——smart 在还有额度的订阅里挑最快重置的那个，pace 挑每小时余量最多的，另有 order、rotate、usage；”按意图”另配一个小模型读每一轮新提问，把测试交给强模型、快问答交给便宜模型。会话在 prompt cache 还值得保留时留在原账号，组里还能套组。
- 隐私遮蔽——把 prompt 里的 API key、私钥、token、邮箱、卡号、身份证号换成占位符再出门，回复里再换回真值；同一个值始终用同一个占位符，对话、prompt cache 与 thinking 签名都不会因此失效。值只存在内存，记录里只留类型、长度和开头几个字符；开了遮蔽却跑不起来时请求直接被扣住（503），不会原样发出去。每个类别可设”遮蔽/仅提示/拦截”，也能指定某些值永不遮蔽。
- 用量与成本——按 agent、模型、账号与上游 key 拆开看 token、缓存读写、推理与花费，单价可自填；magpie quota 与界面里都能看每个套餐的额度窗口，窗口快重置却没怎么用时会提醒，Sessions 与 Context 则能翻回某次对话花了多少、上下文被什么填满。
- 插件与中间件——插件跑在 Bun 上，能装 npm 里的 OpenCode 插件和 pi 包，各自带自己的登录流程；插件也可以当网关中间件：onRequest 改写或拦下请求，onEvent 看每个流式事件，onResponse 看完整回复，钩子抛错或跑太久就把请求原样放过。社区已经备好参数改写、模型映射、系统提示词、敏感词过滤、think 标签处理这几个现成的。
- 顺手工具——任意模型都能挂上 magpie 的网页搜索（Tavily、Brave、Exa、Firecrawl、You.com、DeepSeek、SearXNG 任选，按拖动顺序问，多个 key 轮流用，近期被拒的排最后），也可以把它当 MCP 服务器给 agent 一个 web_search 与 web_fetch；图片工具经 MCP 走你选的模型，视频用 Grok 订阅出；Agents 页还能看各 CLI 的版本并就地升级。
- 局域网共享与多机同步——给每台设备发一个带日/周/月 token 与费用上限的具名 key；笔记本可以借用台式机的供应商、账号与路由组，或用 Docker 跑在服务器、NAS 上从网页管理；配置能备份成文件，也能经 WebDAV（坚果云、Nextcloud）、S3 或加密的 GitHub 仓库在多台机器间同步。
使用场景
四类需求最容易撞上它：客户端各说各的协议、额度分散在多个账号、不想把 .env 里的东西交给供应商、以及配置要在几台机器之间保持一致。
| 人群/角色 | 场景描述 | 推荐指数 |
|---|---|---|
| 同时用多个 CLI 的开发者 | Claude Code 写业务、Codex 改测试、Gemini CLI 查资料，共用一套 key，不用来回改配置 | ★★★★★ |
| 订阅叠了好几个的人 | Claude Max 与 ChatGPT Plus 同时开着，按重置时间轮流用，每天定点把 5 小时窗口错开 | ★★★★★ |
| 在意账单的小团队 | 按 agent、模型与上游 key 拆开看成本，接 OTLP 进自己的监控 | ★★★★☆ |
| 后端与运维 | agent 读 .env、日志之前先开遮蔽，密钥不出本机 | ★★★★☆ |
| 本地模型用户 | Ollama、LM Studio 与云端模型放进同一个路由组，简单的走本地 | ★★★★☆ |
| 有 NAS 或小主机的人 | Docker 跑在服务器上，桌面端与笔记本共用一个网关 | ★★★☆☆ |
| 多设备来回换的人 | 配置经 WebDAV 或 S3 同步，换机器不用重配一遍 | ★★★★☆ |
操作指南
从装好到用上第一个跨供应商的模型，大约五分钟。
- 在 magpie 的 Releases 里下载安装包，或用官网的一行安装脚本，也可以用 go install 或直接拉 Docker 镜像；Mac 版已签名公证，装好会自己更新。
- 打开「Providers」→「Add provider」，从预设里挑一家粘 key——Anthropic、OpenAI、Gemini、Bedrock、DeepSeek、Kimi、智谱 GLM、MiniMax、通义千问、火山方舟、SiliconFlow、OpenRouter、Ollama、LM Studio 都在列表里；想用已有套餐就选登录，它会读取本机 agent 的登录态，也能从 CC Switch、Claude Code、Codex 导入原有配置。
- 切到「Agents」，给每个 agent 点选模型，列表按「供应商/模型」排列，可以搜索；选完开个新会话就落到新模型上。
- 账号多的，把它们加成路由组，策略选「按意图」「smart」或「pace」，让快过期的额度先上。
- 用 Claude 或 ChatGPT 套餐的，在订阅设置里打开每日预热，把各账号的 5 小时窗口定在开工之前，或者设成上一个窗口刚重置的那一刻。
- 要挡敏感信息就进「Settings」→「Privacy」打开遮蔽（默认是关的），「Insights」→「Masking」里能逐条核对改写了什么、供应商实际收到了什么，「Try it」可以先拿一段文本试。
- 给别的设备用就打开局域网共享，为每个客户端发一个带限额的具名 key；不在同一网络的走远程模式，或把整个网关放到 Docker 里。
- 命令行是同一套：「magpie provider add」加供应商，「magpie claude deepseek/…」换模型，「magpie group add」建组，「magpie quota」查余额，「magpie tui」在终端里用完整界面。
支持平台
macOS、Windows 与 Linux 都有桌面版，形态包括菜单栏面板、独立窗口、TUI、网页界面与纯命令行；Mac 端走系统 webview，安装包十几兆。Windows 上 WSL 各发行版里的 agent 也会被接管，会话一起统计。移动方向有面向 Android 终端的 Termux 安装方式。另有 Docker 镜像可跑在服务器或 NAS 上，从网页界面管理。网关默认只监听本机端口，跨设备要手动开放。
产品定价
免费。项目以 MIT 协议开源，源码、命令行与 Docker 部署都不收费，官网也没有会员或订阅层级，没有要解锁的功能页。开销只来自你接进来的东西：API 按用量计费，Claude、ChatGPT 这类套餐按月付费，本地模型只花电费。软件自带用量与成本视图，按 key、账号和模型拆开算，也能给任意模型填自定义单价。页面上的赞助商是第三方中转服务的广告位，不影响功能。
常见问题
Q：我的 key 和 prompt 会被传到它自己的服务器吗？
请求不会。网关跑在你本机，请求直接发给你配置的供应商；遮蔽打开后，连供应商看到的也只是占位符。项目是 MIT 开源的，可以自己编译核对。需要说清的是它每天会上报一次匿名使用情况：一个随机 id、版本与系统，以及用到了哪些 agent、供应商与模型（都用软件自己的标识，自己添加的供应商只记作 custom），不含名称、地址、账号、密钥、prompt 与用量；可以在「Settings」→「Privacy」里分项关掉，或设 DO_NOT_TRACK=1。对外的另一个通道是你主动打开的局域网共享，那时每台设备拿的是单独签发、带配额的 key。
Q：某个账号额度用完了，对话会中断吗？
只配一个账号又没有路由组时，错误会照常抛给 agent。配了多个账号或路由组，网关会在回复送达之前换到下一个能用的账号，agent 收不到报错；撞上限流时按供应商给的 Retry-After 等待，不会反复重试。路由还可以更细：smart 让最快重置的额度先用，pace 优先消耗每小时余量最多的账号，配合每日预热把几个 5 小时窗口错开，就不用盯着时间表手动切换。
Q：带图形界面的编辑器也能接吗？
能。官方名单里排了六十多个客户端，本机装了的才会显示出来，从 Claude Code、Codex、Gemini CLI、Cursor CLI、Zed、VS Code、JetBrains 到 OpenCode、Cline、Qoder 都在其中；本质上只要能把 base URL 指到本地端口就能接，OpenAI、Anthropic、Gemini 三种协议任选，设置里没这一项的客户端用环境变量也一样。
开发者小结
它把多 agent、多供应商、多账号这三层复杂度压进一个本地网关，赢在细节：改配置只动一个键并保留注释，遮蔽连占位符一致性、prompt cache 与 thinking 签名都想到了，额度调度能看到每一次决策，中间件钩子出错也不会把请求弄坏。适合同时跑两三个编码 agent、订阅与 key 又分散在几家的人，也适合要把密钥挡在供应商门外的团队。边界同样清楚：只用一个 agent 加一个官方套餐的人不需要它；要认出姓名、地址、密码这类没有规则可循的内容，得额外下一个 1.6 GB 在 CPU 上跑的小模型；遮蔽打开后模型看到的是占位符，所以”这个 token 为什么被拒”一类关于密钥本身的任务做不了，得把它列进永不遮蔽；网关在本机，机器睡眠时别的设备就取不到模型；仓库不接受外部 PR，问题与建议只能去 Discord 提。
相关文章
