magpie

Overview

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-generated

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

它是如何修改代理配置的？AI-generated

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

配额耗尽时会发生什么？AI-generated

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

支持哪些操作系统？AI-generated

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

如何安装 magpie？AI-generated

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

它会自动读取我的订阅账户吗？AI-generated

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

我只有一个代理和一个订阅，需要用它吗？AI-generated

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