Magpie

模型	创建	更新
gemini-4-argon-high	2026-11-09	2026-11-09

Magpie（仓库 yetone/magpie，官网 usemagpie.ai）是 yetone（Neovim 插件 avante.nvim 作者）于 2026 年 9 月以 MIT 许可开源的跨平台多 Agent 模型切换器与本地大模型网关：它通过无损改写配置文件，将本机 60 余种 AI 编码与对话客户端（Claude Code、Codex、Gemini CLI、OpenCode、Hermes Agent、T3 Code、Cursor 等）统一指向本机 127.0.0.1:3425 网关，在 OpenAI Chat、OpenAI Responses、Anthropic Messages 与 Google Gemini 四套协议间双向转换，并把已登录的订阅账号与 API 密钥池化为可跨工具共享、按额度窗口自动故障转移的模型源。

它的核心取舍是把「多客户端配置切换」与「多协议本地网关」合进一个个人桌面端单二进制：只要同时使用两个以上 Agent、两个以上模型渠道或多个订阅账号，它的四向协议互转、订阅反哺（如驱动本机真实 claude 进程对外桥接工具）与按重置窗口调度就能省去手改配置和手动换号；代价是跨工具复用订阅游走在厂商服务条款（ToS）与风控边缘（11 类内置订阅已因防封禁迁出为社区插件），且项目由 AI 智能体以日均百余次提交、每日数个至数十个版本的极高频率自主编写、评审与发版，主仓库不接受外部 PR，追求稳定的环境不宜直接使用默认滚动更新渠道。依据：官方 AGENTS.md 写明 11 类内置订阅「访问它们可能违反厂商条款，因此迁出为社区插件以避免 magpie 本身被封禁」；LESSONS.md 与 docs/contributors.md 写明「magpie 的代码由智能体编写、评审、合并与发布」，且 README 声明「本仓库不接受 Pull Request」。

是什么

