Anthropic Claude API: гайд разработчика - ключ, первый запрос, цены

Anthropic Claude API - это способ встроить модели Claude в своё приложение через один HTTP-запрос. Чтобы начать, нужны три вещи: аккаунт на platform.claude.com, API-ключ вида sk-ant-... и официальный SDK. Дальше пишешь запрос к эндпоинту /v1/messages, получаешь ответ модели и платишь только за реально использованные токены. Из России понадобится VPN и зарубежная карта.

Дальше разберу весь путь: где взять ключ, как за пять минут сделать первый запрос на Python, сколько это стоит в 2026 году и что делать с доступом из РФ. Это не про Claude Code (агента в терминале) и не про приложение-чат - это про сам API, на котором ты строишь свой продукт.

Чем Claude API отличается от Claude Code и приложения

Один и тот же Claude приходит к тебе тремя разными дверями, и на старте их легко перепутать.

Приложение Claude (claude.ai и десктоп) - это готовый чат для человека. Платишь за подписку, общаешься в окне. Claude Code - агент для разработчика, живёт в терминале, сам читает и правит файлы в проекте. А Claude API - это голый доступ к модели для программиста: ты шлёшь запрос из своего кода и получаешь ответ, из которого сам собираешь что угодно - бота, обработку заявок, разбор документов, свой сервис.

Разница в оплате принципиальная. Подписка Claude Pro или Max - фиксированная сумма в месяц за использование чата и Claude Code. API - оплата по факту, за каждую тысячу токенов, без месячного платежа. Если ты строишь продукт, который сам ходит к модели, тебе нужен именно API-ключ, а не подписка.

Шаг 1: аккаунт и ключ на platform.claude.com

Кабинет разработчика Anthropic живёт на platform.claude.com (Claude Console). Старый адрес console.anthropic.com - это прежнее имя того же кабинета, он ведёт туда же, но в свежей документации везде указан platform.claude.com.

Порядок такой:

Заходишь на platform.claude.com, регистрируешься по email или через Google. Понадобится подтвердить почту и телефон.
Привязываешь платёжный метод и пополняешь баланс. Новым аккаунтам дают немного бесплатных кредитов на пробу, точную сумму Anthropic не называет - её хватает погонять пару запросов, не больше.
Идёшь в Settings - API keys (platform.claude.com/settings/keys), жмёшь создать ключ. Получаешь строку вида sk-ant-api03-....

Дальше самый удобный способ отдать ключ программе - переменная окружения ANTHROPIC_API_KEY. Все официальные SDK читают её сами, и тебе не придётся писать ключ в коде:

export ANTHROPIC_API_KEY="sk-ant-api03-..."

Шаг 2: ставим SDK и делаем первый запрос

У Anthropic есть официальные библиотеки под Python, TypeScript/JavaScript, Java, Go, Ruby, C# и PHP. Возьму Python как самый частый вход.

pip install anthropic

Минимальный первый запрос целиком:

from anthropic import Anthropic

client = Anthropic()  # ключ берётся из ANTHROPIC_API_KEY

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Ответь одним предложением: что такое API?"}
    ],
)

print(message.content[0].text)

Запускаешь - и в консоли появляется ответ модели. Всё, ты только что сходил к Claude из своего кода.

Что тут происходит. Anthropic() создаёт клиента и сам подхватывает ключ из окружения. messages.create шлёт запрос на единственный рабочий эндпоинт POST /v1/messages - через него идёт вообще всё в этом API, и обычный чат, и картинки, и инструменты. model - какую модель дёрнуть, max_tokens - потолок длины ответа, messages - история диалога ролями user и assistant.

Если тебе ближе не Python, а голый HTTP, тот же запрос через curl:

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Привет"}]
  }'

Два обязательных заголовка: x-api-key с твоим ключом и anthropic-version с датой версии API. В SDK про них думать не нужно, там это зашито.

Модели и цены в 2026

Цена в API считается за токены, отдельно за вход (то, что ты отправил) и за выход (то, что модель написала). Токен - это примерно 3-4 символа русского текста. Вот актуальная линейка на конец августа 2026:

Модель	ID	Контекст	Вход $/1М	Выход $/1М
Claude Opus 5	`claude-opus-5`	1M	$5	$25
Claude Sonnet 5	`claude-sonnet-5`	1M	$2	$10
Claude Haiku 4.5	`claude-haiku-4-5`	200K	$1	$5
Claude Fable 5	`claude-fable-5`	1M	$10	$50

Как выбирать под задачу. Sonnet 5 - рабочая лошадка на каждый день, дёшево и быстро, ей закрывается почти всё. Opus 5 берёшь под сложную логику и код. Fable 5 - самая тяжёлая, для долгих автономных задач, и стоит соответственно. Haiku 4.5 - когда нужно быстро, дёшево и в объёме, например разметка или простая классификация. Подробнее про выбор я разбирал в статье про то, какую модель Claude брать.

