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

Разбираю по шагам, как получить ключ Claude API и отправить первый рабочий запрос. Куда идти за ключом, сколько денег класть на счёт, какой командой проверить, что всё работает, и что делать, когда вместо ответа приходит ошибка.

Инструкция рассчитана на человека, который не писал код: Claude API устроен проще, чем кажется со стороны. Все адреса, команды, названия моделей и коды ошибок сверены с официальной документацией Anthropic 4 сентября 2026 года, ссылки собраны в конце. Подходит и для macOS, и для Windows, и для Linux.

Что такое Claude API и чем он отличается от подписки Claude?

У Anthropic два входа к одним и тем же моделям, и путать их дорого.

Чат. Открывается в браузере на claude.ai, есть приложения для телефона и компьютера. Вы платите фиксированную сумму в месяц и работаете руками: пишете, прикладываете файлы, читаете ответ.

Ключ. Программный вход. Вы отправляете запрос из своего кода, получаете ответ в машинном виде и платите за объём текста, который отправили и получили. Модель одна и та же, оболочка разная.

Справочный центр Anthropic отвечает на главный вопрос новичка одной фразой:

«A paid Claude subscription enhances your chat experience but doesn't include access to the Claude API or Console.»

«Платная подписка Claude улучшает работу в чате, но не даёт доступа к API и к Консоли».

• Справочный центр Anthropic, статья про раздельную оплату подписки и Консоли

Отсюда растёт самая частая путаница: человек оплатил подписку, вставил ключ в скрипт и получил отказ по балансу. Счёта два, и пополнять надо тот, к которому привязан ключ.

В поиске эту тему набирают по-разному: «клод апи», «клауд апи», просто «клод». Ищут при этом одно и то же - ключ и первый запрос. Заодно сам продукт часто путают с Claude Code, терминальным помощником, который работает рядом с вашими файлами. Это третий вход, и оплачивается он по своим правилам.

Ключ нужен не всем. Если задача решается перепиской в окне и загрузкой документов, начните с чата - порядок первых шагов разобран в материале как пользоваться Claude в России. Если нужен терминал и работа с папкой проекта, смотрите разбор Claude Code для новичка. Ключ берут тогда, когда к модели должна обращаться программа: бот в мессенджере, разбор входящих заявок, обработка выгрузки из учётной системы.

Доступен ли Claude API из России?

Anthropic держит публичную страницу поддерживаемых стран и территорий. На ней два отдельных перечня: один для API, второй для claude.ai. России нет ни в одном.

Путь первый - прямой аккаунт. Зарубежный номер телефона при регистрации, зарубежная карта для оплаты, доступ из поддерживаемого региона. Связка рабочая и понятная: вы платите Anthropic напрямую, ваши запросы никуда по дороге не заходят. Механика оплаты со всеми оговорками разобрана отдельно - как оплатить Claude Code из России, здесь я её не пересказываю.

Я сам плачу за Claude картой для подписок «Плати по миру»: выпускается за пару минут, пополняется рублями через СБП.

Путь второй - посредник. Российский сервис-прокси регистрируется у Anthropic сам, а вам отдаёт свой адрес и рублёвую оплату. В коде меняются две вещи: базовый адрес и ключ. Методы, параметры и формат ответа остаются те же, переписывать программу не нужно.

У второго пути есть цена, и в русских обзорах её обычно не пишут. Через посредника проходят и ваш запрос, и ответ модели. Формулировка «мы не собираем и не храним данные ваших запросов» - обещание конкретной компании. Технически посредник видит и то, и другое. Для договоров, персональных данных клиентов и внутренних документов это решение с оговоркой; что можно отдавать наружу, а что нет, разобрано в материале про данные в публичной нейросети.

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

Что понадобится до первого запроса?

Список того, без чего начинать бессмысленно:

1. Почта, к которой у вас есть постоянный доступ. К ней привязан аккаунт и восстановление.
2. Рабочий вход на platform.claude.com. Это адрес консоли разработчика. Старый console.anthropic.com тоже работает и отвечает переадресацией на новый.
3. Способ оплаты. Зарубежная карта при прямом аккаунте или рублёвый счёт у посредника - см. предыдущий раздел.
4. Терминал. На macOS - Terminal или iTerm (подойдёт любой MacBook или iMac), на Windows - PowerShell либо WSL, на Linux любой. Команда curl есть во всех трёх системах из коробки.
5. Полчаса. Регистрация и создание ключа занимают минуты, остальное уходит на первый запрос и разбор ответа.
6. Место для ключа. Менеджер паролей или менеджер секретов. Заметка в мессенджере и файл на рабочем столе местом не считаются.

Ключ - это только вход. Дальше начинается работа, которая и приносит деньги: описать процесс, решить, кто читает ответы модели, куда они попадают и что происходит при ошибке. ClaudeLab собирает такие решения под конкретную компанию, а как это выглядит в готовом виде, показано на странице про автоматизацию бизнеса с ИИ.

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

1. Завести аккаунт в консоли Anthropic

   Открыть platform.claude.com и войти в аккаунт или завести новый.

2. Создать ключ в разделе Settings, пункт API keys

   Нажать Create key, задать имя, срок жизни и владельца, скопировать ключ сразу.

3. Пополнить счёт и поставить потолок трат

   Положить деньги в разделе Billing и выставить месячный лимит расхода.

4. Отправить первый запрос на адрес /v1/messages

   Выполнить команду curl или запустить пример на Python с тремя обязательными заголовками.

5. Проверить расход в ответе и в консоли

   Посмотреть блок usage в ответе и страницу расходов в консоли.

Шаг 1. Завести аккаунт в консоли Anthropic

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

1. Открыть platform.claude.com и войти в аккаунт или завести новый.
2. Дождаться письма с подтверждением почты.
3. Пройти регистрацию организации. Аккаунт консоли всегда принадлежит организации, даже если вы в ней один.

Как понять, что шаг закрыт: в левом меню появился Settings, а сверху виден выбор рабочего пространства. Этот аккаунт и открывает вам доступ к Claude API.

Назначение рабочих пространств документация описывает одной строкой:

«Use workspaces to separate environments and control spend by use case.»

«Используйте рабочие пространства, чтобы разделять окружения и контролировать траты по сценариям использования».

• Anthropic, обзорная страница программного интерфейса

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

Шаг 2. Создать ключ и сразу убрать его в надёжное место

Последний шаг из инструкции запомните дословно:

«The Console shows the full key, which starts with sk-ant-, only once, at creation. Copy it and store it somewhere safe, such as a secrets manager. If you lose a key, you can't view it again in the Console. Create a new key instead.»

«Консоль показывает полный ключ, начинающийся с sk-ant-, только один раз, при создании. Скопируйте его и сохраните в надёжном месте, например в менеджере секретов. Если вы потеряли ключ, посмотреть его в Консоли снова нельзя. Создайте новый».

• Anthropic, страница создания ключа

При создании вы выбираете тип ключа. От него зависит, что будет с доступом, когда сотрудник уйдёт из компании:

• Личный ключ работает от вашего имени и перестаёт работать, когда вы выходите из организации. Годится для своей разработки.
• Ключ сервисного аккаунта принадлежит служебной учётной записи и рассчитан на боевые сервисы, ботов и автоматизацию. Документация советует его для всего, чем пользуется не один человек.
• Ключ рабочего пространства - старый формат без владельца. Anthropic сам называет его устаревшим и советует брать один из первых двух.

Если кнопка Create key серая, у вашей роли нет прав на создание ключей - попросите администратора организации поменять роль.

Срок жизни задаётся тут же, при создании. Ставьте его осознанно: ключ с датой окончания сам перестанет работать, если вы про него забудете, и не будет висеть годами.

Шаг 3. Пополнить счёт и поставить потолок трат

Порядок:

1. Открыть Settings, пункт Billing.
2. Пополнить счёт на сумму, которую не жалко потерять на экспериментах.
3. В разделе лимитов трат выставить месячный потолок. Свой потолок может быть только ниже тарифного, выше поднять нельзя.
4. Решить, включать ли автопополнение. Для боевого сервиса оно спасает от простоя, для первых опытов лучше обойтись без него.