开发者与同名辨析：由 yetone 发起，签名安装包与 Homebrew tap 托管于独立仓库 yetone/magpie-releases（GitHub 仓库、发布仓库）。官方 README 声明与 Apache 软件基金会的 Apache Magpie 无关；它也不同于 Windows 全屏窗口缩放工具 Blinue/Magpie，以及本博客作者在个人年度列表中记录的同名在研个人项目。
运行形态与技术栈：基于 Go 1.26、Wails v3（直接调用系统原生 WKWebView / WebKitGTK 4.1 / WebView2，不捆绑浏览器内核；macOS 下载包约 15 MB、编译后单二进制约 30 MB）、Bubble Tea 与纯 Go SQLite（modernc.org/sqlite）构建（go.mod、参考文档）。同一二进制提供五种入口——菜单栏/系统托盘快捷面板（magpie tray）、桌面主窗口（magpie）、终端全功能 TUI（magpie tui）、无桌面浏览器控制台（magpie web，默认监听 127.0.0.1:3430，支持添加到手机主屏作为独立 Web App）与后台守护服务（magpie serve / magpie daemon install，支持 macOS launchd 与 Linux systemd --user），另提供 debian:12-slim（nonroot uid 65532）的 Docker 镜像 ghcr.io/yetone/magpie 与 Android Termux 终端构建。
外科手术式配置接管（Agent Wiring）：支持 60 余种本机已安装的客户端（README 列出 66 项，覆盖 Claude Code、Claude Desktop、Codex、Gemini CLI、Antigravity CLI、OpenCode、Pi、omp、DeepSeek Harness、Goose、Cursor CLI、Zed、VS Code / VSCodium / JetBrains 系列、Devin、Hermes Agent、Kimi Code、Qwen Code、Droid、Cline、Qoder、Grok Build、WorkBuddy、CodeBuddy、T3 Code、Cherry Studio、AstrBot、OpenClaw 等）；任何支持自定义 Base URL 的其他工具也可直接通过 OPENAI_BASE_URL、ANTHROPIC_BASE_URL 或 GOOGLE_GEMINI_BASE_URL 接入。专用配置编辑器按文件格式（JSON/JSONC、TOML、YAML、dotenv、SQLite）只原子修改指向网关所需的键，保留原有注释、缩进与字段顺序；被替换的原始值存入 ~/.config/magpie/stash.json，切回默认或执行卸载脚本时原样恢复，外部程序改动配置时还会提示漂移（Drift）。对不想改动 ~/.claude/settings.json 的场景，提供 claude-magpie 包装命令（仅在单次会话中叠加载入网关配置）；「方案（Profiles）」可将所有 Agent 的当前模型组合存为命名快照一键切换。
四向协议转换与网关防呆：网关默认监听 127.0.0.1:3425，同时暴露 /v1/chat/completions（OpenAI Chat）、/v1/responses（OpenAI Responses，含 SSE 与 Codex WebSocket）、/v1/messages（Anthropic Messages 与 count_tokens）、/v1beta/models/{model}:generateContent（Google Gemini）以及供 VS Code Copilot 等客户端读取的 Ollama 兼容目录路由（/api/tags、/api/show）。入站请求被解析为协议无关的中间表示（IR），双向映射流式分块、工具调用、多模态图片、各家异构的缓存命中字段（统一补全 OpenAI 与 Anthropic 的缓存计数）与推理档位/思考签名（自动剥离或转换跨厂商的 <think>、reasoning_content 与签名块，防止中途换模型报错）。网关在收到上游正常响应头与首包前会暂存连接，超过 3 秒无响应时每 5 秒向客户端发送协议原生保活事件（防 Clash 等本地代理 10 秒断流），并在首字发出前对失败请求无感切换下一个候选账号；内置 loopGuard（流式输出或思考最近 256 个语句单元若只落在不超过 24 种重复句子内即自动切断）与 stoppedToolLoop（连续 8 轮发起完全相同的工具调用且返回相同结果时直接在本地拦截回复，防止白烧额度）（gateway-routing.md）。
检索、语音、图像与决策模型路由：除对话外，网关还提供 /v1/embeddings、/v1/rerank（兼容 Cohere、Jina、Voyage AI）、语音转文字（/v1/audio/transcriptions）、文字转语音（/v1/audio/speech）、图像与视频生成，并在 /v1/decisions（OpenAI Decisions API，如 gpt-6-luna）与 /v1/systemone（TypeSafe System One 接口，如 Jev、Clef、百炼 decision-model-preview）之间做双向协议互转——把 predicate 映射为 noul、把 choice 与 score 映射为对应 criteria，甚至支持组建专门的决策模型故障转移组（如 group/jevs）（参考文档 Decisions 节）。
订阅反哺与社区插件体系：自动发现或登录 Claude（Pro/Max/Team）、ChatGPT（Plus/Pro/Business）、GitHub Copilot、Gemini Code Assist、Antigravity 等订阅（支持从 auth.json、codexbar、CLIProxyAPI、Sub2API、claude-swap 导入），将订阅内的模型以 claude/…、codex/…、copilot/… 形式开放给所有其他 Agent。由于 Anthropic 会根据系统提示词识别并拦截非 Claude Code 流量，Magpie 的 Claude 订阅桥接器不伪造 HTTP 请求，而是通过 claude-tui-helper 在独立伪终端（PTY）中启动本机真实的交互模式 claude 进程（子系统文档写明 Anthropic 对 claude -p 的 sdk-cli 入口按交互模式 cli 约两倍的额度消耗计费，引用 anthropics/claude-code#97074），再通过每次运行随机生成的临时 MCP 回调（POST /_magpie/claude-mcp/<token>）把调用方 Agent 的工具桥接进该轮对话（claude-subscription-bridge.md）。另有 11 类易触碰厂商条款的内置订阅（Command Code、Cursor、Devin、Factory、Grok、Kiro、小米 MiMo、Qoder/Qoder CN、WorkBuddy/WorkBuddy AI、ZCode、Zed）已于 2026-10-17 全部退役，改为在首次需要时自动下载 Bun 运行时，加载 magpie-community/plugins 中的社区插件（兼容 npm 上的 OpenCode 登录插件与 pi 包）；插件同时支持编写 onRequest / onProvider / onAccount / onEvent / onResponse 网关中间件（官方提供对标 New API 渠道能力的 param-override、model-map、system-prompt、word-guard、think-tags 五个现成包）。
额度感知路由组、规则与意图路由：当多个供应商提供同名模型时自动合成 auto/<model> 路由组，也可手动创建可嵌套（最多 8 层）的 group/<id>。内置九种选路策略：
- smart（默认）：在已用额度未达 90% 的订阅账号中，按最大受限窗口（周窗口优先，次看 5 小时窗口）距离重置的小时数排序，最先重置或积分最先过期的账号优先消耗；
- order（按顺序）、drain（用完再换，前序账号恢复也不回切）、rotate（每轮轮流）、usage（已用比例最少或近期一小时半衰期 token 最少优先）；
- pace（到期前用完）：计算「剩余周额度（或比重置更早过期的签到积分）÷ 距离重置/过期小时数」，每小时待消耗额度最高的账号优先；
- weight（按 1–1000 权重平滑穿插）、fast（速度优先，按 20 分钟半衰期统计流式响应首字时间 TTFT 与生成速率 TPS，估算 200 token 耗时最短者优先；每 5 次请求抽 1 次探测满一小时未测的渠道）、cheap（最便宜优先，计入自定义价格与分时倍率——如 DeepSeek 官方 API、Command Code、OpenCode Go 在工作日 UTC 01:00–04:00 及 06:00–10:00 高峰期双倍计价，Ollama Cloud 的 DeepSeek V4.1 Flash / V4 Pro 在工作日 UTC 12:00–18:00 以外半价）。
  配合 auto（默认，一轮工具往返内锁定，跨轮在读写缓存 ≥1,024 token 且距上次回复 5 分钟内继续锁定原账号）、session、turn、off、strict 五档会话保持以保住前缀缓存。路由规则支持按 token 数、带图片、推理强度、客户端名称、上下文压缩请求（/compact 交给廉价模型总结）、星期与时段（支持绑定 IANA 时区及 pause= 暂停规则）、工作目录（从请求中提取工作路径匹配 folders= / except-folders=）和「意图（Intent）」分流：开启意图路由后，每轮用户新发言时由指定的判断模型（配置了 TypeSafe 时默认为 Jev，默认置信度阈值 intentSure = 0.4；也可用任意小模型或本地模型）读取剥离了 <system-reminder> 的最新用户消息（上限 4,000 字符，超长取前 3,000 + 后 1,000）与上轮摘要，在默认 8 秒超时内返回意图编号并同时设定模型与推理强度（use-effort=），同一轮后续数十次工具调用直接沿用该决定（意图路由文档）。
