API-ключ Claude: получить и подключить

API-ключ Claude выпускается в консоли Anthropic: адрес console.anthropic.com ведёт на platform.claude.com, ключи лежат в настройках раздела API keys. Ключ кладут в переменную окружения ANTHROPIC_API_KEY — оттуда его читают официальные SDK и Claude Code. Платите не за подписку, а за токены: миллион входных токенов Claude Sonnet 5 стоит 2 доллара, выходных — 10. Консоль и подписка claude.ai оплачиваются отдельно. Цены и коды ошибок сверены по документации платформы 17 августа 2026 года.

Часть 1 · Понятие

Что такое API-ключ Claude и когда он нужен

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

• Ключ нужен, когда модель вызывает ваш код: бот, скрипт разбора документов, сервис на сайте, автоматизация в n8n.
• Ключ нужен, когда стороннее приложение просит «подключить свою модель» и предлагает поле для API-провайдера.
• Ключ не нужен, если вы просто работаете в приложении Claude или в Claude Code по подписке — там вход по аккаунту.

Сравнение по деньгам не универсально: у ровной ежедневной нагрузки подписка обычно выходит дешевле, у редких всплесков — API. Что входит в тарифы и сколько стоит подписка, разобрано в гайде про тарифы и оплату Claude Code.

Часть 2 · Консоль

Как получить API-ключ в консоли Anthropic

1. Заведите аккаунт в консоли Anthropic. Документация называет обязательными ровно две вещи: аккаунт консоли и API-ключ.
2. Пополните баланс организации. Подписка Pro или Max на claude.ai сюда не считается — это отдельный кошелёк.
3. Откройте настройки ключей и создайте новый ключ. Имя стоит давать говорящее: под каждый проект — свой ключ, чтобы отозвать один, не ломая остальные.
4. Скопируйте значение и сразу положите его в переменную окружения или в менеджер секретов. В репозиторий ключи не коммитят.

Часть 3 · Подключение

Куда подставить ключ Claude API

Прямой вызов идёт на https://api.anthropic.com/v1/messages. Ключ уходит в заголовке x-api-key, рядом обязателен заголовок версии API.

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

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": "Привет, Claude"}
    ]
  }'

В Python и TypeScript ключ вообще не пишут в коде: клиент забирает его из окружения при создании.

pip install anthropic

# ANTHROPIC_API_KEY уже в окружении, в коде его не упоминаем
import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1000,
    messages=[{"role": "user", "content": "Привет, Claude"}],
)
print(message.content)

Отдельная история — Claude Code. Он умеет работать и по подписке, и по ключу, и порядок у него жёсткий: переменная ANTHROPIC_API_KEY перебивает вход по подписке. Отсюда типовая путаница: человек оплатил Max, а расход идёт с баланса консоли.

• Проверить, чем вы платите. Команда /status показывает активный способ входа: строка с API-ключом появляется, только когда ключ реально используется.
• Вернуться на подписку. Достаточно убрать переменную из окружения командой unset ANTHROPIC_API_KEY.
• Посмотреть расход. Команда /usage показывает токены текущей сессии; у подписчиков там же полосы лимитов плана.

Часть 4 · Деньги

Сколько стоят токены Claude API

Три механики снижают счёт сильнее, чем выбор модели «подешевле».

• Кэш промпта. Чтение из кэша стоит десятую часть входной цены. Запись дороже обычного входа: на 25 процентов при пятиминутном кэше и вдвое при часовом. Отсюда порог окупаемости: пятиминутный кэш отбивается после первого повторного чтения, часовой — после второго.
• Batch API. Асинхронная пачка запросов идёт со скидкой 50 процентов и на вход, и на выход. Подходит всему, что не нужно «прямо сейчас»: разметка, переводы, массовый разбор.
• Длина контекста. Полное окно в миллион токенов на моделях 4.6 и новее считается по стандартной цене, надбавки за длинный контекст нет. Но у моделей 4.7 и новее токенизатор новый: на том же тексте он даёт примерно на 30 процентов больше токенов.

Отдельно тарифицируются серверные инструменты: веб-поиск стоит 10 долларов за тысячу поисков, а web fetch доплаты не требует — платите только за токены загруженной страницы. Как устроен сам расход токенов и что его раздувает, разобрано в гайде про экономию токенов и лимиты Claude.

Часть 5 · Отладка

Ошибки Claude API: 401, 402, 429, 529

Разбирать такие ответы руками обычно не нужно: официальные SDK сами повторяют временные сбои с нарастающей задержкой — по умолчанию дважды и с учётом заголовка retry-after, если сервер его прислал. Количество повторов настраивается у клиента.

Часть 6 · Доступ

Claude API из России: что мешает

Anthropic публикует список поддерживаемых стран, и России в нём нет: алфавитный перечень идёт от Romania сразу к Rwanda. На этот же список ссылаются системные требования Claude Code — поддерживаемая страна указана там наравне с версией операционной системы.

• Облака-партнёры. Модели Claude доступны в Amazon Bedrock и Google Cloud, где счёт выставляет облачный провайдер по своим правилам, а не Anthropic напрямую.
• Сторонние провайдеры моделей. Отдают доступ по своему ключу и своему тарифу. Как это выглядит на практике, показано в разборе подключения сторонней модели к Claude Code.
• Подписка вместо API. Для работы руками в терминале и приложении ключ не нужен: там вход по аккаунту, и вопрос сводится к оплате.

Вопросы

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

Читать дальше

Соседние гайды