FreeMagpie

每个 Agent 的模型,
一处搞定。

FreeMagpie 让每个 AI 编程 Agent 都能用上每一个模型:供应商只需添加一次,然后在 Claude Code、Codex、Gemini CLI 里一键选用;额度用完,自动切到下一个账号。

下载 FreeMagpie 查看源码

免费 · 开源(MIT)· macOS / Windows / Linux · 跟随上游持续同步

工作原理

你的 AgentClaude Code · Codex · Gemini CLI
OpenCode · Goose · Crush …
→
FreeMagpie 网关127.0.0.1:3425
四种协议双向转换
→
任意供应商DeepSeek · Kimi · GLM · Claude
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;功能问题与改进建议也欢迎先到上游反馈,让所有人受益。