MoeRouter 文档 获取 API Key

用 Magpie 接入 MoeRouter

把 MoeRouter 添加为 Magpie 的自定义供应商,让 Codex、Claude Code 等 Agent 经本地网关访问模型,并统一查看用量。

更新于 2026-11-14 阅读约 2 分钟 实测:Magpie 0.1.4081 · macOS

本页目录
  1. 安装与首次打开
  2. 添加 MoeRouter 为自定义供应商
  3. 让 Agent 使用 Magpie
  4. 查看用量
  5. 撤回

Magpie(官网 usemagpie.ai)是一个本地模型网关:把多个模型来源集中管理,让 Claude Code、Codex、Claude Desktop 等 Agent 都经过它访问模型,并统计用量。它和同名的 Windows 画面缩放软件无关。

Magpie 需要常驻后台。只用一两个工具时,CC Switch 或手动配置更简单。

安装与首次打开#

从 GitHub Releases 下载 magpie-darwin-arm64.dmg(Intel 机型选 amd64),拖进“应用程序”后打开。首页的“快速上手”会列出 Magpie 在电脑上找到的 Agent,左下角显示本地网关地址 127.0.0.1:3425。

Magpie 首页的快速上手
快速上手分三步:添加模型来源、接入一个 Agent、(可选)设置路由。

添加 MoeRouter 为自定义供应商#

  1. 点 添加供应商,在列表右上角点 + 自定义供应商。

    Magpie 的供应商列表
    预置供应商很多,MoeRouter 用“自定义供应商”。
  2. 填写:

    • 名称:MoeRouter
    • Base URL:标签选 OpenAI 兼容,地址填 https://moerouter.com/v1
    • API 密钥:粘贴 MoeRouter Key
    • 证书:“不校验它的证书”保持不勾选
  3. 点 获取模型,从列表里勾选需要的模型,然后点 添加。

    填写自定义供应商并选择模型
    不勾选任何模型时,保存后会自动拉取全部模型。
  4. 添加后点开供应商,展开最下面的 更多端点,补上原生接口的地址:

    字段 填写
    Anthropic 地址 https://moerouter.com
    Responses 地址 https://moerouter.com/v1
    Gemini 地址 留空。Gemini CLI 建议直连 MoeRouter
    供应商详情
    供应商 ID 是 moerouter,Agent 里以 moerouter/模型名 的形式选择模型。
    更多端点里填好 Anthropic 和 Responses 地址
    填好之后,Claude 类客户端走 Messages、Codex 走 Responses,不需要 Magpie 做格式转换。点“保存”。

让 Agent 使用 Magpie#

回到 Agent 页,点 显示全部 Agent。每一行是一个检测到的客户端,右侧的开关就是“接入 Magpie”。

Magpie 的 Agent 列表
Claude Code 显示“未找到 CLI”时,先安装 Claude Code 并确认 claude 在 PATH 里,再点右上角刷新。

打开 Codex 那一行的开关,选一个模型:

Codex 已接入 Magpie
接入后 Magpie 会改写 ~/.codex/config.toml,让 Codex 访问本地网关。已经在运行的 Codex 会话要重开才会生效。

新开终端验证:

codex exec --skip-git-repo-check "只回复 OK,不要运行命令"
经 Magpie 发出的 Codex 请求
provider: magpie、model: moerouter/gpt-6.1-terra,请求经过 Magpie 到达 MoeRouter。

查看用量#

左侧的 用量 页按 Agent 和模型统计每次调用的 token、首字时间和估算费用。

Magpie 的用量页
Magpie 显示的是估算值。最终扣费以 MoeRouter 的使用日志为准。

撤回#

在 Agent 页关掉对应的开关(Disconnect),Magpie 会移除它写入的配置行;也可以执行 magpie uninstall。

退出 Magpie 后本地网关就停了。 仍然指向 127.0.0.1:3425 的客户端会连不上,所以要先断开再退出。

↑↓ 选择Enter 打开可以直接粘贴报错原文