Magpie 使用教程
把模型来源集中管理,再为各个 Agent 选择合适的模型。 Magpie 可以管理 API 服务、受支持的登录账号和本地模型,通过本地网关提供给不同 Agent 使用。
你仍然在原来的 Agent 里聊天或工作。Magpie 主要负责模型连接、配置与路由,适合同时使用多个 Agent 或多个模型来源的人。

先分清三个名称
| 名称 | 在 Magpie 中的含义 |
|---|---|
| 供应商 | 模型从哪里来,例如 API 服务、支持的订阅账号或本地模型服务器 |
| 模型 | 实际回答问题的模型,通常显示为供应商与模型的组合 |
| Agent | 你正在使用的工作软件,例如 Claude Code、Codex、OpenCode 等 |
Agent 通过 Magpie 使用模型
- 你常用的 Agent接收问题、调用工具、完成工作。
- Magpie 本地网关按你的选择接入模型,必要时执行路由。
- 模型来源API 服务、支持的账号或本地模型服务器。
认识主要页面
桌面窗口顶部或侧边栏提供 Agent、会话、资源库、供应商、路由、网关、用量、插件 等入口。
第一次使用,先看“供应商”和“Agent”。连接稳定以后,再逐步了解路由、用量与资源库,不必一次把所有功能配置完。
添加一个模型来源
进入“供应商”,点击“添加供应商”。界面会按类型列出可用来源,例如订阅登录、模型厂商 API、中转服务和本机模型。

API 服务通常需要在服务商处取得密钥,选择对应预设后填写。预设会带入常用端点,第一次只处理必填项。
订阅账号按对应登录流程连接。可用模型、额度和接入方式随服务变化;能看到入口,不代表任意账号或套餐都能使用。
本地模型则连接到已经运行的本机服务,例如 Ollama 或 LM Studio。模型运行的位置和服务地址都要与实际环境一致。

添加完成后回到供应商列表,检查模型是否已经出现。账号或密钥只在自己的配置中保存,不放进教程截图或聊天示例里。

为 Agent 选择模型
打开“Agent”页面,找到对应软件。Magpie 会显示检测到的 Agent、当前模型和接入状态。点击模型选择位置,按供应商或关键词查找,再选择需要的模型。

选择模型或启用接入可能修改该 Agent 的本地配置,因此这一步要有明确目的。改好后按提示启动或新建会话,再让它完成一个短任务,确认当前模型能实际回答。
选择“默认”通常表示回到 Agent 自己的模型或连接方式,但具体效果取决于该 Agent 的集成。以页面上的状态说明为准,不能只凭一个模型名字判断请求一定经过 Magpie。
路由组有什么用
一个路由组可以把多个模型或账号作为一个选择入口。你在 Agent 中选组名,Magpie 再按组里的规则决定把请求交给谁。
把多个候选模型组织成一个入口
- 选择一个组Agent 使用组名,不必逐个切换候选。
- 按规则选择顺序、轮换、用量等策略决定请求去向。
- 获得回答失败时是否切换,以及如何切换,取决于组的设置。
| 常见模式 | 作用 |
|---|---|
| 顺序(order) | 优先使用前面的成员,不可用时再尝试后面的成员 |
| 轮换(rotate) | 在成员之间轮换分配请求 |
| 用量(usage) | 优先选择使用较少的成员 |
| 智能(smart) | 结合订阅剩余额度与重置情况选择成员 |

第一次可以先使用一个稳定来源。只有在你确实需要后备、轮换或多账号管理时,再创建路由组。组里的每个候选都需要有可用权限和正确配置。
用量、方案与资源库
用量页面集中显示请求、Token、缓存和费用等信息。费用可能按模型标价估算,不能直接当作服务商已经扣款的账单。
**方案(Profiles)**保存一组 Agent 设置,方便在不同工作配置间切换。保存前先把当前配置调好,并给方案起一个自己能理解的名字。
资源库用于集中维护指令、Skills 和 MCP 配置,再按各 Agent 的格式分发。它影响的是工作说明与工具配置,和模型供应商页面的用途不同。
常见问题
为什么列表里没有我安装的 Agent?
先使用 Agent 页的重新检测入口。软件是否安装、命令是否可发现,以及 Magpie 当前版本是否支持该集成,都会影响结果。不要为了显示一个条目而重复安装多个副本。
模型已经选中,但原来的对话仍没变?
先看接入状态,再按提示开启新会话或使用 Magpie 提供的启动方式。已经运行的会话可能还保留旧配置。
它和 CodexBar、FlClash 有什么区别?
Magpie 管理模型与 Agent 的连接;CodexBar 侧重显示额度与用量;FlClash 管理网络流量去向。三者都可能出现“代理”或“用量”等词,但作用层次不同。
本篇本机界面来自 0.1.1235;官方功能资料查阅于 2026-10-15。仅查看页面与未提交表单,没有修改现有 Agent 接入或模型配置。GitHub · 官方快速开始 · 功能参考。