Magpie Skill：把 23 款编码 Agent 的模型切换收进菜单栏

Skill超级捕获手 技术创作者 2026-09-30 797 阅读

当你同时跑 Claude Code、Codex、Gemini CLI、OpenCode、Cursor、Copilot CLI 等多款编码 Agent 时，每款都得维护一套独立的 settings.json / config.toml / opencode.jsonc，换一次模型要翻一个文件；订阅的 Claude Pro 额度，Codex 一点也用不上——多代理时代的「模型切换税」已经到了无法忽视的地步。Magpie 把这一整套收进 macOS 菜单栏里的一格，点点就能让 Codex 跑 DeepSeek、让 Claude Code 用 Kimi，单一本地网关吸收掉 4 套主流 LLM 协议的差异，是近期增长最快的 Agent 基建之一。

一句话与核心能力

Magpie（https://github.com/yetone/magpie）是一个用 Go 写的菜单栏模型调度台，自带本地网关（监听 127.0.0.1:3425），统一翻译 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages、Google Gemini 四套协议，让 Claude Code、Codex、OpenCode 等 23 款 Agent 共享一份模型目录、一个订阅池和一套 Profile 配置。核心能力可拆为三层：跨 Agent 配置编辑（只改 key 对应的一行，不动注释与排版，写入是原子的）、协议翻译网关（streaming、tool calls、reasoning metadata 全程透传）、订阅凭证复用（Claude Code / ChatGPT / Copilot 的登录态可作为 provider 给其它 Agent 用，无需复制 API key）。

设计原则

Magpie 的设计哲学是「不绑定任何模型，只翻译协议」：每个 Agent 的配置文件只编辑真正变化的那一行，注释、缩进、顺序原样保留；模型目录不写死在二进制里，magpie 在用户填入 key 后主动问 vendor 当前提供哪些模型，models.dev 目录兜底补齐没有列表的厂商；沙箱安全要求密钥只存 magpie 自己的 config，不读 shell 环境变量；CLI 版只有 7 MB，桌面版加上系统 webview（Wails 渲染）也只有 15 MB。同时还遵循「不要偷偷接管订阅」的边界——Claude 订阅通过本地 claude 二进制以 MCP 方式代理，避免被第三方分类。

认可度

截至 2026-09-30，GitHub Star 数约 2,629，Forks 约 153（数据来源：GitHub API）。项目创建于 2026-09-23，仅 7 天即冲进 GitHub 周榜前三，单日最高涨 1,305 星；2026-09-26 AI Agent GitHub Digest 与 2026-09-27 周报同时将 magpie 列为「单日最佳 trending 项目」，alphasignal.ai、claudeers.com、myaiexp.com、skillsllm.com 等英文与中文媒体均做了专项报道，Usemagpie.ai 同步上线官网。中文媒体今日头条报道称「magpie 用五天冲进 GitHub 周榜前三」，与官方 star 增长曲线吻合。

链接

  • GitHub：https://github.com/yetone/magpie
  • 官网：https://usemagpie.ai
  • Claudeers 介绍页：https://claudeers.com/magpie
  • SkillsLLM 安全扫描：https://skillsllm.com/skill/magpie

原作者

作者 GitHub 用户名 yetone，是知名 Neovim AI 插件 Avante.nvim 的维护者，长期深耕 Agent × 编辑器集成。Magpie 延续了他一贯的工具思路：用本地、可审计、可控的小工具，解决「Agent 用得多反而更累」的实际痛点。

项目介绍

Magpie 把自己定位成「Each agent’s model. One place」——一个跑在菜单栏里的模型调度台，安装启动后会扫描本机已装的所有编码 Agent 并列成一屏：Claude Code、Codex、Gemini CLI、OpenCode、Cursor、Copilot CLI、Pi、Goose、omp、Crush 等都在探测范围内（README 列出 23 个）。点击任何一项的当前模型值，弹出模型选择器；选定后，magpie 会去改对应 Agent 的配置文件，下一会话生效。

界面有四种形态：菜单栏图标（点图标下拉）、普通窗口（magpie 命令）、TUI 终端（magpie tui）、纯 CLI（适合 WSL/SSH），桌面版还提供 magpie web 把界面开进浏览器。订阅复用是该项目的杀手锏：在 Claude Code、Codex（ChatGPT）或 Copilot 里登录一次，那个登录态会自动作为本地 provider 出现在面板里，其它 Agent 就可以经由 127.0.0.1:3425 走这份订阅——「把 Claude Max 喂给 OpenCode / Pi / Goose」「把 ChatGPT Pro 喂给任意 Agent 的别名」，全程不需要复制粘贴 key。

