🏠 AI Tools Hub | 首页 | 文章 | 评测 | GitHub热门 | 排行榜

Magpie 教程：菜单栏一点，给 Claude Code/Codex/Gemini CLI 统一换模型

Q: Magpie 是什么？

yetone（avante.nvim 作者）开源的单屏 Agent 模型管理器（2766 星，Go 语言）：菜单栏点开一个面板，列出机器上每个 AI agent（Claude Code、Codex、Gemini CLI、OpenCode、Cursor、Goose 等）当前配置的模型，点击选新模型就完成切换——整个应用就这一件事。另有 TUI 终端版和纯 CLI，桌面版小于 15 MB（走系统 webview）。

Q: Magpie 的本地网关是干什么的？

magpie 起一个本地网关（http://127.0.0.1:3425/v1），同时说 OpenAI chat completions、OpenAI Responses 和 Anthropic Messages 三种协议，按你选的模型转发到对应厂商——协议翻译（含流式与工具调用）都在 magpie 内完成。所有 agent 只需指向这一个端点、从同一份模型目录里选，不用各自配各家的 key。

Q: 订阅账号能共享给其他 agent 吗？改配置安全吗？

能共享：登录 Claude Code、Codex（ChatGPT）或 Copilot 后，该登录会作为一个 provider 出现，其他 agent 都能通过网关用它的模型，不复制凭据、不粘贴 key。改配置是外科手术式的：只动你改的那一个键，settings.json/config.toml 里的注释、顺序、缩进原样保留，写入原子完成；magpie 也从不读 shell 环境变量里的 key。

📌 项目地址：github.com/yetone/magpie | 星数：2766+ | 语言：Go（Wails） | 平台：macOS / Linux / Windows

📋 项目简介

机器上装了一堆 AI agent 之后，模型配置散落在 settings.json、config.toml、opencode.jsonc、config.yaml 各处，想统一换模型要挨个文件改。Magpie（yetone 出品，avante.nvim 作者的新作）把这件事变成菜单栏里的一次点击：一个面板列出所有 agent 及其当前模型，点哪个改哪个。它同时内置本地协议网关，让「订阅共享」和「一套 key 全家桶」成为可能。同类的 CLI 侧路由方案可以对照 claude-code-router路由教程阅读。

✨ 核心特性

特性	说明
一个面板管全部	列出每个 agent 当前模型，点击即换；桌面面板 + TUI（magpie tui）+ 纯 CLI 三种形态
极小体积	桌面版 <15 MB（系统 webview，Wails 打包），纯终端版 7 MB
外科手术式改配置	只动改的那个键，注释/顺序/缩进全保留，原子写入
本地统一网关	127.0.0.1:3425/v1 同说 OpenAI/Responses/Anthropic 三协议，流式与工具调用都翻译
订阅共享	Claude Code/Codex/Copilot 的登录变 provider，其他 agent 免 key 复用
真实模型列表	有 key 就问厂商实际服务哪些模型，不写死目录；30+ 预设厂商一键填
不碰环境变量	magpie 从不读 shell 里的 key

🚀 上手

# 菜单栏点图标 → 面板列出全部 agent：
#   Claude Code   claude-fable-5-1[1m]   ~/.claude/settings.json
#   Codex         gpt-6-astra  effort medium
#   Gemini CLI    gemini-3.1-pro
#   OpenCode      anthropic/claude-sonnet-5 ...
# ↑↓ 选 agent · ←→ 选字段 · ↵ 改模型 · s 存 profile · p 配置组

# 把所有 agent 指到本地网关（一套目录统一选模型）：
#   http://127.0.0.1:3425/v1

# 预设厂商：Anthropic/OpenAI/Gemini/DeepSeek/Kimi/GLM/
#   MiniMax/Qwen/OpenRouter/Ollama/LM Studio... 粘 key 即用

💡 使用建议

多 agent 重度用户先做一件事：全部指向本地网关，之后换模型只在一个地方操作，profile（s 键）可以按任务存几套组合
订阅共享场景记得让对应 agent 保持登录态；网关转发不复制凭据，安全性靠原会话
配置文件洁癖者可以放心：它不会重排你的 JSON/TOML，diff 里只有那一个键
CLI 内切模型的需求也可搭配 fast-jev-compaction 这类 Claude Code 插件生态一起用

📚 常见问题

Magpie 是什么？

yetone（avante.nvim 作者）开源的单屏 Agent 模型管理器（2766 星，Go 语言）：菜单栏点开一个面板，列出机器上每个 AI agent（Claude Code、Codex、Gemini CLI、OpenCode、Cursor、Goose 等）当前配置的模型，点击选新模型就完成切换——整个应用就这一件事。另有 TUI 终端版和纯 CLI，桌面版小于 15 MB（走系统 webview）。

Magpie 的本地网关是干什么的？

magpie 起一个本地网关（http://127.0.0.1:3425/v1），同时说 OpenAI chat completions、OpenAI Responses 和 Anthropic Messages 三种协议，按你选的模型转发到对应厂商——协议翻译（含流式与工具调用）都在 magpie 内完成。所有 agent 只需指向这一个端点、从同一份模型目录里选，不用各自配各家的 key。

订阅账号能共享给其他 agent 吗？改配置安全吗？

能共享：登录 Claude Code、Codex（ChatGPT）或 Copilot 后，该登录会作为一个 provider 出现，其他 agent 都能通过网关用它的模型，不复制凭据、不粘贴 key。改配置是外科手术式的：只动你改的那一个键，settings.json/config.toml 里的注释、顺序、缩进原样保留，写入原子完成；magpie 也从不读 shell 环境变量里的 key。