magpie ——模型切换工具终结者上手指南

先问你一个问题：你的电脑上现在装了几个 AI 编程工具？

Claude Code、Codex、Gemini CLI、OpenCode、Cursor……我数了数自己的机器，不知不觉已经装了五六个。然后问题就来了：

  • 想换个模型，每个工具的设置藏在不同的配置文件里，~/.claude/settings.json、~/.codex/config.toml、~/.config/opencode/opencode.jsonc……改一次翻一次文档；
  • 订阅互相浪费：Claude 的会员只能给 Claude Code 用，Codex 背后的 ChatGPT 额度只能 Codex 用，明明都是你在付钱，额度却老死不相往来；
  • 国产模型便宜大碗（DeepSeek、Kimi），但想让 Codex 跑在 DeepSeek 上、Claude Code 跑在 Kimi 上，得自己折腾 base_url 和协议转换。

上周发现的这个开源小工具 magpie，就是来解决这件事的。作者 yetone（Neovim 插件 avante.nvim 的作者），9 月 23 日才发布，一周多已经 2600+ star。它的 slogan 只有一句话：

Every agent’s model. One place.（所有 Agent 的模型，一个地方搞定。）

🐦 它到底是个什么东西？

magpie 常驻在你的菜单栏里，点开就是一个面板：左边列出你机器上装的所有 AI Agent，右边是每个 Agent 当前用的模型。点一下模型名，弹出列表，选一个就换好了。

它同时提供三种形态：菜单栏面板、普通窗口、终端里的 TUI（magpie tui），外加一条纯命令行。喜欢鼠标的点鼠标，喜欢键盘的敲命令。

不过面板只是个门面，magpie 真正的本事，是它在本地跑起来的那个网关。

⚙️ 核心原理：本地网关 + 协议翻译

magpie 在 127.0.0.1:3425 起了一个本地网关，同时讲三种“语言”：

  • OpenAI Chat Completions（/v1/chat/completions）
  • OpenAI Responses（/v1/responses）
  • Anthropic Messages（/v1/messages）
  • 甚至还有 Gemini 的接口

所有 Agent 都指向这一个地址，模型统一写成 provider/model 的格式，比如 deepseek/deepseek-chat。Agent 说什么协议、供应商说什么协议，翻译的工作由 magpie 在中间完成，流式输出、工具调用都照常工作。

这样一来，供应商的 key 只存在 magpie 一处，Agent 手里永远干干净净。每加一个供应商，所有 Agent 的模型选择器里立刻多出它的一排模型。

💰 最杀的功能：一次登录，全 Agent 复用

这是我觉得 magpie 最“值钱”的一点。

你在 Claude Code 里登过录吧？在 Codex 里登过 ChatGPT 吧？magpie 能把这些已登录的 Agent 本身变成一个 provider：

  • Claude Code 的 OAuth 登录 → 变成 claude/...，给其他 Agent 用
  • Codex 的 ChatGPT 登录 → 变成 codex/...，给其他 Agent 用
  • Copilot 的 GitHub 登录 → 变成 copilot/...，给其他 Agent 用

你付的一份订阅，所有 Agent 都能蹭。 比如让 OpenCode 用上你 Claude 会员里的模型，让 Pi 去消费 Codex 的额度——不用复制 key，不用二次付费，退出 Agent 登录这个 provider 就自动消失，干净得很。

（Claude 订阅有个技术细节：Anthropic 会把其他 Agent 的 system prompt 判为第三方流量，magpie 的做法是直接驱动你本机真正的 claude 二进制来生成，再把工具调用桥接回去，挺巧妙的。）

🇨🇳 对国内用户特别友好：国产模型一键接入

magpie 内置了一大堆供应商预设，国产面孔齐全：DeepSeek、Kimi（Moonshot）、GLM、Qwen、百度千帆、MiniMax、阶跃星辰、硅基流动、ModelScope……添加只需要一行命令：

1
magpie provider add deepseek sk-你的key

