点击上方「ai考拉」关注，持续更新 AI 实战笔记

https://usemagpie.ai/zh/

Codex 走hy3， OpenAI，WorkBuddy 接 openrouter，DSH 又一套配置……最后全走回同一座城门

models

很多写代码的人现在桌上不止一个 AI 工具。Codex 里跑着 OpenAI，WorkBuddy 接的是 DeepSeek，DSH 又有自己的模型映射，Claude Code 是 Anthropic，Kimi、Gemini CLI、ZCode、OpenCode 也是各管各的。

JSON、TOML、.env，藏在不同的目录里，你换个模型地址，像在七个部门之间递公文，改到一半想起来还有一份没动。等全部改完，刚才想测的是谁，已经忘了。 

更麻烦的是身份隔离。OpenAI 订阅锁在 Codex 里，Claude 订阅锁在 Claude Code 里，Copilot 又是另一套门户。你明明交了多份钱，它们互不认识。

我以前解决这个问题的办法，是在一个便签本上记：哪个 Key 对哪个工具，哪个订阅还剩多少额度。后来便签本不够用了。  Magpie 是第一个让我把便签本删掉的东西。  它不是编辑器，不是模型，也不是插件。

它是一个本地网关，在本机跑一个 `127.0.0.1:3425` 的端口，常驻在菜单栏里。你点开它，左边是你装了哪些 agent，右边是每个 agent 现在用的模型。点一下，换掉，结束。 

底下干的活分三层，正好对应今天模型市场的现实。

第一层是协议翻译：OpenAI、Anthropic、Gemini 三种接口格式之外，还要接 DeepSeek、Kimi、ZCode、Agnes、SenseNova 这些国产或自定义接口；进来的请求 Magpie 统一转译后再发给上游。

第二层是凭据托管：OpenAI 的 Key、Claude 的登录态、DeepSeek 的 API Key、WorkBuddy 的 token，全收在它口袋里，你的 agent 只需认准本地一个地址。

第三层是路由分发：接近四十个 agent 都能接——Claude Code、Codex、Gemini CLI、OpenCode、Cursor CLI、Zed、VS Code、Copilot CLI、Crush，以及 DSH、Kimi、WorkBuddy、ZCode、Agnes、SenseNova 这些带自定义 endpoint 的工具。

拆掉订阅孤岛

我最早留下来，是因为它解决了订阅孤岛。你在 Claude Code 里登录过一次，Magpie 就把这个登录读出来，列成供应商。Codex、OpenCode、Pi 都能直接调用 Claude 的订阅，不需要你复制 Key，也不需要什么中转站。反过来，你在 WorkBuddy 里登录的 DeepSeek，或在 DSH 里配好的国产模型，也同样被其他 agent 看见。

它每次去读 agent 自带的凭据，token 刷新了自动写回原文件。哪天你把某个 agent 登出，对应的供应商就自动消失。你付过的钱，终于不用再按工具墙分开算了。

CC Switch 也能做账号共享，但思路不一样。CC Switch 是在自己这里重新登录一遍账号，再帮你切；Magpie 是直接读本机现成的登录，连重新登录都省了。

路由

最舍不得的是路由分组。  你手上有一张 DeepSeek 免费额度、一个 OpenAI Plus、一个按量付费官方 Key，以前的分配方式是凭感觉，谁快到期手动切，通常是忘了才切。

Magpie 允许你把几个模型放进同一个组——国产、进口、免费、包月，混着排——然后让 agent 只认这个组名。  组里有五种调度策略。

smart 优先找额度还有富余且最快重置的；order 按你排的顺序用，挂了一个再下一个；rotate 轮流来，公平是公平，效率一般；usage 选调用量最少的；pace 看这周剩余配额，谁剩得多先用谁。  还有一个 stays 参数，决定一次对话锁在同一个账号多久。默认 auto 尽量留在同个账号上吃缓存；session 则整会话不换人。

我平时把 DeepSeek 免费额排在前面，OpenAI 包月放中间，按量的垫后，平时让系统自己选，我每半个月看一次用量表，决定要不要调顺序。

接入改地址

安装和接入其实很轻。去 GitHub Release 下载对应平台的可执行文件，解压后双击运行，菜单栏或托盘就会出现一只鸟。

它不需要安装服务，不需要注册账号，第一次打开只有一个本地端口 `127.0.0.1:3425` 和一张空白的供应商列表。

接下来你要做的，是把各个工具的 Base URL 改指向这个本地地址。

DSH 在模型设置里把 Base URL 改成 `http://127.0.0.1:3425/v1`，渠道选 OpenAI 兼容；Kimi 和 OpenCode 同样改 Base URL，Kimi 走 OpenAI 兼容层，OpenCode 原生支持改 endpoint；WorkBuddy 在插件或自定义模型里填本地网关；ZCode 在模型供应商设置里改 Base；Agnes 与 SenseNova 这类有独立客户端的，只要支持自定义 API 地址，一律指向 `127.0.0.1:3425`，Magpie 会按原协议转发。

改完之后，你不需要在每个工具里重复填 Key。只要 Magpie 这边配好了供应商——DeepSeek 的、OpenAI 的、Kimi 的——agent 过来时它会自动补全凭据。

你甚至可以在 Magpie 里直接切换模型，所有指向它的工具立刻跟着变。  如果你用的是 VS Code 或 Zed 这种编辑器插件，改动范围更小，通常只改一处全局设置；Cursor CLI 和 Copilot CLI 也只需改环境变量或启动参数里的 `--base-url`。  第一次跑可以先开一个对话测试，输出内容如果正常返回，说明链路已经通了。

管一条链

它也有不管的事。供应商的余额、套餐剩余、MCP 服务器、Skills、提示词文件，这些它不接管。它只管“模型从哪来”这条链路。

所以它和 CC Switch 的关系很清楚：Magpie 像水管，决定水流从哪口井来——DeepSeek、OpenAI、Kimi 都一样；CC Switch 像配电箱，决定水送到哪个水龙头。

最省事的用法是在 CC Switch 里建一个自定义供应商，把地址改成本地网关，然后 CC Switch 管配置切换，Magpie 管模型路由。

你的 agent 还是一样多，配置文件还是一样分散，但你已经不再需要为“换模型”这件小事停下手里的活。