本地隐私脱敏（Privacy Masking）：默认关闭。开启后在请求离开本机前，通过确定性规则（私钥块、主流 API Key、JWT、URL 密码、.env 敏感字段、邮箱、排除订单号语境的手机号、校验位通过的身份证号与银行卡号/IBAN、自定义词与日期变体）及可选本地模型——默认下载 39 MB 的 AstrLink Guard（支持中英文，macOS 调用神经网络引擎，默认阈值 0.8，且内嵌结巴词频表过滤「黄绿色」「关键词」等中文普通词误判）或 1.6 GB 的 OpenAI Privacy Filter（默认阈值 0.5）——将敏感值替换为带密钥哈希的固定占位符（如 {{API_KEY_k3v9x2mq}}）或保持前缀与长度的同形态假密钥（Keep a key's form），并在流式回复与工具调用参数中实时换回真值。UUID、消息/工具 ID 与工具 JSON Schema 结构保持不脱敏以免破坏协议；原值仅驻留内存，磁盘只记类型、长度与首字符；脱敏模块异常时直接返回 503 拒绝裸发；还支持配置「命中脱敏时改用（Instead of masking, send to）」，将命中敏感词的请求不脱敏地转交本机 Ollama 等受信任模型处理（本地脱敏文档）。
资源库、MCP/Skill 路由、替身与跨机协同：「资源库（Library）」集中管理指令（以  注释块写入各 Agent 的 CLAUDE.md/AGENTS.md/GEMINI.md）、MCP 服务器、Skills、子代理、Hooks 与 RTK；开启「MCP 路由」后，所有 Agent 只挂载一个 /mcp/magpie/hub/<agent> 端点，命令型 MCP 服务由 Magpie 全局只起一份进程（空闲 10 分钟停机），且当挂载工具超过 10 个时自动替换为 find_tools 与 call_tool 两个按需搜索工具，避免工具 Schema 塞满上下文；「Skill 路由」同理将多个技能折叠为单个 magpie-skills 入口（mcp-router.md、skill-router.md）。此外支持为纯文本或无搜索能力的模型挂载识图替身（描述结果缓存至 vision-cache.jsonl）与联网搜索替身/MCP（支持 Tavily、Brave、Exa、Firecrawl、You.com、DeepSeek、火山豆包、腾讯元宝、SearXNG 多 Key 轮换）；提供 Claude/ChatGPT 5 小时额度窗口重置预热与每日定时预热、订阅重置卡自动使用与插件每日签到；支持 AES-256-GCM 加密备份与 WebDAV / S3 / GitHub 私有仓库每 3 分钟跨机同步；支持局域网共享与「远程 magpie」（含设置额度上限的短期密钥 /v1/magpie/keys 与供 GitHub Actions 免 Secret 换取短期密钥的 OIDC 接口 /v1/magpie/keys/oidc），以及用量账本、上下文窗口构成评分与 OTLP（含 Langfuse v4 预设及读取本地会话 JSONL/SQLite 的对话级追踪）导出。