При прямом аккаунте счёт пополняется зарубежной картой. Карты по выпуску, комиссиям и продлению сравнены в обзоре зарубежной карты для оплаты.

Текст «Your credit balance is too low to access the Anthropic API» отдаётся не только при пустом счёте, и это самая известная ошибка новичка. В публичных обсуждениях разработчиков видно, что тот же текст приходит и в других случаях: ключ от другой организации, ключ в переменных окружения перебил вход по подписке, деньги внесены, но привязаны к другому кошельку. Порядок разбора: проверить баланс, потом проверить, каким именно ключом пошёл запрос.

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

Шаг 4. Сделать первый запрос

Сначала положите ключ в переменную окружения. Переменная окружения - это значение, которое хранится в настройках вашего компьютера или сервера. В файлах проекта его нет: программа читает значение сама, а в коде остаётся только имя. Так ключ не попадает ни в исходники, ни в репозиторий:

export ANTHROPIC_API_KEY="your-api-key-here"

Теперь сам запрос. Команда взята из официального быстрого старта дословно:

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-opus-5",
    "max_tokens": 1000,
    "messages": [
      {
        "role": "user",
        "content": "What should I search for to find the latest developments in renewable energy?"
      }
    ]
  }'

Разберу параметры по одному, потому что именно на них спотыкаются:

• model - идентификатор модели. Пишется точной строкой, придумывать своё написание нельзя.
• max_tokens - потолок длины ответа. На размер вашего запроса он не влияет, и путают это чаще всего.
• messages - переписка. Роль user - ваш текст, роль assistant - ответ модели, который вы возвращаете обратно, когда ведёте диалог.
• Заголовок anthropic-version со значением 2023-06-01 обязателен. Без него запрос не пройдёт.

То же самое на Python, если вам удобнее из кода. Установка занимает три команды, а сам скрипт - десяток строк:

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

Вторая строка делает отдельную папку под библиотеки этого проекта, чтобы не засорять систему. Третья ставит официальную библиотеку Anthropic.

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=1000,
    messages=[
        {
            "role": "user",
            "content": "What should I search for to find the latest developments in renewable energy?",
        }
    ],
)

for block in message.content:
    if block.type == "text":
        print(block.text)

Ни одной строки с самим ключом в этом коде нет, и это правильный способ. Документация объясняет почему:

«Export your API key as an environment variable. The SDK reads ANTHROPIC_API_KEY automatically.»

«Экспортируйте ключ как переменную окружения. Библиотека читает ANTHROPIC_API_KEY автоматически».

• Anthropic, страница первого запроса

Общие правила для программы задаются отдельным полем system - туда кладут инструкцию, которая действует на весь диалог. Как её формулировать, чтобы модель отвечала стабильно, разобрано в материале про системный промпт.

Официальные библиотеки есть также для TypeScript, C#, Go, Java, PHP и Ruby. Они сами подставляют заголовки, сами повторяют неудачный запрос дважды с нарастающей паузой и сами разбирают ответ.

Шаг 5. Посмотреть, за что списали деньги

Вот как выглядит ответ на запрос выше, сокращённо:

{
  "model": "claude-opus-5",
  "id": "msg_013mHbppMPd2PrVJzGMZPt2D",
  "type": "message",
  "role": "assistant",
  "content": [ { "type": "text", "text": "Here are some effective search strategies..." } ],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 21, "output_tokens": 305 }
}

Блок usage - готовый счётчик. Двадцать один токен ушёл на вопрос, триста пять на ответ. Отсюда сразу видно главное свойство оплаты: ответ обычно длиннее вопроса, а исходящий токен ещё и дороже.

После первых запросов загляните сюда:

1. Страница Billing в консоли - остаток на счёте и месячный расход.
2. Страница Limits - лимиты скорости для вашей организации.
3. Отдельный метод подсчёта токенов - он считает объём запроса до отправки и денег за это не берёт. Полезен, когда вы гоните большие документы и хотите знать цену заранее.

