大多数人用 Magpie，图的就是一件事：把各家厂商送的免费额度集中起来，接到自己的 Claude Code、Codex、Reasonix 上用。不用逐个改配置，不用记一堆密钥，一个网关全搞定。
一、Magpie 是什么
Magpie 是一个跑在本机的模型网关（127.0.0.1:3425），由 yetone 开发，MIT 开源（GitHub 32k+ stars）。
它解决的问题很具体：每个 AI 编程工具都只认自己家的接口。
- Codex 只认 OpenAI Responses
- Claude Code 只认 Anthropic Messages
- Gemini CLI 只认 Google 格式
Magpie 在中间做协议转换，于是任何 Agent 都能用任何厂商的模型：
Claude Code → magpie → DeepSeek
Codex → magpie → Kimi
Gemini CLI → magpie → GLM流式输出、工具调用、推理过程都会原样保留，不会因为转协议而失效。
二、免费 Token 从哪来
Magpie 本身不生产 Token，它做的是整合与调度。免费额度来自这几个地方：
| 来源 | 说明 |
|---|---|
| 厂商新用户额度 | DeepSeek、智谱、Kimi、Qwen 等注册即送，部分按月刷新 |
| WorkBuddy 签到 | 每天签到送积分，积分可换模型调用（见第七节） |
| 订阅共享 | Claude Pro/Max、ChatGPT Plus/Pro、GitHub Copilot 的用量，登录一次就能给其他 Agent 用 |
| 免费模型 | 各家的 flash / free 系列长期免费或极低价 |
| 多账号轮换 | 同一厂商加多个账号，额度用完自动切下一个 |
所以准确的说法是：把你自己已经拥有的免费额度和付费订阅，集中喂给所有 AI 工具，而不是凭空生成 Token。
三、四个核心概念
| 概念 | 含义 |
|---|---|
| 供应商 | 模型从哪来：订阅登录、API Key、自定义地址、本地 Ollama |
| Agent | 用模型的软件：Claude Code、Codex、Gemini CLI、Reasonix 等 30+ 种 |
| 网关 | 127.0.0.1:3425，请求中转站 |
| 路由组 | 可选，把多个模型/账号合成一个，额度用完自动换 |
四、安装（Windows）
- 打开官网
usemagpie.ai，下载 Windows 版（约 80 MB，绿色版，无需安装） - 放到固定目录，比如
D:\Program Files\magpie\magpie.exe - 双击运行，托盘出现图标即成功
它会自动创建数据目录 %LOCALAPPDATA%\magpie，密钥保存在 ~/.config/magpie/providers.json，只有你自己可读。
建议开启开机自启：
magpie autostart on五、添加供应商
打开 magpie 主窗口 →「供应商」→「+ 添加供应商」，四种方式：
1. 订阅（无需 Key）
Claude Pro/Max、ChatGPT Plus/Pro、GitHub Copilot、Gemini——点卡片直接跳转登录，完成后账号立刻出现。支持多账号，同一个订阅可以反复添加。
2. 厂商预设
DeepSeek、Kimi、智谱 GLM、Qwen、MiniMax、Mistral、Groq、xAI 等。粘贴 Key 即可，magpie 会自动向厂商查询可用模型。
3. 本地模型
Ollama / LM Studio，无需 Key。
4. 自定义
任何 OpenAI / Anthropic 兼容地址都能接，比如第三方中转站。
六、给 Agent 配模型
「Agent」页会列出本机装了或配置过的 AI 工具，每个一行：
Claude Code claude-sonnet-4.5
Codex gpt-5.5
Reasonix Studio deepseek/deepseek-v4-pro点模型名即可切换。magpie 会只改必要的配置项，注释、缩进、顺序全部保留。
重要：Agent 在启动时读取配置，改动从下一个会话生效。当前正在跑的会话不会中途换模型。
七、实战：让 Reasonix 用上 WorkBuddy 的模型
WorkBuddy 是腾讯的桌面 AI 工作台，插件方式可以拿到它的 15 个模型（Kimi K3、GLM-5.3、DeepSeek V4 Pro、MiniMax M3 等）。
第一步：装插件
magpie plugin add workbuddy插件运行在 Bun 上，第一次安装会自动下载 Bun。如果网络慢导致超时，可以手动装 Bun 并设置环境变量：
# 从镜像下载 Bun，解压到 ~/.bun/bin/bun.exe
[Environment]::SetEnvironmentVariable("MAGPIE_BUN", "$env:USERPROFILE\.bun\bin\bun.exe", "User")第二步：登录
magpie plugin login workbuddy 1会打开 workbuddy.cn 的登录页，扫码或账号登录后自动完成。
第三步：接到 Reasonix
magpie reasonix workbuddy/deepseek-v4-pro打开 Reasonix 的模型列表，就会多出 workbuddy/ 分组，15 个模型任选。
八、每日签到：白拿积分
WorkBuddy 每天签到送积分，magpie 可以自动做。
手动签到：
magpie accounts checkin输出：
✓ WorkBuddy 咔咔 checked in today +100 · a 1-day streak自动签到：打开 magpie →「设置」→「预热与签到」→ 打开「每日定时预热」，之后每天自动执行。
顺带一提，「预热（warm-up）」和「签到（check-in）」是两回事：预热是发一条极小请求让订阅的 5 小时窗口立刻开始计时；签到是领厂商的每日额度。magpie 把它们放在同一个设置组里。
九、进阶功能
隐私脱敏
Agent 会把 .env、配置、日志放进提示词。magpie 在请求离开电脑前，把 Key、私钥、邮箱、银行卡号替换成占位符，回复时再换回来。厂商看不到真值，你自己和 Agent 看到的还是原文。
故障转移
同一个厂商可以加多个账号。某个限流或余额耗尽，请求自动转给下一个，Agent 无感。
用量统计
按 Agent、模型、账号统计 token 和费用，能看到每个请求实际花了多少钱。
方案（Profile）
把整套配置存成方案，比如「省钱模式」「全力模式」，一键切换所有 Agent。
十、常见问题
Q：magpie 关了还能用吗？
不能。网关必须运行，建议开开机自启。关掉后 Agent 会连接失败，切回原生模型即可。
Q：会消耗我的真实账号额度吗？
会。magpie 只是转发，额度来自你添加的供应商。但它支持多账号轮换，可以最大化利用免费额度。
Q：和浏览器插件式的 AI 有什么区别？
magpie 面向的是命令行 Agent（Claude Code、Codex 这类），不是网页助手。它改的是这些工具的配置文件。
Q：安全吗？
开源（MIT），本地运行，密钥不出本机。唯一需要注意的是第三方插件——它们能以你的账号发请求，装之前看清来源。
十一、总结
Magpie 的价值不在于「多一个工具」，而在于把模型选择权还给你：
- 哪个模型便宜用哪个
- 哪个额度多用哪个
- 想换就换，不用改代码、不用重装
对同时用多个 AI 编程工具的人来说，这是目前最省心的方案。
本文基于 magpie v0.1.3354 编写。官网：usemagpie.ai ｜ 开源地址：github.com/yetone/magpie
暂无评论