magpie - 从菜单栏统一管理各个 AI Agent 的模型选择

magpie 是一个把「机器上每个 AI Agent 正在用哪个模型」集中到一处的开源工具。按项目自述，它就是一个单屏界面：列出本机已安装或已配置的各个 AI Agent，以及它们当前被设定的模型，点一下数值就能改选模型。它常驻菜单栏，点图标会下拉一个面板，同一个界面也能以普通窗口打开，另外还提供终端版本和纯命令行版本。它适合同时使用多个编码类 Agent、又不想逐个去翻配置文件的人。

维护者与状态

项目由 yetone 维护，仓库创建于 2026-09-23，最后一次提交为 2026-09-26。截至 2026-09-26，仓库星标数为 844，尚无正式 release。许可证为 MIT。项目官网为 usemagpie.ai。

主要能力

以下能力均来自项目自述（README），未经独立验证。

• 体积小、跨平台。项目自述桌面版体积在 15 MB 以内，因为它通过 Wails 使用系统 webview，不额外打包浏览器内核；仅终端版本为 7 MB。支持 macOS、Linux 和 Windows。
• 外科手术式修改配置文件。据项目说明，它只改动你实际更改的那一个键，settings.json、config.toml、opencode.jsonc 或 config.yaml 里的注释、顺序和缩进都会保留，写入是原子的。
• 为所有 Agent 提供统一端点。项目自述 magpie 会运行一个本地网关，支持 OpenAI chat completions、OpenAI Responses 和 Anthropic Messages API，并转发到实际提供该模型的厂商。Codex、Claude Code、OpenCode 等统一指向 http://127.0.0.1:3425/v1，从同一份目录里选模型，API 之间的转换（含流式与工具调用）由 magpie 完成。
• 复用已登录的订阅。据项目说明，登录 Claude Code、Codex（ChatGPT）或 Copilot 后，该登录会作为一个 provider 出现，其他 Agent 可以通过网关使用它的模型，无需复制凭据或粘贴密钥。
• 一个字段添加 provider。项目自述内置 Anthropic、OpenAI、Gemini、DeepSeek、Kimi、GLM、MiniMax、Qwen、Mistral、Groq、xAI、OpenRouter、Together、Fireworks、SiliconFlow、AiHubMix、302.AI、Ollama、LM Studio 等预设，粘贴密钥即可；自定义厂商只需名称和 base URL。项目强调 magpie 不会从 shell 环境变量读取密钥。
• 真实的模型列表。据项目说明，拿到密钥后 magpie 会向厂商询问其提供的模型并只展示这些；models.dev 目录用于补全名称、推理档位，并在后台自动刷新。可以选择每个 provider 暴露哪些模型，也可以全部暴露。
• 配置档（Profiles）。项目自述可以把所有 Agent 的设置按名称快照下来，再一次切换回去。
• 路由组。据项目说明，路由组把来自一个或多个 provider 的多个模型组合成一个供 Agent 选择的整体，网关会在组内各成员的密钥与账号之间分配请求，并支持 smart、order、rotate、usage 等路由策略，以及会话与密钥的绑定时长设置。
• 从其他应用导入。项目自述应用内的导入对话框可以从 Claude Code 的 settings.json 和 Codex 的 config.toml 复制 provider 到 magpie，导入前可先检查条目。

使用入口

仓库地址：https://github.com/yetone/magpie；官网：https://usemagpie.ai。

据项目说明，界面有三种形态：菜单栏面板、普通窗口（运行 magpie，或在托盘菜单里选择 Open magpie），以及终端版本 magpie tui，此外还有纯 CLI。provider 与模型相关的常用命令包括：

magpie presets
magpie provider add deepseek sk-…
magpie provider add ollama
magpie providers
magpie provider models deepseek
magpie provider test deepseek
magpie models
magpie claude deepseek/deepseek-chat

路由组相关命令：

magpie groups
magpie group add "Opus anywhere" models=claude/claude-opus-5-5,copilot/claude-opus-5.5 routing=order stays=session
magpie group set opus-anywhere models+=openrouter/anthropic/claude-opus-5.5 routing=usage
magpie group rm opus-anywhere
magpie claude group/opus-anywhere

据项目说明，自定义 provider 可接受 url=（OpenAI 兼容 base）、anthropic=（Anthropic 兼容 base）或两者，另有 responses=、catalog=、models= 等参数；预设未覆盖的部分也可以用同样方式覆盖。

许可与限制

许可证为 MIT。

据项目说明，界面只显示已安装或已配置的 Agent；provider 作用域下的 Agent（OpenCode、Pi、Goose、Crush、omp、Hermes Agent）使用 provider/model 形式。已登录 Agent 作为 provider 时，magpie 每次读取该 Agent 自己的凭据、按其方式刷新令牌，并把轮换后的令牌写回原处，自身只保存模型选择，退出登录后该 provider 即消失。ChatGPT 后端只支持流式并会拒绝部分参数，magpie 会转换非流式请求并丢弃会被拒绝的参数。项目自述还提到 Claude 订阅存在差异：Anthropic 会把其他 Agent 的系统提示视为第三方流量。此外，从其他应用导入后，后续对 Agent 设置的改动不会自动同步到 magpie；指向 magpie 自身或只写了 env_key 的条目会被跳过。以上均为项目自述内容，实际行为请以仓库与官方文档为准。