Magpie

让编程Agent一键切换任意模型的开源网关

免费开源

AI代码编程

更新于2026年11月12日

产品简介

Magpie（官网 usemagpie.ai）是一款面向 AI 编程 Agent 的开源本地模型路由与网关工具，由开发者 yetone 主导维护，采用 MIT 协议，支持 macOS、Windows、Linux 等平台。Magpie 解决的核心问题是：当电脑里同时装有 Claude Code、Codex、Gemini CLI、OpenCode、Cursor CLI、Goose 等多个编码 Agent 时，各家模型、API 密钥、订阅账号与配置文件彼此孤立，切换模型需要反复手工修改 settings.json、config.toml、config.yaml 等文件。Magpie 在本地启动一个轻量网关（默认 127.0.0.1:3425），统一接入 DeepSeek、Kimi、智谱 GLM、通义 Qwen、OpenAI、Anthropic、Gemini、OpenRouter、Ollama 等供应商，并提供菜单栏应用、桌面窗口、终端 TUI 与 CLI 多种形态。用户只需在 Magpie 里添加一次供应商或登录一次订阅，就能在统一列表里为任意 Agent 一键指定「供应商/模型」，例如让 Claude Code 跑 Kimi、让 Codex 跑 DeepSeek。Magpie 还会在 OpenAI、Anthropic、Gemini 协议间做请求转换，保留流式输出、工具调用与推理内容，并通过路由组、智能配额调度、故障转移、用量统计等能力，把多模型管理成本从「改配置」降到「点一下」。

主要功能

统一模型切换：在单一界面集中管理 Claude Code、Codex、Gemini CLI、OpenCode 等已安装 Agent 的底层模型，点击即可切换，无需逐个手工编辑各 Agent 的配置文件。
本地多协议网关：在本机运行网关，兼容 OpenAI Chat/Responses、Anthropic Messages、Gemini 等接口协议，自动完成请求转换、流式传输、工具调用与推理内容透传。
供应商与订阅共享：只需添加一次 API 密钥或登录 Claude、ChatGPT、Copilot、Gemini 订阅，即可把同一份额度共享给多个 Agent 使用，密钥仅存本地且不暴露给 Agent。
路由组与智能故障转移：将多个模型、密钥或账号编为「路由组」，支持 smart、order、rotate、usage、pace 等策略，配额耗尽或限流时自动切换到可用成员并保持会话连续。
原子化配置改写：精准修改各 Agent 的配置文件，只变更目标字段，完整保留注释、缩进、键顺序，写入过程原子化，避免半完成文件损坏，切回原生模型可还原原值。
用量与配额看板：按 Agent、模型维度统计 token 消耗、缓存命中、费用与配额重置时间，支持命令行查询配额和导出 CSV，帮助控制多账号多模型的使用成本。
多形态操作入口：同时提供菜单栏应用、桌面窗口、终端 TUI、纯 CLI 与 Web UI，支持脚本化调用、配置方案（Profile）保存、插件中间件及局域网共享网关能力。

使用方法

安装 Magpie：访问 usemagpie.ai 下载对应系统安装包，或在终端执行 curl -fsSL https://usemagpie.ai/install.sh | sh。
启动应用：打开菜单栏/桌面版，或在终端运行 magpie tui 进入交互界面。
添加供应商：在「Providers」页选择预设（如 DeepSeek、Kimi、GLM、Ollama），粘贴 API Key，或登录已有 Claude/ChatGPT/Copilot 订阅。
为 Agent 选模型：在「Agents」页找到本机已识别的编码工具，点击模型名，从 provider/model 列表中选择目标模型并保存。
重启 Agent 会话：关闭并重新开启对应 Agent 的会话，使新模型与网关配置生效（正在运行的会话沿用启动时的模型）。
进阶配置（可选）：用 magpie group add 建路由组、magpie save work 存配置方案、magpie quota 查配额、magpie usage 看用量。

产品价格

开源免费：Magpie 采用 MIT 许可证，个人与商用均免费，源码开放在 GitHub（yetone/magpie），无强制付费墙。
无内置付费计划：官网未公布 SaaS 订阅、Pro 版或按量计费套餐，桌面版与 CLI 均可直接免费使用。
成本结构：实际模型调用费用仍由上游供应商/订阅账号产生（如 DeepSeek 充值、Claude 订阅、OpenRouter 余额等），Magpie 本身不代收模型费用。
企业自托管：支持 Docker、局域网网关、远程 Magpie、WebDAV/S3 同步等自部署形态，无额外授权费，但需自担基础设施与账号合规成本。

应用场景

多编码 Agent 协同开发：在 Claude Code、Codex、Gemini CLI 等工具间统一调度不同模型，按任务类型灵活分配代码生成、重构与审查能力。
跨厂商模型对比测试：同一项目切换 DeepSeek、Kimi、GLM、Qwen、GPT 系列模型，观察不同底座在补全质量、推理深度与工具调用上的差异。
多账号配额调度：将多个 Claude/Copilot/DeepSeek 账号放入路由组，智能分摊配额与故障转移，避免单账号限流导致编码会话中断。
本地隐私与离线模型接入：通过 Ollama、LM Studio 接入本地模型，配合网关脱敏与回环地址，满足敏感代码不出本机的研发合规要求。
成本敏感型团队提效：按 Agent 统计 token 与费用，配合「省钱/全力」配置方案，在预算约束下把高价订阅留给关键任务、廉价模型承接日常生成。