README

magpie

 所有 Agent 的模型，一处搞定。

Claude Code 跑 Kimi，Codex 跑 DeepSeek，Gemini CLI 跑 GLM，OpenCode 用你的 ChatGPT 订阅。
在菜单栏一点就能切换。所有 Agent 共用一个本地网关，
额度用完时，它会悄悄切到你的下一个账号。

   
!macOS !Windows !Linux !Docker !Termux

Thanks to Kimi for supporting magpie and the open source community.

赞助商

    
  

下载  ·  文档  ·  完整参考（英文）  ·  插件  ·  Discord  ·  English · 简体中文




  
  






 magpie 适合你吗？

每个 Agent 都把模型写在自己的配置文件里，格式各不相同，key 和 base URL 各管各的。花钱买的订阅只能在一个 Agent 里用。magpie 把这些收进一个应用和一个本地网关：

- 任意 Agent 用任意模型，在一张表里选。magpie 只改 Agent 配置里该改的那一个键。
- 一个 provider 处处能用：API key、本地模型，或者你登录着的 Claude、ChatGPT、Copilot、Gemini、Grok 订阅。
- 额度用完也不断：同一个服务商的下一个账号自动接上，路由组还能换到别的模型或服务商，Agent 看不到报错。只有一个账号又没建路由组时，没有可换的，报错会原样回给 Agent。
- 密钥不出你的电脑：在 设置 → 隐私 打开脱敏后（默认关闭），提示词里的密钥、密码、邮箱，在请求离开电脑前就在本地脱敏，回复里再换回原值。

如果你用不止一个 Agent、不止一个 provider 或不止一个账号，它就适合你。如果你只用一个 Agent、只用它自家的订阅，而且够用，那就不需要 magpie。

支持 macOS、Windows 和 Linux（菜单栏应用、窗口、TUI、Web 界面和 CLI），也能跑在 Docker 和 Termux 上。

 快速开始

1 · 安装。从 usemagpie.ai 下载应用，或者运行：

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


Mac 版已签名并公证，每个版本都会自动更新。Linux 上脚本装桌面版，桌面上没装 WebKitGTK 4.1 时会先用系统的包管理器装上（sudo 会要密码）；没有桌面或没有终端可问时装终端版，并告诉你该装哪个包。用 --gui 或 --tui 可以自己选。网络受限时可用 --proxy 或 --mirror。也可以 go install github.com/yetone/magpie@latest，或者用 Docker 镜像。 用 curl -fsSL https://usemagpie.ai/install.sh | sh -s -- --uninstall 卸载：先把 Agent 恢复成原来的配置，再拿掉脚本装上的东西（magpie 已被删掉时会临时下载一个来恢复）；~/.config/magpie 里的设置会保留，加 --purge 才一起删除。

2 · 添加 provider。打开 magpie，进入 Providers → 添加 provider。选一个预设、粘贴 key，或者登录一个订阅。

3 · 选模型。在 Agents 页给每个 Agent 选一个模型。开一个新会话就用上了。

也可以全程在终端里操作：

sh
magpie provider add deepseek sk-…               预设只需要 key
magpie claude deepseek/deepseek-v4-pro           Claude Code 用 DeepSeek
magpie codex moonshot/kimi-k2.5                  Codex 用 Kimi
magpie group add "Opus anywhere" models=claude/claude-opus-5-5,copilot/claude-opus-5.5 routing=smart
magpie claude group/opus-anywhere                在多个订阅间自动切换
magpie save work && magpie use work              方案
magpie quota                                     每个套餐还剩多少
magpie settings set theme dark                   设置里的每一项，也能在终端改
magpie tool generate_image "一只喜鹊，水彩" -o hero.png    直接调用 magpie 的生图、识图、搜索工具
magpie tui                                       全部功能，在终端里


magpie 通过读取智能体的登录信息（Claude Code 和 Codex 的文件、钥匙串）找到它们登录的订阅。不想让它读取，可以在 设置 → 隐私 里关闭「订阅账号」，或运行 magpie accounts discovery off（on 重新开启）。MAGPIE_NO_ACCOUNTS=1 只对这一次运行关闭，不改动保存的设置。API Key 服务商不受影响。

 支持的 Agent




Claude Code · Claude Desktop · Claude Science · Codex · Gemini CLI · Antigravity CLI · OpenCode · OpenChamber · MiMo Code · DevEco Code · Pi · oh-my-pi · StepCode · MothX · PenguinHarness · Aside · OmO · Prime Agent · Goose · Cursor CLI · Cursor Private Inference · Zed · VS Code Chat · VS Code Insiders · VSCodium Chat · Zoo Code · JetBrains Air · Air (JetBrains IDEs) · Copilot (JetBrains) · Copilot CLI · Crush · DeepSeek Harness · Reasonix Studio · Command Code · fx · Devin · Hermes Agent · Mis

Top issues

Latest release

Improvements

- Aligned route icons with their labels on the context card.

 Install

Download from usemagpie.ai, or curl -fsSL https://usemagpie.ai/install.sh | sh. An installed magpie updates itself.

- macOS (Apple Silicon): magpie-darwin-arm64.dmg
- macOS (Intel): magpie-darwin-amd64.dmg
- Windows: magpie-windows-amd64.exe (ARM: magpie-windows-arm64.exe)
- Linux: magpie-linux-amd64 / magpie-linux-arm64 (needs GTK 3 and WebKitGTK 4.1)
- Terminal only: magpie-cli--



 改进

- 对齐了路线图标与上下文卡片上的标签。

 安装

从 usemagpie.ai 下载，或运行 curl -fsSL https://usemagpie.ai/install.sh | sh。已安装的 magpie 会自动更新。



-