ClaudeMap

magpie

菜单栏应用加本地网关,一站给支持清单里的 75 款 agent 换模型:Claude Code 跑 Kimi、Codex 跑 DeepSeek、Gemini CLI 跑 GLM、OpenCode 走你的 ChatGPT 套餐,配额耗尽自动切下一个账号(MIT)

SDK 与工具gatewaymodel routingmenu bar appsubscription failovermulti-agent

magpie 是 yetone 开源的本地模型网关与切换器(MIT,撰稿时 33,076 星,2026-11-10),口号是「Every agent's model. One place」:各 agent 的模型配置分散在各自的文件、格式与密钥里,订阅只在自己家能用——magpie 把这些收进一个应用和一个本地网关。在 Agents 页的一处列表里给任何 agent 挑任何模型,magpie 只改该 agent 自己配置里要紧的那一个键;支持清单列出 75 款 agent,从 Claude Code、Claude Desktop、Codex、Gemini CLI、Goose、Zed、Cursor CLI 到 ZCode、Devin、Cline 等,凡能设 base URL 的工具都能接网关。网关常驻 127.0.0.1:3425,会说 OpenAI Chat、OpenAI Responses、Anthropic Messages 与 Gemini 四种协议并在其间互译,流式、工具调用与推理内容都在内。订阅复用不贴密钥:magpie 读取各 agent 已登录的凭据(Claude Code 与 Codex 的本地文件、macOS 钥匙串)来发现可用套餐——Claude、ChatGPT、Copilot、Gemini 或 Grok 套餐均在此列。配额耗尽时供应商的下一个账号顶上,路由组再换到别的模型或供应商,agent 侧看不到报错;单账号且无路由组则无可切换,报错直达 agent。隐私侧提供本机脱敏(Settings → Privacy 开启,默认关):提示词里的密钥、密码与邮箱在你电脑上先遮后发、回复里再还原。发行形态覆盖 macOS、Windows、Linux(菜单栏应用、窗口、TUI、Web UI 与 CLI),另有 Docker 与 Termux;还有 profiles、magpie quota 配额总览,以及图像、视觉、搜索等可直接调用的工具。官方站点 usemagpie.ai,文档见 https://usemagpie.ai/docs/start。

它做什么

  • 一处列表管所有 agent:给任何 agent 挑任何模型,magpie 只改该 agent 自己配置里要紧的那一个键——Claude Code 跑 Kimi、Codex 跑 DeepSeek、Gemini CLI 跑 GLM、OpenCode 走你的 ChatGPT 套餐
  • 本地网关常驻 127.0.0.1:3425,会说 OpenAI Chat、OpenAI Responses、Anthropic Messages 与 Gemini 四种协议并在其间互译,流式、工具调用与推理都在内;凡能设 base URL 的工具都能接
  • 订阅复用不贴密钥:已登录的套餐(Claude、ChatGPT、Copilot、Gemini 或 Grok)从各 agent 自己的登录凭据里发现——Claude Code 与 Codex 的本地文件、macOS 钥匙串
  • 配额故障转移:供应商的下一个账号顶上,路由组再换到别的模型或供应商,agent 侧看不到报错
  • 本机隐私脱敏(默认关):提示词里的密钥、密码与邮箱在你电脑上先遮后发、回复里再还原
  • 发行形态覆盖 macOS、Windows、Linux 的菜单栏应用、窗口、TUI、Web UI 与 CLI,另有 Docker 与 Termux;还有 profiles、magpie quota 与图像、视觉、搜索直调工具

什么时候用

适合同时使用多个 agent、多家供应商或多个账号的开发者:把分散在各工具里的模型配置、订阅与密钥收进一处,并为配额与稳定性做故障转移;README 原话说得直白——如果你只用一个 agent、守着官方套餐就够了,那不需要它。

如何上手

# 安装(macOS 构建已签名并公证;--gui/--tui 选择形态):
curl -fsSL https://usemagpie.ai/install.sh | sh

# 添加供应商,然后把任意模型接到任意 agent:
magpie provider add deepseek sk-…
magpie claude deepseek/deepseek-v4-pro          # Claude Code 跑 DeepSeek
magpie codex moonshot/kimi-k2.5                 # Codex 跑 Kimi

# 也可用 go install github.com/yetone/magpie@latest 或 Docker 镜像;防火墙后加 --proxy/--mirror
# 卸载会先还原各 agent 的原始配置:
curl -fsSL https://usemagpie.ai/install.sh | sh -s -- --uninstall

注意事项

订阅发现靠读取各 agent 的登录凭据——Claude Code 与 Codex 的本地文件、macOS 钥匙串——且默认开启;可在 Settings → Privacy → Subscription accounts 关闭,或运行 magpie accounts discovery off,单次运行用 MAGPIE_NO_ACCOUNTS=1。隐私脱敏同样默认关:开启之前,提示词是不加遮蔽地离开你机器的。故障转移得有可转移的对象——单账号且无路由组时,报错直达 agent。该赛道与 cc-switch 这类配置管理器、claude-code-router 这类代理有重叠;magpie 的差异点在网关、订阅复用与配额故障转移。发行版从独立的 yetone/magpie-releases 仓库发布,README 披露 Kimi 为支持方。MIT。撰稿时 33,076 星(2026-11-10)。

代码仓库

yetone/magpie

收录日期

地图上的相关资源

  • 开放的 Agent Skills 标准——任何 agent 都能加载的 SKILL.md 文件夹,2026-10-22 起由 Agentic AI Foundation 治理。

    • official
    • spec
    • agent-skills
    • standard
  • Harness Bridge

    SDK / 工具

    一个本地启动器:让 Claude Code 与其他七种编码 harness 直连任意 OpenAI / Anthropic / Responses 兼容端点——不改任何一行配置文件。

    • launcher
    • local-models
    • cli
    • menu-bar
  • Claude for Siri

    SDK / 工具

    用你已登录的 Claude Code 账号回答 macOS Spotlight 与 Siri 的提问——一个实验性的 macOS 27 模型委派提供者。

    • macos
    • siri
    • spotlight
    • model-delegation