magpie

magpie 是一个 2026-09-23 发布的免费开源菜单栏应用，它只解决一件事：让机器上每个 Agent 都能用上你手上的任意模型。以前想把 Codex 换成更便宜的模型、把 Claude Code 换成更快的模型，得手改 settings.json；现在 magpie 把已安装的 Agent 列成一屏，每行显示它当前指向的模型，点一下就能换。

仓库上线首日就冲到 430 star，说明同时养着两个以上编码 Agent 的人比想象中多得多。

核心功能

• 一屏管住所有 Agent。 Claude Code、Codex、Gemini CLI、OpenCode、Pi、Goose、Cursor CLI、Copilot CLI、Crush 列在同一屏，各自显示当前模型。
• 外科手术式改配置。 magpie 只重写你改动的那一个键：~/.claude/settings.json、~/.codex/config.toml、~/.config/opencode/opencode.jsonc、~/.config/goose/config.yaml 里的注释、键顺序和缩进都会保留，写入是原子的。
• 配置档（Profiles）。 把当前所有 Agent 的设置存成「省钱」「专注」之类的档案，一键整体切换。
• 终端版本可用。 同一屏还有 magpie tui 和纯 CLI 命令，SSH 环境照样能用。

网关是怎么工作的

magpie 真正有意思的一半不是菜单栏，而是协议转换层。Codex 只会讲 OpenAI Responses，Claude Code 只会讲 Anthropic Messages，Gemini CLI 只讲 Google 的格式。magpie 在 127.0.0.1:3425 跑一个网关，同时接受这三套协议，再转发给真正提供该模型的厂商，流式输出、工具调用和 reasoning 块都在转换范围内。

把任意 Agent 的 base URL 指向 http://127.0.0.1:3425/v1，它就能用一个自己从没听说过的模型。密钥留在 magpie 里，Agent 手里只有一个本地地址。

供应商与订阅复用

加供应商只要一行：magpie provider add deepseek sk-...。内置预设覆盖 Anthropic、OpenAI、Gemini、DeepSeek、Kimi、GLM、MiniMax、Qwen、Mistral、Groq、xAI、OpenRouter、Together、Fireworks、SiliconFlow、AiHubMix、302.AI、Ollama、LM Studio，自定义厂商只需要一个名字和一个 base URL。

最特别的是订阅复用。如果你已经在 Claude Code、Codex 或 Copilot 里登录过，这个登录本身就会变成一个供应商：Claude Pro / Max 会在 OpenCode、Pi、Goose 里显示为 claude/claude-sonnet-5，Copilot 席位会显示为 copilot/claude-sonnet-4.5。它不复制凭证，而是每次读取 Agent 自己的凭证文件，并按 Agent 的方式刷新 token。

模型列表直接从厂商拉取，配不上时用 models.dev 目录补名字和 reasoning 档位，所以今早刚发布的模型下次刷新就会出现在选择器里。

定价

magpie 本身免费：MIT 许可、开源、无需账号，桌面版不到 15 MB，纯终端版约 7 MB。你只需要付模型厂商的钱；走已有订阅的话不额外花钱。

快速开始

1. 从 usemagpie.ai 下载桌面版，或用终端安装：

curl -fsSL https://usemagpie.ai/install.sh | sh

2. 加一个供应商并粘贴密钥，或者直接沿用已登录的 Agent 作为供应商。
3. 打开菜单栏面板，逐个 Agent 选模型。只有已安装或已配置的 Agent 才会出现。
4. 开新的 Agent 会话。配置改动对下一次会话生效，不影响正在跑的那次。

源码在 GitHub，CLI 也可以用 go install github.com/yetone/magpie@latest 安装。

限制与风险

• 项目只有一天大。 仓库创建于 2026-09-23，属于早期软件。要放进团队流程就锁定版本。
• 它会读取 Agent 凭证。 把 Claude、ChatGPT、Copilot 的登录复用到别的 Agent 是实打实的能力，也意味着 magpie 会碰这些凭证文件。README 写清了读写范围，开启前请自己看一遍；把订阅接入第三方 Agent 之前，也请确认各厂商的服务条款。
• 桌面版不是全平台通吃。 Wails 构建需要 macOS 11 以上；Linux 上桌面版依赖 WebKitGTK 4.1，否则用终端版本。
• 本地网关也是网关。 它监听回环地址，但本机任何进程都能访问。

常见问题

magpie 会存我的 API 密钥吗？

会，存在 magpie 自己的配置里，而且它不读系统环境变量里的密钥。Agent 只看到本地网关。

只能在 macOS 上用吗？

不是。Linux 和 Windows 都支持，纯终端版本最轻。

它能替代 OpenRouter 或 LiteLLM 吗？

不能。那两个在云端把流量转发给不同厂商；magpie 在本地，干的是改你这台机器上 Agent 配置的活。

换回原厂模型怎么办？

magpie 会恢复配置里原来完全一致的内容，不需要手工撤销。

替代方案

• CC Switch：专注在 Claude Code 的多供应商切换，Rust/Tauri 桌面界面。
• Claude Code：如果你只需要一个 Agent，这就是本体。
• Codex CLI：OpenAI 的终端 Agent，也是 magpie 可以改写的对象之一。
• OpenRouter Gateway：面向云端路由的 API 网关技能，而不是本地网关。

总结

多 Agent 时代留下了一笔很无聊的税：每个新 Agent 都重写一遍模型选择器，而你每想换一个模型就要改一次配置。magpie 的做法是不去占模型的位置，而是占住中间的翻译层，把这笔税消掉。如果你同时在用两个以上的编码 Agent，这是最省事的模型管理方式。