每个 Agent 的模型,
一处搞定。
FreeMagpie 让每个 AI 编程 Agent 都能用上每一个模型:供应商只需添加一次,然后在 Claude Code、Codex、Gemini CLI 里一键选用;额度用完,自动切到下一个账号。
工作原理
OpenCode · Goose · Crush …
四种协议双向转换
ChatGPT · OpenRouter · Ollama …
Codex 只认 OpenAI Responses,Claude Code 只认 Anthropic Messages。网关两种都会说,并在两个方向上互相转换——流式输出、工具调用和推理过程都不落下。
为什么用它
任意 Agent × 任意模型
一个本地网关同时支持 OpenAI Chat、OpenAI Responses、Anthropic Messages 和 Gemini 四种协议,双向转换,任何 Agent 都能用任何厂商的模型。
订阅共享
在任一 Agent 里登录过 Claude、ChatGPT、Copilot,这个登录就成了所有 Agent 都能用的供应商,令牌按原方式自动刷新。
多账号智能路由
一个模型背后可以挂多个密钥和账号:智能、按顺序、轮流、按权重等九种策略;限流自动退避、额度用完自动切换,Agent 看不到错误。
本地脱敏
打开后,请求离开电脑前把 API key、邮箱等敏感值换成占位符,回复时再换回来;原值只在内存里,从不落盘。默认关闭。
不动你的配置
只改 Agent 配置里需要的那几个键,注释、顺序、缩进原样保留,原子写入;断开连接时精确还原。
小巧原生
约 15 MB,基于系统 WebView,没有 Electron;菜单栏应用、TUI、命令行和 Docker 都有。
快速开始
方式一 · 从源码构建(现在就能用)
git clone https://github.com/cq0206/freemagpie.git
cd freemagpie
make build # 桌面版(macOS / Windows / Linux)
make cli # 纯终端版(交叉编译友好)
需要 Go 1.26+;Linux 桌面版还需要 GTK 3 与 WebKitGTK 4.1。
方式二 · 下载预编译版本
到 GitHub Releases 获取各平台安装包(首次发布准备中,可先用源码构建)。
与上游 magpie 的关系
FreeMagpie 是开源项目 magpie(作者 @yetone,MIT 许可)的下游发行版:main 分支持续跟随上游同步(fast-forward),自有改动集中在 freemagpie 分支并保持尽量少。
完整文档、使用技巧与社区讨论请看上游官网 usemagpie.ai;功能问题与改进建议也欢迎先到上游反馈,让所有人受益。