magpie

项目简介

magpie 是一个菜单栏应用兼本地网关，用来选择每个 AI 编码 agent 所使用的模型。它列出已安装的 agent 及其当前模型，在你改选其他模型时只重写对应的那一个配置项，并让请求经由 127.0.0.1:3425 转发，使任何 agent 都能使用任何服务商的模型。

核心功能

• 菜单栏面板列出每个已安装的 AI agent 及其模型，点击数值即可更改，magpie 只改写该 agent 配置文件中的对应键。
• 本地网关运行在 127.0.0.1:3425，转换 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 与 Google Gemini 等 API，涵盖流式输出、工具调用与推理。
• 配置编辑是外科手术式的，保留 settings.json、config.toml、opencode.jsonc 或 config.yaml 中的注释、顺序与缩进，写入为原子操作。
• Claude Code、Codex（ChatGPT）与 GitHub Copilot 的已登录订阅可作为服务商，供其他 agent 使用，无需复制密钥。
• 服务商预设与自定义服务商通过粘贴密钥完成配置，模型列表从服务商与 models.dev 获取，密钥保留在 magpie 中。
• 配置档可快照所有 agent 的设置并一键整体切换；路由组可在多个账号或模型之间分摊请求，并处理故障转移、速率限制与配额。

适用场景

• 在一个菜单栏选择器里，让 Codex 使用 DeepSeek、Claude Code 使用 Kimi、Gemini CLI 使用 GLM。
• 让 OpenCode、Pi、Goose 等其他 agent 使用 Claude Pro/Max 或 ChatGPT 方案，而无需向每个 agent 粘贴凭据。
• 把服务商密钥与 base URL 集中到一个本地网关，使 agent 本身不持有服务商凭据。
• 在多个账号或密钥之间分摊请求，以应对速率限制、配额与故障转移。

快速开始

• 下载 Windows 或 macOS 桌面应用，或使用提供的安装脚本从终端安装。
• 用 magpie provider add deepseek sk-… 添加服务商；预设只需密钥，Ollama 等本地服务器则无需密钥。
• 用 magpie codex deepseek/deepseek-v4-pro、magpie claude moonshot/kimi-k3、magpie gemini zhipu/glm-5.3 等命令为 agent 指定模型。
• 用 magpie tui 打开终端版应用，用 magpie ls 查看各 agent 及其模型，用 magpie save work 与 magpie use work 管理配置档。

部署与要求

• macOS 11 或更高版本，Apple Silicon 或 Intel。
• Windows 10 或更高版本，x64 或 ARM。
• Linux 需 GTK 3 与 WebKitGTK 4.1，x86-64 或 ARM64。
• 本地网关运行在 127.0.0.1:3425；桌面应用使用系统 webview，体积小于 15 MB，仅终端版为 7 MB。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。