magpie：统一管理 AI API、订阅与 Agent 模型

这是个啥

magpie 是一个开源的 AI 模型管理工具：把 API 密钥、支持的订阅账号和模型收进同一个桌面应用，再通过本地网关供 Codex、Gemini CLI、OpenCode 等 Agent 使用。

平时切模型，要分别找配置文件、改地址和密钥；用了 magpie，就可以在供应商页面集中添加接口，在 Agent 页面选择模型。它会修改对应客户端的配置，通常需要开启新会话才能生效。

它适合同时使用多个模型供应商、多个账号或多个 Agent 的人。只用一家官方客户端，而且现有功能已经够用，就不一定需要再加一层网关。

项目采用 MIT 协议，支持 Windows、macOS 和 Linux，也提供命令行、Web 界面及 Docker 等运行方式。

不只管理订阅，也能集中管理 API

magpie 的一个实用场景，是把散落在各处的 API 接口集中起来：

• 官方 API：例如 DeepSeek、千问／百炼、Google、MiniMax 等，按供应商添加密钥。
• 兼容接口和中转：填写服务名称、接口地址和密钥；可用模型、价格和稳定性取决于实际服务商。
• 订阅账号：部分服务支持登录账号，或发现本机已有登录，具体接入方式因服务而异。
• 本地模型：也支持 Ollama、LM Studio 等本地服务，可按需要配置。

API 和订阅是不同的计费方式。把账号接进 magpie，不代表免费、无限额度，也不会消除原有套餐的使用限制。

它解决哪些问题

统一切换模型。 同一处管理供应商和模型，再给不同 Agent 选择要用的组合，减少手动维护多份配置的工作。

转换接口协议。 本地网关支持 OpenAI Chat、OpenAI Responses、Anthropic Messages 和 Gemini 等接口，并提供协议转换。具体模型能否处理图片、推理、工具调用等功能，仍取决于上游模型、接口和客户端；接入后需要验证实际效果。

组合多个账号或模型。 可以建立路由组，按顺序、轮询、用量或订阅额度等策略选择成员，在成员不可用时尝试其他成员。切换效果取决于错误类型、成员可用性和配置。

查看使用情况。 用量页面可展示请求、token 和费用等信息；费用估算与余额查询的准确性，取决于服务商接口、价格配置和接入方式。

还提供意图路由、搜索、资料库和远程共享等扩展功能，可以在基础接入跑通后再逐项启用。

普通 API 接入，需要装插件吗？

通常不需要。使用 API 密钥时，优先在「供应商」里选择预设，或添加兼容接口。

插件主要用于额外的订阅登录方式、供应商接入和网关扩展。只有确实需要对应功能时再安装。插件是第三方代码，可能接触登录凭据或请求内容，应核对来源和权限。

快速上手

1. 从官网或官方发布页下载适合自己系统的版本。
2. 打开「供应商」，添加一个 API 接口或支持的订阅账号。
3. 获取模型列表，检查是否包含自己要用的模型。
4. 在「Agent」页面给对应客户端选择模型，再开启新会话。
5. 用简短任务测试生成、流式输出和工具调用，通过后再配置路由组。

注意：能获取模型列表，不等于余额充足，也不等于生成和工具调用已经可用。 不要只看到模型名称就认为接入完成。

隐私和使用边界

密钥由 magpie 在本机保存。使用时，请求会经过本地网关转发给选择的服务商；选择中转服务，也意味着请求会交给该中转处理。本地运行网关不代表模型请求离线完成。

magpie 可以发现本机部分 Agent 的订阅登录信息，可在「设置 → 隐私」关闭订阅账号发现；API 密钥接入不依赖这一功能。

按项目当前说明，正式版默认发送部分使用统计，例如随机标识、版本、系统和部分功能使用信息；可在隐私设置中关闭部分或全部统计，或使用 DO_NOT_TRACK=1。合作伙伴跳转链接等服务器侧计数另有说明，细节请查看官方隐私文档。

订阅能否用于某个第三方客户端、编程套餐能否用于某类任务，应分别查看对应服务商当前的条款和套餐限制。软件支持某种接入方式，不代表供应商对所有用法都作出许可。

适合谁

如果你经常在 DeepSeek、千问、Gemini 等模型之间切换，或者手上有多个 API 和账号，magpie 值得用来集中管理。先添加一个供应商、跑通一个 Agent，再逐步增加接口，比一开始装满插件和路由规则更容易排查问题。

项目仓库：https://github.com/yetone/magpie

官网下载：https://usemagpie.ai

上手指南：https://usemagpie.ai/docs/zh/start

隐私说明：https://usemagpie.ai/docs/zh/privacy

更新日期：2026-10-16。功能与服务支持范围以项目及供应商最新说明为准。