Как считаются деньги и что такое токен?

Токен - минимальная единица, которой модель меряет текст. Это не буква и не слово: короткое слово укладывается в один токен, длинное разбивается на части.

Официальный ориентир по объёму у Anthropic такой:

«Context window: 1M tokens is roughly 555k words or 2.5M Unicode characters on the current tokenizer...»

«Окно контекста: один миллион токенов - это примерно 555 000 слов или 2,5 миллиона символов Unicode на текущем токенизаторе...»

• Anthropic, обзор моделей

Цифра из цитаты - только ориентир. Сколько токенов выйдет из вашего текста, зависит от языка и содержания. Точный ответ даёт бесплатный метод подсчёта токенов, который считает объём до отправки. Пока вы его не прогнали, планируйте бюджет с запасом.

Принцип оплаты такой:

1. Считается и вход, и выход. Отправленный текст оплачивается по одной ставке, полученный - по другой.
2. Ответ дороже вопроса. Отсюда простое правило: длинные ответы - главная статья расхода, и ограничение max_tokens экономит реальные деньги.
3. Чем сильнее модель, тем дороже токен. Гонять простую сортировку заявок через самую мощную модель - переплата на ровном месте.

Актуальные ставки по каждой модели лежат на официальной странице тарифов. Я их сюда не переношу намеренно: линейка обновляется, и цифры в статье протухнут быстрее, чем вы к ней вернётесь.

Разницу с подпиской путают чаще всего. У подписки лимит считается в сообщениях за окно времени: сколько раз в день вы можете написать модели. Разбор этих лимитов есть в материале про лимиты нейросетей.

У ключа лимита в сообщениях нет вообще. Есть месячный потолок трат и скорость обращений, и это разные вещи. Общая картина по стоимости работы с нейросетями собрана в разборе цен на нейросети.

Какую модель выбрать под задачу?

Таблица моделей, доступных по Claude API, собрана с официальной страницы обзора 4 сентября 2026 года:

Окно контекста в таблице - это сколько текста модель держит в одном разговоре. Сама рекомендация в документации звучит так:

«If you're unsure which model to use, start with Claude Opus 5 for most workloads.»

«Если вы не уверены, какую модель взять, начинайте с Claude Opus 5 для большинства задач».

• Anthropic, обзор моделей

При переносе чужих примеров спотыкаются на идентификаторе. У моделей поколения 4.6 и новее он пишется без даты: claude-opus-5, и форма claude-opus-5-20260724 из старых примеров вернёт ошибку. У более ранних, как Claude Haiku 4.5, основной идентификатор идёт с датой, а короткий claude-haiku-4-5 работает как его сокращение.

Снизить счёт можно тремя способами, и все три официальные:

• Выбор модели. Между младшей и старшей моделью линейки ставка отличается примерно в десять раз. Половина всей экономии берётся отсюда.
• Пакетная обработка. Если ответ не нужен сию секунду, задачи складывают пачкой. По такому режиму документация обещает скидку в половину цены.
• Кеш запроса. Когда в каждое обращение вы подкладываете один и тот же большой кусок текста - регламент, прайс, инструкцию для бота, - его кешируют. Повторное чтение стоит десятую часть обычной входящей ставки, а у самой сильной модели линейки ещё меньше.

Что делать с ошибками 401, 429 и «credit balance is too low»?

Таблица кодов с официальной страницы ошибок:

У 401 есть бытовая причина, о которой редко пишут: при копировании ключа часто прилипает лишний пробел или невидимый перенос. Проверьте хвост строки перед тем, как выпускать новый ключ.

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

«Limits are organized into usage tiers; your organization is placed on a tier automatically and can move to a higher tier over time.»

«Лимиты организованы в уровни использования; ваша организация попадает на уровень автоматически и со временем может перейти на более высокий».

• Anthropic, обзорная страница программного интерфейса

Отсюда практический вывод: резкий скачок нагрузки сам по себе даёт отказы. Документация прямо советует наращивать трафик постепенно и держать ровный режим обращений.

