如果你跟我一样,同时用着 Claude Code、Codex、Gemini CLI、OpenCode、Cursor、Copilot CLI……那你一定懂这种痛苦:
想换个模型,得翻六七个 JSON 或 TOML 配置文件。
每个 Agent 各管各的,订阅了 Claude Pro 的配额 Codex 一点也用不上,DeepSeek 的 Key 得在每个工具里重复填一遍。换一次模型,像做了一次小型 DevOps。
最近 GitHub 上有个项目五天冲到 1300+ Star,就是来解决这件事的。
它叫 Magpie,作者是 Avante.nvim 的维护者 yetone。
一句话说清楚:它是什么
跑在菜单栏里的 AI 模型调度台。
装好启动,它自动扫描你本机装了哪些编码 Agent,全部列在一个面板上。目前支持 23 个 Agent——从主流的 Claude Code、Codex 到小众的 omp、Crush 都在。
点任何一栏的模型名,弹出选择器,选定后 Magpie 直接去改对应的配置文件,下个会话生效。
就这么简单。但它简单得不简单。
三个让我觉得"这作者想清楚了"的设计
1. 手术式写入:只改一个键
大多数工具改配置文件的做法是:读入 → 重写 → 存回。注释没了,手动排序炸了,你自己调的缩进也没了。
Magpie 不一样。它只动你改的那一个键,注释、顺序、缩进原样保留,写入是原子操作。被替换掉的旧值存进 stash.json,想切回原生模型时精确还原。
这个细节决定了你敢不敢把配置文件交给它。Agent 的配置文件是手工维护了很多轮的资产,被毁一次就不会再交出去。
2. 本地网关:一套 API 翻译三种方言
这是 Magpie 最核心的能力。
问题在于:Codex 只认 OpenAI Responses 格式,Claude Code 只认 Anthropic Messages,Gemini CLI 说 Google 那套。三个 Agent 三种 API,互不兼容。
Magpie 在 127.0.0.1:3425 起了一个本地网关,三种 API 全部双向翻译——流式响应、工具调用、推理参数都在翻译范围内。所有 Agent 指向同一个地址,模型统一写成 provider/model 格式。
真实密钥只存在 Magpie 自己的 providers.json(权限 0600),Agent 配置里不再出现任何 Key。
配好一个供应商(比如 DeepSeek),它的模型就自动出现在每个 Agent 的选择器里。DeepSeek、Kimi、GLM、Qwen、MiniMax、OpenRouter、Ollama 等二十家供应商都预设好了。
3. 登录态即供应商:不用复制 Key
这可能是全项目最有想法的一步。
你已经登录过 Claude Code?登录过 Codex(ChatGPT 账号)?登录过 Copilot?这些登录态直接变成供应商,其他所有 Agent 都能用它们的模型。
Magpie 每次实时读取 Agent 自己的凭据,按 Agent 同样的方式刷新 Token,不在别处存任何副本。
其中 Claude 的处理最能说明作者把平台规则读透了:Anthropic 会把非 Claude Code 代理的请求归类为第三方流量。Magpie 的对策是驱动本机真实的 claude 二进制跑每一轮生成,调用方的工具经 MCP 桥接进去。从 Anthropic 看来,请求始终是 Claude Code 发出的。
还有一个彩蛋:路由组
把多个模型绑成一个 group/<id>,Agent 只当它是一个模型。四种路由策略:
|
|
|
|---|---|
| smart
|
|
| order |
|
| rotate |
|
| usage |
|
多账号分摊配额这个需求,在别的工具里要架一层代理服务。在 Magpie 里,就是模型选择器里的一个条目。
四种使用形态
|
|
|
|---|---|
| 菜单栏图标 |
|
| 桌面窗口 |
|
| magpie tui |
|
| magpie web |
|
桌面版不到 15 MB(Go 写的,用系统 Webview 渲染),纯 CLI 版 7 MB。不捆绑任何运行时。
要注意的坑
-
模型列表依赖厂商 API 实时拉取,厂商接口抖动时列表会短暂空掉 -
Claude Team 订阅登录有 bug(issue #31,还在跟进) -
智谱的用量显示重复(国内套餐/国外套餐/API 三种账号形态没区分) -
Windows/Linux 构建没签名,SmartScreen 首次运行会拦一道 -
没有版本 tag,发行动作放在另一个仓库,靠应用内自更新
谁该装?
同时用两个以上编码 Agent 的人:现在就装。散落在二十多个文件里的模型配置收进一个面板,试错成本接近零。
手里有多个 Key 或多个订阅的人:收益直接翻倍。一个供应商配好,所有 Agent 共享。
只用一个 Agent 一个模型的人:收益有限,可以等等。
最后
Magpie 解决的不是一个宏大的问题,但它解决得足够漂亮。
好的开发者工具不需要重新定义工作流,只需要把你已经在忍受的事情消灭掉。
换模型不该翻六个配置文件,就这么简单。
GitHub 地址:github.com/yetone/magpie
关键词:#Magpie #AI编程 #ClaudeCode #Codex #模型管理 #开源工具 #本地网关 #Agent配置 #yetone #开发者工具

