# 用 Magpie 为 Claude Code / Codex 配置 WanAPIs

> 在 Magpie 中导入 WanAPIs，配置 OpenAI、Responses 和 Anthropic 接口，再为 Claude Code、Codex 选择模型。含手动填写方法、免费配置自检与常见问题。

网页版:https://wanapis.com/docs/magpie

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

## 一览

| 项目 | 取值 |
| --- | --- |
| 适用工具 | 已安装的 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. 安装 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. 一键加入 Magpie

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

**公开导入入口（不含密钥）**

```
https://wanapis.com/agents
```

### 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. 在 Agent 页面选择模型并启用

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

### 5. 重启客户端，保持 Magpie 运行

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

### 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 启用前，避免另一套配置工具同时接管。

---

本文由 WanAPIs 官网生成,和网页版内容同步。全部教程的 Markdown 目录:https://wanapis.com/docs/index.md