当前状态

高速增长与活跃度（截至 2026-11-09，通过 GitHub 仓库页内嵌 JSON、shields.io 与 yetone/magpie-releases 核验）：主仓库 yetone/magpie 创建于 2026-09-23，在开源不到七周内累计 32,664 star（徽章显示 33k）、2,880 fork（页面显示 2.9k）、36 watcher、7,011 次提交、3,374 个 tag 与 2,083 个 release；当前未关闭 issue 为 3,446 个（最新编号已达 #5766），未关闭 PR 为 16 个。签名发布仓库 yetone/magpie-releases 最新正式版本为 v0.1.3373（2026-11-08/11-09 发布）。
AI 智能体自主开发与日均数十版发版节奏：LESSONS.md、docs/code-standards.md 与 docs/contributors.md 公开记录该项目由编码智能体自主编写、互相评审、合并与发版，每晚复盘当日提交并把重复出现满三天的缺陷模式写入编码规范（如 2026-10-05 单日 220 次提交、约 170 个版本，其中约 40 个为修复当日或前一日回归；10-11 至 10-14 四天内 602 次提交、56 个 tag）。默认更新渠道为接收每一个发布的 every（一天数版至数十版），另设每周一 00:00 UTC 选取已发布满三天版本的 stable 渠道（标记了 Urgent release 的紧急修复会立即进入 stable）。
维护模式与外部贡献政策：README 明确声明「本仓库不接受 Pull Request，只有维护者能提交」，用户通过 Discord 或 GitHub Issues 提交反馈；维护者驱动智能体先对社区分支或补丁执行「有害性审查（Look for harm first）」（拦截任何改动 .github/、新增未知网络上报、读取无关凭证或注入中转站推广链接的改动），再在临时 HOME 沙箱与真机上执行「手改破坏验证（Broken by hand）」及 Chromium/WebKit 双引擎五语言 GUI 测试，合并后通过 Co-authored-by 与官网「贡献墙」署名致谢（docs/contributors.md、docs/code-standards.md）。
平台打包与签名状态：macOS（Apple Silicon 与 Intel）桌面版及 CLI 已由 Apple 签名并公证；Windows（WebView2，支持管理 WSL 发行版内 Agent）与 Linux（GTK 3 + WebKitGTK 4.1，安装脚本自动调用包管理器补齐依赖，无桌面环境自动降级安装终端版）构建目前尚未代码签名。Docker 镜像自 2026-10-18（提交 ae7dc10）起由 distroless 改为 debian:12-slim（arm64 镜像体积由 82 MB 增至 157 MB），以支持在容器内运行需要 curl、bash 与 glibc 的订阅 CLI 安装脚本及 Bun 插件。

优势

配置接管与四向协议翻译形成闭环：单纯的配置切换器受限于客户端原生支持的协议，而单纯的本地网关需要用户手动逐个修改各工具的配置文件与环境变量。Magpie 把两端合在一起——点击或一条命令即可无损改写 60 余种客户端配置，同时在 127.0.0.1:3425 完成四套协议、流式工具调用与思考签名的互转，卸载或断开时还能从 stash.json 完整还原（参考文档、iTech 评测）。
订阅反哺与缓存粘性设计贴合重度多订阅场景：支持将 Claude、ChatGPT、Copilot 等已登录订阅直接供给其他 Agent 使用；Claude 订阅通过本机真实交互模式 claude 进程与 MCP 工具桥接（既规避第三方系统提示词风控，又避开 claude -p 约两倍的额度扣减），路由组默认在前缀缓存有效期内（读写 ≥1,024 token 且在 5 分钟内）将后续轮次锁定在同一账号上，并支持 5 小时窗口定时/重置预热（如早间提前触发首个 5 小时窗口，实现单日错峰用满三个窗口）与重置卡自动使用（claude-subscription-bridge.md、沉默王二实测）。
路由维度覆盖额度寿命、实测速度、分时价格与每轮意图：除常规主备与轮询外，smart 与 pace 直接针对包月/包周套餐的「重置作废」与「签到积分提前过期」建模；fast 按近期实测首字延迟与生成速率动态选路；cheap 原生计算 DeepSeek 与 Ollama Cloud 的峰谷分时电价；意图路由则允许接入 Jev 等毫秒级决策模型或本地轻量模型，在每轮首条请求时按任务类型同时选定目标模型与推理强度（use-effort），官方在 20 条真实中英文编程消息上实测 DeepSeek V4 Flash、GLM-5.3 Flash、MiMo v2.6 Flash 作为分类器均达到 20/20 准确（中位耗时分别为 0.75 秒、1.3 秒、1.9 秒）（意图路由文档）。
上下文减负与本地隐私脱敏具备工程深度：「MCP 路由」与「Skill 路由」把多 Agent 重复启动的 MCP 进程收敛为单实例，并在工具超过 10 个时自动转为按需搜索，避免工具定义挤占上下文窗口；「本地脱敏」采用固定哈希占位符与同形态假密钥保持上下文一致，流式文本与工具参数双向还原，原值不落盘且故障时强制返回 503，还支持把命中敏感信息的请求直接改发给本机模型。
全界面对齐与可观测性完整：桌面端、托盘面板、TUI、Web 与 CLI 完全互通，路由与用量页实时展示每次选路原因、首字时间、重试链路、上下文窗口各部分占比（系统提示词、MCP 工具、Skills、文件、对话）与脱敏前后对照，并支持免插桩读取本机 Claude Code、Codex、OpenCode、Gemini CLI、Pi 会话记录导出至 Langfuse。

