Skip to content

Magpie 使用教程 ​

把模型来源集中管理,再为各个 Agent 选择合适的模型。 Magpie 可以管理 API 服务、受支持的登录账号和本地模型,通过本地网关提供给不同 Agent 使用。

你仍然在原来的 Agent 里聊天或工作。Magpie 主要负责模型连接、配置与路由,适合同时使用多个 Agent 或多个模型来源的人。

Magpie 本机 Agent 页面,显示添加模型来源、接入 Agent 与可选路由设置
本机 0.1.1235 的 Agent 页面。先添加模型来源,再决定哪些 Agent 使用它;路由是后续可选功能。点击查看静态大图 →

返回软件总览 · 查看这些软件如何配合

先分清三个名称 ​

名称在 Magpie 中的含义
供应商模型从哪里来,例如 API 服务、支持的订阅账号或本地模型服务器
模型实际回答问题的模型,通常显示为供应商与模型的组合
Agent你正在使用的工作软件,例如 Claude Code、Codex、OpenCode 等

Agent 通过 Magpie 使用模型

  1. 你常用的 Agent接收问题、调用工具、完成工作。
  2. Magpie 本地网关按你的选择接入模型,必要时执行路由。
  3. 模型来源API 服务、支持的账号或本地模型服务器。
本地网关是连接入口。模型是否在本机运行,要看你选的是本地模型还是远程服务。

认识主要页面 ​

桌面窗口顶部或侧边栏提供 Agent、会话、资源库、供应商、路由、网关、用量、插件 等入口。

第一次使用,先看“供应商”和“Agent”。连接稳定以后,再逐步了解路由、用量与资源库,不必一次把所有功能配置完。

添加一个模型来源 ​

进入“供应商”,点击“添加供应商”。界面会按类型列出可用来源,例如订阅登录、模型厂商 API、中转服务和本机模型。

Magpie 添加供应商界面,按订阅、插件与模型厂商分类
本机添加供应商界面。不同入口的授权方式不同;选择类型后,再看它要求填写什么。点击查看静态大图 →

API 服务通常需要在服务商处取得密钥,选择对应预设后填写。预设会带入常用端点,第一次只处理必填项。

订阅账号按对应登录流程连接。可用模型、额度和接入方式随服务变化;能看到入口,不代表任意账号或套餐都能使用。

本地模型则连接到已经运行的本机服务,例如 Ollama 或 LM Studio。模型运行的位置和服务地址都要与实际环境一致。

Magpie 新增 API 服务的空白密钥表单
本机打开的 API 服务表单,密钥未填写、配置未提交。请求头、并发和额外请求体等选项可以在有具体需要时再调整。点击查看静态大图 →

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

Magpie 已连接供应商列表,个人账号信息已遮挡
本机供应商列表,账号信息已遮挡。供应商开关与 Agent 接入开关属于不同层次:有模型来源,并不表示每个 Agent 都已经使用它。点击查看静态大图 →

为 Agent 选择模型 ​

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

Magpie 官方模型选择器,按供应商展示模型
官方模型选择器示例。模型名称随供应商列表更新,截图中的名称不是固定必选项。点击查看静态大图 →

选择模型或启用接入可能修改该 Agent 的本地配置,因此这一步要有明确目的。改好后按提示启动或新建会话,再让它完成一个短任务,确认当前模型能实际回答。

选择“默认”通常表示回到 Agent 自己的模型或连接方式,但具体效果取决于该 Agent 的集成。以页面上的状态说明为准,不能只凭一个模型名字判断请求一定经过 Magpie。

路由组有什么用 ​

一个路由组可以把多个模型或账号作为一个选择入口。你在 Agent 中选组名,Magpie 再按组里的规则决定把请求交给谁。

把多个候选模型组织成一个入口

  1. 选择一个组Agent 使用组名,不必逐个切换候选。
  2. 按规则选择顺序、轮换、用量等策略决定请求去向。
  3. 获得回答失败时是否切换,以及如何切换,取决于组的设置。
常见模式作用
顺序(order)优先使用前面的成员,不可用时再尝试后面的成员
轮换(rotate)在成员之间轮换分配请求
用量(usage)优先选择使用较少的成员
智能(smart)结合订阅剩余额度与重置情况选择成员
Magpie 官方路由视图,展示 Agent 与模型来源之间的请求关系
官方路由视图示例,用于观察请求从哪个 Agent 进入、发往哪个来源。它是模型路由,与 FlClash 的网络代理不是一回事。点击查看静态大图 →

第一次可以先使用一个稳定来源。只有在你确实需要后备、轮换或多账号管理时,再创建路由组。组里的每个候选都需要有可用权限和正确配置。

用量、方案与资源库 ​

用量页面集中显示请求、Token、缓存和费用等信息。费用可能按模型标价估算,不能直接当作服务商已经扣款的账单。

**方案(Profiles)**保存一组 Agent 设置,方便在不同工作配置间切换。保存前先把当前配置调好,并给方案起一个自己能理解的名字。

资源库用于集中维护指令、Skills 和 MCP 配置,再按各 Agent 的格式分发。它影响的是工作说明与工具配置,和模型供应商页面的用途不同。

常见问题 ​

为什么列表里没有我安装的 Agent?

先使用 Agent 页的重新检测入口。软件是否安装、命令是否可发现,以及 Magpie 当前版本是否支持该集成,都会影响结果。不要为了显示一个条目而重复安装多个副本。

模型已经选中,但原来的对话仍没变?

先看接入状态,再按提示开启新会话或使用 Magpie 提供的启动方式。已经运行的会话可能还保留旧配置。

它和 CodexBar、FlClash 有什么区别?

Magpie 管理模型与 Agent 的连接;CodexBar 侧重显示额度与用量;FlClash 管理网络流量去向。三者都可能出现“代理”或“用量”等词,但作用层次不同。

本篇本机界面来自 0.1.1235;官方功能资料查阅于 2026-10-15。仅查看页面与未提交表单,没有修改现有 Agent 接入或模型配置。GitHub · 官方快速开始 · 功能参考。

微信联系

李不凯的个人微信二维码,扫码添加好友

使用微信扫一扫,手机上可长按保存二维码