ARTICLE · 1084644
993 Star,一个面板管住19个AI编程助手,贵模型只留给难活
上周装完第四个 AI 编程工具之后，我发现自己有四个配置文件要记。模型名写在四个不同的地方，换一次模型要改四处，改漏一处工具就报错，还得回去翻文档。
机器上的 AI 助手有 19 个，模型却散在 19 个文件里
有人把这件事收进了一个菜单栏面板：993 Star 的 magpie，MIT，Go 写的，一个二进制。
作者 yetone 的定位很直白：Codex 跑 DeepSeek，Claude Code 跑 Kimi，Gemini CLI 跑 GLM，全从一个菜单栏面板点选。
它不用你放弃任何一个工具。它只是把每个工具"现在用的是哪个模型"摆在一屏里，点一下改掉。
先看它认识哪些 agent
README 里排了一张表，19 个，还在加
Claude Code、Codex、Gemini CLI、OpenCode、Pi、Goose、Cursor CLI、Copilot CLI、Crush、DeepSeek Harness、Command Code、omp、Devin、Hermes Agent、Cline、Qoder、Grok Build、ZCode、Alma。
这些工具读配置的路径各不相同：Claude Code 是 ~/.claude/settings.json，Codex 是 ~/.codex/config.toml，Gemini CLI 是 ~/.gemini/settings.json，OpenCode 是 opencode.jsonc，Goose 是 config.yaml。
它最值钱的细节不是"能换模型"，是"只改你换的那一个键"。
手动改 config.toml 最怕的就是覆盖掉自己上个月写的注释和缩进顺序。它的做法是只动这一个 key，注释、顺序、缩进原样保留，写入还是原子的——不会出现改到一半工具读到半个文件的情况。
装它两条命令，选一条： → 官方脚本：curl -fsSL https://usemagpie.ai/install.sh | sh → Go 直接装：go install github.com/yetone/magpie@latest → 桌面版 15 MB，纯终端版 7 MB（无 cgo，能交叉编译），macOS / Linux / Windows 都有
真正撑住它的是本机那一个网关
127.0.0.1:3425，一个端口讲四种 API
面板只是门面。它在本机起了个网关，模型名字统一写成 provider/model，所有 agent 都指向 http://127.0.0.1:3425/v1，从同一份目录里挑模型。
网关同时讲四套协议：OpenAI chat completions、OpenAI Responses、Anthropic Messages、Gemini generateContent。谁跟谁说不到一块，它就在中间翻译，流式和 tool call 都带。
意思是：任何能填 base URL 的东西都能接进来，不用等官方支持列表。改一个环境变量就完事：
OPENAI_BASE_URL=http://127.0.0.1:3425/v1 OPENAI_API_KEY=magpie ANTHROPIC_BASE_URL=http://127.0.0.1:3425 GOOGLE_GEMINI_BASE_URL=http://127.0.0.1:3425
CLI 也不止能点鼠标，日常几条就够：
magpie ls # 所有 agent 和它们当前的模型 magpie claude deepseek/deepseek-chat magpie codex effort high magpie provider add deepseek sk-xxx magpie provider test deepseek # 每个 API 发一次小请求，带延迟 magpie save work # 整套设置存成 profile
一个面板 + 一个本地网关，是它全部的两个部件
顺手盘活你已经付过钱的订阅
这一条对个人开发者最实用
你登录过的 Claude Code、Codex（ChatGPT）、Copilot、Devin，会被它当成一个 provider。也就是说你用 OpenCode 也能直接调用 Claude 订阅里的模型，不用复制 key、不用再买一份。
它读的是这些工具自己的凭据，token 轮换后写回原处；你退出登录，这个 provider 就消失。
还有一个我觉得聪明的设计：路由组。同一个模型如果你有两个来源（比如自己的 key + 订阅），可以组成一组，路由策略四选一：smart（额度快过期的先用）、order、rotate、usage。stays=session 能让一整轮对话留在同一个账号上——不然每轮换账号，缓存全浪费。
组合之后就是：架构和疑难 bug 喂贵模型，补全、写测试、改文档丢便宜模型，账单立刻能分档看。
模型统一写成 provider/model，所有 agent 从同一份目录里挑
我踩过的 5 个坑，提前说
都是 README 里明写、但很容易忽略的
坑一：切完模型不重启，等于没切。这些 agent 在启动时读配置，正在跑的会话会一直用旧模型。Codex 更严格，连模型列表都是启动时读的，必须重启 Codex。
坑二：Claude 订阅这条路不是"借 key"。Anthropic 会把另一个 agent 的 system prompt 判定成第三方流量，所以 magpie 是实实在在地驱动你本机的 claude 二进制。没装 Claude Code、没登录，这条路直接不通。
坑三：Google 账号登录已经收紧。个人账号不再能拿 Gemini CLI 的登录，得是 Code Assist Standard / Enterprise 并且指定项目名；Antigravity 账号被发现在 Antigravity 之外使用有被封的可能，用你输得起的账号。
坑四：key 是明文存的。在 ~/.config/magpie/providers.json，权限 0600。备份文件是加密的（AES-256-GCM，PBKDF2 派生密钥），但订阅登录不在备份里，换机器要重新登。别在公司共享机器上把它当密码保险箱。
坑五：它 9 月 23 号才开源，4 天涨到 993 Star。项目本身节奏很快，Linux 桌面版要 libgtk-3-dev 和 libwebkit2gtk-4.1-dev（只要终端版就 make cli，不依赖 cgo）；Windows 和 Linux 的包还没签名。自己用很香，别急着当团队基础设施。
比换模型更值钱的，是它这套结构
面试和述职都能用
把这段抽出来看：一个 OpenAI 兼容端点 + 一份模型目录 + 凭据集中在一处 + 协议翻译层。
这套结构就是很多公司内部 AI 平台的样子，只是规模不同。面试被问"业务代码怎么做到换模型不改代码"，你讲这个比背框架名有用得多；做得再实一点，还能讲成本按任务分档、网关单点鉴权的问题。
对个人来说更直接：你付的订阅费终于不用为同一件事付两遍，手里的工具也不必再被某一家模型绑死。
总结—— 1. 19 个 agent、四种配置格式，它只改你换的那一个键，注释和缩进都不动 2. 本机 127.0.0.1:3425 一个网关讲四套协议，任何能填 base URL 的工具都能接 3. 登录过的订阅变成 provider，别的 agent 直接用，不用复制 key 4. 坑集中在重启、Claude 订阅路径、Google 账号收紧、明文存 key 这四处
💬 你现在给自己配了几个 AI 编程工具？模型是分开管还是早就想统一了，评论区说说
📂 更多同类内容，点击合集「程序员效率工具库」→ 如果这篇帮你省下一次翻文档，点个「在看」↘