Amp 在一年后重新开放 BYOK：连接和配置 AIHubMix
Amp 已经重新开放 BYOK（自带密钥），并且 AIHubMix 现在支持它。本文使用 Anthropic 的 Claude 模型作为示例，逐步介绍如何通过 自定义 URL 和 模型路由 将 Amp 指向 AIHubMix API，包括 API 密钥、模型名称映射和项目设置。
如果您正在搜索“设置 Amp BYOK”、“将 Amp 连接到 AIHubMix”、“AIHubMix API 密钥”、“Amp 自定义 URL”或“Amp 模型路由”，以下步骤将涵盖这些内容。
Amp 的用途是什么？
- 多模型工作流：将不同的模型分配给不同的模式和代理——Claude、GPT 或用于轻量工作的一种快速模型。
- 整个项目上下文：Amp 可以跨代码库读取、编辑文件、运行命令和执行测试。
- BYOK 和自定义路由：通过模型路由、自定义 URL 和第三方 API 服务选择自己的模型和提供者。
- Web 和 CLI 一起使用：在浏览器中配置模型，然后继续在终端中工作。
- 为团队而生：共享任何线程并与团队成员一起处理。
- 云同步线程：每个线程自动同步到云，因此您的团队始终从相同状态开始。
本指南的其余部分使用 Anthropic 的 Claude 模型展示如何将 AIHubMix 连接到 Amp。
为什么通过 AIHubMix 路由 Amp？ 一个密钥和一个基本 URL 可以访问 400 多个模型，端点与 Anthropic 消息 API 兼容（因此 Amp 可以原生与其通信），每个密钥的模型名称映射加上错误回退让您能够适应客户所期望的任何命名方式。 创建账户 →
第一部分 — 连接 API
步骤 1：打开个人设置
在 Amp 主屏幕上，点击左下角的 个人设置 。
步骤 2：添加自定义模型路由
在左侧边栏找到 模型路由 ，点击右侧的 添加 ，选择 自定义 URL。
步骤 3：创建 API 密钥并设置模型名称映射
前往 AIHubMix 控制台 并创建一个 API 密钥，然后在上面配置模型名称映射。
Amp 期望模型名称采用 provider/model 格式——例如 anthropic/claude-fable-5-1。AIHubMix 模型 ID 不带 provider/ 前缀，因此添加一个映射，将 Amp 发送的名称重写为 AIHubMix 提供的模型 ID：
| 别名（Amp 发送的内容） | 目标（AIHubMix 模型 ID） |
|---|---|
anthropic/claude-fable-5-1 | claude-fable-5-1 |
使用别名的请求将被重写为目标模型 ID。每个密钥支持最多 5 个映射，您还可以选择添加回退模型，当请求出错时按顺序重试。
步骤 4：填写连接详细信息
返回到 Amp 的 自定义 URL 屏幕，填写字段：
- API 密钥：您刚刚在 AIHubMix 中创建的密钥。
- API 格式：选择 与 Anthropic 消息 API 兼容。
- 基本 URL：
https://aihubmix.com—— Amp 在字段下方确认请求将发送到https://aihubmix.com/v1/messages。 - 模型：列出您映射的别名，每行一个（例如
anthropic/claude-fable-5-1）。Amp 将解析每一个，并在下面显示其显示名称。
保持 创建后激活 选中，以便新请求立即开始通过提供者路由，然后点击 创建。
步骤 5：验证连接
保存后， 模型路由 页面将列出您的新 自定义 URL。点击 检查访问 以测试连接。
有效的密钥将返回 有效密钥 以及 GET https://aihubmix.com/v1/models 探测，返回 HTTP 200 响应和可见模型的计数。下面的模型列表将显示此自定义 URL 可以访问的所有内容。
第二部分 — 创建项目和线程
步骤 6：创建项目
点击左下角的项目条目，然后在右上角点击新项目按钮。
选择 从头开始，输入项目名称，然后完成项目创建。
步骤 7：创建线程
在项目内，点击 新线程 以开始任务。
第三部分 — 分配模型并开始工作
步骤 8：为每个角色分配模型
返回到 个人设置 并打开 模式拨盘。每种模式会自动选择其模型；在这里您可以为模式的 主要代理、 Oracle 和 子代理 固定特定模型和推理努力。任何保留在 自动 上的内容将继续遵循 Amp 自身的路由。
步骤 9：选择模式并开始对话
点击 新线程 ，选择您想要的模式和模型，然后开始聊天或交给 Amp 一个开发任务。
这就是完整的设置。通过一个 AIHubMix 密钥，Amp 可以访问 Claude、GPT 和平台上的每个其他模型——您可以在不触及其余配置的情况下更换任何模式背后的模型。
- AIHubMix — https://aihubmix.com/
- Amp — https://ampcode.com/