局限与注意事项

跨工具复用订阅与自动签到的服务条款（ToS）与封号风险：将某个客户端的订阅凭证桥接给其他客户端使用、定时预热或自动签到，天然处于各厂商服务条款与风控边缘。官方快速上手文档明确警告「Google 可能封禁在 Antigravity 之外使用的 Antigravity 账号，请用丢了也不心疼的账号」；AGENTS.md 亦写明 Command Code、Cursor、Devin、Factory、Grok、Kiro、MiMo、Qoder、WorkBuddy、ZCode、Zed 共 11 类订阅「访问它们可能违反厂商条款，因此迁出到社区 OpenCode 插件以避免 magpie 本身被封禁」。在合规严格的企业环境或不可承受封号风险的主力工作账号上，不应启用跨工具订阅桥接与自动签到。
AI 高频自主发版伴随的回归风险与 issue 积压：项目在不到两个月内产生 7,011 次提交、3,374 个 tag，同时积压了 3,446 个未关闭 issue；LESSONS.md 坦承早期曾出现单日 170 个版本中约 40 个用于修补同日或前日引入的回归（如默认环境变量覆盖用户自定义设置达约 150 个版本、未读文件解析错误被写回为空账号列表、Windows 显示器切换回调泄漏、WSL 迁移锁文件误报等）。尽管目前已建立手改破坏测试与多语言 UI 测试门禁，但默认的 every 渠道每天自动更新多次，生产或日常重度依赖时应切换至每周一更新的 stable 渠道。
单人维护（BDFL）加智能体闭环的治理约束：主仓库不接受外部 PR，所有合并与发版均由维护者 yetone 及其智能体流水线控制；外部开发者无法直接通过 PR 合入代码，只能提 Issue 或在 Discord 描述需求等待官方智能体实现（iTech 评测）。
本地脱敏的功能代价与误判边界：脱敏默认关闭；开启后云端模型只能看到 {{API_KEY_…}} 占位符，因此无法完成「分析该密钥或令牌本身为何报错」的任务（必须手动放入「从不脱敏」）；图片、截图与二进制文件内的敏感文字不会被遮盖；正则与本地模型在自由文本上仍可能误判（如社区曾报告把「黄绿色」「关键词」误判为中文人名、把 Line 账号误判为手机号 #5756，虽经持续修补但仍需在「观测 › 脱敏」页核对）。
插件中间件与局域网 MCP 路由的权限边界：网关中间件运行在 Bun 上且能读写所有流经网关的明文请求与回复，安装第三方非官方插件存在完整流量暴露风险；开启「MCP 路由」并打开「局域网共享」时，持有未受限网关密钥的其他机器可调用宿主机上的命令型 MCP 服务器，相当于拥有宿主机当前用户的命令执行权限（MCP 路由文档）。
默认开启的每日遥测与官网跳转计数：正式版默认每天向 PostHog（us.i.posthog.com）发送一次统计事件，包含本机随机生成的 install-id、版本、操作系统与架构、已启用内置 Agent / 供应商 / 模型的 ID 与数量，以及添加供应商页首排赞助商伙伴被展示、打开与添加的次数（自建供应商只记为 custom，不含名称、URL、密钥、提示词与用量）；可在「设置 → 隐私」关闭、设 DO_NOT_TRACK=1 / MAGPIE_NO_STATS=1 或从源码构建规避。但添加页拉取 /api/partners（每 10 次抽样 1 次）与点击赞助商官网/获取 Key 链接（经 usemagpie.ai/go/… 跳转）由官网 Cloudflare Worker 直接按国家计数，不受客户端隐私开关控制（隐私文档）。
常驻进程依赖与本地代理软件冲突：所有接入 Magpie 的 Agent 在运行时都依赖 127.0.0.1:3425 网关在线；在开启了 Surge、Clash 或 mihomo 系统代理/TUN/增强模式的机器上，发往 127.0.0.1 的请求常被代理软件截获转走（仅配 skip-proxy 对 Codex 等客户端往往不够），导致 Agent 报 502 或 499 而 Magpie 路由页无记录，必须在代理规则最上方显式添加 IP-CIDR,127.0.0.0/8,DIRECT,no-resolve 与 IP-CIDR6,::1/128,DIRECT,no-resolve（快速上手 FAQ）。

