一键接入指南

HyperAI Relay 与 Anthropic 官方 API 完全兼容,只需把客户端的 Base URL 指向 https://api.hyper-ailab.com,API Key 用你自己的 sk-relay-...,就可以在 熟悉的工具里获得 Opus 4.7 的满血质量 + Memory 持久记忆。

本指南配套控制台的 /app/connect 页面,在页面上点击"复制配置"可直接拿到 下列代码片段。

在开始前

  1. 注册并登录 hyper-ailab.com
  2. 进入 Key 管理,生成一个新 Key 并妥善保存
  3. 账户余额 ≥ $1 即可开始使用(Standard 计费约 $0.015 / 千 token output)

下文所有配置中出现的 sk-relay-YOUR_KEY_HERE 请替换为你的真实 key。

Cursor(写代码首选)

Cursor 原生支持 Anthropic base URL,打开 Settings → Models → Add Provider, 粘贴以下配置:

{
  "provider": "anthropic",
  "apiBase": "https://api.hyper-ailab.com",
  "apiKey": "sk-relay-YOUR_KEY_HERE",
  "model": "claude-opus-4-7"
}

重启 Cursor 后,模型列表里会出现 claude-opus-4-7,直接选即可。 Cmd/Ctrl+K 编辑、Cmd/Ctrl+L 对话都会走 HyperAI Relay。

在 Cursor 里用 Memory

在 Cursor Rules(.cursorrules 或 .cursor/rules/*.md)中加入:

You may use the memory_20250818 tool to persist user preferences across
sessions. Read /memories at session start.

Opus 4.7 会自动在 /memories/ 下维护用户偏好、项目背景、已解决问题等上下文。

Claude Desktop(Mac / Windows)

  1. 打开 Claude Desktop → Settings → Developer → Edit Config
  2. 在 mcpServers 字段下新增:
{
  "mcpServers": {
    "hyper-ailab": {
      "command": "npx",
      "args": [
        "@anthropic-ai/mcp-server-relay",
        "https://api.hyper-ailab.com"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "sk-relay-YOUR_KEY_HERE"
      }
    }
  }
}
  1. 重启 Claude Desktop

如果你不熟悉 MCP,直接用 Chatbox(下面)会更简单 —— Chatbox 只要点一下 deep link 就能自动配置。

Chatbox(推荐 · 国内/移动端)

Chatbox 是开源跨平台 LLM 客户端,支持 Windows / Mac / Linux / Android / iOS, 国内网络环境下直连 HyperAI Relay 比官方 claude.ai 更稳定。

最简单的方式是在 /app/connect 页面直接点 🚀 一键导入到 Chatbox 按钮,Chatbox 会自动打开并预填配置。打开后只需要把配置里的 REPLACE_ME 替换为你的真实 key 即可。

也可以手动配置:

  1. 打开 Chatbox → Settings → AI Provider → Add Custom Provider
  2. 填写:
  3. Provider Name:HyperAI Relay
  4. API Type:Claude
  5. Base URL:https://api.hyper-ailab.com
  6. API Key:你的 sk-relay-...
  7. Model:claude-opus-4-7(或 claude-sonnet-4-6 / claude-haiku-4-5)

没装 Chatbox?点这里下载。

常见问题

为什么复制了配置却连不上?

最常见原因: 1. sk-relay-YOUR_KEY_HERE 没改成真实 key 2. 代理工具(Clash / Surge)把 api.hyper-ailab.com 分流到了错误的节点 —— 加到直连列表即可 3. 账户余额为 0 —— 去 充值 兑换

能用 Claude Code / Cline / Aider 吗?

可以,见 客户端接入详解。任何支持 ANTHROPIC_BASE_URL 环境变量的客户端都可以通过设置:

export ANTHROPIC_BASE_URL=https://api.hyper-ailab.com
export ANTHROPIC_API_KEY=sk-relay-YOUR_KEY_HERE

直接接入。

能先试用再接入吗?

可以,/try 提供 10 轮免费试用 + Memory 功能完整演示,不需要先配置。 体验满意后再去 /app/connect 把 key 接到你熟悉的工具。

下一步