一个地址，接住所有 AI 工具：在懒猫微服上搭自己的 magpie 网关

> magpie 是给你所有 Agent 统一选模型的地方：先把模型来源加进来，再给每个 Agent 选一个模型，magpie 会把它写进那个 Agent 自己的配置文件。背后是一个小网关，同时说 OpenAI / Anthropic / Gemini 三种 API，并在它们之间互转——所以 Claude Code 能用 ChatGPT 订阅里的 GPT，Codex 能用 DeepSeek，OpenCode 能用你的 Claude 订阅。 通过下面的地址安装应用 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.magpie ## 为什么值得装在懒猫微服上 magpie 官方形态是跑在你自己电脑本机（127.0.0.1:3425），只服务那一台机器。装到微服上，它的角色会变—— - **一个域名，全家设备都能用**：笔记本、台式机、手机、平板都指到同一个地址，接入只要三行环境变量； - **订阅、密钥、用量都留在你自己家**：谁在用什么模型、花了多少，一目了然； - **装一次，升级在商店点一下**：备份就是拷走一个目录。 从"本机小工具"变成"家里的 AI 网关"，这是它最值得被放在微服上的原因。 ## 概念速览：四张桌子 打开控制台你会发现整个应用就是四张桌子，理解它们之后，所有操作都能自己推出来： | 桌子 | 是什么 | 你要做的事 | |---|---|---| | **供应商** | 模型从哪里来：订阅、API 密钥、本机模型、自定义接口 | 把你有的来源都摆上来，一次就好 | | **Agent** | 用模型的工具：Claude Code、Codex、OpenCode、Gemini CLI…… | 每个工具点一下，选个模型 | | **网关** | 所有请求经过的出口：一个地址、五种 API | 复制走地址，别让工具直连上游 | | **路由组** | 可选：把多个账号或同名模型合成一个 | 有第二个账号时再来 | 每个模型都写作 provider/model，例如 deepseek/deepseek-chat。 ## 怎么用 <!-- 配图：懒猫应用商店的 magpie 安装页（安装时顺手截一张即可） --> ### 第 1 步 · 添加供应商 打开「供应商」标签页，点 ＋添加供应商。模型来源有四类： - **订阅 · 登录即可**：Claude（Pro/Max/Team）、ChatGPT（Plus/Pro/Business）、Cursor、Grok、Copilot、Devin。点卡片后 magpie 会打开厂商自己的登录页，登录完成账号立刻出现；同一个卡片再点一次就能加第二个账号——订阅只需在这里登录一次，不用先去别的 Agent 里登； - **厂商预设**：Anthropic、OpenAI、Gemini、DeepSeek、Kimi、GLM、Qwen 等，选一个、粘 API Key，magpie 会向厂商问出模型列表； - **本机**：Ollama 和 LM Studio，无需密钥； - **自定义**：任何 OpenAI 兼容地址（以 /v1 结尾）或 Anthropic 兼容根地址。 以前在 Claude Code / Codex 里配过供应商？面板顶部的「导入…」会读取它们的配置文件，把勾选的供应商带进来（不改动原文件，而且导入的是拷贝，之后两边的改动互不同步）。  ### 第 2 步 · 给每个 Agent 选模型 「Agent」标签页里，本机装过或配置过的每个 Agent 各占一行，显示它当前用的模型。**点模型 → 选一个**，就完成了——magpie 会把选择直接写进那个 Agent 自己的配置文件，只改它需要的几个键，注释、顺序、缩进全都保留，写入是原子的。 | Agent | 写入什么 | |---|---| | Claude Code | ~/.claude/settings.json 里的 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 和模型变量 | | Codex | ~/.codex/config.toml 的一个 [model_providers.magpie] 表；你自己的 ChatGPT 登录不受影响 | | OpenCode / MiMo Code / Pi / Crush 等 | 一个 magpie 供应商条目 + magpie/provider/model | | Gemini CLI | GOOGLE_GEMINI_BASE_URL 指向网关、密钥认证与模型 | 两个必须记住的点： - **改的是"下一个会话"**：Agent 在启动时读配置，已经在跑的会话保持原来的模型； - **Codex 还要重启应用**：它的模型列表也是启动时生成的，切换后把 Codex 应用和已打开的会话一起重启。 在 Agent 页底部点「＋ 保存当前」，可以把所有 Agent 的设置存成一个方案，之后一键全部切回——试新模型之前先存一个，心里就有底了。  模型选择列表  ### 第 3 步 · 把其他设备接上 「网关」页是微服版相对官方形态最大的不同：你会拿到一个**域名地址**和**五种 API**（OpenAI / Responses / Anthropic / Gemini / System One），任何支持 OpenAI 兼容接口的工具都能接。 export OPENAI_BASE_URL=https://你的域名/v1 export OPENAI_API_KEY=sk-magpie-key-… # 网关页里为每台设备单独建一把 注意：对 magpie 列表里的那些 Agent（Claude Code、Codex 等），你**不需要**手动配这些环境变量——magpie 已经写好了。这几行是留给它管不了的工具的，网关页的「接入」部分有一键复制。 两个安全相关的动作： - **装完第一件事：生成一个KEY** 打开 网关-添加网关密钥（如果你没想好名字，可以在设置-网络与共享里面打开“局域网共享”会生成一个叫Magpie的网关密钥） - **每台设备一把密钥**：新建、命名、分开统计。用量页会按密钥把消耗列清楚，谁在用什么一目了然。  ### 第 4 步（可选）· 路由组：多账号与同名模型的合体 当你有两个 ChatGPT 账号、或者同一个模型既有订阅又有 API Key 时，路由组把它们合成一个名字（group/id 形式），Agent 把它当作一个模型来选。同名模型会**自动成组**：Claude 订阅和 Copilot 都有 Claude Opus，DeepSeek 官方和 OpenRouter 都有 DeepSeek，选它就能分摊到多个来源。 路由方式：智能（默认，余额多的先用）、按顺序、轮流、最少使用、重置前用完。还能用规则把某类对话交给组里指定成员： - tokens=150k——长对话优先发给便宜模型； - compact——Agent 压缩上下文时的总结交给便宜模型，正式对话留在原地； - folders=~/work/acme——某个项目里的会话先发给指定模型； - intent="一个简单问题"——用几个词描述意图，让它按内容分流。 路由页会实时显示每一轮被哪条规则、送到了哪里。  ## 用量、上下文与方案 「用量」页按 Agent 和模型统计**经过网关**的每次调用：token、缓存命中、费用，以及每份订阅已用的额度和重置时间（直连厂商的请求不经过 magpie，不会计入——这也正是把工具都收到网关下的好处）。 「上下文」标签页能看到每次请求的提示词里装了什么：系统提示词、工具定义、指令文件、读入的文件、对话各占窗口多少，并给每个 Agent 一个百分制得分。提示词原文只在内存里留最近 10 次，magpie 退出即消失，不会发往任何地方。  ## 进阶：终端与自动化 magpie 的每一步在命令行都有对应命令（在应用容器的终端里执行）： | 命令 | 作用 | |---|---| | magpie ls | 列出找到的每个 Agent 及其当前设置 | | magpie models | Agent 能选的所有模型 | | magpie claude codex/gpt-5.5 | 把某个 Agent 的模型设成指定值 | | magpie accounts add codex | 再登录一个 ChatGPT/Claude 订阅 | | magpie save work / use work | 保存 / 应用方案 | | magpie usage 7d | 按 Agent 和模型统计 token 与费用 | | magpie agent default | 恢复该 Agent 原样，移除 magpie 的接入 | magpie help 是完整列表；不加参数的 magpie 是终端里的完整 TUI。 ## 几个真实会遇到的坑 - **订阅登录的回调**：在容器里发起登录时，浏览器最后会跳回 localhost，那个页面打不开——把地址栏里整条地址复制出来，粘进登录流程里的 Callback URL 输入框即可； - **想恢复原样**：在模型选择列表里选 Agent 自带的模型，或者用对应的 default 命令，magpie 会删掉它写入的内容并恢复原来的值； - **手动改配置不会冲突**：magpie 每次都重新读文件，只动它设置的那几个键； - **代理软件的 502 陷阱**（如果你在本机也跑 magpie）：Surge / Clash 之类会把发往 127.0.0.1:3425 的请求劫走，在规则最前面加 IP-CIDR,127.0.0.0/8,DIRECT,no-resolve 与 IP-CIDR6,::1/128,DIRECT,no-resolve 即可； - **截图和分享前先轮换密钥**：控制台会打印完整密钥，发到公开场合之前记得在网关页「轮换密钥」，顺手检查用量页里的账号名； - **备份与迁移**：一切都在 /lzcapp/var/config，整目录拷走即完成备份； - **隐私**：你的提示词、回复、密钥只发给你自己用的供应商，中间没有 magpie 的服务器；正式版每天报一次"多少人在用"的匿名统计，设置 → 隐私里可以关掉。 ## 写在最后 AI 工具的更新速度已经超过了我们维护配置的耐心。与其在每个工具里追着改，不如给自己搭一个稳定的入口：**上游随便换，入口永远是你的**。magpie 在懒猫微服上只是点一下安装的事，而它带来的秩序感，会在你接第三台设备的时候开始显现。