yetone GitHub avatar

magpie

Go
模型切换工具yetone最近推送 2026年11月18日
AI 开发工具MIT38.1k3,4424,461 issues7 天 +4,176

AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月17日

一个本地网关加菜单栏应用,让 Codex、Claude Code 等编程 Agent 自由切换底层模型。

magpie 把各个编程 Agent 的模型配置集中到一个应用和一个本地网关里。每个 Agent 原本各自维护模型文件、密钥和 base URL,magpie 统一管理这些配置,让你从一份列表里为任意 Agent 选择模型。它支持把 API Key、本地模型或已登录的 Claude、ChatGPT、Copilot、Gemini、Grok 订阅用到各个 Agent 上。

推荐指数

4.0

多 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. 第 1 步

    集中配置

    在 Providers 页添加 API Key、本地模型或登录订阅,统一保存。

  2. 第 2 步

    改写 Agent 配置

    在 Agents 页选模型后,magpie 修改该 Agent 配置中关键的模型字段。

  3. 第 3 步

    本地网关转发

    Agent 请求经本地网关转发到目标模型或订阅。

  4. 第 4 步

    失败切换

    配额耗尽时按账号或路由组自动切换,避免错误传到 Agent。

快速上手

  1. 1

    安装

    用官方脚本安装,或从官网下载应用。

    curl -fsSL https://usemagpie.ai/install.sh | sh
  2. 2

    添加提供商

    打开 magpie,进入 Providers → Add provider,选预设并粘贴密钥或登录订阅。

  3. 3

    为 Agent 选模型

    在 Agents 页为每个 Agent 选择模型,新开会话即生效。

  4. 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 数量较多,遇到问题可能需自行排查或等社区响应。

主题标签

claude-codecodexdeepseekgemini-clillmmacos