大家好，这里是王先生的播客。先来看个数字：magpie 的 GitHub 仓库 9 月 23 日才建，截至 10 月 27 日下午已经有两万三千多个 star，版本号跑到了 v0.1.1711。

这篇就简单说说，它是干啥的、好在哪、怎么用。

如果你手上同时开着 Claude Code、Codex 好几个编码 Agent，又想让它们用上 DeepSeek、Kimi、GLM、Qwen 这些模型，大概率被各家的配置文件折腾过。magpie 就是冲着这个来的。

王先生自己的电脑上就装着，用下来的感觉是这样的：

非常不错，ui很漂亮，特别是路由动画，一个喜鹊很有趣。功能也特别丰富，支持很多agent，模型提供商也支持的特别多。我电脑基本使用的所有agent都使用这个magpie代理了。包括pi,claude code/desktop,codex,deepseek harness。

图 1　王先生的 magpie Windows 桌面版 Agent 页

它是干啥的：本机一个网关，替 Agent 翻译协议#

麻烦出在协议上。按官网的说法，Codex 只讲 OpenAI 的 Responses 协议，Claude Code 只讲 Anthropic 的 Messages 协议，各家模型厂商又各有各的接口。

magpie 在你电脑上跑一个网关，地址是 127.0.0.1:3425，在 OpenAI 和 Anthropic 两种协议之间双向翻译。你在界面里给某个 Agent 点选一个模型，它只改写这个 Agent 配置里被改动的那一个键；选回原生模型，就还原回去。

官方给自己的定位也很直白：同时用不止一个 Agent、不止一家模型的人。

至于翻译之后各模型在各 Agent 里表现如何，这篇没有做对比测试，换了模型效果会不会一样，得你自己跑跑看。

有啥优点#

  1. 一个界面管多个 Agent：上面那张图就是王先生的 Windows 桌面版，Claude Code、Claude Desktop、Codex、Pi、DeepSeek Harness 都接进来了，每个各选了自己的模型。
  2. 预设厂商多：内置预设里有 DeepSeek、Kimi、智谱 GLM、Qwen、MiniMax、火山方舟、百度千帆、腾讯云等，国内常见的几家都有现成预设。
  3. 平台全：macOS、Windows、Linux 都有安装包，也能用 Docker 跑；README 里列的支持 Agent 有 60 多个，各家接入的成熟度不太一样。
  4. 软件免费、MIT 开源：magpie 本身不收钱，模型费用按你自己在各厂商的 key 付。
  5. 用量和费用一眼看到：内置用量页，能看调用次数、token、缓存命中，还会按价格表估算花了多少钱。

怎么用：从安装到给 Agent 换上模型#

先说清楚来源：下面第 1～3 步，团队在一台 Linux 测试机上用终端版跑过（安装脚本是先读过源码、再按同样流程手动下载校验的），截图来自那台测试机；第 4、5 步需要真实 key，按官方文档写，界面用王先生的 Windows 截图对照。

第 1 步：安装

官方一行命令：

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

这个脚本会先查最新版本的下载地址和 SHA-256 校验值，下载、校验后装到 ~/.local/bin/magpie。Linux 上检测到 WebKitGTK 4.1 就装桌面版，否则装终端版。macOS 和 Windows 也可以直接下载 dmg、exe 安装包；国内网络不顺可以加 --proxy 或 --mirror。

装完看一下版本：

Terminal window
magpie --version

第 2 步：启动网关（桌面版应用打开就启动）

Terminal window
magpie serve

正常会看到 magpie gateway on http://127.0.0.1:3425，同时列出 OpenAI 的 /v1/chat/completions、/v1/responses 和 Anthropic 的 /v1/messages 几个端点。

图 2　Linux 终端版实测（团队测试机运行）

第 3 步：看看有哪些厂商预设

Terminal window
magpie presets

图 3　Linux 终端版实测（团队测试机运行），顶部为赞助位

第 4 步：添加厂商 key

命令行一条就够（sk-… 换成你自己的 key）：

Terminal window
magpie provider add deepseek sk-…

桌面版在供应商页面里添加，粘贴 key 就行。本地跑 Ollama 的话，magpie provider add ollama 不需要 key。

图 4　王先生的供应商配置页（以 Command Code 为例，密钥已打码）

第 5 步：给 Agent 指定模型

Terminal window
magpie claude deepseek/deepseek-v4-pro
magpie codex moonshot/kimi-k2.5

想还原就用 magpie <agent> default。改完之后新开的会话才生效。桌面版就是在 Agent 页里点选，效果见开头那张图。

其他支持自定义 base URL 的客户端，也可以直接指向网关，key 随便填（网关只监听本机）：

Terminal window
export ANTHROPIC_BASE_URL=http://127.0.0.1:3425 ANTHROPIC_API_KEY=magpie

看路由和用量

接好之后，托盘面板的「路由」页能看到今天的调用情况。截图那一刻，王先生这边是今日 720 次调用、3.6M token。

图 5　托盘面板「路由」页，数据为截图当时

在「模型 › 路由」页还能看最近一个请求是怎么路由的：为什么走这个模型，上下文窗口里各部分各占多少 token。

图 6a　路由详情

图 6b　路由说明特写

提到的这个喜鹊路由动画，官网首页的路由一节有演示，其中「按意图」模式是这样分流的：每轮对话开始时先问一个小而快的分类模型，这条消息属于哪条规则，再交给对应的模型（我平时没用这个，意图这个判断感觉不靠谱）。

图 7　路由示意（据官网按意图路由演示绘制）

用量页按模型拆分 token 和请求数，还能导出 CSV。王先生截图那天的估算是约 $9.03，这个数是 magpie 按价格表估出来的，实际以厂商账单为准。

图 8　用量页，金额为 magpie 按价格表估算

装之前要注意什么#

  1. 项目很新，更新极快：仓库建了一个多月，版本号一天能跳上百个。默认是每个版本都推，怕折腾的话，用 magpie update channel stable 切到 stable 通道，大约每周一版。
  2. 网关只听本机，请求照样发给厂商：你的 prompt 和代码仍然会发到你选的那家模型厂商，用哪家就要接受哪家的数据政策。key 存在 magpie 里，Agent 拿不到。
  3. 脱敏默认关闭，可以手动开启。 可以将你个人信息在发送时加密，AI回复时如果出现就解密。
  4. 预设列表顶上那几家是赞助位：列表最前面一段标着 partners (sponsors)，这篇不作推荐，按自己需要选厂商。
  5. 背后是个人开发者：主要作者是 GitHub 上的 yetone。

谁该试、谁先不用管#

简单说：同时用好几个编码 Agent、又想在多家模型之间换着用的人，可以去试试；只用一个 Agent、只用它原生模型的，先不用管。王先生的建议是装的时候顺手切到 stable 通道，省得天天被更新打扰。

你现在给 Claude Code、Codex 换模型用的是什么方案？评论区聊聊，王先生也想抄抄作业。

项目地址再贴一次：https://github.com/yetone/magpie

今天就简单说到这儿，王先生下篇见。

参考资料#

  1. magpie 官网：https://usemagpie.ai
  2. magpie GitHub 仓库与 Quick start：https://github.com/yetone/magpie#quick-start
  3. 文中 star 数、版本号来自 GitHub API，查询于 2026-10-27 16:41（北京时间）