详细介绍
工具简介
Magpie 是一款开源的本地 AI 模型调度与管理工具,由开发者 yetone 推出,核心定位是「让每一个 Agent 都能用上每一个模型」。它在本地运行一个轻量级网关(默认监听 127.0.0.1:3425),把 Claude Code、Codex、Gemini CLI、OpenCode 等数十种编程助手的请求统一接入,经过协议转换后再转发给任意模型供应商。简单来说,Magpie 打破了「某个 Agent 只能绑定某个模型」的固有壁垒——你可以让 Claude Code 调用 ChatGPT 订阅,让 Codex 使用 DeepSeek,让 OpenCode 使用 Claude 订阅,一切只需在一个界面里点选即可完成。
在 AI 编程助手百花齐放的今天,开发者往往同时使用多个工具:Claude Code 擅长复杂重构,Codex 生态成熟,Gemini CLI 拥有超长上下文,OpenCode 灵活可定制。但每个工具都有自己的配置文件、Base URL、API Key 格式和协议规范,手动维护成本极高。Magpie 正是为解决这一痛点而生,它把订阅账号、厂商 API Key、本地模型统一收进一个入口,让几十个 Agent 共享同一批供应商资源,无需再为每个工具单独配置。
主要功能
统一模型选择与配置接管
Magpie 将所有供应商集中到一个界面管理。添加完成后,你可以为 Claude Code、Codex、Gemini CLI、OpenCode 等数十种 Agent 分别指定一个模型,Magpie 会自动改写该 Agent 自己的配置文件,把原值暂存、原子写入并保留注释格式,全程无需手动编辑 JSON 或 TOML。当你想恢复原样时,只需在模型列表选回 Agent 自带模型,或运行 magpie <agent> default,Magpie 会删除自己写入的内容并还原配置。
本地协议网关与三协议互转
Magpie 在本机运行一个小型网关,实现 OpenAI、Anthropic、Gemini 三种 API 协议之间的互相转换,且流式输出和工具调用(Tool Calling)都不受影响。这是「任意 Agent 用任意模型」的技术基石——无论 Agent 原生使用哪种协议,Magpie 都能把它翻译成目标模型能理解的形式,再把响应翻译回来。
订阅登录接入
对于 Claude、ChatGPT、Copilot、Gemini、Antigravity 等订阅服务,Magpie 支持通过浏览器 OAuth 登录直接接入,无需 API Key,还能添加多个账号。这意味着你已经付费的订阅可以在任意 Agent 中复用,极大提升订阅价值。
厂商密钥与本机模型支持
Magpie 内置 DeepSeek、Kimi、GLM、Qwen 等主流厂商预设,一键填入 API Key 即可使用;同时支持 Ollama、LM Studio 等本地模型运行器,以及任意兼容 URL 的自定义接口,覆盖云端与本地全场景。
路由组与故障转移
你可以把多个模型或多个账号合成一个路由组,Magpie 提供智能、顺序、轮流、按权重、最便宜、速度优先等 9 种路由策略。当一个账号额度用完时,系统会自动切换到下一个,保障工作流不中断。
意图路由规则
Magpie 支持按对话长度、是否带图、推理强度、工作文件夹、时段等条件,把特定对话自动发给指定模型。例如长对话或复杂任务交给旗舰模型,简单问题或上下文压缩交给便宜模型,从而兼顾质量与成本。
快速模式
对于支持的模型,Magpie 可一键开启 priority/Ultrafast 档位,每个 Agent 单独设置,响应更快但价格更高,适合对延迟敏感的场景。
使用方法
- 安装:运行 curl -fsSL https://usemagpie.ai/install.sh | sh 一键安装,支持 macOS、Windows、Linux。
- 启动:打开 Magpie 应用,网关随应用在后台运行;也可用 magpie tray 只开托盘图标,或 magpie serve 只跑网关。
- 添加供应商:在「供应商」标签页点 +,订阅类走浏览器登录,厂商类粘贴 API Key,本机模型选 Ollama/LM Studio。
- 给 Agent 选模型:在「Agent」标签页点某个 Agent 当前模型,从列表选任意供应商模型,Magpie 自动改写配置。
- 开新会话生效:Agent 启动时才读配置,选完模型需新开会话。
- 查看用量:在「用量」标签页按 Agent 和模型查看 token、费用及各订阅剩余额度。
- 卸载:运行安装脚本加 --uninstall 参数,会先断开所有 Agent 并恢复配置,再删除程序。
产品优势
| 对比维度 | Magpie | CC Switch |
|---|---|---|
| 核心定位 | 本地 LLM 网关 + 统一模型控制平面 | 桌面工作台(直连/路由/聚合三模式) |
| 产品重心 | 网关优先、自动化优先 | GUI 优先、资源管理优先 |
| Agent 适配范围 | 数十种,官方适配清单更广 | 以 Claude Code、Codex 为主 |
| 操作入口 | GUI、菜单栏、CLI、TUI、Web UI 五种 | 官方桌面 GUI 为主 |
| 部署形态 | 桌面、Docker、Termux、局域网共享、Remote Magpie | Windows/macOS/Linux 桌面端 |
| 协议转换 | 网关内统一转换 OpenAI、Anthropic、Gemini | Routing 模式支持四类协议转换 |
| 路由策略 | 9 种策略 + 嵌套路由组 + 意图路由 + 会话亲和 | 故障转移队列、熔断、健康监测 |
此外,Magpie 的自动化程度极高:接管 Agent 时自动改写配置、暂存原值、原子写入并保留注释格式,断开一键恢复,全程无需手动编辑配置文件。其路由能力更像一个可编排的系统,9 种路由策略配合嵌套路由组、意图路由和会话账号亲和,让多账号额度的利用效率最大化。
应用场景
- 多 Agent 统一调度:同时使用 Claude Code、Codex、Gemini CLI、OpenCode 等多个编程工具时,在一个界面为每个 Agent 分别选模型,告别散落各处的配置文件。
- 订阅账号价值最大化:把 Claude、ChatGPT 等订阅登录进 Magpie 后,可在任意 Agent 里复用,并用路由组在多账号间按额度轮换。
- 高性价比模型搭配:通过意图路由把长对话、复杂任务分给旗舰模型,把简单问题、上下文压缩交给便宜模型。
- 团队与多设备共享:通过局域网共享或 Remote Magpie,让团队其他成员、家里的电脑、NAS 和服务器都接入同一个网关,共用配置好的供应商和路由策略。