另一项实用功能是 Profile：把当前所有 Agent 的设置打一个快照命名保存，之后可以一键切回整套配置，适合在不同项目、不同 model 组合之间快速切换。

特点

  • 协议透明网关：本地 127.0.0.1:3425 同时支持 OpenAI Chat Completions / Responses、Anthropic Messages、Google Gemini，Codex 跑 DeepSeek、Claude Code 跑 Kimi 都不需要 patch 任何 Agent。
  • 订阅凭证复用：Claude Code / ChatGPT / Copilot 的本地登录态作为 provider 共享给其它 Agent，订阅内模型零成本跨工具。
  • 19+ 内置厂商：Anthropic、OpenAI、Gemini、DeepSeek、Kimi、GLM、MiniMax、StepFun、Qwen、Tencent Cloud Token Plan、Huawei Cloud MaaS、Volcengine Ark、Mistral、Groq、xAI、OpenRouter、Together、Fireworks、SiliconFlow、AiHubMix、302.AI、Ollama、LM Studio……自定义厂商只需填 name 和 base URL。
  • 动态模型目录：拿到 key 后自动从 vendor 拉真实模型列表，models.dev 兜底；模型发布当日上午即可在面板内可选。
  • 手术式配置编辑 + Profile 快照：只改 key 对应的一行，写入原子化；随时按 profile 回滚。

使用方法

一键安装（macOS / Linux / Windows）：

curl -fsSL https://usemagpie.ai/install.sh | sh

或用 Go 直接装 CLI：

go install github.com/yetone/magpie@latest

启动：

magpie           # 打开菜单栏 / 普通窗口
magpie tui       # 终端 TUI
magpie --help    # 全部子命令

最小使用流程：

  1. 启动 magpie，自动扫描本机已装 Agent 并列出当前模型。
  2. 在面板填入一个 provider 的 API key（如 Anthropic），magpie 会自动从 vendor 拉取模型清单。
  3. 点击任意 Agent 行（如 Claude Code）的 model 字段，从下拉里选一个新模型，magpie 改 ~/.claude/settings.json 中的对应字段，下一会话生效。
  4. （可选）在 Claude Code / Codex / Copilot 中登录一次，magpie 会把登录态注册为本地 provider，其它 Agent 即可走该订阅。
  5. 用 Profile 保存当前全套配置，后续可一键切换。

使用场景与人群

  • 同时使用 2 款以上编码 Agent（Claude Code + Codex、Claude Code + Cursor、Codex + OpenCode 等）的个人开发者：告别反复翻 settings.json 改 model 字段。
  • 订阅了 Claude Pro / Max、ChatGPT Plus / Pro、GitHub Copilot 的重度用户：把订阅额度「二次分配」给任意 Agent，无需逐个 Agent 都买 API key。
  • 多项目多模型组合的工作室：Profile 一键切换「前端项目用 Kimi」「安全审查用 Opus 5」「日常副驾用 Sonnet 5」。
  • 跑 Claude Code + Codex 同时干活、需要把模型选择在多 Agent 之间快速 AB 切换的开发者。

不适合：只跑单一 Agent、只用一家模型、不在菜单栏操作的人——杀鸡用牛刀。

输入与输出案例

案例 1：让 Codex 跑 DeepSeek

  • 操作前：Codex 默认只配 OpenAI Responses，模型字段是 gpt-6-astra。
  • 操作：
    bash
    magpie tui # 或菜单栏面板
    # 1. 在 Provider 里新增 DeepSeek，粘贴 API key
    # 2. 切到 Codex 那一行，model 下拉里选 deepseek-coder-v3
    # 3. 回车保存
  • 操作后：~/.codex/config.toml 中 model = "deepseek-coder-v3"，Codex 下一次启动自动走 DeepSeek API，无需修改 codex 本体。

案例 2：把 Claude Max 订阅喂给 OpenCode / Pi

  • 操作前：OpenCode / Pi 默认要单独配 Anthropic API key 或只支持本地 Ollama；订阅的 Claude Max 与它无关。
  • 操作：
    bash
    # 1. 已在 Claude Code 内登录 Claude Pro/Max（保持登录态）
    magpie
    # 2. magpie 自动检测到 Claude Code 登录态，注册为本地 provider "Claude Subscription"
    # 3. 切到 OpenCode，model 字段选 "Claude Subscription · claude-fable-5-1"
    # 4. OpenCode config.jsonc 中 provider 改为 magpie 的本地端点 http://127.0.0.1:3425/v1
  • 操作后：OpenCode / Pi 走本地网关 → 复用 Claude Max 订阅额度，无需单独申请 API key，单日用量与 Claude Code 共享配额。

GitHub: https://github.com/yetone/magpie

评论区

0 条评论

登录后可评论。

Skill超级捕获手 797 阅读