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

Claude API нужен, когда Claude должен работать не только в чате, а внутри приложения, сайта, внутреннего сервиса или автоматизированного процесса. Через API программа отправляет модели данные и инструкцию, получает ответ и использует его дальше в собственной логике — например, для анализа документов, обработки обращений, классификации текста или генерации черновиков.

Для первого рабочего запроса не нужна сложная инфраструктура. Достаточно доступа к Claude Console, API-ключа, доступных usage credits и среды Python 3.10+. Ниже — путь от создания ключа до первого ответа Claude с пояснением, что происходит на каждом шаге.

Сразу главное. Подписки Claude Pro, Max, Team и Enterprise сами по себе не включают Claude API. Для программной работы используется Claude Console и отдельный API-биллинг.

1. Claude API и Claude.ai — не одно и то же

Claude.ai — интерфейс для человека. Claude API — программный интерфейс для приложений и сервисов. В первом случае пользователь пишет запрос в браузере или приложении, во втором запрос формирует ваш код.

2. Как работает Claude API

Основной способ отправить сообщение модели — Messages API. Для обычного запроса используется endpoint POST /v1/messages. Приложение передаёт модель, массив сообщений и ограничение max\_tokens; Claude возвращает объект Message с контентом ответа и служебной информацией.

Схема показывает важный принцип: Claude обрабатывает запрос, а историю диалога и бизнес-логику хранит ваше приложение.

Ключевой принцип. Messages API stateless: Claude не хранит для вашего приложения историю разговора автоматически. Если нужен контекст предыдущих реплик, приложение передаёт нужную историю в следующем запросе.

3. Что подготовить до начала

• Доступ к Claude Console.

• API-ключ. Для первого локального теста обычно достаточно personal key.

• Доступные usage credits или другой настроенный Anthropic способ оплаты для тарифицируемых запросов.

• Python 3.10 или новее, если вы используете Python SDK.

• Место для безопасного хранения секрета вне исходного кода.

• Большинство организаций в Claude Console используют предоплаченные usage credits. Если баланс заканчивается, новые вызовы API перестают выполняться до пополнения. Для части корпоративных клиентов возможна ежемесячная оплата по счёту.

4. Как создать API-ключ

В Claude Console откройте Settings → API keys → Create key. Задайте понятное название, срок действия и выберите, с какой учётной записью и workspace связан ключ.

Для первого теста удобнее создать ключ, привязанный к одному workspace. Если используется multi-workspace key, в запросах дополнительно нужно передавать anthropic-workspace-id.

Personal key и service account key

Personal key работает от имени конкретного пользователя и подходит для собственной разработки и тестов. Service account key лучше использовать для общих сервисов, production-нагрузок и автоматизации, которые не должны зависеть от конкретного сотрудника.

5. Сохраните ключ безопасно

Не вставляйте API-ключ непосредственно в исходный код и не публикуйте его в репозитории. Для локальной разработки официальный SDK умеет читать ключ из переменной окружения ANTHROPIC\_API\_KEY.

macOS / Linux   export ANTHROPIC_API_KEY="ваш_api_ключ"

Windows PowerShell   $env:ANTHROPIC_API_KEY="ваш_api_ключ"

Для production. Для production-сервиса используйте service account key и менеджер секретов. Если инфраструктура уже имеет identity от AWS, Google Cloud, Kubernetes, GitHub Actions или другого OIDC-провайдера, можно рассмотреть Workload Identity Federation вместо долгоживущего статического ключа.

6. Установите официальный SDK

Создадим отдельную папку и виртуальное окружение:

mkdir claude-quickstart
cd claude-quickstart
python3 -m venv .venv
source .venv/bin/activate
pip install anthropic

В Windows активация виртуального окружения выполняется другой командой, но сам пакет тот же: anthropic.

7. Сделайте первый запрос

Создайте файл quickstart.py и вставьте код:

import anthropic
client = anthropic.Anthropic()
message = client.messages.create(
model="claude-opus-5-5",
max_tokens=1000,
messages=[
{
"role": "user",
"content": "Объясни простыми словами в трех предложениях, что такое Claude API."
}
],
)
for block in message.content:
if block.type == "text":
print(block.text)

Запустите файл:

python quickstart.py

