Magpie

Magpie

免费增值WebWindowsMacLinux
访问官网

Magpie是开源本地AI模型调度网关,统一接入Claude Code、Codex等数十种编程助手,实现任意Agent用任意模型。

Magpie访问官网

详细介绍

工具简介

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 单独设置,响应更快但价格更高,适合对延迟敏感的场景。


使用方法

  1. 安装:运行 curl -fsSL https://usemagpie.ai/install.sh | sh 一键安装,支持 macOS、Windows、Linux。
  2. 启动:打开 Magpie 应用,网关随应用在后台运行;也可用 magpie tray 只开托盘图标,或 magpie serve 只跑网关。
  3. 添加供应商:在「供应商」标签页点 +,订阅类走浏览器登录,厂商类粘贴 API Key,本机模型选 Ollama/LM Studio。
  4. 给 Agent 选模型:在「Agent」标签页点某个 Agent 当前模型,从列表选任意供应商模型,Magpie 自动改写配置。
  5. 开新会话生效:Agent 启动时才读配置,选完模型需新开会话。
  6. 查看用量:在「用量」标签页按 Agent 和模型查看 token、费用及各订阅剩余额度。
  7. 卸载:运行安装脚本加 --uninstall 参数,会先断开所有 Agent 并恢复配置,再删除程序。


产品优势

对比维度MagpieCC Switch
核心定位本地 LLM 网关 + 统一模型控制平面桌面工作台(直连/路由/聚合三模式)
产品重心网关优先、自动化优先GUI 优先、资源管理优先
Agent 适配范围数十种,官方适配清单更广以 Claude Code、Codex 为主
操作入口GUI、菜单栏、CLI、TUI、Web UI 五种官方桌面 GUI 为主
部署形态桌面、Docker、Termux、局域网共享、Remote MagpieWindows/macOS/Linux 桌面端
协议转换网关内统一转换 OpenAI、Anthropic、GeminiRouting 模式支持四类协议转换
路由策略9 种策略 + 嵌套路由组 + 意图路由 + 会话亲和故障转移队列、熔断、健康监测

此外,Magpie 的自动化程度极高:接管 Agent 时自动改写配置、暂存原值、原子写入并保留注释格式,断开一键恢复,全程无需手动编辑配置文件。其路由能力更像一个可编排的系统,9 种路由策略配合嵌套路由组、意图路由和会话账号亲和,让多账号额度的利用效率最大化。


应用场景

  • 多 Agent 统一调度:同时使用 Claude Code、Codex、Gemini CLI、OpenCode 等多个编程工具时,在一个界面为每个 Agent 分别选模型,告别散落各处的配置文件。
  • 订阅账号价值最大化:把 Claude、ChatGPT 等订阅登录进 Magpie 后,可在任意 Agent 里复用,并用路由组在多账号间按额度轮换。
  • 高性价比模型搭配:通过意图路由把长对话、复杂任务分给旗舰模型,把简单问题、上下文压缩交给便宜模型。
  • 团队与多设备共享:通过局域网共享或 Remote Magpie,让团队其他成员、家里的电脑、NAS 和服务器都接入同一个网关,共用配置好的供应商和路由策略。

核心功能

1
统一模型选择
把所有供应商集中到一个界面,为 Claude Code、Codex、Gemini CLI、OpenCode 等数十种 Agent 分别指定模型,Magpie 自动改写各 Agent 配置文件,无需手动编辑 JSON/TOML,一处配置处处可用。
2
本地协议网关
在本机 127.0.0.1:3425 运行轻量网关,实现 OpenAI、Anthropic、Gemini 三种 API 协议互相转换,流式输出和工具调用均不受影响,真正实现任意 Agent 用任意模型。
3
订阅登录接入
Claude、ChatGPT、Copilot、Gemini、Antigravity 等订阅通过浏览器 OAuth 登录即可接入,无需 API Key,还能添加多个账号并在任意 Agent 中复用,提升订阅价值。
4
厂商密钥与本机模型
支持 DeepSeek、Kimi、GLM、Qwen 等厂商预设一键填 Key,也支持 Ollama、LM Studio 等本地模型和任意兼容 URL 的自定义接口,覆盖云端与本地全场景。
5
路由组与故障转移
把多个模型或账号合成一个组,提供智能、顺序、轮流、按权重、最便宜、速度优先等 9 种路由策略,一个额度用完自动换下一个,保障工作流不中断。
6
意图路由规则
按对话长度、是否带图、推理强度、工作文件夹、时段等条件,把特定对话自动发给指定模型,实现长对话用旗舰模型、简单问题用便宜模型的智能调度。
7
快速模式
支持的模型可一键开启 priority/Ultrafast 档,每个 Agent 单独设置,响应更快但价格更高,适合对延迟敏感的高频交互场景。

