Интеграция API Claude в ваше приложение

В первый день интеграция Claude API невелика по объёму: установка SDK и один вызов с аутентификацией. Но готовность к промышленной эксплуатации определяется тем, что окружает этот вызов: потоковой передачей, повторными попытками, бюджетами токенов и наблюдаемостью. Это руководство охватывает весь путь и содержит рабочий код, который можно сразу адаптировать.

Аутентификация и ваш первый запрос

Установите официальный SDK (pip install anthropic или npm install @anthropic-ai/sdk), задайте ключ в переменной окружения — никогда не храните его в исходном коде — и выполните один вызов Messages API, чтобы проверить всю цепочку. Версия API задаётся заголовком anthropic-version, который SDK устанавливают за вас.

Ключи работают одинаково независимо от того, получены ли они в консоли Anthropic или через совместимый с Anthropic шлюз, такой как AI Prime Tech (независимый сервис, не связанный с Anthropic): единственное различие — base_url, с которым создаётся ваш клиент.

Выбор моделей под задачи

Интеграции с жёстко заданной единственной моделью либо обходятся слишком дорого, либо не обеспечивают нужного качества. Выбирайте модель по задаче: Haiku 4.5 для классификации, извлечения данных и маршрутизации; Sonnet 4.6 для большинства функций продукта и программирования; Opus 4.8, когда глубина рассуждений — ключевая ценность продукта; Fable 5, когда нужно контекстное окно 1M. Полное сравнение — в статье <a href="/ru/learn/claude-api-models-compared/">Сравнение моделей Claude</a>.

Задавайте модель в конфигурации, а не в константе: названия моделей меняются каждые несколько месяцев, и вам понадобится проводить A/B-тестирование новых выпусков без развёртывания.

Потоковая передача, тайм-ауты и повторные попытки

Используйте потоковую передачу для всего, за чем наблюдает пользователь: события, отправляемые сервером, передают токены по мере их генерации, сокращая воспринимаемую задержку с многих секунд до менее чем одной. Вызовы без потоковой передачи с большим значением max_tokens также чаще приводят к тайм-аутам чтения на прокси — это класс ошибок, который проявляется только в рабочей среде.

Повторяйте запросы при ответах 429 и 5xx с экспоненциальным увеличением задержки и случайным разбросом, учитывайте заголовки retry-after, если они присутствуют, и ограничивайте общее число попыток. Считайте ошибки 400 постоянными: проблема в самом теле запроса (часто это слишком большой вход; см. <a href="/ru/learn/claude-api-errors-troubleshooting/">Ошибки Claude API</a>), а повторные попытки лишь расходуют квоту.

Чек-лист перед запуском в рабочей среде

Перед запуском: установите лимиты токенов для входа и выхода; ведите журнал стоимости каждого запроса (данные об использовании возвращаются в каждом ответе); включите кэширование промптов для повторяющихся системных промптов; предусмотрите резервную модель или конечную точку на случай сбоев; проверьте защиту от инъекций в промпт, если в него попадает пользовательский ввод.

Большинство сложностей интеграции связано не с самим API, а с неограниченным ростом контекста и недостатком наблюдаемости. С первого дня записывайте количество входных и выходных токенов, и неожиданные расходы исчезнут.

import os, anthropic

client = anthropic.Anthropic(
    api_key=os.environ["ANTHROPIC_API_KEY"],
    base_url=os.environ.get("ANTHROPIC_BASE_URL", "https://aiprimetech.io"),
)

with client.messages.stream(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Summarize our launch plan in 3 bullets."}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

Часто задаваемые вопросы

AI Prime Tech — независимый API-шлюз. Он не связан с Anthropic, не одобрен этой компанией и не является её реселлером. Claude и названия связанных моделей — товарные знаки их соответствующих владельцев.