Claude 兼容协议

了解如何通过 Anthropic 官方原生协议（/v1/messages）将只支持 Claude 原生接口的客户端、CLI 编程工具及 Anthropic SDK 接入 OpenRely。

协议概述

对于某些专门针对 Anthropic 生态构建的客户端、命令行智能体（如 Claude Code 原生模式、部分沉浸式翻译插件、Claude Desktop 插件）以及使用官方 @anthropic-ai/sdk 的开发项目，通常只支持 Anthropic 原生 Messages 协议规范。

OpenRely API 原生支持 Anthropic /v1/messages 接口格式。您只需将请求 Base URL 重定向至 OpenRely，并填入您的 OpenRely API Key，即可免翻墙高速调用 Claude 等全球顶尖模型。

📌 核心连接规范

参数项	标准填写值	说明
API 服务地址 (Base URL)	`https://api.openrely.ai`	若客户端底层自动补齐 `/v1/messages`，填根域名即可；部分工具可能要求填 `https://api.openrely.ai/v1`
鉴权请求头 (Headers)	`x-api-key: sk-••••`	填入您的 OpenRely API Key（系统同时自动兼容 `Authorization: Bearer sk-••••`）
版本控制头 (Version)	`anthropic-version: 2023-06-01`	Anthropic 官方推荐的标准 API 版本号
数据格式	`Content-Type: application/json`	标准 JSON 请求与响应体

⚡ 核心端点与请求示例

消息创建 (Messages API)

Anthropic 官方核心的消息对话端点，原生支持 Thinking 深度思考过程、Prompt Caching 提示词缓存与工具调用。

端点：POST /v1/messages
完整 URL：https://api.openrely.ai/v1/messages

请求示例 (Request)

curl -X POST "https://api.openrely.ai/v1/messages" \
  -H "x-api-key: sk-••••" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello Claude!" }
    ]
  }'

响应示例 (Response)

{
  "id": "msg_01XyZ987...",
  "type": "message",
  "role": "assistant",
  "model": "claude",
  "content": [
    {
      "type": "text",
      "text": "Claude message routed."
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 11,
    "output_tokens": 18
  }
}

🛠️ 客户端与 SDK 快速集成

from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.openrely.ai",
    api_key="sk-your-openrely-key",
)

message = client.messages.create(
    model="claude",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "用一句话介绍你自己"}
    ],
)

print(message.content[0].text)

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

const anthropic = new Anthropic({
  baseURL: 'https://api.openrely.ai',
  apiKey: 'sk-your-openrely-key',
});

const response = await anthropic.messages.create({
  model: 'claude',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'Hello Claude!' }],
});

console.log(response.content[0].text);

若您使用的第三方 CLI 工具遵循 Anthropic 官方环境变量命名规范，可在终端中直接执行：

export ANTHROPIC_BASE_URL="https://api.openrely.ai"
export ANTHROPIC_API_KEY="sk-your-openrely-key"