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

magpie 是给你所有 Agent 统一选模型的地方：先把模型来源加进来，再给每个 Agent 选一个模型，magpie 会把它写进那个 Agent 自己的配置文件。背后是一个小网关，同时说 OpenAI / Anthropic / Gemini 三种 API，并在它们之间互转——所以 Claude Code 能用 ChatGPT 订阅里的 GPT，Codex 能用 DeepSeek，OpenCode 能用你的 Claude 订阅。

通过下面的地址安装应用

为什么值得装在懒猫微服上

magpie 官方形态是跑在你自己电脑本机（127.0.0.1:3425），只服务那一台机器。装到微服上，它的角色会变——

• 一个域名，全家设备都能用：笔记本、台式机、手机、平板都指到同一个地址，接入只要三行环境变量；
• 订阅、密钥、用量都留在你自己家：谁在用什么模型、花了多少，一目了然；
• 装一次，升级在商店点一下：备份就是拷走一个目录。

从"本机小工具"变成"家里的 AI 网关"，这是它最值得被放在微服上的原因。

概念速览：四张桌子

打开控制台你会发现整个应用就是四张桌子，理解它们之后，所有操作都能自己推出来：

桌子	是什么	你要做的事
供应商	模型从哪里来：订阅、API 密钥、本机模型、自定义接口	把你有的来源都摆上来，一次就好
Agent	用模型的工具：Claude Code、Codex、OpenCode、Gemini CLI……	每个工具点一下，选个模型
网关	所有请求经过的出口：一个地址、五种 API	复制走地址，别让工具直连上游
路由组	可选：把多个账号或同名模型合成一个	有第二个账号时再来

每个模型都写作 provider/model，例如 deepseek/deepseek-chat。

怎么用

第 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 在懒猫微服上只是点一下安装的事，而它带来的秩序感，会在你接第三台设备的时候开始显现。