优缺点分析

优点
+任意 Agent 跑任意模型:本地网关完成 OpenAI、Anthropic、Gemini 三协议互转,流式和工具调用都支持,彻底打破 Agent 与模型的绑定限制
+订阅即插即用:Claude、ChatGPT、Copilot 等订阅通过浏览器 OAuth 一键登录接入,无需 API Key,可在任意 Agent 中复用
+自动化程度高:接管 Agent 时自动改写配置、暂存原值、原子写入并保留注释格式,断开一键恢复,全程无需手动编辑配置文件
+路由能力强大:9 种路由策略、嵌套路由组、意图路由和会话账号亲和,让多账号额度利用效率最大化
缺点
-需要本地运行常驻网关进程,对不熟悉命令行和网络配置的新手有一定学习成本
-部分高级路由与共享功能(如 Remote Magpie、局域网共享)配置相对复杂,需要理解协议和网络知识
-作为较新的开源项目,版本迭代较快,文档和生态仍在完善中

适用人群

同时使用多个 AI 编程助手的开发者拥有多个 AI 订阅账号、希望最大化利用额度的重度用户需要统一管理云端与本地模型的团队和技术负责人希望低成本搭配旗舰与廉价模型、优化 AI 使用成本的企业

常见问题

Q: Magpie 是免费的吗?
Magpie 本身是开源工具,代码托管在 GitHub 上,安装和使用不收取费用。你只需为自己实际调用的模型付费——无论是订阅账号还是厂商 API Key。Magpie 的价值在于帮你统一管理这些资源并提升利用率,例如把已有订阅复用到更多 Agent,或用路由策略把简单请求分给便宜模型来降低成本。
Q: 使用 Magpie 需要 API Key 吗?
不一定。对于 Claude、ChatGPT、Copilot、Gemini、Antigravity 等订阅服务,Magpie 支持通过浏览器 OAuth 登录直接接入,无需 API Key,还能添加多个账号。对于 DeepSeek、Kimi、GLM、Qwen 等厂商模型,则需要粘贴对应的 API Key;本地模型如 Ollama、LM Studio 则无需密钥,直接选择即可。
Q: Magpie 会修改我的 Agent 配置文件吗?能恢复吗?
会。当你在 Magpie 中为某个 Agent 选择模型时,它会自动改写该 Agent 的配置文件,但会先暂存原值,采用原子写入并保留注释格式。当你不再需要时,只需在模型列表选回 Agent 自带的模型,或运行 magpie <agent> default,Magpie 就会删除自己写入的内容并恢复原配置,不会留下残留。
Q: Magpie 支持哪些操作系统和部署方式?
Magpie 支持 macOS、Windows、Linux 三大桌面平台,并提供一键安装脚本。除桌面应用外,还支持 Docker、Termux、局域网共享以及 Remote Magpie 等部署形态,方便在 NAS、服务器或多设备环境中使用。操作入口包括 GUI、菜单栏、CLI、TUI 和 Web UI 五种,满足不同使用习惯。
Q: 选完模型后为什么没有立即生效?
因为 Agent 只在启动时读取配置文件,所以为 Agent 选完模型后需要新开一个会话才能生效。这是正常现象,并非配置失败。如果你在已运行的会话中切换模型,旧会话仍会使用之前的模型设置,新开会话即可加载 Magpie 写入的新配置。