magpie

概览

GitHubGitHub

magpie 是一个用 Go 编写的本地网关应用，用于集中管理多个 AI 编程代理（Agent）的模型配置。它解决的核心问题是：不同的 AI 代理通常各自维护独立的配置文件、API Key 和 Base URL，导致订阅计划无法跨工具共享。 通过 magpie，用户可以在一个界面中为任意代理选择任意模型。它会原子性地重写代理的配置文件中对应的键值，同时保留原有的注释、顺序和格式。 ### 主要能力 - **统一网关**：在 `127.0.0.1:3425` 运行本地服务，支持 OpenAI Chat、OpenAI Responses、Anthropic Messages 和 Gemini 协议之间的转换，包括流式输出、工具调用和推理过程。 - **配额故障转移**：通过路由组（routing group）功能，当某个账户或模型的配额耗尽时，自动切换到下一个可用账户或模型，代理端不会收到错误信息。 - **多提供商支持**：可以添加 API Key、本地模型，或直接使用已登录的 Claude、ChatGPT、Copilot、Gemini、Grok 等订阅计划。 - **配置集（Profiles）**：将所有代理的模型设置保存为一个命名配置（如 "Budget"、"Focus"），一键切换整套环境。 - **多种交互方式**：提供 macOS 菜单栏应用、Windows/Linux 窗口、TUI、Web UI 和 CLI。 ### 支持的代理 支持超过 60 种代理工具，包括 Claude Code、Codex、Gemini CLI、Cursor CLI、Cline、Devin 等。任何接受 Base URL 的工具也可以通过设置环境变量指向 magpie 网关来使用。 ### 适用人群 适合同时使用多个 AI 代理、多个提供商或多个账户的开发者。如果只使用单一代理并搭配其官方订阅，则不需要此工具。 ### 运行平台 支持 macOS、Windows、Linux、Docker 以及 Termux。macOS 版本经过签名和公证，支持自动更新。

Q&A

magpie 支持哪些 AI 代理？由 AI 生成

支持超过 60 种代理，包括 Claude Code、Codex、Gemini CLI、Cursor CLI、Cline、Devin、Zed、VS Code Chat 等。magpie 只会显示本机已安装的代理。任何接受 Base URL 的工具也可以通过环境变量指向网关使用。

它是如何修改代理配置的？由 AI 生成

magpie 会原子性地重写代理自身配置文件中对应的那个键值，同时保留文件原有的注释、顺序和格式。

配额耗尽时会发生什么？由 AI 生成

通过路由组（routing group）功能，当某个账户或模型的配额用完时，magpie 会自动将请求转移到下一个账户或模型，代理端不会看到错误信息。

支持哪些操作系统？由 AI 生成

支持 macOS、Windows、Linux，也可以在 Docker 和 Termux 上运行。macOS 构建版本经过签名和公证，并支持自动更新。

如何安装 magpie？由 AI 生成

可以从 usemagpie.ai 下载应用，或者在终端运行 curl -fsSL https://usemagpie.ai/install.sh | sh。也支持 go install 或 Docker 镜像安装。防火墙后可使用 --proxy 或 --mirror 参数。

它会自动读取我的订阅账户吗？由 AI 生成

默认情况下，magpie 会通过读取代理的登录文件和系统钥匙串来发现已登录的订阅账户。可以在 Settings → Privacy → Subscription accounts 中关闭此功能，或使用命令 magpie accounts discovery off。设置 MAGPIE_NO_ACCOUNTS=1 可在单次运行时禁用。

我只有一个代理和一个订阅，需要用它吗？由 AI 生成

不需要。原文指出，如果你只使用一个代理并搭配该厂商自己的订阅计划且已经足够，就不需要使用 magpie。它面向的是使用多个代理、多个提供商或多个账户的用户。