Claude API: как получить ключ и сделать первый запрос

Claude API — это способ обращаться к моделям Anthropic (Opus, Sonnet, Haiku) прямо из своего кода: отправляете текст запроса, получаете ответ модели в формате JSON. На нём строят чат-ботов, ассистентов поддержки, генераторы описаний и целые AI-агенты. В этой заметке разберём весь путь новичка: где взять ключ, как сделать первый запрос через curl, Python и Node.js, что вернёт API и сколько это стоит в 2026 году.

Что такое Claude API и когда он нужен

Веб-версия Claude удобна, чтобы поговорить с моделью вручную. Но как только вы хотите встроить модель в свой продукт — обрабатывать сотни запросов, генерировать тексты по расписанию, подключить ИИ к сайту или CRM — нужен API. Это HTTP-интерфейс: ваша программа шлёт запрос на сервер Anthropic и получает ответ. Разница с чатом простая: в чате отвечаете вы, в API отвечает ваш код.

Ключевой эндпоинт один — /v1/messages. Через него проходит и простой вопрос, и сложный диалог с историей, и вызов инструментов (tool calling). Освоив первый запрос, вы освоите 80% работы с API.

Шаг 1. Регистрация и получение API-ключа

API-ключ — это секретная строка, которая подтверждает, что запрос идёт от вас, и к которой привязана оплата. Получить его можно в консоли Anthropic:

1. Зайдите в консоль по адресу platform.claude.com (прежний адрес console.anthropic.com ведёт туда же) и авторизуйтесь.
2. Откройте раздел Settings → API keys (прямая ссылка — platform.claude.com/settings/keys).
3. Нажмите Create Key, дайте ключу понятное имя (например, test-local) и скопируйте значение.

Важный момент: полное значение ключа показывается один раз. Закрыли окно — увидеть его снова нельзя, придётся создавать новый. Ключ начинается с префикса sk-ant-.

Оплата работает по модели pay-as-you-go: вы пополняете баланс в разделе Billing и платите только за реально использованные токены. Многие новые аккаунты получают небольшой стартовый кредит на пробу, но правила периодически меняются — актуальную сумму смотрите прямо в консоли.

Как безопасно хранить ключ

Ключ — это доступ к вашему кошельку, поэтому обращаться с ним нужно как с паролем. Три правила, которые экономят деньги и нервы:

• Никогда не вставляйте ключ прямо в код и не коммитьте его в Git. Утёкший в публичный репозиторий ключ находят боты за минуты.
• Храните ключ в переменной окружения. В терминале Linux или macOS это делается так:

  export ANTHROPIC_API_KEY="sk-ant-ваш-ключ"

• Если ключ всё же засветился — сразу отзовите его кнопкой Delete в консоли и создайте новый. Отозванный ключ мгновенно перестаёт работать.

Тот же подход мы разбирали в заметке про Gemini API — принципы безопасности у всех провайдеров одинаковые.

Шаг 2. Первый запрос

Все запросы уходят на один адрес методом POST:

https://api.anthropic.com/v1/messages

К запросу нужно приложить три обязательных заголовка:

• x-api-key — ваш API-ключ;
• anthropic-version — версия API, сейчас это 2023-06-01;
• content-type: application/json — формат тела запроса.

В теле запроса обязательны три поля: model (какую модель зовём), max_tokens (потолок длины ответа) и messages (сама переписка — массив реплик с ролями user и assistant).

Вариант через curl

Самый быстрый способ проверить, что ключ работает, — отправить запрос прямо из терминала:

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1000,
    "messages": [
      { "role": "user", "content": "Привет! Ответь одним предложением, что такое API." }
    ]
  }'

Вариант на Python

Для реальных проектов удобнее официальный SDK. Установите его командой pip install anthropic. SDK сам подхватит ключ из переменной окружения ANTHROPIC_API_KEY, поэтому в коде его писать не нужно:

from anthropic import Anthropic

client = Anthropic()

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1000,
    messages=[
        {"role": "user", "content": "Объясни, что такое токен в языковой модели."}
    ],
)

print(message.content[0].text)

Вариант на Node.js

Для JavaScript-проектов есть SDK @anthropic-ai/sdk (ставится через npm install @anthropic-ai/sdk):

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

const client = new Anthropic();

const message = await client.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 1000,
  messages: [
    { role: "user", content: "Напиши слоган для кофейни в три слова." },
  ],
});

console.log(message.content[0].text);

Что вернёт API

Ответ приходит в JSON. Разбирать его целиком не обязательно, но полезно понимать ключевые поля:

• content — массив блоков ответа; текст лежит в content[0].text;
• stop_reason — почему модель остановилась (end_turn — договорила сама, max_tokens — упёрлась в лимит длины);
• usage — сколько токенов ушло на запрос (input_tokens) и на ответ (output_tokens). Именно по этим числам считается оплата.

Если хотите, чтобы модель отвечала строго в заданном формате (например, готовым JSON для вашей программы), задайте роль и правила через отдельное поле system — это системная инструкция, которая задаёт поведение на весь диалог.

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

В API доступно несколько семейств моделей, и выбор — это баланс «умнее / быстрее / дешевле». По состоянию на июль 2026 года ориентиры такие (цена за 1 млн токенов):

Для первых экспериментов и большинства задач хорошо подходит Sonnet 5 — он заметно дешевле Opus, но при этом сильный. Если нужно обработать тысячи однотипных коротких запросов, переключайтесь на Haiku. Тяжёлую аналитику и генерацию кода отдавайте Opus. Обратите внимание: у Sonnet 5 действует вводная цена ($2/$10) — по данным Anthropic, после 1 сентября 2026 года она поднимется до $3/$15, поэтому итоговую стоимость всегда сверяйте на странице тарифов.

Сколько это стоит и как не переплатить

Оплата идёт за токены, а не за запросы. Токен — это примерно 3–4 символа текста; и ваш вопрос, и ответ модели тарифицируются. Два встроенных механизма помогают резко снизить счёт:

• Кэширование промпта (prompt caching). Если в каждый запрос вы вставляете один и тот же большой кусок (инструкцию, документацию, контекст), его можно закэшировать. Повторное чтение из кэша стоит всего 0,1 от базовой цены входа — экономия до 90% на этой части.
• Batch API. Когда ответы не нужны мгновенно, отправляйте задания пакетом в асинхронном режиме — это даёт скидку 50% и на вход, и на выход.

Чтобы не словить неожиданный счёт, в разделе Billing задайте лимиты трат (usage limits) и следите за расходом на дашборде. Для наглядного контроля затрат на контент мы описывали общий подход в заметке про автоматизацию контента нейросетями.

Типичные ошибки новичка

• 401 Unauthorized — ключ неверный, отозван или не подставился из переменной окружения. Проверьте echo $ANTHROPIC_API_KEY.
• 429 Too Many Requests — превышен лимит скорости для вашего уровня доступа; добавьте паузу и повторную попытку.
• 400 с сообщением про max_tokens — забыли обязательное поле max_tokens или указали значение выше лимита модели.
• Пустой или обрезанный ответ — почти всегда слишком маленький max_tokens; увеличьте лимит.

Что дальше

Вы получили ключ, отправили первый запрос и понимаете, как считаются деньги — это фундамент. Следующие шаги: добавить системную инструкцию через поле system, научить модель вызывать ваши функции (tool calling) и подключить её к своим данным. Если планируете писать код вместе с моделью, посмотрите наш практический гайд по Claude Code. А чтобы модель ходила в ваши базы и сервисы, пригодится протокол MCP — с ним Claude API превращается из «умного текстового автомата» в полноценного помощника, работающего с реальными инструментами.