Anthropic SDK: первые шаги с Claude API

uv add anthropic

import anthropic

# Явная передача ключа:
client = anthropic.Anthropic(api_key="sk-ant-api03-...")

# Или SDK сам читает ANTHROPIC_API_KEY из окружения:
client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Привет! Объясни что такое API."}
    ]
)

print(message.content[0].text)

client.messages.create(
    model="claude-sonnet-4-6",   # обязательно
    max_tokens=1024,             # обязательно
    system="Ты Python-тьютор.", # необязательно — задаёт роль
    temperature=0.7,             # необязательно — 0.0–1.0
    messages=[                   # обязательно
        {"role": "user", "content": "Первый вопрос"},
        {"role": "assistant", "content": "Первый ответ"},
        {"role": "user", "content": "Второй вопрос"},
    ]
)

message.id                      # уникальный ID запроса
message.model                   # модель которая ответила
message.stop_reason             # "end_turn" или "max_tokens"
message.content[0].text         # текст ответа
message.usage.input_tokens      # токены запроса (биллинг)
message.usage.output_tokens     # токены ответа (биллинг)

try:
    message = client.messages.create(...)
except anthropic.AuthenticationError:
    print("Неверный API-ключ. Проверь .env")
except anthropic.RateLimitError:
    print("Превышен лимит запросов — подожди немного")
except anthropic.APIConnectionError:
    print("Нет подключения к API Anthropic")
except anthropic.APIStatusError as e:
    print(f"Ошибка API {e.status_code}: {e.message}")

# Настройка количества попыток:
client = anthropic.Anthropic(
    api_key=API_KEY,
    max_retries=3,      # по умолчанию 2
    timeout=30.0,       # таймаут в секундах
)