magpie

官方中文正文为项目官方提供的中文文档（原文转载），本站未作翻译、未改动文字，仅剔除图片与无关章节。

magpie 适合你吗？

每个 Agent 都把模型写在自己的配置文件里，格式各不相同，key 和 base URL 各管各的。花钱买的订阅只能在一个 Agent 里用。magpie 把这些收进一个应用和一个本地网关：

• 任意 Agent 用任意模型，在一张表里选。magpie 只改 Agent 配置里该改的那一个键。
• 一个 provider 处处能用：API key、本地模型，或者你登录着的 Claude、ChatGPT、Copilot、Gemini、Grok 订阅。
• 额度用完也不断：同一个服务商的下一个账号自动接上，路由组还能换到别的模型或服务商，Agent 看不到报错。只有一个账号又没建路由组时，没有可换的，报错会原样回给 Agent。
• 密钥不出你的电脑：在 设置 → 隐私 打开脱敏后（默认关闭），提示词里的密钥、密码、邮箱，在请求离开电脑前就在本地脱敏，回复里再换回原值。

如果你用不止一个 Agent、不止一个 provider 或不止一个账号，它就适合你。如果你只用一个 Agent、只用它自家的订阅，而且够用，那就不需要 magpie。

支持 macOS、Windows 和 Linux（菜单栏应用、窗口、TUI、Web 界面和 CLI），也能跑在 Docker 和 Termux 上。

快速开始

1 · 安装。从 usemagpie.ai 下载应用，或者运行：

curl -fsSL https://usemagpie.ai/install.sh | sh

_{Mac 版已签名并公证，每个版本都会自动更新。网络受限时可用 --proxy 或 --mirror。也可以 go install github.com/yetone/magpie@latest，或者用 Docker 镜像。}

2 · 添加 provider。打开 magpie，进入 Providers → 添加 provider。选一个预设、粘贴 key，或者登录一个订阅。

3 · 选模型。在 Agents 页给每个 Agent 选一个模型。开一个新会话就用上了。

也可以全程在终端里操作：

magpie provider add deepseek sk-…              # 预设只需要 key
magpie claude deepseek/deepseek-v4-pro          # Claude Code 用 DeepSeek
magpie codex moonshot/kimi-k2.5                 # Codex 用 Kimi
magpie group add "Opus anywhere" models=claude/claude-opus-5-5,copilot/claude-opus-5.5 routing=smart
magpie claude group/opus-anywhere               # 在多个订阅间自动切换
magpie save work && magpie use work             # 方案
magpie quota                                    # 每个套餐还剩多少
magpie tool generate_image "一只喜鹊，水彩" -o hero.png   # 直接调用 magpie 的生图、识图、搜索工具
magpie tui                                      # 全部功能，在终端里

magpie 通过读取智能体的登录信息（Claude Code 和 Codex 的文件、钥匙串）找到它们登录的订阅。不想让它读取，可以在 设置 → 隐私 里关闭「订阅账号」，或运行 magpie accounts discovery off（on 重新开启）。MAGPIE_NO_ACCOUNTS=1 只对这一次运行关闭，不改动保存的设置。API Key 服务商不受影响。

支持的 Agent

magpie 只显示你电脑上装了的 Agent；部分 Agent 的配置说明见参考文档（英文）。其他任何能填 base URL 的工具也都能用这个网关：

export OPENAI_BASE_URL=http://127.0.0.1:3425/v1     OPENAI_API_KEY=magpie
export ANTHROPIC_BASE_URL=http://127.0.0.1:3425     ANTHROPIC_API_KEY=magpie
export GOOGLE_GEMINI_BASE_URL=http://127.0.0.1:3425 GEMINI_API_KEY=magpie

整体结构

127.0.0.1:3425 上的网关同时支持 OpenAI Chat、OpenAI Responses、Anthropic Messages 和 Gemini，并在它们之间互相转换，流式输出、工具调用和推理都支持。

功能

任意模型，任意 Agent

点一下模型，弹出可搜索的列表：你添加的每个 provider 的每个模型，格式是 provider/model。选中后 magpie 原子地改写 Agent 的配置，注释、顺序和格式原样保留。方案（Profile）把所有 Agent 的配置存成一个名字，比如「省钱」「专注」，一键全部切回去。每个 Agent 还可以有自己的常用模型短名单，方案也会一并保存。

隐私脱敏

Agent 会把读到的东西放进提示词：一个 .env、一份配置、一段带 token 的日志。打开脱敏后，请求离开电脑前，magpie 在本地把这些值换成占位符，回复里再换回来。Agent 和你的文件里始终是真值，厂商一个也看不到。

代价：模型看到的是 {{API_KEY_…}} 而不是 key，所以针对值本身的任务（比如这个 token 为什么被拒）没法做，这类值可以加进 从不脱敏。规则偶尔会判错，在脱敏页一眼就能看到。默认关闭，在 设置 → 隐私 里打开。专门留作示例的域名（example.com、.test、.invalid）下的邮箱不会脱敏。

Provider

选一个预设，粘贴 key。模型列表直接来自厂商，名称和推理档位从 models.dev 补全，今天早上刚发布的模型，下次刷新就出现在你的选择器里。

预设包括 Anthropic · OpenAI · Google Gemini · Amazon Bedrock（runtime 与 Mantle）· DeepSeek · Kimi · 智谱 GLM · MiniMax · 阶跃星辰 · 通义千问 · 百度千帆 · 腾讯云 · 华为云 MaaS · 火山方舟 · Mistral · Groq · Nous Portal · xAI · OpenRouter · Together · Fireworks · 硅基流动 · NVIDIA NIM · 魔搭 · Ollama · LM Studio …… 以及任何兼容 OpenAI 或 Anthropic 的地址。

