magpie 是一个面向 AI 编程 Agent 的模型与供应商统一管理工具。它运行在菜单栏、桌面窗口、TUI 和 CLI 中，可集中查看并切换 Claude Code、Codex、Gemini CLI、OpenCode、Goose、Cursor CLI、Copilot CLI 等本机 Agent 使用的模型。项目核心能力是提供本地网关，将 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages、Gemini 等 API 统一到本地地址，并把不同厂商、订阅账号、本地模型或自定义 OpenAI 兼容服务暴露给各种 Agent 使用。
适用领域
AI 编程助手 / LLM 模型路由 / 本地开发工具 / 多模型管理 / API 网关 / macOS 菜单栏应用 / CLI/TUI 工具 / Agent 配置管理
配置难度
中等。普通开发者可以通过预设 provider 和菜单栏界面快速上手；但如果要使用订阅复用、自定义供应商、routing group、跨协议网关、Google Cloud Project 或多个 Agent 的深度集成，需要理解各 Agent 配置文件、API 协议差异和本地凭据管理。
商业价值
对中国开发者和 AI 工程团队有较高实用价值。它能把 DeepSeek、Kimi、GLM、Qwen、硅基流动、302.AI、OpenRouter、本地 Ollama/LM Studio 以及海外订阅模型统一接入 Claude Code、Codex、Gemini CLI 等工具，降低模型切换成本、减少 API Key 分散配置、提升多模型评测效率。对于需要在成本、速度、上下文能力、代码能力和可用性之间频繁权衡的团队，magpie 可作为本地模型路由和 Agent 配置中枢使用。
01
技术亮点
- 统一管理多个 AI Agent 的模型配置，解决多工具、多模型切换混乱的问题。
- 支持菜单栏、桌面窗口、TUI 和 CLI，多种交互方式适合不同开发习惯。
- 二进制体积小，桌面版小于 15 MB，终端版约 7 MB，使用系统 WebView 而非内置大型运行时。
- 对配置文件进行外科式修改，只改动目标字段，尽量保留注释、顺序和缩进，并采用原子写入。
- 内置本地多协议网关，支持 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages、Gemini API，并能进行协议转换。
- 支持流式输出、工具调用和 reasoning 参数的跨 API 转换。
- 支持大量供应商预设，包括 Anthropic、OpenAI、Gemini、DeepSeek、Kimi、GLM、MiniMax、Qwen、Mistral、Groq、xAI、OpenRouter、Together、Fireworks、SiliconFlow、AiHubMix、302.AI、Ollama、LM Studio 等。
- 可自动从供应商或 models.dev 获取真实模型列表，不依赖硬编码模型表。
- 支持 profiles，一键保存和切换所有 Agent 的配置组合。
- 支持把已登录 Agent 的订阅能力作为 provider，减少重复复制 API Key。
- 支持 routing group，在多个模型、供应商或账号之间做智能路由、轮询、顺序降级或按使用量分配。
02
目标用户
- 同时使用 Claude Code、Codex、Gemini CLI、OpenCode、Cursor CLI 等多个 AI 编程工具的开发者
- 希望在 DeepSeek、Kimi、GLM、Qwen、OpenRouter、Ollama、LM Studio 等模型之间快速切换的开发者
- 拥有多个 AI 订阅账号，希望在不同 Agent 中复用模型能力的用户
- 团队内部需要统一模型入口、减少 API Key 分散配置的工程团队
- 经常测试不同大模型效果、延迟、成本与稳定性的 AI 应用开发者
03
配置要求
- 默认本地网关监听 127.0.0.1:3425，可通过 MAGPIE_ADDR 修改。
- 需要根据使用的模型供应商配置 API Key，例如 DeepSeek、OpenAI、Anthropic、Kimi、GLM、Qwen、OpenRouter 等。
- 本地模型服务如 Ollama、LM Studio 通常不需要 API Key，但需要本地服务已启动。
- magpie 会读写不同 Agent 的配置文件，例如 ~/.claude/settings.json、~/.codex/config.toml、~/.gemini/settings.json、~/.config/opencode/opencode.jsonc、~/.config/goose/config.yaml 等。
- 如果希望复用 Claude Code、Codex、Copilot、Devin 等登录态，需要对应 Agent 已安装并登录。
- Claude 订阅复用需要本机安装并登录 Claude Code，因为 magpie 会调用真实 claude 二进制。
- Google Gemini CLI 或 Antigravity 登录可能需要配置 Google Cloud Project，例如 GOOGLE_CLOUD_PROJECT 或 magpie accounts project gemini <email> <project-id>。
- 自定义 provider 需要提供 OpenAI 兼容 url=、Anthropic 兼容 anthropic=，可选 responses=、catalog=、models= 等参数。
- 若使用 routing group，需要配置 group 的 models、routing 和 stays 策略。
04
适用场景
- 在一个界面中查看所有已安装 Agent 当前使用的模型，并快速切换
- 让 Codex 使用 DeepSeek、让 Claude Code 使用 Kimi、让 Gemini CLI 使用 GLM 等跨供应商组合
- 把所有 Agent 的模型请求统一指向本地网关 http://127.0.0.1:3425/v1
- 通过配置 provider，把 OpenAI、Anthropic、Gemini、DeepSeek、Kimi、Qwen、OpenRouter、Ollama 等模型统一暴露给本机 Agent
- 使用 routing group 在多个供应商或多个账号之间做顺序、轮询、按使用量或智能路由
- 将已登录的 Claude Code、Codex、Copilot、Devin 等订阅作为 provider 复用到其他 Agent
- 为不同工作场景保存 profile，例如低成本模型、强推理模型、本地模型、企业代理模型等
- 通过 CLI 批量管理 provider、model、group 和 agent 模型选择
05
部署与配置
- 从项目发布页下载对应系统的 magpie 二进制或桌面应用；README 描述其支持 macOS、Linux 和 Windows。
- 将 magpie 放入 PATH，或在 macOS 中启动菜单栏应用。
- 运行 magpie 打开普通窗口，或运行 magpie tui 使用终端界面。
- 如只需要本地网关，可运行 magpie serve。
- 添加模型供应商，例如：magpie provider add deepseek sk-xxx。
- 查看可用 provider：magpie providers。
- 查看聚合后的模型目录：magpie models。
- 为某个 Agent 设置模型，例如：magpie claude deepseek/deepseek-chat。
- 将需要接入的 Agent API 地址指向 magpie 本地网关，例如 http://127.0.0.1:3425/v1。
06
风险与注意事项
- 项目会读取和修改多个 Agent 的配置文件，虽然宣称外科式修改和原子写入，但仍建议提前备份关键配置。
- 本地网关集中承载多个供应商和登录态，一旦本机环境被恶意软件访问，可能扩大凭据与模型使用风险。
- 复用第三方 Agent 的订阅登录态可能受到对应服务条款、风控或平台限制影响。
- README 明确提示 Google 可能暂停它认为在 Antigravity 外部使用的账号，需要谨慎。
- Claude、Cursor、Grok、Devin 等订阅复用依赖对应 CLI 和登录状态，链路复杂，稳定性可能受上游 CLI、API、账号状态影响。
- 跨 API 翻译虽然方便，但不同模型和协议对工具调用、系统提示、reasoning、非流式请求等行为支持不完全一致，可能出现兼容性差异。
- 项目星标数较高但仍属于快速演进的开发者工具，模型名、上游接口、Agent 配置格式变化都可能导致适配失效。
- 如果团队环境中多人共用配置或共享机器，需要明确 API Key、订阅账号和费用归属。
2026-09-26
第16名
新收录 · github_search
