magpie

magpie 是一个跑在本机的多模型 API 网关 + 编程 Agent 模型切换器（GitHub yetone/magpie，MIT 开源，Go 编写）。它解决一个具体痛点：Codex 只会说 OpenAI Responses 协议，Claude Code 只会说 Anthropic Messages，Gemini CLI 说 Google 格式——magpie 在 127.0.0.1:3425 起一个本地网关，同时接受这三种协议并双向互译（含 streaming、tool calls 与 reasoning），让任意 Agent 调用任意厂商的模型。

核心能力

• 协议互译网关：暴露 /v1/chat/completions、/v1/responses、/v1/messages、/v1/messages/count_tokens、/v1beta/models/{model}:generateContent、/v1/models 等标准路径；任何支持自定义 base-URL 的客户端都能接入（OPENAI_BASE_URL / ANTHROPIC_BASE_URL / GOOGLE_GEMINI_BASE_URL，网关 key 填任意值）
• Agent 配置外科手术式改写：只改动用户改过的那一个键，保留注释、键序与缩进，原子写入；覆盖 ~/.claude/settings.json、~/.codex/config.toml、opencode、goose 等；切回原生模型时精确还原
• 订阅复用：把已登录的 Claude Code（Pro/Max/Team）、Codex（ChatGPT Plus/Pro/Business）、Copilot、Grok、Cursor、Devin 登录态当作 provider，其模型以 claude/…、codex/…、copilot/… 前缀出现在其它 Agent 的模型选择器里，无需复制 Key
• 供应商预设与动态模型列表：内置约 20 个预设（Anthropic、OpenAI、Gemini、DeepSeek、Kimi、GLM、MiniMax、Qwen、Mistral、Groq、xAI、OpenRouter、Together、Fireworks、SiliconFlow、AiHubMix、302.AI、Ollama、LM Studio 等），有 Key 时向厂商实时拉取模型列表，并由 models.dev 目录补充名称与推理级别
• 路由组与智能路由：多账号 / 多 Key 合并为一个 group/<id>，支持按意图（小模型分类器判定后路由）、按顺序、轮换、最少使用优先，以及限流感知（按厂商 Retry-After）、余额耗尽与故障转移
• Profiles 配置快照：把各 Agent 的设定存成命名配置（如「Budget」「Focus」），一键整体切换
• 多入口且轻量：菜单栏桌面 App（Wails + 系统 WebView，非 Electron）、TUI（magpie tui）、CLI；支持 macOS / Windows / Linux；桌面构建 < 15 MB，终端构建约 7 MB
• 次要能力：magpie://import 导入链接（参数放在 URL fragment，浏览器不会发给服务器）、用量统计（token / 缓存命中 / 成本）、自更新、加密备份

适用场景 适合同时使用两个及以上 AI 编程 Agent（Claude Code + Codex + Gemini CLI 等）、希望统一切换模型并复用已有订阅的本机开发者，尤其 macOS 用户。只用单一 Agent、或对合规与凭据安全高度敏感的企业团队，收益有限。

同名消歧（重要）：本条目是 yetone/magpie（usemagpie.ai），不是 Blinue/Magpie（Windows 画面放大工具），也不是 magpie.im、magpie.report、AMD Magpie 或若干 Postgres / 数据侧的同名 Magpie 项目。

风险提示：① 它会读取其它 Agent 的凭据文件并跨 Agent 复用订阅登录态，还会按 reset 窗口「预热」账号，README 自述建议「用一个你输得起的账号」，存在违反厂商条款导致封号的风险；② 官网 /terms、/privacy 均为 404，没有服务条款与隐私政策；③ 项目极早期（仓库 2026-09-23 创建，版本 0.1.x，一天内从 v0.1.218 迭代到 v0.1.223）；④ 单点维护（作者 yetone 独揽 401 次提交，其余 11 人各 1–8 次），无公司实体与支持承诺；⑤ curl | sh 安装并静默自动更新，Windows/Linux 构建未签名。正面来看：确为 MIT 完整 Go 源码、网关仅监听 loopback、密钥本地 0600 存储、README 未提及遥测，社区反响良好（1,242★ / 69 forks）。