magpie

菜单栏一键换模型，Codex 也能跑 DeepSeek

开源 unknown 开发框架

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 13399

维护状态活跃

是否开源是

定价模式 unknown

项目预览

项目数据

分类开发框架

开发团队yetone

所属国家

官网地址https://usemagpie.ai

GitHubhttps://github.com/yetone/magpie

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言Go

技术栈/模型claude-code,codex,deepseek,gemini-cli,llm,macos

GitHub 星标★ 13399

30天Star增速

HF 下载量

上线时间2026-09-23 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-16

浏览次数0

项目介绍

Magpie 是一个运行在 macOS 菜单栏的轻量工具，解决 AI 编程代理模型选择受限的问题。它把 Codex、Claude Code、Gemini CLI 等主流编码代理与 DeepSeek、Kimi 等第三方大模型打通，让你在菜单栏一键切换：Codex 跑 DeepSeek、Claude Code 跑 Kimi，无需改配置或重装工具。核心能力包括统一管理多代理与多模型映射、菜单栏快速切换、本地代理转发请求，以及集中查看当前会话使用的模型。用 Go 编写，体积小、启动快，适合想用便宜或特定模型驱动编码代理的开发者，也方便对比不同模型在同一代理下的实际表现。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：本地安装 5 步

环境要求

macOS 系统（magpie 是运行在菜单栏的应用，Mac 构建已签名并公证）
用于第三方模型的 API Key（如 DeepSeek、Kimi），或已登录的订阅账号
可选：已安装 Go 环境（仅在使用 go install 方式安装时需要）
可选：Docker（README 提供了 Docker 镜像方案，详见官方文档）

安装与启动步骤

1安装 magpie

从官网下载应用，或执行脚本安装；网络受限时可在脚本参数中使用 --proxy 或 --mirror，也可用 go install 或 Docker 镜像。
```
curl -fsSL https://usemagpie.ai/install.sh | sh
```
2添加模型服务商

打开 magpie，进入 Providers → Add provider，选择预设并粘贴 Key，或直接登录订阅账号；命令行等价写法如下。
```
magpie provider add deepseek sk-xxxxxxxx
```
3为代理指定模型

在 Agents 页面为每个编码代理选一个模型，然后开一个新会话即生效；也可用命令行把 Claude Code 指到 DeepSeek、Codex 指到 Kimi。
```
magpie claude deepseek/deepseek-v4-pro
magpie codex moonshot/kimi-k2.5
```
4按需组合与配置档

可以把多个模型组成一个组实现智能路由和故障切换，也可以保存/切换配置档（profiles），避免重复手工设置。
```
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
```
5查看额度与终端界面

用 magpie quota 查看每个 Key、套餐和账号的余额与额度窗口，或直接运行 magpie tui 在终端里完成全部操作。
```
magpie quota
magpie tui
```

关键配置

配置项	必填	说明	示例
`MAGPIE_NO_ACCOUNTS`	否	设为 1 时，本次运行不读取代理的订阅登录信息，不改动已保存的设置	`1`
`--proxy`	否	防火墙后安装脚本使用的代理参数	`--proxy`
`--mirror`	否	防火墙后安装脚本使用的镜像参数	`--mirror`

如何确认成功

运行 magpie quota 能列出各套餐余额，或 magpie tui 能正常打开终端界面，即说明安装与配置成功。

常见问题

Q：不想让 magpie 读取我的订阅账号登录信息怎么办？

A：关闭 Settings → Privacy → Subscription accounts，或执行 magpie accounts discovery off（用 on 重新打开）；临时关闭可设环境变量 MAGPIE_NO_ACCOUNTS=1，API Key 方式的服务商不受影响。

Q：公司网络或防火墙下安装脚本跑不通怎么办？

A：在安装脚本后追加 --proxy 或 --mirror 参数走代理或镜像；也可以改用 go install github.com/yetone/magpie@latest 或官方 Docker 镜像安装。

Q：切换模型需要重装或改代理工具的配置文件吗？

A：不需要。magpie 会把代理真正读取的那一个关键配置改写掉，在 Agents 页面或命令行切换后，开一个新会话就使用新模型。

Q：怎么知道哪个模型更省钱或表现更好？

A：magpie 会统计 Token、缓存读写、推理与调用次数，并按标价换算成美元或人民币成本，还可以自定义任意模型的单价，按会话和账号查看账单。

注意事项

magpie 读取 Claude Code、Codex 等代理的登录文件以及 Keychain 来发现订阅账号，介意隐私请在设置中关闭该功能。
Mac 版本已签名并公证，且每个构建都会自我更新，无需手动升级。
README 中出现的模型名（如 deepseek/deepseek-v4-pro、moonshot/kimi-k2.5）是示例，实际可选模型以你所在账号和服务商为准。
Docker 安装方式官方只给出了文档链接，请以 usemagpie.ai/docs/docker 的最新说明为准。

核心亮点

菜单栏一键切换模型与代理组合，省去改配置重启的麻烦
支持 Codex、Claude Code、Gemini CLI 与 DeepSeek、Kimi 等第三方模型交叉搭配
Go 编写，常驻菜单栏资源占用低，本地转发请求便于统一管理

不足之处

目前仅支持 macOS，Windows 和 Linux 用户无法使用
依赖各代理的接口协议，上游更新后可能出现兼容问题

适用场景

想用 DeepSeek 的低价额度驱动 Codex 写代码
在 Claude Code 里切换 Kimi 对比同一任务的效果
同时管理多个编码代理，按项目快速切换默认模型

替代项目

LiteLLM、OpenRouter

上一篇：awesome-adk-agents

下一篇：没有了！