价格与许可

MIT 许可，完全免费：核验于 2026-11-09，主仓库 LICENSE 文件首行为 MIT License（Copyright (c) 2026 yetone），仓库元数据 license.spdxId 为 MIT，自 2026-09-23 首次开源提交（6c99ab0）起即为 MIT 许可。软件本身、跨机同步、MCP/Skill 路由、本地脱敏与 Docker 镜像均无付费墙或商业授权层级；项目运营通过 Kimi 及多家 API 中转站赞助商（APINEBULA、零词元、APIKEY.FAN、WandAPI、AIGoCode）支持。
实际使用成本：完全取决于用户自行接入的 API Key 或订阅套餐。需要注意三类由 Magpie 自身发起、会消耗上游额度或费用的辅助调用（在用量页均单列在 Agent magpie 名下）：
1. 意图路由分类调用：每当用户发起新一轮发言且可能命中意图规则时，会调用一次判断模型（输入最多约 4,000 字符用户消息加意图列表，输出 1–2 token；若选用 Jev 则按 System One 输入 token 计费，若选用订阅内模型则占用该订阅额度）；
2. 识图替身与联网搜索替身：纯文本模型收到图片或无搜索模型触发搜索时，调用配置的视觉模型或搜索模型/API 产生的费用；
3. 5 小时窗口预热与插件缓存保活（Cache keep-alive）：定时发送极小请求开启额度窗口，或插件（如 Devin）定时重发最后一轮以维持缓存热度所产生的消耗。

价格历史

日期	方案	变化	来源
2026-09-23	开源发布（MIT），全功能 $0	首次记录基线	LICENSE 提交记录
2026-11-09	全功能 $0（MIT）	复核未变	GitHub 仓库、官网

替代方案

CC Switch（farion1231/cc-switch）：基于 Tauri 2 的 MIT 开源桌面配置切换器，内置 90 多个服务商预设，管理 Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi、MiniMax Code、Kimi Code、Oh My Pi 共 12 个工具的配置、MCP、Skills 与提示词，并提供可选的本地路由代理（默认端口 15721）。按 Magpie 官方对比页（2026-11 口径），如果只需要手动给这十来个工具切换直连供应商、希望配置文件保持直连地址，CC Switch 的预设更多且直接；如果需要管理 60+ 工具、在任意工具间跨协议复用 Claude / ChatGPT / Copilot 订阅、按周重置时间或意图动态选路，Magpie 更完整（且支持一键导入 CC Switch 的既有配置）（官方对比页）。本区暂无独立笔记。
Claude Code Router（CCR）：运行在 127.0.0.1:3456 的 MIT 开源本地模型网关与控制台，提供桌面端、带 Web 界面的 npm CLI 与 Docker，主打按请求头与请求体条件编写可编程路由规则、请求改写、凭据池与有序备用模型。适合偏好通过规则配置精细控制网关转发的开发者；Magpie 的差异在于菜单栏一键改写 60+ 客户端配置、真实 claude 进程订阅桥接、基于重置窗口的 smart/pace 调度以及本地隐私脱敏（官方对比页）。本区暂无独立笔记。
LiteLLM / New API（BerriAI/litellm、QuantumNous/new-api） / CLIProxyAPI：面向服务端、团队或自建中转站的模型网关。LiteLLM 侧重生产应用的多模型统一 SDK/Proxy、团队预算管控与企业审计；New API 主打渠道分发、多租户令牌计费与管理后台（Magpie 的网关中间件 JSON 配置即直接兼容 New API 的 param_override 与 model_mapping）；CLIProxyAPI 专注于把订阅 CLI 封装为标准 API 中继。要为团队或线上服务搭建集中计费网关应选 LiteLLM 或 New API；个人开发者在桌面或家庭 NAS 上统一调度自己的多个 Agent 与订阅账号则选 Magpie（iTech 评测）。本区暂无独立笔记。
T3 Code / Stably Orca / Herdr（见「智能体编排」主题）：这三者解决的是「如何并行运行、监督与评审多个 CLI 编码智能体的会话、终端与 git worktree」，而 Magpie 解决的是底层「每个智能体配置哪个模型、请求发往哪个账号」。两者属于上下游互补关系而非互斥替代——例如可以在 T3 Code 或 Herdr 中监督并行会话，同时由 Magpie 接管 T3 Code（~/.t3/userdata/settings.json）及各 CLI 的底层模型路由与额度故障转移。