预设之外的中转站也能加，给个名字和 base URL 就行。Key 从供应商那里实时拉取真实的模型列表（不是写死的），早上发布的新模型，刷新一下就能在选择器里看到。

🚀 五分钟上手

1. 安装

去官网下对应系统的安装包，或者一行命令：

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

macOS / Windows / Linux 都支持，整个二进制不到 15MB，macOS 版已签名公证。

2. 添加供应商

1
2
3
magpie provider add deepseek sk-xxx        # 预设只需粘贴 key
magpie provider add ollama                 # 本地模型连 key 都不要
magpie providers                           # 看看都加了谁

3. 给 Agent 换模型

鼠标党：点菜单栏图标，点一下模型名，搜索/选择，完事。

命令行党：

1
2
3
magpie claude deepseek/deepseek-chat   # Claude Code 换上 DeepSeek
magpie codex moonshot/kimi-k2.5        # Codex 换上 Kimi
magpie ls                              # 看所有 Agent 当前配置

注意：magpie 改配置文件是“手术级”的——只动你要改的那一个键，注释、缩进、顺序原样保留，写入是原子的，不会把你的配置文件写坏。

4. Profiles：一键切换整套配置

1
2
magpie save work        # 把当前所有 Agent 的设置存成名叫 work 的快照
magpie use work         # 一键切回来

比如存三套：work（主力模型全开）、cheap（全切 DeepSeek/Kimi，能省则省）、local（全切 Ollama，断网也能干活）。演示时切 work，月底预算紧了切 cheap。

5. 进阶：Routing groups 智能路由

把几个模型编成一组，网关按策略自动选：

1
2
magpie group add "Opus-anywhere" models=claude/claude-opus-5-5,copilot/claude-opus-5.5 routing=smart
magpie claude group/opus-anywhere

routing=smart 会优先选还有配额、且配额最先续期的那个订阅——一个订阅的额度用完了，自动切到下一个接着用，你完全无感，等于把几个订阅的额度拼成一个大的用。

✅ 为什么我推荐它：五个理由

1. 终结“配置地狱”。 二十多个 Agent（Claude Code、Codex、Gemini CLI、OpenCode、Cursor CLI、Copilot CLI、Cline、Qoder、Kimi Code……）的模型设置，一个面板 / 一条命令全搞定。

2. 让每一分订阅费都花得值。 登录一次，全 Agent 共享，再也不用为“这个额度只能在这个工具里用”肉疼。

3. 国产模型即插即用。对国内开发者和钱包都友好：预设全、加得快。Codex on DeepSeek、Claude Code on Kimi 这种“混搭”，以前要手动改 base_url、折腾协议转换，现在点两下就行。

4. 小而稳。 MIT 开源，单文件十几 MB，不读你 shell 环境变量里的 key，配置文件改动可预期，还自带备份迁移（magpie backup / magpie restore，换机器不丢配置）。

5. 作者靠谱，社区热度高。 yetone 是 avante.nvim 的作者，有长期维护开源项目的记录；发布一周 2600 star，issue 和 PR 都很活跃。

⚠️ 几点小提醒

  • 项目非常新（9 月 23 日发布），功能迭代快，遇到 bug 去 GitHub 提 issue，作者修得很快；
  • Codex 启动时才读一次模型列表，换完模型记得重启 Codex；
  • 想把 Gemini CLI 的个人 Google 登录接进来要小心：Google 可能封在非官方客户端使用的账号，magpie 会先弹窗让你确认，建议用不心疼的号；
  • 网关默认只监听本机回环地址，想共享给局域网其他机器记得去设置里打开鉴权，别裸奔。

写在最后

AI 编程工具正在从“一个”变成“一堆”，模型也在从“几个”变成“几十个”。当数量上来之后，管理复杂度本身就成了最大的成本——magpie 解决的正是这一层。

它不教你写更好的 prompt，也不承诺更强的模型，它只是把“让每个工具都用上最合适的模型”这件事，从半小时的折腾变成一次点击。如果你电脑上装了两个以上的 AI Agent，值得一试。

项目地址：https://github.com/yetone/magpie