01
真实使用场景
手上有 Claude Code、Codex、Gemini CLI 几个 Agent,各自的配置文件格式不一样,key 和 base URL 各写各的。
想换个模型跑,就得翻文档改配置;某个订阅额度见底,还得手动换账号。
magpie 把这些收进一个菜单栏应用。
打开 Agents 页,给每个 Agent 点一个模型,比如 Claude Code 选 Kimi、Codex 选 DeepSeek,新开会话就生效。
它只改配置里该改的那一个键,注释和格式原样保留。
用终端的人也能全程命令行:magpie provider add deepseek sk-… 加服务商。
magpie claude deepseek/deepseek-v4-pro 直接指定 Claude Code 用哪个模型。
另一个常见场景是订阅复用。
你登录过的 Claude、ChatGPT、Copilot 订阅,magpie 会当成 provider 给其他 Agent 用,一个订阅不再只服务一个工具。
02
它解决什么问题
问题不在模型不够多,而在配置太散。每个 Agent 一套写法,换个模型像做一次小迁移,试错成本高。
第二个问题是额度。同一个服务商往往有多个账号,哪个先用、哪个快重置,全靠人记。
magpie 用路由组把这层接住:额度用完时自动切到下一个账号,Agent 那边看不到报错。
第三个问题是隐私。Agent 会把读到的 .env、配置、带 token 的日志塞进提示词,这些内容会原样发给厂商。
magpie 可以在请求离开电脑前本地脱敏。
它做的其实是把「模型选择」和「请求转发」从各个 Agent 里抽出来,放到一个本地网关上。
网关跑在 127.0.0.1:3425,同时支持 OpenAI Chat、OpenAI Responses、Anthropic Messages 和 Gemini
几种接口,并在它们之间互相转换。
03
核心功能体验
最直接的体验是模型选择器。
点一下弹出可搜索列表,格式是 provider/model,你添加的每个服务商的每个模型都在里面。
方案(Profile)能把所有 Agent 的配置存成一个名字,比如「省钱」「专注」,一键整体切回去。
路由组是另一个重点。
它把一组模型包装成一个 Agent 可选的模型,支持 smart、order、rotate、usage、pace 几种模式。
smart 会在还有额度的订阅里优先用最快重置的那个。
只要提示词缓存还值得保留,对话就留在回答它的那个账号上。
隐私脱敏默认关闭,在设置 → 隐私里打开。
打开后,API key、私钥、token、邮箱这类值会在本地换成 {{API_KEY_…}} 占位符,回复里再换回原值,流式文本和工具调用参数也算。
原值只在内存里,不落盘。
用量页能看到 token、缓存读写、推理和调用次数,按官方价格算花费。
magpie quota 可以查每个套餐还剩多少。
插件部分给了扩展空间:插件可以是登录方式,也可以是网关中间件,用 JavaScript 写 onRequest、onEvent、onResponse 钩子。
改写或拒绝请求。
04
优点与不足
优点集中在统一和可控。
一个本地网关管住几十种 Agent,配置改动原子化,方案一键切换,账号自动轮换,这些是日常真能省时间的部分。
跨平台也做得比较全,macOS、Windows、Linux 都有菜单栏应用、窗口、TUI、Web 界面和 CLI,还能跑在 Docker 和 Termux 上。
许可证是 MIT。
不足也要说清楚。
项目还很新,创建于 2026 年 9 月,最新版本 v0.1.3616 发布于 2026 年 11 月 10 日,版本号还是 0.1 开头。
开放的 issue/PR 有 3631 个,说明反馈量大,也说明还有不少待处理的问题。
最新 Release 资产下载总量只有 41,下载数据并不算高。
脱敏有代价:模型看到的是占位符而不是真实值,针对值本身的任务做不了,这类值需要加进「从不脱敏」。
规则偶尔也会判错。
另外仓库明确不接受 Pull Request,只有维护者能提交,想贡献得先去 Discord 描述清楚。
05
适合谁
如果你同时用不止一个 Agent、不止一个服务商或不止一个账号,magpie 正好对上。
尤其是订阅分散在 Claude、ChatGPT、Copilot 几处,又想交叉使用的人。
如果你只用一个 Agent、只用它自家的订阅,而且够用,那就不需要它。
多装一层网关只会多一个要维护的东西。
对隐私敏感、又不得不把配置和日志喂给 Agent 的人,可以试试脱敏功能,但要接受它带来的限制。
想自己写插件、做路由策略的人也有空间,中间件那套钩子足够直接。
项目在 GitHub 上已经拿到 3.4 万 Star,fork 2998,热度不低。
要不要用,取决于你手上到底有几个 Agent、几个账号。















暂无评论内容