软鉴SoftMemo
浏览软件目录

Magpie 是面向 AI 编程助手的本地模型网关与管理应用，可从菜单栏为 Claude Code、Codex、Gemini CLI 等统一选择模型，接入 API 密钥、订阅账号或本地模型。它支持跨协议转换、多账号与模型故障转移，也可通过 Docker 部署为供其他电脑使用的共享网关。

适合同时使用多个编程助手并经常更换模型的开发者 · 需要在多个账号和供应商之间分配编程请求的用户 · 希望让多台电脑共用模型入口的自托管用户

亮点

  1. 跨工具统一选模型

    从同一列表为不同编程助手选择模型，通过本地网关连接 API、订阅与本地模型。

  2. 额度耗尽自动接替

    配置多个账号或路由组后，可在额度耗尽时换用其他账号、模型或供应商。

  3. 请求发出前脱敏

    手动开启后，在本机替换提示中的密钥、密码和邮箱，并在回复中还原；默认关闭。

  4. 用量与费用集中查看

    汇总各账号额度、会话费用和上下文占用，支持自定模型价格与账单导出。

功能说明

模型与配置

  1. 接入多类模型源

    添加订阅、API 密钥、Ollama、LM Studio 或自定义 OpenAI、Anthropic 兼容端点。

  2. 转换接口协议

    在 OpenAI Chat、OpenAI Responses、Anthropic Messages 和 Gemini 接口间转换，包含流式输出、工具调用与推理。

  3. 保存整套配置

    以配置档保存所有助手的设置及各自模型短名单，之后统一切换。

  4. 保留原配置格式

    仅修改必要配置项并原子写入，保留注释、顺序和缩进；新模型对下一次会话生效，Codex 还需重启应用并重新打开会话。

  5. 提供桌面、终端和浏览器界面

    支持 macOS、Windows 和 Linux，提供菜单栏、窗口、TUI、Web UI 和 CLI 等使用方式；另支持 Termux 环境，不等同于提供普通 Android 应用。

  6. 通过官网或命令行安装

    可从 usemagpie.ai 下载，使用官方 install.sh 脚本，或通过 go install 安装；README 说明构建支持自动更新，macOS 构建经过签名和公证。Docker 使用单独的镜像更新流程。

  7. Linux 安装会按环境选择界面

    脚本默认安装桌面版；缺少 WebKitGTK 4.1 时会通过包管理器补装并请求 sudo 授权。无桌面或无法交互询问时安装终端版，也可显式选择 GUI 或 TUI。

路由与接替

  1. 分配账号请求

    可按顺序、轮换、权重、使用量、到期时间或近期响应速度等策略，在同一提供商的多个账号或密钥间分配请求。

  2. 设置备用模型

    供应商额度耗尽、限流或不可用时，改用备用列表中的模型。

  3. 按任务选择模型

    依据请求长度、图片、推理需求、助手、任务意图或项目目录匹配路由规则。目录匹配依赖助手在请求中报告工作目录；文档明确列出 Claude Code、Codex、OpenCode 和 Pi，不报告目录的助手无法匹配目录规则。

  4. 单独路由上下文压缩

    可为 Claude Code、Codex、OpenCode、Pi、Gemini CLI、Qwen Code 和 Kimi Code 的上下文压缩另选模型，原对话及所在轮次的缓存保持原路由。

用量与会话

  1. 核算模型费用

    统计 Token、缓存读写、推理和调用，按标价估算费用，也可自定模型价格。

  2. 查看账号额度

    查看密钥、订阅和账号的余额及额度窗口，并在窗口即将重置且仍有较多额度未用时提醒。

  3. 检查会话与上下文

    查看会话费用、上下文占用及缓存使用情况，并一键在终端重新打开会话。

