Claude API за 30 минут: первые запросы на Python

Claude API это прямой доступ к языковой модели Anthropic без интерфейса claude.ai: вы отправляете запрос через код и получаете ответ. Это открывает возможности, недоступные в чате: автоматизация, интеграция в приложения, пакетная обработка данных, создание собственных инструментов на базе Claude. В этом руководстве: от регистрации до первого рабочего запроса за 30 минут.

Зачем использовать API вместо claude.ai

Веб-интерфейс это один чат с одним человеком. API позволяет:

• Интегрировать Claude в ваш продукт или сервис
• Автоматически обрабатывать тысячи документов
• Создать своего бота в Telegram, WhatsApp, Slack
• Встроить AI в корпоративные системы (CRM, ERP, поддержка)
• Установить системный промпт который сохраняется во всех сессиях
• Контролировать параметры (temperature, max_tokens) для каждого запроса

Регистрация и API ключ

Шаг 1: Зайдите на console.anthropic.com, зарегистрируйтесь с email. Шаг 2: В верхнем меню: API Keys > Create Key. Скопируйте ключ (он показывается только один раз!). Ключ начинается с «sk-ant-…». Шаг 3: Пополните баланс (минимум $5) через Billing > Add credit card. API тарифицируется по токенам: входящие + исходящие. Claude 3.5 Sonnet стоит около $3 за миллион входящих токенов и $15 за миллион исходящих (проверяйте актуальные цены в console.anthropic.com/billing).

Установка SDK

Anthropic предоставляет официальный Python SDK:

pip install anthropic

Также доступен TypeScript/JavaScript SDK для Node.js: npm install @anthropic-ai/sdk

Первый запрос к Claude API

Python пример:

import anthropic

client = anthropic.Anthropic(api_key="sk-ant-ваш-ключ")

message = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Привет! Напиши краткое введение в Python для начинающих."}
    ]
)

print(message.content[0].text)

Запустите: python script.py. Получите ответ Claude в консоли. Это всё что нужно для первого запроса.

Системный промпт: задаём роль

System prompt это скрытые инструкции, которые задают поведение Claude для всего диалога. Аналог Custom Instructions в веб-версии, но программируемый:

message = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    system="Ты профессиональный копирайтер для B2B SaaS. Пишешь только на русском. Тон: деловой, без жаргона. Отвечаешь кратко, без лишних вводных слов.",
    messages=[
        {"role": "user", "content": "Напиши заголовок лендинга для CRM-системы"}
    ]
)

Диалог: multi-turn разговор

Для поддержания диалога вы сами управляете историей сообщений: добавляете пары user/assistant в список messages:

conversation = []

def chat(user_message, conversation):
    conversation.append({"role": "user", "content": user_message})
    response = client.messages.create(
        model="claude-sonnet-4-5",
        max_tokens=1024,
        messages=conversation
    )
    assistant_reply = response.content[0].text
    conversation.append({"role": "assistant", "content": assistant_reply})
    return assistant_reply

print(chat("Какой язык лучше для начала изучения программирования?", conversation))
print(chat("А если я хочу делать веб-сайты?", conversation))

Пакетная обработка документов

Практическое применение: обработать 100 CSV-записей с отзывами клиентов и определить тональность каждого:

import csv

reviews = ["Отличный продукт, очень доволен!", "Качество хуже ожидаемого", "Нормально, ничего особенного"]

results = []
for review in reviews:
    response = client.messages.create(
        model="claude-haiku-4-5-20251001",   # Haiku быстрее и дешевле для простых задач
        max_tokens=20,
        messages=[{"role": "user", "content": f"Тональность отзыва (positive/negative/neutral): '{review}'"}]
    )
    results.append({"review": review, "sentiment": response.content[0].text.strip()})

for r in results:
    print(f"{r['sentiment']}: {r['review'][:50]}")

Выбор модели: Sonnet, Haiku, Opus

• claude-haiku-4-5: быстрый и дешёвый. Для простых задач: классификация, суммаризация коротких текстов, простые вопросы-ответы.
• claude-sonnet-4-5: баланс качества и скорости. Для большинства задач.
• claude-opus-5: максимальное качество. Для сложного анализа, написания длинных качественных текстов, complex reasoning.

Вывод

Claude API это несколько строк Python и несколько долларов на начало. За 30 минут вы пишете первый рабочий скрипт. Реальная сила открывается когда вы начинаете интегрировать его в рабочие процессы: пакетная обработка данных, чат-боты, корпоративные инструменты. Начните с простого: автоматизируйте одну рутинную задачу с Claude API и оцените результат.

Структура API-запроса к Claude

Anthropic API принимает HTTP POST запросы на endpoint https://api.anthropic.com/v1/messages. Обязательные поля: model (например «claude-sonnet-4-5″), max_tokens, messages (массив с role и content). Необязательные: system (системный промпт), temperature, top-p. Авторизация через заголовок x-api-key. Типовой запрос через Python с библиотекой anthropic: import anthropic; client = anthropic.Anthropic(api_key=»…»); message = client.messages.create(model=»claude-sonnet-4-5″, max_tokens=1024, messages=[{«role»:»user»,»content»:»Привет!»}]). Billing: токены входа (input tokens) + токены выхода (output tokens). Для claude-sonnet-4-5 в 2026: примерно $0.003 за 1k input tokens, $0.015 за 1k output tokens. С prompt caching входящие токены при повторном использовании кэшируются дешевле.

Практические паттерны для Claude API

• System prompt: всегда задавай роль и контекст в system параметре, не в user-сообщении. System prompt стоит как input токены, но кэшируется эффективнее.
• Streaming: для длинных ответов используй stream=True — получай токены по мере генерации, а не ждёшь весь ответ. Улучшает UX в realtime-приложениях.
• Batching: Batch API (доступен для объёмных задач) снижает стоимость на 50%. Запросы обрабатываются асинхронно, ответ через 1-24 часа.
• Vision: передавай изображения как base64 в content массиве: {«type»:»image»,»source»:{«type»:»base64″,»media_type»:»image/jpeg»,»data»:»…base64…»}}.
• Tool Use: определяй инструменты в параметре tools. Claude вызовет инструмент в ответе, ты выполнишь функцию и передашь результат обратно в messages.

Частые вопросы

Читайте также

• Как начать работать с Claude: руководство для начинающих
• Claude Projects: как организовать работу с постоянной памятью
• 25 промптов для Claude которые работают: копируй и используй