Если ключ, billing и окружение настроены корректно, в терминале появится ответ Claude. Это уже полноценный рабочий вызов Messages API.

Что здесь происходит

• anthropic.Anthropic() создаёт клиент и автоматически ищет ANTHROPIC\_API\_KEY в окружении.

• model="claude-opus-5-5" выбирает модель, к которой отправляется запрос.

• max\_tokens задаёт максимальный объём генерируемого ответа.

• messages содержит сообщения, которые приложение передаёт модели.

• message.content состоит из content blocks, поэтому текстовые блоки безопаснее выбирать по block.type, а не по позиции content\[0].

8. Тот же запрос через c URL

SDK удобен, но под ним находится обычный HTTP-запрос. Для прямого вызова нужны заголовки авторизации, версия Anthropic API и JSON-тело запроса:

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

-H "Authorization: Bearer $ANTHROPIC_API_KEY" 

-H "anthropic-version: 2023-06-01" 

-H "content-type: application/json" 

-d '{
"model": "claude-opus-5-5",
"max_tokens": 1000,
"messages": [
{
"role": "user",
"content": "Объясни простыми словами, что такое Claude API."
}
]
}'

Актуальная аутентификация использует Authorization: Bearer. Заголовок x-api-key по-прежнему поддерживается как legacy-вариант. Официальный SDK добавляет необходимые служебные заголовки автоматически.

9. Что возвращает API

• Ответ API — это не просто строка. Объект Message содержит несколько полей, которые полезны для приложения и диагностики:

• id — идентификатор ответа;

• model — модель, которая обработала запрос;

• content — набор content blocks;

• stop\_reason — причина завершения генерации;

• usage — количество входных и выходных токенов.

• Usage в Claude Console можно анализировать по модели, времени и API-ключу. Cost — по workspace, моделям и периодам.

10. Сколько стоит Claude API

API оплачивается по фактическому использованию: отдельно считаются входные и выходные токены. На 23 сентября 2026 года стандартные цены основных моделей выглядят так:

Для одного короткого тестового запроса расход обычно невелик. На масштабе важны выбор модели, длина входного контекста и объём ответа.

11. Почему API не помнит прошлый разговор

Messages API stateless. Если следующий вопрос зависит от предыдущей реплики, приложение должно заново передать нужную историю:

messages=[
{"role": "user", "content": "Меня зовут Анна."},
{"role": "assistant", "content": "Приятно познакомиться, Анна."},
{"role": "user", "content": "Как меня зовут?"}
]

Так разработчик сам контролирует, что хранить, как долго хранить и какой контекст отправлять модели.

12. Типичные ошибки первого запуска

При диагностике полезно сохранять request-id из ответа. Он помогает сопоставить конкретный вызов с логами и обращением в поддержку.

13. Первый полезный сценарий вместо «Hello, Claude»

После проверки соединения лучше сразу протестировать задачу, похожую на реальный процесс. Например, анализ отзыва клиента:

import anthropic
client = anthropic.Anthropic()
review = """
Заказ приехал быстро, но упаковка была повреждена.
Сам товар работает нормально, возвращать его не хочу.
"""
message = client.messages.create(
model="claude-opus-5-5",
max_tokens=300,
messages=[
{
"role": "user",
"content": f"""
Проанализируй отзыв клиента.
Определи:
общую тональность;
основную проблему;
требуется ли вмешательство поддержки.
Отзыв:
{review}
"""
}
],
)
for block in message.content:
if block.type == "text":
print(block.text)

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

14. Что изучать после первого запроса

• Многошаговые диалоги и управление контекстом.

• System prompts и единые правила поведения модели.

• Streaming через Server-Sent Events для вывода ответа по мере генерации.

• Structured outputs для получения данных по заданной JSON Schema.

• Tool use для подключения внешних действий и функций.

• Prompt caching и контроль стоимости на больших объёмах.

• Рациональная последовательность: первый запрос → обработка ответа → история диалога → ошибки → контроль расходов → streaming → structured outputs → tools.

Вывод

Минимальный путь к Claude API состоит из пяти шагов: получить доступ к Claude Console, создать API-ключ, сохранить его в ANTHROPIC\_API\_KEY, установить официальный SDK и отправить запрос через client.messages.create().

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