同时开着 Claude Code、Codex、Gemini CLI 时，最烦的不是写代码，而是：每个 Agent 各用各的模型配置。想给 Claude Code 换 Kimi、给 Codex 换 DeepSeek，往往要改不同格式的配置文件、粘不同的 key，还得记得哪个订阅额度快没了。
下文的 Magpie 属于「网关与路由」这一类；其他几类周边工具和按需求的搭配建议，见AI 编程 Agent 生态全景。
Magpie 把这件事收进菜单栏：加一次 provider，本地网关翻译协议，任意 Agent 点一下就能换模型；额度打满时还能静默切到下一个账号。资料查阅于 2026 年 10 月 16 日。
Magpie 是什么
Magpie 是开源的本机「Agent 模型网关 + 切换器」，仓库：yetone/magpie，写这篇时约 1.34 万星（GitHub API 13443），协议 MIT，主语言 Go。官网：usemagpie.ai，中文站：usemagpie.ai/zh。发布包走 yetone/magpie-releases，当前约 v0.1.1263（2026-10-15）。
它干三件事：
- 本地网关默认在
127.0.0.1:3425，同时说 OpenAI Chat / Responses、Anthropic Messages、Gemini，并在中间做流式、工具调用、reasoning 的互译——所以 Codex 也能打 DeepSeek，Claude Code 也能打 Kimi。 - 菜单栏 / 窗口 / TUI / CLI 给每个已安装的 Agent 选
provider/model，只改配置里该改的那一个键，注释和排版尽量保留。 - 路由组 + 多账号：
smart/order/rotate等策略在订阅额度、限流、欠费之间切换，尽量不让 Agent 先看到报错。
官方自己划边界：如果你只用一个 Agent、只用它自家订阅，而且够用——不需要 Magpie。多 Agent、多 key、多订阅才是它的甜点。
怎么装、怎么用
Mac / Windows / Linux 都支持；Mac 构建声明已签名公证，体积约 15 MB 级原生应用（非 Electron）。一键安装：
curl -fsSL https://usemagpie.ai/install.sh | sh
也可官网下包，或 go install github.com/yetone/magpie@latest。装好后：Providers 里加预设（DeepSeek、Kimi、GLM、Qwen、OpenRouter、Ollama…）粘 key，或复用已登录的 Claude / ChatGPT / Copilot 等订阅；再到 Agents 页给每个 Agent 选模型，新开会话即生效。
终端示例：
magpie provider add deepseek sk-…
magpie claude deepseek/deepseek-v4-pro
magpie codex moonshot/kimi-k2.5
magpie group add "Opus anywhere" models=claude/claude-opus-5-5,copilot/claude-opus-5.5 routing=smart
magpie claude group/opus-anywhere
magpie save work && magpie use work
magpie quota
magpie tui
任意只认 base URL 的客户端也可直连网关，例如：
export OPENAI_BASE_URL=http://127.0.0.1:3425/v1
export OPENAI_API_KEY=magpie
支持的 Agent 名单很长（Claude Code、Codex、Gemini CLI、OpenCode、Cursor CLI、Goose、Cline…），界面只显示本机已装的。
和 CC Switch / LiteLLM / OpenRouter 差在哪
| Magpie | CC Switch 一类 | LiteLLM | OpenRouter | |
|---|---|---|---|---|
| 形态 | 本机菜单栏 + 网关 | 多为配置/UI 切换 | 常作服务端代理 | 云端聚合 API |
| 协议翻译 | 本机多协议互译 | 通常偏单一生态 | 强，偏运维部署 | 云端统一 OpenAI 风 |
| 订阅复用 | 可读本机登录当 provider | 看具体工具 | 一般不碰桌面登录 | 无 |
| 适合谁 | 多 Agent 桌面党 | Claude 重度、想快切配置 | 团队网关、可观测 | 懒自建、接受云中转 |
一句话：Magpie 更像「写代码的人自己电脑上的总控台」；LiteLLM 更像「给团队架的代理」；OpenRouter 是「把模型买在别人家」；CC Switch 等则往往更窄、更偏某条 Agent 线。Magpie 还能从 CC Switch 等导入 provider，迁移成本相对低。
优点
- 痛点真实：多 Agent × 多模型 × 多订阅，配置地狱确实存在。
- 本机网关 + 协议翻译，不必每个 Agent 只认自家 API。
- 路由组与额度感知，对「同时挂几个 Max / Plus」的人实用。
- MIT、体积小、跨平台，Mac 还有自动更新路径。
不足
- 订阅发现会读 Agent 登录态 / 钥匙串（可在设置或
magpie accounts discovery off关掉）；敏感环境要自己权衡。 - 把 A 家订阅塞进 B 家客户端，是否触碰各家 ToS，官方帮不了你，责任在用户。
- 版本号还在 0.1.x，Issues 很多（写这篇时仓库 open issues 约 800+），跟得紧就好，别当零维护基础设施。
- 功能面很满（插件、intent routing、嵌套路由），新人容易一次开太多，先搞懂「加 provider → 选模型」即可。
适合谁
- 同一台电脑上 Claude Code / Codex / Gemini CLI / OpenCode 换着用的人。
- 想把 DeepSeek、Kimi、GLM、本地 Ollama 和现有订阅放进同一套切换习惯里的人。
- 愿意本机跑一个小网关、换「少改配置文件」的人。
如果只开一个官方 Agent、只充一家的钱，直接用原厂设置更简单。多入口开始打架时，再装 Magpie 往往一次就懂它为什么涨星。
