AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月17日
一个本地网关加菜单栏应用,让 Codex、Claude Code 等编程 Agent 自由切换底层模型。
magpie 把各个编程 Agent 的模型配置集中到一个应用和一个本地网关里。每个 Agent 原本各自维护模型文件、密钥和 base URL,magpie 统一管理这些配置,让你从一份列表里为任意 Agent 选择模型。它支持把 API Key、本地模型或已登录的 Claude、ChatGPT、Copilot、Gemini、Grok 订阅用到各个 Agent 上。
推荐指数
多 Agent、多模型、多账号用户的实用聚合工具,功能完整但 issue 积压较多。
近 7 天
+4,176
新增 Star
总 Star 排名
#162
雷达追踪的 3,931 个 AI 仓库中
创建于
2026
2026年9月24日
核心亮点
1统一模型选择
在一个列表里为每个 Agent 指定模型,自动改写对应配置文件。
2本地网关
一个本地网关同时服务多个 Agent,统一转发请求。
3额度自动切换
配额用尽时自动切到下一个账号或路由组,Agent 不感知错误。
4隐私掩码
开启后密钥、密码、邮箱在本地脱敏后再发出,回复时还原。
5多端可用
提供菜单栏应用、窗口、TUI、Web UI 和 CLI,支持 Docker 与 Termux。
适用场景
多 Agent 混用
例如:Claude Code 用 Kimi,Codex 用 DeepSeek,Gemini CLI 用 GLM,各自从同一界面切换。
订阅跨工具复用
例如:把已登录的 ChatGPT 套餐配置给 OpenCode 使用。
额度耗尽兜底
例如:某个订阅额度用完时,路由组自动切到另一个账号或模型继续跑。
终端批量配置
例如:用 magpie claude deepseek/deepseek-v4-pro 一条命令切换 Claude Code 的模型。
它是怎么工作的
第 1 步
集中配置
在 Providers 页添加 API Key、本地模型或登录订阅,统一保存。
第 2 步
改写 Agent 配置
在 Agents 页选模型后,magpie 修改该 Agent 配置中关键的模型字段。
第 3 步
本地网关转发
Agent 请求经本地网关转发到目标模型或订阅。
第 4 步
失败切换
配额耗尽时按账号或路由组自动切换,避免错误传到 Agent。
快速上手
- 1
安装
用官方脚本安装,或从官网下载应用。
curl -fsSL https://usemagpie.ai/install.sh | sh - 2
添加提供商
打开 magpie,进入 Providers → Add provider,选预设并粘贴密钥或登录订阅。
- 3
为 Agent 选模型
在 Agents 页为每个 Agent 选择模型,新开会话即生效。
- 4
命令行切换
也可直接用 CLI 指定模型。
magpie claude deepseek/deepseek-v4-pro
适合谁
- 同时使用多个编程 Agent 的开发者
- 在多个模型提供商或账号间切换的用户
- 希望订阅跨工具复用的用户
- 偏好终端或菜单栏操作的用户
不太适合
- 只用一个 Agent 和官方套餐的用户
- 不需要多模型切换的轻度用户
成熟度
- 活跃度近期仍有推送,star 数很高,但开放 issue 达 4415 个。
- 文档README 详细,另有文档站和参考文档链接。
- 社区star 与 fork 数高,有 Discord 社区和插件仓库。
- 上手难度提供安装脚本和图形界面,命令行也覆盖主要操作。
使用前注意
- · 采用 MIT 许可,可自由使用和修改。
- · README 称支持 macOS、Windows、Linux、Docker 和 Termux,但仓库 topics 标注为 macOS。
- · 隐私掩码默认关闭,需在设置中手动开启。
- · 开放 issue 数量较多,遇到问题可能需自行排查或等社区响应。
