Magpie：开源本地AI网关，一键切换多AI编程Agent底层大模型

Magpie是什么

Magpie（喜鹊）是基于 Go 语言编写、MIT开源协议的跨平台本地AI网关工具，同时提供菜单栏GUI、TUI终端界面、CLI命令行三种交互形态，支持Windows、macOS、Linux三大操作系统。

Magpie核心定位是本机多AI编程Agent统一模型路由器，在本地搭建API网关，自动完成不同大模型服务商接口协议转换。开发者只需要一次性配置API密钥，本机所有AI编码Agent（Cursor、Claude Code、Codex、Gemini CLI等）无需修改自身配置文件，即可一键切换底层大模型，集中管理多服务商密钥，解决多AI工具密钥分散、模型切换繁琐的痛点。

功能特色

1. 本地统一AI协议网关：本地转发请求，自动完成OpenAI、Anthropic、Gemini、DeepSeek等多厂商API协议转换，原生支持流式输出、工具调用、长思考推理，完整透传会话上下文，不经过第三方远程服务器中转。

2. 菜单栏可视化一键切换模型：桌面状态栏常驻面板，自动扫描本机已安装AI Agent，可视化查看每个Agent当前使用模型，点击即可切换模型，切换后会话快速生效，无需手动修改Agent配置。

3. 多服务商密钥与故障转移：集中保存多家模型服务商API Key，支持在线API以及本地部署模型接入；内置故障自动转移机制，当服务商额度耗尽、接口异常时自动切换备用服务商/模型，避免编码任务中断。

4. Token用量与成本统计：内置用量仪表盘，统计各模型Token消耗、调用花费，直观查看服务商连接状态，方便控制API调用成本。

5. 多交互形态：系统菜单栏GUI、TUI终端界面、CLI命令行三套操作入口，图形化用户和重度终端用户都可使用。

6. 广泛Agent兼容：支持Cursor、Claude Code、Codex、Gemini CLI、OpenCode等数十款主流AI编程Agent。

技术细节

Magpie 使用 Go 语言开发，编译为单二进制可执行文件，部署简单，无额外运行依赖，跨平台打包分发。

• 网络层：本地启动轻量HTTP网关服务，运行在本机，所有API请求仅在本地转发，不会上传密钥到第三方服务器；

• 协议转换层：内部实现多模型API适配器，把各个AI Agent发出的请求翻译成对应大模型服务商可识别API格式，返回结果反向转换回Agent兼容格式；

• Agent探测模块：自动扫描本地AI Agent的安装信息，识别Agent配置，支持手动关闭扫描能力；

• 路由调度模块：支持静态模型绑定、自动故障转移、多服务商轮询策略；

• 存储：API密钥、配置信息本地持久化存储；

• 授权协议：MIT开源协议，允许个人、商业场景自由使用、修改源代码。

应用场景

1. 同时使用多款AI编程Agent的开发者，不想逐个修改每个Agent的API地址、密钥与模型配置。

2. 需要频繁对比不同大模型编码效果，快速切换模型做测试调试。

3. 本地部署开源大模型，希望让Cursor、Claude Code等各类AI编码工具统一调用本地模型。

4. 多API Key管理，需要配置备用服务商，防止单一账号额度用尽导致任务中断。

5. 统计AI编码工具Token消耗，精细化管控大模型调用成本。

使用方法

1. 安装方式

方式一：脚本一键安装

curl magpie.ai/install.sh | sh

方式二：Go命令安装

go install github.com/yetone/magpie@latest

方式三：二进制包安装，前往 magpie-releases 仓库下载对应系统安装包，直接安装运行。

2. 基础配置

1. 启动Magpie，打开菜单栏面板，添加模型服务商（Provider），填入服务商API Key；

2. Magpie自动扫描本机识别已安装AI Agent；

3. 为每个Agent绑定默认模型，在状态栏菜单直接切换模型；

4. 终端用户可使用 magpie tui 打开终端界面，magpie ls 查看本机所有Agent配置；magpie help 查看完整命令列表。

3. 日常使用

启动Magpie后台常驻，打开Cursor、Claude Code等AI Agent，无需修改Agent内部任何配置，直接在Magpie菜单栏切换底层模型，网关自动接管请求转发。

竞品对比

常见问题解答

问：Magpie会把我的API密钥上传到第三方服务器吗？

答：不会。Magpie是本地运行网关，API密钥全部保存在本机，所有请求在本地转发，不会上传密钥到外部服务。

问：Magpie支持Windows系统吗？

答：支持，Magpie是跨平台工具，macOS、Windows、Linux都可以正常运行。

问：Magpie是否需要修改Cursor、Claude Code这类AI Agent的配置文件？

答：不需要，Magpie在网络代理层完成API协议转换，Agent保持原有配置不变，直接由本地网关接管请求。

问：Magpie可以接入本地部署的大模型吗？

答：可以，只要本地大模型提供兼容OpenAI规范API接口，就可以添加为Magpie的服务商，供AI Agent调用。

问：Magpie扫描本机AI Agent，会读取隐私文件吗？

答：Magpie仅扫描AI Agent相关配置信息，不会读取无关个人文件；你可以在设置内关闭自动扫描Agent功能。

问：Magpie是否免费，可以商用吗？

答：项目使用MIT开源协议，个人免费使用，也允许商用，你可以自由阅读、修改项目源码。

相关链接

• 项目GitHub仓库：https://github.com/yetone/magpie

• 官方文档站点：https://usemagpie.ai

总结

Magpie是一款Go语言开发的本地AI网关开源工具，依靠本地API协议转换能力，统一管理电脑上多款AI编程Agent的大模型服务商与密钥，通过系统菜单栏实现模型一键切换，搭配故障转移、Token用量统计能力，省去开发者反复修改各类AI编码工具配置的操作成本，适合重度使用AI编程Agent的开发人员。