📌 评测对象：yetone/magpie | 星数：7,596（2026-10-09）| 语言：Go | 协议：MIT | 创建：2026-09-23 | 出处：开源项目，GitHub，yetone（openai-translator 作者）新作
一句话定位："每个 Agent 的模型放在一个地方——Claude Code 跑 Kimi、Codex 跑 DeepSeek、Gemini CLI 跑 GLM，菜单栏一键切换，配额用完自动跳下一个账户。" magpie 不是一个新 Agent，而是所有现有 AI coding Agent 的"模型管理层"——它把 Claude Code、Codex、Gemini CLI、OpenCode 等 45+ 个 Agent 各自散落在不同配置文件里的模型/密钥/Provider 统一到一个 app + 一个本地网关后面。
作者 yetone 是知名开源开发者（openai-translator 50k+星），magpie 9 天 7.6k 星延续了其"解决真实痛点"的开源风格。与之前评测的 PhotoCraft（Rust 重写 Photoshop）不同，magpie 是 AI 开发者工具链的核心基础设施——模型路由/切换/网关。站内已有 CC Switch AI 编码管理器教程 和 Claude Code Router 路由教程，magpie 的差异在于"多 Agent 统一管理"而非"单 Agent 路由"。更多 Agent 框架知识可参考 DeepSeek Harness Agent 指南。
| 维度 | 分数 | 评述 |
|---|---|---|
| 理念 | 9.0 | "Every agent's model in one place"是精准定位——每个 AI coding Agent 都把自己的模型配置存在各自的文件里（Claude Code 有 settings.json、Codex 有自己的 config），用户在 Agent 之间切换时需要手动改多个文件。magpie 把这层碎片化统一掉，是 AI Agent 多工具并用时代的刚需基础设施。45+ Agent / 4 API 协议 / 5 路由模式 / 0 手动配置文件，产品边界清晰。 |
| 工程 | 8.5 | Go 原生编译、跨平台 5 种形态（菜单栏 app/窗口/TUI/Web UI/CLI）、Docker + Termux 支持。本地网关支持 4 种 wire API 协议（OpenAI 兼容/Anthropic/Google/Groq），5 种路由模式（单模型/轮询/故障转移/权重/配额感知）。Mac 构建签名+公证+自动更新。扣分=Linux 菜单栏体验不如 macOS 原生，CLI 功能仍在完善。 |
| 数据诚实 | 8.5 | README 明确说明"如果你只用一个 Agent 且其厂商自己的订阅够用，你不需要 magpie"——不夸大适用场景。透明列出 45+ Agent 支持列表和 4 种 API 协议，不隐瞒兼容性限制。插件系统和社区生态如实标注"建设中"。 |
| 上手 | 9.0 | curl 一键安装、菜单栏选模型、零手动编辑配置文件——三步从安装到使用。Provider 预设（DeepSeek/Kimi/GLM/OpenAI 等）只需粘贴一个 API key。CLI 同样简洁：`magpie claude deepseek/deepseek-v4-pro` 一行命令给 Claude Code 切到 DeepSeek。TUI/Web UI 双形态适配终端和桌面用户。 |
| 安全 | 8.5 | 本地网关运行，API 密钥不离开本机——magpie 充当 Agent 和 Provider 之间的中间人，密钥存在本地不经过第三方服务器。MIT 开源可审计。Mac 构建签名+公证。扣分=网关默认监听本地端口，多用户系统需注意端口隔离；密钥存储方式未详细说明加密措施。 |
| 文档 | 8.5 | 有完整 docs 站点（usemagpie.ai/docs）、参考文档、插件开发指南、Discord 社区。README 以"适用场景→快速开始→CLI 命令→路由模式"展开，信息密度高。中英文双语。扣分=5 种路由模式的详细配置示例不够充分，高级用法需看源码。 |
| 成本 | 9.5 | MIT 开源完全免费，无 SaaS 订阅、无 API 中间费用。本地网关不增加任何 token 成本（透明转发）。用户仍需各自 Provider 的 API key/订阅，但这是 Provider 费用不是 magpie 的。扣 0.5 分=Mac 签名版和未来可能的付费功能未明确。 |
| 生态 | 8.5 | 7.6k 星 9 天爆发，yetone 个人品牌效应强（openai-translator 50k+星）。45+ Agent 覆盖当前主流 AI coding 生态（Claude Code/Codex/Gemini CLI/OpenCode/Aider/Cline 等）。插件系统+社区 Discord 活跃。扣分=项目较新（16天），第三方插件和集成生态尚在早期。 |
总分：8.7 / 10
magpie 与传统模型路由器（如 Claude Code Router）的根本区别是"管理范围"：路由器只转发一个 Agent 的请求到不同模型，magpie 管理 45+ 个 Agent 的模型配置——每个 Agent 在 magpie 的 Agents 页面可以独立选模型/Provider/账户。这意味着你可以在同一台机器上让 Claude Code 跑 Kimi K3、Codex 跑 DeepSeek V4 Pro、Gemini CLI 跑 GLM-5.3，各 Agent 互不干扰，切换不重启。
# 给 Claude Code 切到 DeepSeek
magpie claude deepseek/deepseek-v4-pro
# 给 Codex 切到 Kimi
magpie codex kimi/kimi-k3
# 给 Gemini CLI 切到 GLM
magpie gemini glm/glm-5.3magpie 的路由组（routing group）是杀手级功能——把多个账户/模型编成一组，当配额用完（429 限流）或 API 出错时，自动切换到组里下一个账户/模型，Agent 完全不感知错误。这意味着你不用盯着终端等限流恢复，也不用手动改配置切换账户。这对同时用多个免费 Provider（DeepSeek 免费额度+Kimi 免费额度+GLM 免费额度）的用户尤其有价值——把所有免费额度串起来用。
magpie 本地网关支持 4 种 wire API 协议：OpenAI 兼容（最通用）、Anthropic（Claude API 原生）、Google（Gemini API 原生）、Groq（低延迟推理）。5 种路由模式覆盖从简单到复杂的场景：单模型（固定路由）、轮询（均匀分发）、故障转移（主备切换）、权重（按比例分发）、配额感知（429 自动跳过）。这让 magpie 既是个人工具也是团队网关。与 Claude Code Router 路由教程中的单 Agent 路由相比，magpie 的路由是跨 Agent 的。
magpie 不是只有一种界面——菜单栏 app（macOS/Windows/Linux 系统托盘）、窗口 GUI、TUI（终端界面）、Web UI（浏览器管理）、CLI（命令行）五种形态同一套配置。开发者可以在终端用 CLI 快速切换模型，切到桌面用菜单栏选模型，远程服务器用 Web UI 管理。Docker 镜像和 Termux 支持让它在服务器和 Android 上也能跑。
| ✅ 优势 | ❌ 劣势 |
|---|---|
| 45+ Agent 统一管理模型配置 | 无移动端原生 app |
| 配额用完自动故障转移 | Linux 菜单栏体验弱 |
| 4 API 协议 + 5 路由模式 | 路由模式文档不足 |
| 5 种运行形态跨平台 | 密钥存储安全性未说明 |
| curl 一键安装零手动配置 | Agent 格式变化需跟进适配 |
| MIT 开源 yetone 出品 | 项目较新生态早期 |
Claude Code Router 只路由 Claude Code 一个 Agent 的请求到不同模型，magpie 管理 45+ 个 Agent 的模型配置——不仅路由请求，还能在菜单栏给每个 Agent 选不同的模型/Provider/账户。magpie 的本地网关支持 4 种 API 协议（OpenAI 兼容/Anthropic/Google/Groq），而 Claude Code Router 主要走 OpenAI 兼容协议。如果你只用 Claude Code 一个 Agent，Router 更轻量；如果你同时用 Claude Code + Codex + Gemini CLI 等多个 Agent，magpie 是统一管理方案。