共享网关

  1. 部署服务器网关

    在无桌面的服务器或 NAS 上用 Docker 运行，通过浏览器管理模型源与订阅，为其他电脑上的助手提供模型。容器内没有可配置的助手，浏览器界面默认处于网关模式，不显示 Agents 或 Library。

  2. 为远程客户端配置必需的网关密钥

    容器外的所有请求，包括宿主机请求，都必须携带已启用的网关密钥，否则返回 401。可为各客户端分别建密钥，并限定可用模型及按日、周、月或自定义天数、小时数计算的用量。

  3. 限制访问来源

    可配置允许访问的 IP 地址，未允许的连接在校验密钥前即被拒绝。经过反向代理或隧道时，网关看到的是代理地址，需在代理侧限制实际客户端。

  4. Docker 更新需拉取镜像并重建容器

    使用新镜像在同一数据卷上重建容器；保存在 /config 中的模型源、密钥、登录信息和插件会保留。不能将桌面构建的自动更新方式直接套用于容器。

适合场景

  1. 同时使用多个编程助手并经常更换模型的开发者

    统一管理模型来源，并用配置档一起切换各助手的设置，减少逐个编辑配置的操作。

  2. 需要在多个账号和供应商之间分配编程请求的用户

    可按权重等策略分配请求，配置额度或服务异常时的备用模型，并按任务类型决定路由；按项目目录分流时需使用会报告目录的助手。

  3. 希望让多台电脑共用模型入口的自托管用户

    可在服务器或 NAS 部署网关，用独立密钥控制各客户端的模型范围和用量。

取舍

选它的理由

  • 协议转换覆盖流式输出、工具调用与推理本地网关支持 OpenAI Chat、OpenAI Responses、Anthropic Messages 和 Gemini 协议并相互转换，不只是替换模型名称或请求地址。
  • 配置方案可一次恢复多个助手的模型设置Profiles 保存各助手的配置及各自的模型短名单；修改助手配置时采用原子写入，并保留注释、顺序和格式，便于在不同工作方案间切换。
  • 路由规则可按项目与任务类型选择模型可根据上下文长度、图片、推理要求、助手、项目目录或用户意图分流。项目目录规则依赖助手在请求中报告目录，文档明确列出 Claude Code、Codex、OpenCode 和 Pi，不报告目录的助手无法匹配。规则在一轮开始时决定模型，并在工具结果回传期间保持不变；该轮超过模型上下文容量时例外。
  • 可选的本地脱敏会在回复中还原原值开启后，请求中的密钥、密码和邮箱会先替换为占位符，回复再还原，助手和文件继续使用原值；该功能默认关闭，不能将其理解为默认不向上游发送敏感内容。

先想清楚

  • 不适合只用一个助手的原厂模型且完全不需要切换的用户

使用须知

  • 模型切换不改变已经运行的会话助手在启动时读取配置，新模型对下一次会话生效；Codex 还需重启应用，并在切换后重新打开会话。
  • 使用 Claude 订阅需保留 Claude CodeClaude 订阅请求通过本机安装的 Claude Code 处理；Docker 镜像不自带它，需先让 Magpie 下载后才能使用该订阅。
  • 单账号且未配置路由组时无法自动接替额度耗尽后的继续运行依赖其他可用账号或模型；只有一个账号且没有路由组时，错误仍会传给助手。
  • 会读取本机助手的已有订阅登录信息自动发现来源包括 Claude Code、Codex 的登录文件及系统钥匙串；不希望读取时可关闭订阅账号发现，API 密钥提供商仍可使用。
  • Linux 图形界面安装可能需要管理员授权桌面环境缺少 WebKitGTK 4.1 时，安装脚本会通过包管理器安装并请求 sudo 授权；无桌面或无法交互询问时则安装终端版本。

安全警示

  • 官方文档警告：在 Antigravity 外使用其订阅可能导致 Google 暂停账号。

基于公开资料与 AI 分析整理，仅供参考，请自行核实。

同分类软件

查看全部

更多「编程开发」软件

软鉴 SoftMemo

AI 整理的软件知识库

AI 整理软件资料、版本动态、更新通知、订阅权益与对比分析，沉淀可复用的工具知识。

进入软鉴浏览软件目录
访问网站