Claude 兼容接口

使用 Anthropic Messages 协议的客户端(Claude Code、Anthropic SDK 等)可以直接接入:把 base URL 指向 https://inferstream.cn/claude,Key 填到 ANTHROPIC_API_KEY,模型名填模型库里的任意模型名,不限于 Claude 系列。网关会把 Messages 请求翻译给对应上游,流式同样支持。鉴权头用 x-api-key,也接受 Authorization: Bearer。

Claude Code

Claude Code 只认三个环境变量。设好后照常启动,ANTHROPIC_MODEL 可以指到模型库里的任意模型名;不设则用客户端默认的 Claude 模型名,前提是模型库里有这个名字。

Claude Code / 环境变量
export ANTHROPIC_BASE_URL=https://inferstream.cn/claude
export ANTHROPIC_API_KEY=sk-...
# 可选:把默认模型指到模型库里的任意模型名
export ANTHROPIC_MODEL=deepseek-chat

也可以写进 ~/.claude/settings.json 的 env 字段,效果相同。Claude Code 的 cache_control 与工具调用在上游是 Anthropic 时原样透传,见下方的参数差异。

Cursor

Cursor 的自定义地址走 OpenAI 协议,不走 Claude 入口:在 Settings → Models 里把 OpenAI API Key 填成你的 Key,勾选 Override OpenAI Base URL 填 https://inferstream.cn/v1,再把要用的模型名加为自定义模型即可。

提示

以上步骤对应 Cursor 当前的设置界面,版本不同时入口名称可能有差异;核心只有两项:base URL 与 Key。

请求示例

Python(anthropic SDK)
from anthropic import Anthropic

client = Anthropic(base_url="https://inferstream.cn/claude", api_key="sk-...")

message = client.messages.create(
    model="deepseek-chat",
    max_tokens=1024,
    messages=[{"role": "user", "content": "用一句话介绍杭州。"}],
)
print(message.content[0].text)
POST /claude/v1/messages
curl https://inferstream.cn/claude/v1/messages \
  -H "x-api-key: $INFERSTREAM_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'

Node.js 的 @anthropic-ai/sdk 同样通过构造参数 baseURL 与 apiKey 改地址。GET /claude/v1/models 返回 Claude 格式的模型列表。

参数与差异

场景行为
上游是 Anthropiccache_control、thinking、tools 原样透传,响应回填 usage.cache_read_input_tokens 与 cache_creation_input_tokens。
上游是其他供应商thinking 按推理参数翻译,cache_control 丢弃、不报错。
多模型回退models 字段在这条接口同样可用,规则见对话补全。
错误以 Anthropic 的 { type: "error", error: {…} } 形状返回,状态码含义见错误码与限流。
费用查询用 message.id 查费用查询接口。