Anthropic SDK 接入

Shuro 完整兼容 Anthropic 协议。把 base_url 指到 https://shuro.vip，官方 anthropic SDK（Python / TypeScript）即可直接调用 Claude 全系模型。

• Base URL：https://shuro.vip（注意：不带 /v1 后缀，SDK 自己会拼）
• 端点：POST /v1/messages
• API Key：控制台 → 「令牌」创建，见 获取 API Key

仅限 Claude 系列

Anthropic 协议只能调 Claude 系列模型。GPT 系列（gpt-5.5 / gpt-5.4 / gpt-5.4-mini）请走 OpenAI 协议 → OpenAI SDK 接入。反过来，Claude 全系两个协议都支持。

Python

pip install anthropic

from anthropic import Anthropic

client = Anthropic(
    base_url="https://shuro.vip",
    api_key="<您的 API Key>",
)

resp = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "用一句话解释什么是 API 中转"}],
)
print(resp.content[0].text)

TypeScript / Node.js

npm install @anthropic-ai/sdk

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

const client = new Anthropic({
  baseURL: "https://shuro.vip",
  apiKey: "<您的 API Key>",
});

const resp = await client.messages.create({
  model: "claude-sonnet-4-6",
  max_tokens: 1024,
  messages: [{ role: "user", content: "用一句话解释什么是 API 中转" }],
});
console.log(resp.content[0].type === "text" ? resp.content[0].text : "");

流式输出

Python

with client.messages.stream(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "写一首关于代码的短诗"}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

TypeScript

const stream = client.messages.stream({
  model: "claude-sonnet-4-6",
  max_tokens: 1024,
  messages: [{ role: "user", content: "写一首关于代码的短诗" }],
});
stream.on("text", (text) => process.stdout.write(text));
await stream.finalMessage();

环境变量方式

官方 SDK 会自动读取 ANTHROPIC_BASE_URL / ANTHROPIC_API_KEY：

export ANTHROPIC_BASE_URL="https://shuro.vip"
export ANTHROPIC_API_KEY="<您的 API Key>"

from anthropic import Anthropic

client = Anthropic()  # 自动读环境变量

ANTHROPIC_AUTH_TOKEN 与 ANTHROPIC_API_KEY

Claude Code 用的是 ANTHROPIC_AUTH_TOKEN（Bearer 认证）；SDK 直连推荐 ANTHROPIC_API_KEY（x-api-key 头）。Shuro 两种认证方式都接受，同一个令牌通用。

curl 快速验证

curl -sS https://shuro.vip/v1/messages \
  -H "x-api-key: <您的 API Key>" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-haiku-4-5-20251001",
    "max_tokens": 32,
    "messages": [{"role": "user", "content": "Reply with one word: pong"}]
  }'

返回 JSON 里看到 pong 即通。

进阶能力

• 扩展思考：在请求里加 thinking 参数即可开启显式思维链，详见 Thinking 参数。
• 提示缓存：给 system / messages 加 cache_control 标记，命中后按缓存读取倍率 0.1 计费（即输入价的 10%），详见 提示缓存优化。
• 工具调用 / 视觉：见 Function Calling、视觉能力。

可用模型

模型 ID	模型倍率	上下文
claude-opus-4-8	2.5	1M
claude-opus-4-7	2.5	1M
claude-opus-4-6	2.5	1M
claude-fable-5	5	1M
claude-sonnet-4-6	1.5	1M
claude-haiku-4-5-20251001	0.5	200K

倍率即成本系数：短任务/后台任务可选低倍率型号（如 claude-haiku-4-5-20251001，0.5）；高倍率型号为高能力档（如 claude-fable-5，5）。按自己的任务实测选择。

完整目录与倍率见 支持的模型、定价与计费。

常见错误速查

现象	跳转
401 Invalid token	401 排查
503 No available accounts	503 排查
其他错误码	错误代码对照表

下一步

• 终端 agentic 编程：Claude Code
• 混用 GPT 或已有 OpenAI 生态代码：OpenAI SDK 接入
• 省钱技巧：成本优化