如果你同时在用 Claude Code、Codex、Gemini CLI 这类 AI 编程助手，一定遇到过这种局面：每个助手都有自己的配置文件、自己的模型列表、自己的登录方式；手里明明有好几个订阅和 API Key，换个模型却要翻半天配置；某个订阅的额度一用完，活就卡在半路。Magpie 就是来收拾这个烂摊子的：它把所有助手和所有模型收到一个菜单栏应用里，模型想换就换，额度用完自动换下一个。
Magpie 是什么
Magpie 是一个开源的本地网关加菜单栏应用。它的核心思路很简单：本机起一个网关（地址是 127.0.0.1:3425），所有 AI 编程助手都通过这个网关去调用模型；你在 Magpie 里统一管理供应商、账号和模型，助手那边不需要再逐个改配置。官方的口号是“Every agent’s model. One place.”——每个助手的模型，一个地方全搞定。
举个例子：你可以在 Claude Code 里跑 Kimi 的模型，也可以在 Codex 里跑 DeepSeek 的模型；或者反过来，让 Gemini CLI 用上 GLM 的模型。模型和助手之间不再绑定，完全由你自由搭配。
核心功能亮点
1. 任意模型配任意助手，一处切换。在 Agents 页面点一下，就能为某个助手换上任意供应商的模型，格式是“供应商/模型”；Magpie 会直接改写助手自己的配置文件，而且会保留原有的注释、顺序和格式。多个助手的配置还能存成一个 Profile（比如“省钱模式”“专注模式”），一键整体切换。
2. 订阅也能当成模型来源。你已经登录的 Claude、ChatGPT、GitHub Copilot、Gemini、Antigravity 等订阅，在 Magpie 里会被当作一个供应商，提供给所有助手使用。也就是说，一个订阅不再只服务于它自家的助手，而是全家通用。每个订阅还可以添加多个账号，额度不够时自动在账号间故障转移。
3. 路由组：额度用完不断线。把几个模型组成一个路由组（比如 group/daily-coding），助手选中这个组后，网关会在组成员之间分配请求。路由模式有 smart（优先用快到期的剩余额度）、order（按顺序用完再换下一个）、rotate（轮询）、usage（先用最少用的）、pace（按剩余时间匀速消耗）五种。对话还会尽量留在同一个账号上，以保住厂商的提示词缓存。
4. 隐私掩码：密钥不出本机。助手经常会把读到的 .env、配置文件、日志原样塞进提示词，里面可能就有真实的 API Key。开启掩码后，Magpie 会在本机把这些敏感值替换成占位符再发出去，回复里的占位符再换回真实值；厂商从头到尾看不到你的密钥。掩码记录只保留值的类型、长度和前几个字符，敏感值本身只存在内存里、不落盘；如果掩码无法运行，请求会被拦下（返回 503），而不是明文发出。
5. 用量、额度和账单一目了然。Usage 页面汇总每个 Key、每个订阅的 Token 数、缓存命中率和按官方价计算的成本；magpie quota 命令能直接查所有计划的剩余额度；还有提醒功能，在某个额度窗口快续期、却还剩很多没用时提醒你。团队场景下还能把网关共享到局域网，或者用 Docker 部署到服务器、NAS 上。
截图导览
图 1：Agents 页面。Claude Code 配 Kimi K3、Codex 配 DeepSeek V4 Pro、Gemini CLI 配 GLM-5.3——不同助手的模型都在同一张表里选。来源：仓库 README 官方演示图
图 2：菜单栏面板。从 macOS 菜单栏点开就能快速切换模型，不用进终端改配置。来源：仓库 README 官方演示图
图 3：隐私掩码 Insights 页面。7 天里拦截了 5812 个敏感值，哪些请求被改过、厂商实际收到的是什么，都能逐条对账。来源：仓库 README 官方演示图
快速上手
照 README 的步骤，上手分三步，不需要 GPU，也不需要自己编译：
- 安装。去官网 usemagpie.ai 下载应用，或者在终端运行官方一键脚本：
curl -fsSL https://usemagpie.ai/install.sh | sh。Mac 构建已经过签名和公证；也可以用go install github.com/yetone/magpie@latest，或者跑 Docker 镜像。 - 添加供应商。打开 Magpie，进入 Providers → Add provider，选一个预设、粘贴 API Key；或者直接登录已有的订阅。预设覆盖 Anthropic、OpenAI、Google Gemini、DeepSeek、Kimi、智谱 GLM、MiniMax、Qwen、Groq、OpenRouter 等几十家，也支持 Ollama、LM Studio 这类本地模型服务和任意兼容 OpenAI、Anthropic 协议的地址。
- 选模型、开新会话。在 Agents 页面为每个助手挑好模型，新开一个会话就生效。纯终端用户也可以用命令行完成同样操作，例如
magpie claude deepseek/deepseek-v4-pro（让 Claude Code 跑 DeepSeek）、magpie quota（查所有计划的剩余额度）、magpie tui（在终端里打开完整界面）。
门槛提醒：Magpie 本身不送模型额度，你得自带 API Key，或者已经有 Claude、ChatGPT、Copilot 这类订阅；纯本地模型走 Ollama 或 LM Studio，不需要额外花钱，但效果取决于你本机的模型。隐私掩码里那个“连名字、地址、密码都能识别”的本地小模型是可选项，约 1.6 GB 下载量、在 CPU 上跑，不开它也能用基于规则的掩码。
我的建议
适合谁：同时用两个以上 AI 编程助手的人；手里有多个订阅或多个 API Key、想把钱花在刀刃上的人；经常被“额度用完了”打断工作、想让任务自动续上的人；以及在意提示词里别把真实密钥发给厂商的人。对这四类人，Magpie 解决的是每天都会碰到的真麻烦，不是锦上添花。
不适合谁：只用一个助手、且只用它自带官方套餐的人——README 自己也说了，这种情况你不需要它。另外，如果你对“它会读取助手登录文件来发现订阅”这件事介意，记得可以在设置里关掉订阅账号发现功能，或者用 MAGPIE_NO_ACCOUNTS=1 只关单次；纯 API Key 用户完全不受影响。
值不值得试：结论是值得。理由有三：第一，它是 MIT 开源、近一个月内从零涨到两万多 Star（2026-10-28 核实为 23,580 star），更新频率是“今天仍在提交”的级别，不是弃坑项目；第二，它不绑架你——模型、订阅、本地模型全是自己的，网关跑在本机，不合用随时可以拆掉，助手配置原样保留；第三，隐私掩码和路由组这两个功能在同类工具里确实少见，前者是安全刚需，后者是省钱刚需。唯一要提醒的是：这是一个 2026 年 9 月底才创建的新项目，功能迭代快，界面和命令细节可能变化，照着官方文档走比照着任何一篇旧文章走都靠谱。
GitHub 仓库：https://github.com/yetone/magpie；官网与下载：https://usemagpie.ai；入门文档：https://usemagpie.ai/docs/start
