WanAPIsWanAPIs
注册

用 Magpie 为 Claude Code / Codex 配置 WanAPIs

Magpie 是开源的模型与供应商管理工具，通过本地网关为 Claude Code、Codex 等 Agent 转发请求。和 CC Switch 一样，先添加 WanAPIs，再在 Magpie 的 Agent 页面选择模型并启用；仅导入供应商还不会改变现有客户端。

免费注册拿 Key 查看模型与价格

一键导入只预填接口地址，不含密钥。请在 Magpie 中填写自己的 Key 并确认，再到 Agent 页选择模型。

加入 Magpie（不含密钥）下载 Magpie打开 API 密钥与免费自检

一览

适用工具
已安装的 Claude Code、Codex 等 Magpie 支持的 Agent
供应商名称
WanAPIs
OpenAI / Responses 地址
https://api.wanapis.com/v1
Anthropic 地址
https://api.wanapis.com
API Key
WanAPIs 控制台中你自己的令牌，完整保留 sk- 前缀
计费
导入与控制台配置自检不调用模型；Agent 的真实模型请求按 WanAPIs 价格计费

接入步骤

  1. 1

    安装 Magpie，准备 WanAPIs 令牌

    从 Magpie 官网或官方 Releases 下载与你的 macOS、Windows 或 Linux 架构匹配的版本。打开应用；Claude Code / Codex 需要另外安装。在 WanAPIs 控制台的「API 密钥」页创建或选择自己的令牌，并确认可用分组、模型限制和账户资金来源。

    下载与令牌入口
    Magpie 官网：https://usemagpie.ai/#get
官方 Releases：https://github.com/yetone/magpie-releases/releases/latest
WanAPIs API 密钥：https://api.wanapis.com/keys
  2. 2

    一键加入 Magpie

    打开 WanAPIs 的 Agent 接入页，点击「加入 Magpie」，允许浏览器打开本机应用。在 Magpie 导入预览中核对名称与接口地址，手动填写自己的 API Key，点击添加并保存。已有同名供应商时先检查替换提示。公开入口不携带密钥；控制台令牌菜单也有「加入 Magpie」，默认不带令牌，只有你主动选择携带并再次确认时才交给本机应用。

    公开导入入口（不含密钥）
    https://wanapis.com/agents
  3. 3

    无法唤起应用时，手动添加供应商

    在 Magpie 的「供应商」页选择「添加供应商 → 自定义供应商」。名称填 WanAPIs，主 API 选择 OpenAI，Base URL 填下面的 /v1 地址，粘贴自己的 API Key。展开「更多端点」，补充 Anthropic 和 Responses 地址；主 API 对应的地址已在 Base URL 填写，无需重复。可以获取模型后选择所需模型，再保存。

    Magpie 自定义供应商
    Name: WanAPIs
API: OpenAI
Base URL: https://api.wanapis.com/v1
API Key: sk-xxx（替换为你自己的完整令牌）

更多端点 / More endpoints:
Anthropic URL: https://api.wanapis.com
Responses URL: https://api.wanapis.com/v1
  4. 4

    在 Agent 页面选择模型并启用

    进入 Magpie 的「Agent」页，找到已安装的 Claude Code 或 Codex，为该工具选择 WanAPIs 及其可用模型并启用。保留客户端需要的协议：Claude Code 使用 Anthropic 入口，Codex 使用 Responses 入口。模型名以你这把令牌可用的列表为准，不要只修改显示名称。添加供应商与为某个 Agent 启用是两个步骤。

  5. 5

    重启客户端，保持 Magpie 运行

    退出并重新打开正在运行的 Claude Code / Codex 会话；Codex 桌面应用或 IDE 内的会话也要重新启动或新建，让它读取新配置。Magpie 作为本地网关需要保持运行，关闭窗口后可留在托盘或菜单栏。准备好后再发真实请求；它可能产生费用，导入成功本身不代表上游连接已经验证。

  6. 6

    遇到问题先跑免费配置自检

    回到 WanAPIs 控制台「API 密钥」，打开对应令牌的菜单，选择「免费接入自检」，填写模型名并按客户端选 Anthropic 或 Responses，再点击运行。按结果检查令牌状态、模型限制和分组。自检不发上游请求、不扣费；它不能检查你本机的 Magpie 端口、Agent 配置或上游实时可用性，资金提示也不保证足够支付一次实际请求。

已知限制

  • 本文按 Magpie 官方文档与公开源码核对了配置流程，WanAPIs 的导入参数和界面已验证；未在本机完成 Magpie 导入保存或真实付费调用。不同版本的按钮位置可能变化。
  • Magpie 的模型列表可能只显示令牌首个有效分组的模型。模型不在列表时，先在 WanAPIs 控制台确认这把令牌的分组与限制，再按 Magpie 当前版本支持的方式添加确切模型 ID。
  • 不要同时让 Magpie 与 CC Switch 为同一个 Agent 写入配置，否则后启用的工具可能覆盖前者。需要改回其他工具时，先在 Magpie 中关闭该 Agent 的接管，再在目标工具中重新启用并重启会话。

常见问题

为什么导入后 Claude Code / Codex 仍走原来的供应商？

导入只添加供应商。还需在 Magpie 的 Agent 页面为目标工具选择 WanAPIs 的模型并启用，然后重启客户端或新开会话。已有进程不会自动读取所有配置变化。

OpenAI 和 Anthropic 为什么不是同一个 Base URL？

Magpie 的 OpenAI / Responses 字段填写 https://api.wanapis.com/v1；Anthropic 字段填写根地址 https://api.wanapis.com。不要把 /v1/messages 或 /v1/responses 的完整调用路径填进供应商地址，也不要重复加 /v1。

点击加入 Magpie 没反应怎么办？

确认应用已经安装并运行，允许浏览器打开 magpie 协议；如果仍无法唤起，按手动添加步骤填写相同地址和自己的 Key。无需把 Key 放进网页链接或发给他人。

免费自检通过后还会调用失败吗？

可能。自检只反映当前配置证据，真实连接、Magpie 本地转发、客户端协议、模型权限和足额预算仍需分别确认。没有在自检中调用模型，真实请求才可能收费。

已经用 CC Switch 配好，需要迁移吗？

不需要。如果现有配置稳定，可以继续用 CC Switch。选择 Magpie 时先保留原配置，在 Magpie 为同一个 Agent 启用前，避免另一套配置工具同时接管。

现在就把 Magpie 接到 WanAPIs

一个 API Key 调用 GPT、Claude、Gemini、DeepSeek、Kimi、GLM 等模型,国内直连、按 token 实付。

免费开始 完整文档