yetone开源magpie：35个编程agent共用一个模型网关，配额用完自动切号，菜单栏一点就换模型

如果你同时用 Claude Code、Codex、Gemini CLI 好几个编程智能体，大概率经历过这种场面：每个工具的模型配置藏在各自的文件里、格式各异、密钥互不相通；下午三点配额跑光，只能翻出配置文件手动改。昨天 GitHub 上的热门新项目 magpie，就是要终结这种"一人多agent、处处改配置"的生活——24 小时涨了 700 多颗星。

项目作者是 yetone，前端与 AI 工具圈的老熟人，此前因开源 Cursor 风格的 VS Code 插件 Avante.nvim 而广为人知。magpie 采用 MIT 许可，支持 macOS、Windows、Linux、Docker 甚至 Termux，项目口号一句话讲完："Every agent's model. One place."——所有智能体的模型，放在一处。

核心是三件事：一个列表、一个网关、一套路由。

一个列表：magpie 能识别本机安装的 35 个以上的编程智能体——Claude Code、Codex、Gemini CLI、OpenCode、Goose、Cline、Kimi Code、MiniMax Code，连 WorkBuddy、CodeBuddy Code 都在支持之列。想给某个 agent 换模型，点一下下拉框选新模型即可，magpie 只改该 agent 自己配置文件里的那一个键，注释、顺序、格式原样保留，还支持把整套配置存成 Profile（"省钱档""专注档"）一键切换。

一个网关：本地起一个 127.0.0.1:3425 的服务，同时讲 OpenAI Chat、OpenAI Responses、Anthropic Messages 和 Gemini 四种协议，并且互相翻译，流式输出、工具调用、推理内容全部兼容。任何能配 base URL 的工具都能接进来，设三个环境变量就能用。

一套路由：把多个供应商的多个模型编成一个路由组，配额用完、触发限流，网关自动切到下一个成员，agent 端根本看不到报错。路由策略有五种——smart（优先用配额最快重置的账号，减少浪费）、order（按顺序用到坏为止）、rotate（每轮换人）、usage（谁用得少谁先上）、pace（按每小时剩余配额比例分配）。会话会粘住曾回答它的账号，尽量保住供应商的提示词缓存。更进一步的意图路由允许指定一个小模型先读每轮对话，测试请求转给强模型、简单问题转给快模型。

订阅账号也能变成供应商。 magpie 最有意思的设计是"登录一次，处处可用"：你的 Claude、ChatGPT、Copilot、Gemini、Grok 订阅登录态可以直接作为一种 provider 供其他 agent 调用，无需复制任何密钥，一个订阅还能挂多个账号互相故障转移。国产模型支持也相当齐：DeepSeek、Kimi、智谱 GLM、MiniMax、阶跃、Qwen、百度千帆、腾讯云、火山方舟、华为云 MaaS 都有预设，模型列表从 models.dev 实时拉取，早上发布的模型刷新一下就能用。

插件与中间件生态直接复用 npm 上的 OpenCode auth 插件和 pi 包，magpie plugin add 一条命令安装；插件还可以作为网关中间件，读写每个请求和响应——社区已备好参数覆盖、模型改名、统一系统提示词、敏感词过滤、think 标签处理等现成中间件，与 New API 的玩法对齐。

用量与成本追踪做到账单级：按会话、按账号、按上游密钥统计 token、缓存命中、按牌价折算的成本，每个密钥可设上限，magpie quota 一看各家余额和配额窗口，还支持 OTLP 导出接入自己的可观测体系。此外它支持局域网共享（给每个客户端发独立网关密钥、各设额度）、笔记本远程复用台式机的 magpie、Docker 部署到 NAS、WebDAV/S3 多机同步。

安装三步走：官网下载或 curl -fsSL https://usemagpie.ai/install.sh | sh 一键脚本（也可 go install 或 Docker），添加供应商（选预设贴密钥），然后在 Agents 页为每个工具点选模型。命令行同样全能：magpie claude deepseek/deepseek-v4-pro 让 Claude Code 跑 DeepSeek，magpie group add 建故障转移组，magpie tui 在终端里用全部功能。

对重度多agent用户来说，magpie 解决的是真实痛点：订阅和 API 配额的碎片化。一个本地网关把所有模型、所有账号、所有工具缝在一起，配额耗尽自动续命，这个体验目前没有太直接的同类品。项目刚上线不久热度正猛，MIT 协议商用无忧，值得试一把。

来源：GitHub yetone/magpie 项目主页