magpie：智能体模型统一网关

项目简介

每个编码智能体都把自己的模型写在各自的配置文件里，格式、字段和 base URL 各不相同；你付费订阅的服务往往也只能在一个工具里用。magpie 把这些统一放到一个应用和一个本地网关后面：在菜单栏里给任意智能体挑选任意模型，网关负责协议翻译、路由和故障转移。

它适合同时使用多个智能体、多个提供商或多个账号的人；如果你只用一家的一个智能体配官方订阅，那并不需要它。

主要功能

• 任意模型配任意智能体：模型列表以 provider/model 展示，选中后原子地改写该智能体的配置文件，原有注释、顺序和格式保持不变。
• 一个提供商处处可用：API key、本地模型，或已登录的 Claude、ChatGPT、Copilot、Gemini、Grok 订阅。
• 额度耗尽自动接管：同一提供商的下一个账号接手，路由组切换到其他模型或提供商，智能体不会看到错误。
• Profiles：把多个智能体的配置存成一个名字（如 "Budget"、"Focus"），一键整体切换。
• 隐私脱敏：在设置 → 隐私开启后，prompt 中的密钥、密码、邮箱会在本机替换成占位符，返回时再还原，供应商看不到真实值。
• 本地网关：127.0.0.1:3425 同时支持 OpenAI Chat、OpenAI Responses、Anthropic Messages 和 Gemini 协议，并在其间互相转换，包含流式、工具调用和 reasoning。
• 多种界面形态：菜单栏应用、窗口、TUI、Web UI 和 CLI。
• 广泛的智能体支持：Claude Code、Codex、Gemini CLI、OpenCode、Cursor CLI、Zed、VS Code Chat、Copilot CLI、Cline 等，只显示本机已安装的那些。

安装与使用

从 usemagpie.ai 下载安装包，或运行安装脚本。安装后在 Providers → Add provider 选择预设并粘贴 key，或登录订阅；再到 Agents 页面为每个智能体选模型，新开会话即生效。

curl -fsSL https://usemagpie.ai/install.sh | sh

也可以在终端完成同样的操作：

magpie provider add deepseek sk-…
magpie claude deepseek/deepseek-v4-pro
magpie codex moonshot/kimi-k2.5
magpie quota
magpie tui

任何接受 base URL 的工具也能接入网关：

export OPENAI_BASE_URL=http://127.0.0.1:3425/v1
export ANTHROPIC_BASE_URL=http://127.0.0.1:3425

卸载脚本安装的内容：

curl -fsSL https://usemagpie.ai/install.sh | sh -s -- --uninstall

注意事项

• 支持 macOS、Windows 和 Linux，也可在 Docker、Termux 中运行；Linux 桌面版需要 GTK 3 与 WebKitGTK 4.1。
• magpie 默认会读取智能体已登录的订阅信息（Claude Code、Codex 的配置文件、Keychain）。可在 设置 → 隐私 → 订阅账号 关闭，或执行 magpie accounts discovery off；单次运行可用 MAGPIE_NO_ACCOUNTS=1 临时关闭。
• 隐私脱敏默认关闭，需要在设置里手动开启。
• 只有一个账号且没有路由组时，额度耗尽仍然会把错误抛给智能体。
• 安装包会自动更新。

本作品整理自 GitHub 开源项目 yetone/magpie，原作者 @yetone，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。