客户端接入指南

HyperAI Relay 与 Anthropic 官方 API 完全兼容,只需将客户端的 ANTHROPIC_BASE_URL(或等价配置)改为 https://api.hyper-ailab.com,把 API Key 改为你在控制台生成的 sk-relay-v1-...,就可以像使用官方 Anthropic API 一样使用。

已验证支持的客户端

Claude Code(Anthropic 官方 CLI)

最佳适配。设置环境变量后直接运行:

export ANTHROPIC_BASE_URL=https://api.hyper-ailab.com
export ANTHROPIC_API_KEY=sk-relay-v1-你的key
claude

也可以写进 shell rc(~/.zshrc / ~/.bashrc)永久生效。

Cline(VSCode 插件)

Cline 和它的 fork Roo Code / Kilo Code 都原生支持 Anthropic 自定义 Base URL:

  1. 打开 Cline 插件的 Settings(齿轮图标)
  2. API Provider 选 Anthropic
  3. 勾选 Use custom base URL
  4. Base URL 填 https://api.hyper-ailab.com
  5. API Key 填 sk-relay-v1-...
  6. Model 选 claude-sonnet-4-5 / claude-haiku-4-5 等

Aider

Aider 通过 LiteLLM 后端支持 Anthropic,只需环境变量:

export ANTHROPIC_API_KEY=sk-relay-v1-你的key
export ANTHROPIC_API_BASE=https://api.hyper-ailab.com
aider --model anthropic/claude-haiku-4-5

或者使用 openai/ 前缀接入(如果本服务将来支持 OpenAI 兼容模式)。

OpenCode

SST 团队出的 Claude Code 风格终端工具,支持 Anthropic base URL 自定义,配置方法与 Claude Code 相同。

Anthropic Python SDK

from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.hyper-ailab.com",
    api_key="sk-relay-v1-你的key"
)

message = client.messages.create(
    model="claude-haiku-4-5",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude!"}
    ]
)

print(message.content)

安装:

pip install anthropic

Anthropic Node.js SDK

使用 Node.js SDK 接入：

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  baseURL: 'https://api.hyper-ailab.com',
  apiKey: 'sk-relay-v1-你的key'
});

async function main() {
  const message = await client.messages.create({
    model: 'claude-haiku-4-5',
    max_tokens: 1024,
    messages: [
      { role: 'user', content: 'Hello, Claude!' }
    ]
  });
  console.log(message.content);
}

main();

确保已安装最新版本的 SDK：

npm install @anthropic-ai/sdk

curl 复杂请求示例

Tool Use 请求

curl https://api.hyper-ailab.com/v1/messages \
  -H "x-api-key: sk-relay-v1-你的key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-haiku-4-5",
    "max_tokens": 1024,
    "tools": [
      {
        "name": "get_weather",
        "description": "获取指定城市的天气",
        "input_schema": {
          "type": "object",
          "properties": {
            "city": {"type": "string", "description": "城市名称"}
          },
          "required": ["city"]
        }
      }
    ],
    "messages": [
      {"role": "user", "content": "北京今天天气怎么样？"}
    ]
  }'

流式请求（带 Tool Use）

curl https://api.hyper-ailab.com/v1/messages \
  -H "x-api-key: sk-relay-v1-你的key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-haiku-4-5",
    "max_tokens": 1024,
    "stream": true,
    "tools": [
      {
        "name": "get_weather",
        "description": "获取指定城市的天气",
        "input_schema": {
          "type": "object",
          "properties": {
            "city": {"type": "string", "description": "城市名称"}
          },
          "required": ["city"]
        }
      }
    ],
    "messages": [
      {"role": "user", "content": "上海今天天气怎么样？"}
    ]
  }'

所有工具的接入方式与官方 API 完全一致,HyperAI Relay 不做任何修改地透传请求和响应。

不直接支持的客户端

以下工具暂时无法直接接入 HyperAI Relay,因为它们不支持自定义 Anthropic Base URL:

  • Cursor:Cursor 目前只接受 Anthropic 官方 endpoint 作为 Anthropic provider,无法 override base URL。如需使用可通过 LiteLLM 或其他代理中转。
  • 任何只接受 OpenAI 兼容格式的客户端:HyperAI Relay 当前只提供 Anthropic 原生 API,不提供 OpenAI 兼容层。未来版本可能会加。

如果你用的工具不在本指南列表里,判断能否接入的方法:

  1. 看文档是否支持 ANTHROPIC_BASE_URL 环境变量或类似 "自定义 endpoint" 选项
  2. 能 → 就能用
  3. 不能 → 暂时不行

有支持建议告诉我们:admin@hyper-ailab.com。