适用建议

建议采用：同时使用两个以上编码或对话 Agent（如混用 Claude Code、Codex、OpenCode、Hermes Agent、T3 Code），或手握多个订阅账号与多家 API Key（如希望在 Codex 里跑 DeepSeek/Kimi/GLM、在 OpenCode 里用 Claude/ChatGPT 订阅、在多个账号间按 5 小时/周窗口自动错峰消耗）。
无需采用：只用一个 Agent 且只用它自家的单一订阅、额度够用（官方 README 明言此类用户不需要它）；或需要搭建面向生产环境与多租户计费的团队网关（应选 LiteLLM 或 New API）。
落地上手五条实操建议：
1. 先锁稳定更新渠道与后台服务：安装后执行 magpie update channel stable 切换到每周稳定版渠道，避开日均十余次构建的波动；在 macOS 或 Linux 上运行 magpie daemon install 将网关注册为系统级后台服务，避免关闭终端或 GUI 导致正在运行的 Agent 断连。
2. 排查本地代理直连规则：使用 Surge、Clash 或 mihomo 时，先把 IP-CIDR,127.0.0.0/8,DIRECT,no-resolve 与 IP-CIDR6,::1/128,DIRECT,no-resolve 放在代理规则最顶部，防止 Agent 发往 127.0.0.1:3425 的流量被代理软件劫持。
3. 按需隔离主力配置：如果不希望日常直接运行的 claude 命令被改写 ~/.claude/settings.json，不要在 Agents 页直接连接 Claude Code，而是运行 magpie claude launcher add 后改用 claude-magpie 按会话启动。
4. 开启意图路由与工具路由时的省钱与省上下文配置：挂载超过 10 个 MCP 工具时开启「资源库 → MCP → MCP 路由」以启用按需工具搜索；开启意图路由时优先选用本地模型（Ollama / LM Studio）、廉价 Flash 模型或 Jev（$0.042 / M 输入 token），不要把昂贵的慢速推理模型设为分类器。
5. 安全与隐私边界：在「设置 → 隐私」中按需关闭 计入用户数（或设环境变量 DO_NOT_TRACK=1）及 订阅账号 自动发现（magpie accounts discovery off）；开启本地脱敏时，若需让模型排查特定密钥报错，将该值加入「从不脱敏」或设置「命中脱敏时改用」转交本机 Ollama 模型；切勿在不可承受封号风险的企业合规账号上开启跨工具订阅复用。

变更记录

2026-11-09：创建。核验 yetone/magpie 与 yetone/magpie-releases 仓库状态（32,664 star、2,880 fork、3,446 open issues、v0.1.3373、MIT 许可），整理外科手术式配置接管、四向协议 IR 互转、真实 claude 进程订阅桥接与 11 类退役内置订阅插件化、九种路由模式与意图路由（含 Jev / System One 集成）、本地双模脱敏（规则 + AstrLink Guard / Privacy Filter）、MCP/Skill 路由、AI 智能体自主研发与高频发版机制、PostHog 遥测与合作伙伴跳转计数边界，以及与 CC Switch、Claude Code Router、LiteLLM / New API 的选型对照。

参考来源

