最近 opencode 的免费模型火爆得不得了。继 DeepSeek V4.1 Flash、GLM-5.3-Flash 之后,LongCat 2.5 Preview Free、Step 5 Preview Free、MiMo-V2.6-Flash、Cat Jam Free……免费池子越攒越大,官方 Free 列表现在已经有 10 个模型可以随便用。

但有个问题卡在那儿:这些免费模型只认 opencode 一个客户端。
日常不止 opencode 一个 Agent:WorkBuddy(agent 工作台,跑日常工作流)、DeepSeek Harness(日常写码用的 agent,下称 dsh),还有 Claude Code、Codex 轮着上。模型是好模型,但它们锁在 opencode 里——想在别的 Agent 用,配置改起来一个头两个大。

以前很多人会推荐使用 cc-Switch(开源的模型供应商切换器)。但经过深度体验后,发现 magpie(usemagpie.ai)比 cc-Switch 更好用,配置也更简单。

之前怎么用:一条链路,两个环节
环节一:cc-Switch,把供应商接进各个 Agent。cc-Switch 的思路是「以 Agent 为中心」:每个 Agent 都有自己格式的配置文件,cc-Switch 一对一地改——你切哪家供应商,它就改哪个 Agent 的配置文件,改完生效。Claude Code、Codex、Gemini CLI 各管各的,互相独立。

环节二:dsh-workbuddy-connect 这类插件,定向打通。WorkBuddy 里有免费模型,dsh 想用?装个 dsh-workbuddy-connect 插件,专门把 WorkBuddy 的免费模型接到 dsh 里。
这套方案能跑,但用久了两个痛点很明显:每接一个新 Agent 就得重复配一遍,配置格式五花八门;插件是点对点的专车,不成网。Agent 数量一多,维护配置的功夫比干活还多。
magpie:一个本机网关,全 Agent 通吃
先说结论式定位:magpie 是跑在你电脑上的本地 AI 网关,让每个 Agent 能用上每一个模型。

magpie 在本机起了一个网关(127.0.0.1:3425)。这个网关会「说」各家 API 方言——OpenAI Chat、OpenAI Responses、Anthropic Messages、Gemini——而且在它们之间互相翻译,流式输出、工具调用、推理过程一个不落。
你的 Agent 以为自己还在跟原生供应商对话,实际上请求都走本地网关,由 magpie 转发给真正的模型。
一句话记住这个分层:Agent 决定你怎么交互,网关决定它用什么模型——这两件事本来就不该绑死在一个客户端里。

和 cc-Switch 对比
| 工具 | 核心思路 | 实现方式 |
|---|---|---|
| cc-Switch | Agent 为中心 | 分别改每个 Agent 的配置文件,Agent 之间相互独立 |
| magpie | 网关为中心 | 本机统一网关,Agent 全部对接网关;key 集中保管,协议自动转换 |
一个是「每家合资装修自己的房子」,一个是「先修一条主路,谁都能上路」。
magpie 的功能特点
① 一个 provider 处处能用。预设非常全:Anthropic、OpenAI、Google Gemini、DeepSeek、Kimi、智谱 GLM、MiniMax、阶跃星辰、通义千问、百度千帆、腾讯云、火山方舟、Mistral、Groq、OpenRouter、Together、Fireworks、硅基流动、NVIDIA NIM、魔搭、Ollama、LM Studio……以及任何兼容 OpenAI 或 Anthropic 的地址。

② 订阅也变成「供应商」。你在某个 Agent 里登录过(Claude Pro/Max、ChatGPT Plus/Pro、Copilot 等),这个登录就成了一个 provider,它的模型会出现在其他所有 Agent 的选择器里——不复制任何东西,不用粘贴密钥。
③ 一张表切换所有 Agent 的模型。每个 Agent 在用什么模型,列表里一眼看清,点一下就换。还能存请求方案,比如一个「省钱」方案一次切换所有 Agent。

④ 额度用完不断线。路由组里放同一个供应商的多个账号或多个模型,一个额度用完自动切到下一个,Agent 那边看不到报错。
⑤ 平滑导入。它能直接读取你在 CC Switch、Claude Code、Codex、Alma 里配置的 provider——cc-Switch 老用户搬家几乎零成本。
⑥ 形态全,Windows 友好。菜单栏应用、窗口、TUI、Web UI、CLI 都有,支持 macOS、Windows、Linux、Docker,连 Termux 都能跑。

⑦ 不在内置列表的 Agent 也有兜底。官方文档明确写了:其他任何能填 base URL 的工具都能用这个网关。
实测:把 opencode、workbuddy 的免费模型接进 dsh
第一步:安装。官网 usemagpie.ai 直接下载安装包(macOS / Windows / Linux / Docker / Termux 都有),全程几分钟搞定,装好它会在后台起网关服务。

第二步:把 opencode、workbuddy 变成「供应商」。opencode 的登录态直接对着网关用上——opencode 的免费模型即被收进 magpie。workbuddy 不在 magpie 内置的 Agent 列表里,把它作为自定义 provider 添加进去。


第三步:在 Agents 页选 dsh 的模型。magpie 的 Agents 列表里明确支持 DeepSeek Harness。在 dsh 那一行选好想用哪个 provider 的哪个模型——比如把 opencode 的免费模型指给它——配置只写入该改的那一项。

第四步:开用。dsh 里直接切换到刚接进来的免费模型。opencode、WorkBuddy、dsh 三个工具就此接通。


多数 Agent 在 magpie 里切完模型,下一次会话即生效;个别 Agent 需要重启一次会话。中途如果想恢复原状,选回原生模型就行,配置会原样还原。


项目地址
- 官网:https://usemagpie.ai/zh
- GitHub:https://github.com/yetone/magpie
- cc-Switch(老方案):https://github.com/farion1231/cc-switch
如果你在用不止一个 Agent、不止一个模型,或者手头有想「跨客户端复用」的免费/付费模型,magpie 值得装——一个本机网关,Agent 和模型从此解耦,配一次,处处能用。