Ошибка с балансом разобрана в третьем шаге: текст один, причин несколько. Разбирайте по порядку - деньги на счёте, тот ли ключ ушёл в запрос, тот ли аккаунт.

В каждом ответе приходит заголовок с идентификатором запроса. Когда пишете в поддержку, приложите его - без него разбор занимает в разы дольше.

Как не потерять ключ и не оплатить чужие запросы?

Ключ Claude API - это доступ к вашим деньгам. С августа 2024 года Anthropic входит в программу поиска секретов GitHub. Механика такая: сервис находит токен в публичном репозитории, пересылает его Anthropic, компания отзывает ключ и уведомляет владельца. Утечка заканчивается сразу двумя неприятностями: чужими тратами по вашему счёту и внезапно отключённым ключом посреди рабочего дня.

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

1. Ключ в менеджер секретов сразу при создании. Консоль покажет его один раз.
2. В код и в конфигурационные файлы ключ не вписывать. Только переменная окружения.
3. Файл .env - в список, который не уходит в репозиторий (он называется .gitignore). Одна строка в файле.
4. Ключа не должно быть в коде страницы, которую открывает браузер. Всё, что уехало в браузер, может прочитать любой посетитель, поэтому обращение к модели идёт с вашего сервера. Чтобы включить прямые запросы из браузера, в библиотеке Anthropic надо явно выставить флаг со словом dangerously в названии - разработчики назвали этот режим опасным своими руками.
5. Разные ключи на разработку, тест и боевой сервис. Утёк один - гасите только его, остальные продолжают работать.
6. Срок жизни и плановая замена. Ключ с датой окончания и замена раз в квартал стоят пяти минут в год.
7. Лимит трат в консоли. Потолок расхода ограничивает цену любой ошибки конечной суммой.

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

Что дальше можно собрать на ключе Claude API?

Русские статьи по теме обычно заканчиваются на фразе «вы получили ключ». Дальше начинается то, ради чего ключ и берут, поэтому дальше - сценарии, которые собираются на нём за считаные дни.

Разбор входящих обращений. Письмо или заявка приходит, модель размечает тему, срочность и нужный отдел, дальше запись падает в учётную систему. Экономит первую линию поддержки.

Подготовка ответов по базе знаний. Регламент и прайс подкладываются в запрос, и ответ собирается по этим документам. Здесь особенно окупается кеш: один и тот же большой кусок текста читается дешевле.

Извлечение данных из документов. Договор, накладная, счёт на входе - таблица с полями на выходе. Проверять результат всё равно нужно, но ручного ввода становится в разы меньше.

Массовая обработка. Тысяча карточек товара, архив обращений, выгрузка отзывов. Задачи складываются пачкой и обсчитываются со скидкой.

Тот же ключ может питать и агента Claude Code. Как Claude Code работает от ключа и чем это отличается от подписки - в отдельном разборе.

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

Где вы сейчас

• Аккаунта нет, доступ не настроен. Начните со второго раздела и с разбора оплаты из России, к шагам вернётесь после.
• Аккаунт есть, ключ не создавали. Ваш следующий шаг - второй и третий шаги инструкции: ключ и деньги на счёте, минут пятнадцать вместе.
• Ключ есть, первый запрос падает с ошибкой. Идите сразу в раздел про коды ошибок, там разобраны 401, 429 и сообщение про низкий баланс.
• Запросы проходят, непонятна экономика. Смотрите разделы про токены и выбор модели: там три рычага, которые снижают счёт без потери качества.

Чек-лист

• Аккаунт в консоли заведён, вход на platform.claude.com повторяется стабильно.
• Ключ создан, начинается с sk-ant- и лежит в менеджере секретов; в переписке и на рабочем столе его нет.
• На счёте есть деньги, а в разделе Billing выставлен месячный потолок трат.
• Первый запрос вернул текст модели, и в ответе виден блок usage.
• Ключ передаётся через переменную окружения, в исходном коде его нет ни одной строкой.
• Файл .env внесён в список, который не уходит в репозиторий, и ключ ни разу не попадал в публичный.
• Модель выбрана под задачу, а max_tokens ограничен разумной длиной ответа.