yetone/magpie（GitHub 主仓库）：项目定位、架构图、支持 Agent 与预设供应商列表、MIT 许可证与「不接受 Pull Request」声明；仓库内嵌 JSON 于 2026-11-09 核验为 32,664 star、2,880 fork、36 watcher、7,011 commits、3,374 tags、2,083 releases、创建于 2026-09-23。
yetone/magpie-releases（签名构建与 Homebrew tap 仓库）：各平台签名构建流程、Formula/magpie.rb 与最新正式版本号（2026-11-09 核验为 v0.1.3373）。
仓库内置完整参考手册 docs/reference.md：60 余种 Agent 的配置文件路径与改写字段、四协议网关端点、/v1/embeddings 与 /v1/rerank、/v1/decisions 与 /v1/systemone 互转、账号选择 6 步规则与路由模式、claude 订阅桥接、更新渠道（every 与 stable）、后台服务、Docker 与 NAS 网关模式、AES-256-GCM 备份与三端同步、OTLP 与 Langfuse v4 导出、~/.config/magpie 文件清单及每日统计规则（读取于 2026-11-09）。
仓库内置架构与治理文档（AGENTS.md、LESSONS.md、docs/code-standards.md、docs/contributors.md）：11 类内置订阅因厂商条款风险退役迁入 @magpie-community/opencode-*-auth 插件的清单、AI 智能体自主编写/评审/合并/发版机制与日均百余次提交的回归复盘记录、社区贡献「有害性审查（Look for harm first）」与手改破坏测试门禁（读取于 2026-11-09）。
仓库内置子系统设计参考 docs/subsystems/：逐份核验 gateway-routing.md（脱敏豁免、Jev 置信度 intentSure、5 秒保活、loopGuard 与 8 轮工具死循环拦截）、claude-subscription-bridge.md（伪终端交互模式 claude-tui-helper 规避 -p 两倍额度计费、临时 MCP 回调）、provider-plugins.md（插件迁移、延迟计费、积分钱包、北京时间每日签到）、mcp-router.md（单实例共享、10 分钟空闲停止、>10 工具自动转 find_tools/call_tool 按需搜索）、skill-router.md（magpie-skills 聚合）与 gui-shell.md（WebView2 隐藏低内存目标）（读取于 2026-11-09）。
Magpie 中文官方文档：快速上手：九种路由模式与五档会话保持、路由规则与 8 层嵌套路由组、claude-magpie 启动器、Surge / Clash / mihomo 本地回环直连排障、便携模式与卸载恢复流程（读取于 2026-11-09）。
Magpie 中文官方文档：意图路由：每轮新发言判定流程、前 3,000 + 后 1,000 字符截断与 <system-reminder> 剥离、默认 8 秒超时与 10 分钟内存缓存，以及 20 条真实编程消息下 DeepSeek V4 Flash / GLM-5.3 Flash / MiMo v2.6 Flash 20/20 全对的官方实测数据（读取于 2026-11-09）。
Magpie 中文官方文档：本地脱敏与隐私：确定性脱敏规则、AstrLink Guard（39 MB，默认阈值 0.8）与 OpenAI Privacy Filter（1.6 GB，默认阈值 0.5）本地模型、fail-closed 503 保证、「命中脱敏时改用」转交本地模型，以及 PostHog 每日上报 JSON 批次示例、关闭开关与官网 usemagpie.ai/go/… 跳转计数边界（读取于 2026-11-09）。
Magpie 中文官方文档：订阅用于任意 Agent、资源库、MCP 路由与远程 magpie：订阅共享矩阵、Antigravity 封号风险警告、资源库六大模块、局域网命令型 MCP 权限提醒、短期网关密钥与 GitHub Actions OIDC 换取密钥机制（读取于 2026-11-09）。
Magpie 中文官方文档：与 CC Switch、Claude Code Router 对比：三者在支持工具数、切换方式、协议转换、订阅登录、路由与故障转移、界面形态与许可证上的官方对照表（2026 年 11 月口径，读取于 2026-11-09）。
yetone/magpie：一个本地网关，让所有 Agent 随便挑模型（iTech，博客园，2026-10-28）：第三方架构走查与点评——四协议 IR 转换、internal/edit 无损改写与漂移检测、订阅复用的 ToS 风险定性、本地脱敏适用边界、与 LiteLLM / New API / CC Switch 的坐标对比，以及对主仓库不接受外部 PR 和高频迭代的独立评价。
替代 CC Switch，Magpie 真的很顶。（沉默王二，2026-10）：第三方实测——Claude Code 四档思考与 Sub-agent 独立绑定模型、前缀缓存保鲜期、识图替身与联网搜索替身、5 小时额度窗口重置预热与每日定时预热错峰用满三个窗口、重置卡自动消耗。
GitHub Issues · yetone/magpie：未关闭 issue 总数（3,446）与社区反馈的典型边界问题（如 #5756 Line 号误脱敏为手机号、#5744 Windows 渲染、#5745 WSL 历史迁移锁文件、#5043 Claude 订阅长会话超时恢复，读取于 2026-11-09）。

R0sin's Skrode