导入能读取你在 CC Switch、Claude Code、Codex 和 Alma 里配置的 provider。「添加到 magpie」链接让 provider 网站一键把配置交给 magpie。每个 key 和每个账号都可以走自己的代理。

订阅

你登录过的 Agent 背后就是一个带模型的订阅，magpie 把它当成 provider 给其他所有 Agent 用。每个订阅可以加多个账号，magpie 会在它们之间自动切换。

• Claude：驱动本机真正的 claude 程序，通过 MCP 桥接你的 Agent 的工具
• Codex / ChatGPT：你的 ChatGPT 订阅里的模型，给所有其他 Agent 用
• GitHub Copilot、Gemini（Code Assist）、Antigravity、Grok（SuperGrok） 等等
• 任何 OpenCode 登录插件或 pi 包，直接从 npm 安装

每日预热会在你选定的时间，或者上一个窗口刚重置时，启动每个 Claude 和 ChatGPT 账号的 5 小时窗口。

路由组

路由组是 Agent 当作一个模型来选的一组模型，比如 group/daily-coding。网关会把请求分摊到每个成员的 key 和账号上：

只要厂商的提示词缓存还值得保留，对话就留在回答它的那个账号上。路由组可以嵌套。意图路由由你选的一个小模型读每一轮新消息，写测试交给强模型，简单问题交给便宜的模型。路由页实时展示每一次决策。

插件

magpie plugin add opencode-gemini-auth   # npm 上的 OpenCode 插件
magpie plugin add pi-antigravity         # pi 包，同样的方式
magpie plugin login google-plugin        # 在 magpie 里走它自己的登录流程

插件运行在 Bun 上，第一次需要时自动下载。插件负责登录、列出模型和发送请求，Agent 像用其他 provider 一样用它的模型。去 magpie-community/plugins 逛逛，或者自己写一个。

插件还可以是网关中间件：一段 JavaScript，能看到每个 Agent 发出和收到的内容。onRequest 可以改写或拒绝请求，onEvent 看到每个流式事件，onResponse 看到完整回复。钩子抛错或超时，请求原样放行。

// alias.middleware.js — magpie plugin add ./alias.middleware.js
export function onRequest(body, ctx) {
  if (body.model === "fast") return { ...body, model: "deepseek/deepseek-chat" };
}

magpie plugin add @magpie-community/middleware-model-map
magpie plugin options model-map '{"mapping": {"fast": "deepseek/deepseek-chat"}}'

用量和花费

共享

还有

• 资料库：指令、MCP 服务器、技能和子代理只写一次，magpie 按每个 Agent 的格式写进它的文件，删除时只删自己写的部分。
• 任何模型都能联网搜索：不能搜索的模型由 magpie 代为搜索，用能搜索的 provider 或搜索 API（Tavily、Brave、Exa、Firecrawl、You.com、DeepSeek、SearXNG），按你拖好的顺序调用，每个都能单独关闭而不删除密钥。一个 API 可以填多个密钥：搜索默认轮流使用（pick=order 则按顺序），最近被拒的密钥最后才用；Tavily 的每个密钥用了多少额度，在设置页和 magpie search 里都能看到。任何 Agent 都能把同一个搜索挂成 MCP 服务器，提供 web_search 工具和按 URL 读取网页的 web_fetch 工具。
• 图片和视频：通过 MCP 给任何 Agent 一个生图工具，用你选的模型；有 Grok 订阅还能生成视频。
• Agent 保持最新：Agents 页显示每个 CLI 的版本，按当初的安装方式更新，没装的也给出安装命令。
• WSL：在 Windows 上，WSL 发行版里的 Agent 一样能配置，会话也一样统计。
• 保持唤醒、浅色和深色，在 Omarchy 上跟随你的主题。

文档

隐私

你的提示词、回复、密钥和账号只发给你用的供应商；打开隐私脱敏后，其中的密钥连供应商也收不到。正式版 magpie 每天告诉我们一次它在用：一个随机 ID、版本和系统，以及用了哪些 agent、供应商和模型，只用 magpie 自己的 ID（你自己添加的供应商只记作 custom），以及添加供应商页里排在最前的合作伙伴每天被展示、打开和添加的次数（只有次数）。不发送名称、URL、账号、密钥、提示词和用量。可以在 设置 → 隐私 里关掉一部分或全部，也可以设 DO_NOT_TRACK=1。合作伙伴的官网和获取 Key 链接经 usemagpie.ai/go/… 跳转并计一次点击，usemagpie.ai 也统计合作伙伴列表的拉取次数；这是服务器本身看到的，不受设置影响，不记录 ID 和 IP。插件、导入链接和库里的图标经 usemagpie.ai/api/icon 获取，图标所在的服务器只看到 Cloudflare 的地址，看不到你的 IP；这台服务器只转发图片，不计数也不记录。隐私页列出了 magpie 自己发出的所有内容，附示例和每个开关；规则见参考文档。

社区

有问题、有想法，或者某个模型就是不出现？请到 Discord 反馈。

本仓库不接受 Pull Request，只有维护者能提交。想要修复或新功能，请在 Discord 里描述清楚，我们来实现。

如果 magpie 帮你少改了一次配置文件，点个 ⭐ 能让更多人发现它。

许可证

MIT

magpie 与 Apache Magpie 及 Apache 软件基金会没有隶属关系。