Magpie

用 Magpie 为 Claude Code、Codex 等工具统一管理 API 和模型。推荐从主站“我的密钥”一键导入，按下面三步开始使用。

1. 安装并打开 Magpie

前往 Magpie 官网，按你的系统下载安装。也请先安装你要使用的 Claude Code 或 Codex。

2. 从“我的密钥”一键导入（推荐）

1. 打开 AruHub 我的密钥，找到一把启用中的密钥。
2. 点击该密钥右侧操作区的 快捷接入 按钮，在面板中选择 magpie。
3. 选择要使用的工具和模型，例如 Claude Code 或 Codex。模型以当前密钥可用的列表为准。
4. 点击 导入到 magpie；浏览器提示打开客户端时，选择打开 Magpie。
5. 在 Magpie 中核对并确认导入供应商，再按下一步为 Agent 选择模型。

地址、密钥和所选模型会随导入带入，不用逐项复制粘贴。导入后仍需在 Magpie 中为 Agent 选择模型。

如果没有打开客户端，先确认 Magpie 已安装并启动，再回到主站重试。导入链接包含当前密钥，请勿分享给他人。

没有成功导入？展开手动填写方式

打开 供应商 → ＋ 添加供应商 → 自定义，填写下面的信息并保存。

项目	填写内容
名称	AruHub
OpenAI 兼容地址	https://api.aruhub.com/v1
Anthropic 兼容地址	https://api.aruhub.com
API 密钥	在 AruHub 控制台 创建的 API Key

可以同时填写两个地址。地址栏只填上面的 Base URL，不用再加 /chat/completions 或 /messages。

密钥需要填进 Magpie；只在终端里设置 API Key 环境变量，不会自动同步到这里。

3. 给 Agent 选模型，开新会话

1. 打开 Agent 标签页，找到 Claude Code 或 Codex。
2. 点击当前模型，选择 AruHub 下可用的模型。列表里没有时，可以输入完整模型 ID；以你的密钥可用模型为准，名称可在 模型广场 核对。
3. 重新打开工具并开始新会话。使用 Codex 时，请重启 Codex 应用或终端里的 codex。
4. 发一句“你好”。收到正常回复后，可在 Magpie 的 用量 页查看这次请求。

Magpie 会替你写入 Agent 配置，按这条流程接入时，无需再手动改配置文件。

使用时保持 Magpie 运行

请求会经过 Magpie 的本地网关。关闭窗口后可以留在托盘运行；如果完全退出，接入它的 Agent 会连不上。

遇到问题先看这里

情况	怎么处理
看不到 Claude Code 或 Codex	确认工具已安装并启动过，然后重新打开 Magpie
换模型后还是旧模型	结束旧会话，再开新会话；Codex 需要重启
提示 401	检查 Magpie 中保存的 API Key 是否正确、有效
提示 404 或找不到模型	核对上面的两个地址，以及模型 ID 和密钥权限
想恢复工具原来的接入方式	在 Magpie 的模型列表里选回 Agent 自带的默认模型

接入方式参考：Magpie 官方快速上手。