Отдельно про Sonnet 5: его цена $2/$10 была вводной и должна была вырасти до $3/$15 первого сентября. Так вот, повышение отменили - десятого августа Anthropic объявила, что $2/$10 остаётся постоянной ценой. Так что можно на неё закладываться.

Цена за выход в долларах за миллион токенов: Fable 5 дороже всего, дальше Opus 5, Sonnet 5 и Haiku 4.5

Цены и названия моделей Anthropic меняет часто, поэтому перед реальным запуском сверяйся на claude.com/pricing на дату чтения.

Что API умеет кроме одного запроса

Тот же /v1/messages тянет намного больше, чем простой вопрос-ответ. Что тебе пригодится, когда дойдёшь до настоящего продукта:

Стриминг. Ответ приходит по кусочкам, как печатает человек, а не одним куском в конце. Для чат-интерфейсов это обязательно, иначе пользователь смотрит на пустой экран.
Вызов инструментов (tool use). Ты описываешь модели свои функции, и она сама решает, когда их дёрнуть: сходить в базу, посчитать, вызвать твой код. Это основа для агентов.
Кэширование промптов. Если ты гоняешь один и тот же длинный системный промпт в каждом запросе, его можно закэшировать: повторное чтение из кэша стоит 10% от обычной цены входа. На объёме экономит заметно.
Batch API. Не нужен мгновенный ответ? Отправляешь пачку запросов в асинхронную обработку и платишь ровно вдвое меньше, минус 50% на вход и выход.
Файлы и картинки. В запрос можно вложить изображение или PDF-документ, и модель прочитает его прямо в контексте.
Подсчёт токенов. Отдельный вызов count_tokens считает, сколько токенов займёт запрос, ещё до отправки. Не пытайся считать токены Claude сторонними библиотеками вроде tiktoken, они от другой модели и соврут.

Лимиты и тарификация: Start, Build, Scale

Оплата в API - pay-as-you-go, по факту потребления, в долларах, помесячным счётом. Никакого фиксированного платежа, потратил на 40 центов - заплатил 40 центов.

Раньше аккаунты делились на Tier 1-4 по сумме пополнения. В 2026 схему упростили: теперь три уровня - Start, Build, Scale, и поднимаешься по ним автоматически по мере использования, а не привязка к сумме на балансе. Уровень определяет лимиты скорости по трём осям: запросов в минуту (RPM), входных токенов в минуту (ITPM) и выходных в минуту (OTPM). Упрёшься в потолок - получишь ошибку 429, подожди и повтори. Точные числа лимитов смотри в консоли, они зависят от модели и уровня.

Как подключиться из России

Россия не входит в список поддерживаемых стран Anthropic - причина в ограничениях OFAC. Список общий и для API, и для сайта Claude. На практике это значит две проблемы, ровно как со всеми сервисами Anthropic и OpenAI.

Первая - геоблок по IP. Регистрация и запросы проверяют геолокацию, поэтому нужен VPN с чистым зарубежным IP, причём держать его включённым постоянно, а не только на вход. Тот же барьер я подробно разбирал в статье про доступ и оплату Claude Code из России - для API всё то же самое.

Вторая - оплата. Пополнение идёт через Stripe, а он отбивает карты российских банков по BIN ещё до списания. Рабочие варианты: зарубежная или виртуальная карта на своё имя с иностранным BIN (её часто можно пополнять рублями через СБП), либо доступ через агрегатор.

Из агрегаторов у российских разработчиков прижился OpenRouter - единый API-шлюз к сотням моделей, включая Claude, с OpenAI-совместимым интерфейсом. Меняешь пару строк, и твой код ходит к Claude через него. Правда, OpenRouter тоже сидит на Stripe, так что карту РФ он напрямую не примет, платят через те же зарубежные карты или посредников-пополняльщиков. Подавай это как существующую практику: посредники периодически закрываются, риск на тебе, но людям это позволяет работать.

С чего начать на практике

Что нужно собрать до первого запроса: аккаунт Anthropic, VPN с чистым IP, API-ключ и пополненный баланс, а карта РФ напрямую не пройдёт

Короткий план, если хочешь пощупать API сегодня. Заведи аккаунт на platform.claude.com (из РФ - под VPN), пополни баланс на пару долларов, выпусти ключ и сразу сохрани его. Поставь SDK своим менеджером пакетов, положи ключ в ANTHROPIC_API_KEY и прогони тот минимальный пример на Sonnet 5 - он самый дешёвый для экспериментов. Когда ответ придёт, дальше уже наращивай: стриминг для интерфейса, инструменты для агента, кэш и batch для экономии.

Если тебе больше по душе агент в терминале, а не свой код вокруг API, посмотри руководство по Claude Code CLI - там тот же Claude, но с готовой обвязкой под разработку.