




magpie是一款面向AI开发者的本地模型网关工具,旨在解决多Agent环境下模型配置分散、额度管理困难的问题。它通过统一的本地服务接口,让Claude Code、Codex、Gemini CLI等不同工具能够灵活调用各类大模型资源,包括API密钥、本地模型以及已登录的订阅服务。
1.启动magpie应用,在主界面或设置菜单中找到“Providers”或“服务商管理”选项卡。

2.点击“添加供应商”按钮,从预设列表中选择对应的模型厂商,如Anthropic、OpenAI、DeepSeek、Kimi等。

3.输入有效的API Key,部分厂商还需要填写Base URL,若使用中转站请确保地址正确。

1.确保magpie网关已在本地运行,记录其监听地址,默认为http://127.0.0.1:3425。
2.打开终端或命令行工具,设置环境变量以指向magpie网关:export ANTHROPIC_BASE_URL=http://127.0.0.1:3425。
3.设置API密钥变量:export ANTHROPIC_API_KEY=magpie(此处使用固定值标识通过网关转发)。
4.在magpie应用中,进入“Agents”管理界面,找到Claude Code条目。
5.选择希望Claude Code使用的具体模型,例如claude-3-5-sonnet-latest。
6.magpie会自动修改Claude Code的底层配置文件,仅更新必要的键值对,保留原有注释和格式。
7.重启Claude Code会话,即可通过magpie网关调用配置的模型。
1.在magpie主界面进入“Routing Groups”(路由组)配置页面。
2.创建一个新的路由组,命名为如“daily-coding”或“backup-pool”。
3.向该组中添加多个成员模型,这些成员可以来自不同的Provider或同一Provider的不同账号。
4.选择合适的路由策略,推荐“smart”模式,它会优先选择剩余时间最长重置的订阅,最大化利用额度。
5.也可选择“order”模式按顺序尝试,或“rotate”轮询模式平衡负载。
6.在Agent配置中,将模型选择指向这个路由组名称,而非单一模型。
7.当当前使用的账号额度耗尽或报错时,网关会自动静默切换到下一个可用成员,用户无感知。
1.magpie原生支持数十种主流AI编程助手,包括但不限于Claude Code、Codex、Gemini CLI、Antigravity CLI。
2.支持编辑器内置AI,如VS Code Chat、VS Code Insiders、VSCodium Chat、JetBrains Air、Copilot (JetBrains)。
3.支持独立CLI工具,如OpenCode、MiMo Code、DevEco Code、Pi、oh-my-pi、StepCode、Aside、OmO、Prime Agent。
4.支持新兴AI代理,如Goose、Cursor CLI、Zed、Crush、DeepSeek Harness、Reasonix Studio、Command Code。
5.支持国产及特定场景Agent,如Kimi Code、Qwen Code、Muse Code、MiniMax Code、Droid、Cline、Qoder。
6.只要任何工具允许自定义Base URL和API Key,理论上均可通过magpie网关进行连接和管理。
| 操作功能 | Windows快捷键 | 说明 |
|---|---|---|
| 显示/隐藏面板 | Ctrl + Shift + M | 快速呼出菜单栏控制面板 |
| 切换当前模型 | Ctrl + Alt + K | 弹出可搜索的模型选择列表 |
| 打开设置 | Ctrl + , | 进入全局配置与Provider管理 |
| 刷新模型列表 | F5 | 从models.dev同步最新模型信息 |
| 退出程序 | Alt + F4 | 完全关闭magpie后台服务 |
| 项目 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | Windows 10 (64-bit) | Windows 11 / macOS / Linux |
| 内存 | 512 MB | 1 GB 及以上 |
| 磁盘空间 | 100 MB | 500 MB (含缓存) |
| 网络环境 | 稳定互联网连接 | 低延迟宽带,支持代理 |
| 依赖组件 | 无额外依赖 | Node.js (可选,用于部分插件) |
此内容由AI根据文章内容自动生成,并已由人工审核