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

API-ключ Claude создаётся в Claude Console (бывшая Anthropic Console): Settings → API keys → Create key. Скопируйте строку с началом sk-ant- сразу: Console показывает ключ только один раз, а для запросов на балансе нужны кредиты.

Ключ и сам API: в чём разница

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

В обычном аккаунте Console API работает по предоплате: вы покупаете кредиты, и из баланса списывается стоимость успешных вызовов. За неудачные запросы плата не взимается. Отдельная подписка для API не нужна: кредиты покрывают API, playground и Claude Code, но когда баланс закончится, вы не сможете вызвать API или пользоваться playground, пока не пополните счёт.

Где взять ключ: пошагово в Claude Console

Порядок ниже повторяет официальную инструкцию, между входом и созданием ключа добавлено пополнение баланса:

1. Откройте platform.claude.com и войдите в аккаунт. Если аккаунта нет, зарегистрируйтесь. Старый адрес console.anthropic.com перенаправляет в этот же кабинет.
2. В Settings → Billing нажмите Buy credits, введите сумму и пополните баланс кредитами с банковской карты.
3. Перейдите в Settings → API keys или откройте страницу ключей.
4. Нажмите Create key и дайте ключу понятное имя, например Production или Local Dev. Выберите срок действия и Linked account: для своей разработки укажите себя, для общего проекта или сервера используйте сервисный аккаунт. Выберите и рабочее пространство (workspace): ключ без него требует заголовок anthropic-workspace-id в каждом запросе, и пример кода ниже без этого заголовка вернёт ошибку 400. Если кнопка неактивна и ваша роль не разрешает создавать ключи, обратитесь к администратору организации, чтобы он изменил роль или создал ключ сервисного аккаунта для вашей задачи.
5. Скопируйте ключ сразу: он начинается с sk-ant- и показывается только один раз. Если потеряете строку или закроете окно без копирования, снова посмотреть её в Console нельзя: удалите потерянный ключ и создайте новый.

Срок действия ключа можно задать на 3 часа, 1 день, 7 дней, 30 дней, выбрать свой срок или Never. Для личной работы сразу привяжите ключ к одному workspace: если ключ не ограничен рабочим пространством, в каждом запросе придётся передавать его идентификатор в заголовке anthropic-workspace-id.

Покупать кредиты могут пользователи с ролью Admin или Billing. Купленные кредиты действуют год со дня покупки. Деньги за них не возвращаются. В Settings → Billing можно включить Auto-reload: когда баланс опустится ниже выбранного порога, он пополнится автоматически.

Как создать аккаунт и оплатить из России

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

1. Откройте platform.claude.com и зарегистрируйтесь. Если аккаунт уже есть, войдите в него.
2. Подготовьте банковскую карту: российские карты для такой оплаты не подходят. Виртуальную карту с зарубежным BIN (Visa или Mastercard), выпущенную иностранным банком или финтех-сервисом и пополняемую в долларах или евро, можно рассматривать как вариант карты. Она должна соответствовать тем же требованиям к платёжному адресу; сама по себе виртуальная карта не гарантирует успешную оплату.
3. Сверьте платёжный адрес с адресом, записанным в банке. Даже небольшое расхождение, например пропущенный диакритический знак или опечатка в названии улицы, может привести к отказу. Подготовьтесь подтвердить платёж через 3-D Secure, если это потребуется. Anthropic не принимает сторонние платёжные сервисы вроде PayPal и Venmo, оплата проходит банковской картой.
4. В Settings → Billing нажмите Buy credits, введите сумму и пополните баланс кредитами с банковской карты.

В статье как оплатить Claude из России собраны способы оплаты подписки. Для баланса API требования к карте сохраняются: платёжный адрес должен быть в поддерживаемой стране. У посредника заранее уточните, пополняет ли он именно баланс API. Перед оплатой перепроверьте актуальность предложений из обзоров оплаты Anthropic из РФ.

Перед пополнением проверьте страну доступа по списку Anthropic: Россия в него не входит, и зарубежная карта не снимает ограничение доступа к Claude API и Claude.ai с российского IP.

По теме: Claude API: что это, как подключить из России и цены 2026

Куда вставлять ключ

Ключ вставляют в настройки приложения или передают программе через переменную ANTHROPIC_API_KEY. Официальные SDK Anthropic читают её автоматически; при создании клиента ключ также можно передать явно:

• В приложениях и инструментах вайбкодинга найдите поле Anthropic API key в настройках. Вставьте туда ключ и сохраните.
• Для локальной разработки и серверов задайте ANTHROPIC_API_KEY в окружении или храните ключ в менеджере секретов. Прописывать секретную строку в исходниках не нужно.
• При явной передаче используйте параметр клиента SDK, например Anthropic(api_key=...). Не сохраняйте настоящий ключ в файле с кодом.

В Claude Code ключ тоже задаётся через ANTHROPIC_API_KEY. При первом запуске в интерактивном режиме программа один раз спрашивает, использовать ли его, и после вашего согласия ключ получает приоритет перед входом по подписке Pro или Max: запросы оплачиваются с баланса API. Чтобы вернуться к подписке, выполните unset ANTHROPIC_API_KEY, а затем проверьте активный способ входа командой /status. Остальные команды и порядок работы собраны в инструкции как пользоваться Claude Code.

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

Первый запрос на Python можно отправить через официальный SDK: установите пакет командой pip install anthropic и задайте ключ в окружении. На 7 октября 2026 актуальна версия 1.11.0, нужен Python 3.10 или новее. В примере ниже строка sk-ant-api03-... служит заглушкой; подставьте свой ключ только в команду для терминала.

pip install anthropic
export ANTHROPIC_API_KEY="sk-ant-api03-..."

В Windows вместо export выполните setx ANTHROPIC_API_KEY "sk-ant-api03-...", затем откройте новое окно терминала, чтобы переменная стала доступна программе.

Для Claude Sonnet 5.5 в таблице моделей указан идентификатор claude-sonnet-5-5. Клиент anthropic.Anthropic() возьмёт ключ из окружения и отправит запрос с этим идентификатором, текстом сообщения и ограничением max_tokens=1000, после чего цикл выведет текстовые блоки из полученного ответа:

import anthropic

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

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

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

Не вписывайте ключ в файл с кодом и не отправляйте его в репозиторий; если храните строку в .env, добавьте этот файл в .gitignore, чтобы секрет не попал в историю проекта вместе с остальными файлами.

Для JavaScript и TypeScript установите пакет командой npm install @anthropic-ai/sdk; актуальная версия на 7 октября 2026 составляет 0.131.0. TypeScript SDK поддерживает Node.js 20 LTS и новее, а клиент new Anthropic() тоже читает ANTHROPIC_API_KEY. Запросы к Claude делайте с сервера: SDK по умолчанию отключён для браузера, потому что любой посетитель сайта может посмотреть его код, найти там ключ и использовать его для своих запросов.

Безопасность ключа

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

• Не публикуйте ключ в открытом коде, скриншотах и чатах. Не коммитьте его в публичный репозиторий на GitHub.
• Храните ключ в переменной окружения или менеджере секретов, не записывая секретную строку в текст программы.
• Заведите разные ключи под разные задачи и удаляйте те, что больше не нужны, в разделе API keys.
• На странице API keys действие Disable временно отключает ключ, а Delete удаляет его навсегда. Отключение можно отменить. Если ключ мог утечь, удалите его и создайте новый.
• В Settings → Billing откройте Spend limits и нажмите Set limit или Adjust limit, чтобы задать лимит расходов. Он не может превышать потолок вашего уровня и ограничивает траты при случайном цикле запросов.

Anthropic вместе с GitHub ищет ключи Claude в публичных репозиториях. Найденный ключ автоматически деактивируется, а владелец получает уведомление. Если вы выложили ключ вместе с кодом, удалите его в Console и создайте новый, затем обновите строку в приложениях, которые им пользовались.

По теме: Claude 403: как безопасно найти причину и исправить в 2026

Ошибка invalid api key и другие частые проблемы

Ошибка 401 authentication_error, в том числе с сообщением invalid x-api-key, означает проблему с ключом. В официальном справочнике ошибок среди причин названы неверный формат, отзыв и истечение срока. Проверьте строку ключа, его состояние в кабинете, адрес API и заголовок, в котором программа отправляет ключ:

• При копировании мог попасть невидимый пробел или перенос строки в конце. Скопируйте ключ заново и уберите пробелы по краям; эта причина описана в справочнике по ошибкам Claude API.
• Ключ мог быть удалён, отключён через Disable или просрочен. Выпуск нового ключа не отключает уже созданные. После истечения срока запросы получают 401 authentication_error; вернуть просроченный ключ в работу или продлить его нельзя, нужно создать новый.
• Ключ и адрес должны быть из одной системы. Если base_url указывает на прокси, а ключ официальный, или наоборот, запрос тоже вернёт 401. Проверьте, какой адрес вы указали и откуда получили ключ.
• Если ключ попал в публичный репозиторий GitHub, Anthropic могла автоматически деактивировать его. Проверьте почту: Anthropic присылает владельцу ключа письмо об отключении. Замените скомпрометированный ключ новым.

Сам API принимает ключ в заголовке Authorization: Bearer или в прежнем x-api-key, оба варианта поддерживаются. Переменную ANTHROPIC_API_KEY читают SDK и Claude Code, а не сервер API. Для прямой работы с api.anthropic.com ключом из Console используйте ANTHROPIC_API_KEY.

В Claude Code переменная задаёт заголовок запроса: ANTHROPIC_API_KEY передаётся в x-api-key, а ANTHROPIC_AUTH_TOKEN в Authorization: Bearer. Если вы настроили свой шлюз через ANTHROPIC_BASE_URL, выбирайте переменную по его требованиям: для bearer token нужна ANTHROPIC_AUTH_TOKEN, для API key (заголовок x-api-key) нужна ANTHROPIC_API_KEY. Ключ в неверной переменной попадёт в заголовок, который шлюз не читает, и запрос завершится ошибкой 401.

Ошибка 402 billing_error указывает на проблему с оплатой или платёжными данными: проверьте Billing. Если закончились кредиты, пополните баланс, иначе вызовы API останутся недоступны.

При ошибке 429 rate_limit_error превышен лимит запросов или месячный потолок трат вашего уровня. При ограничении частоты подождите время из заголовка retry-after. Если достигнут ваш собственный лимит расходов, ответ будет 400 invalid_request_error с текстом «You have reached your specified API usage limits». Перевыпуск ключа при проблемах с оплатой и лимитами не поможет.

Сколько стоит использование ключа в 2026

Отдельной платы за ключ нет. Базовые вызовы оплачиваются за входные и выходные токены; некоторые серверные инструменты стоят отдельно, например веб-поиск стоит 10 долларов за 1000 поисков сверх стоимости токенов. На октябрь 2026 в официальной таблице цен указаны следующие суммы в долларах за 1 миллион токенов ввода и вывода:

• Claude Haiku 5.5: ввод 0,10 доллара, вывод 0,50 доллара для запросов до 100 тыс. токенов (для более длинных 0,50 и 2,50 доллара).
• Claude Sonnet 5.5: ввод 2 доллара, вывод 10 долларов.
• Claude Opus 5.5: ввод 4 доллара, вывод 20 долларов.
• Claude Fable 5.1: ввод 10 долларов, вывод 50 долларов.

В текущей линейке моделей Haiku 5.5 самая быстрая, Sonnet 5.5 сочетает скорость и качество, а Fable 5.1 предназначена для самых сложных задач. Если вы пока не знаете, какую модель выбрать, документация предлагает начинать с Opus 5.5. Прежние Opus 4.8 и Haiku 4.5 перенесены в список legacy-моделей.

Чтение из кэша промптов стоит 10% обычной цены ввода, у Opus 5.5 и Sonnet 5.5 5%, у Fable 5.1 2,5%. Batch API даёт скидку 50% на входные и выходные токены при асинхронной обработке запросов. Сопоставить цены подписок и API можно в статье сколько стоит Claude.

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

Ключ API и подписка Claude Pro это одно и то же?

Нет. Подписка Pro или Max открывает чат на claude.ai и лимиты в приложениях, а API-ключ это отдельный доступ с оплатой по факту за токены. Одно другое не заменяет.

Можно ли получить ключ бесплатно?

Сам ключ бесплатный, но для вызовов API нужен положительный баланс кредитов. Новым пользователям Anthropic даёт небольшую сумму бесплатных кредитов на проверку API; для постоянной работы баланс придётся пополнять. Обычный аккаунт Console работает по предоплате.

Почему при вставке ключа пишет invalid api key?

Причиной может быть лишний пробел при копировании, удалённый, отключённый или просроченный ключ, неверный заголовок либо адрес. Выпуск нового ключа не отключает уже созданные. Скопируйте ключ заново без пробелов и проверьте, что обращаетесь к api.anthropic.com через ANTHROPIC_API_KEY.

Что делать, если потерял ключ?

Потерянный ключ нельзя снова посмотреть в Console. Зайдите в Settings → API keys, удалите потерянный и создайте новый, затем обновите его во всех приложениях.

По теме: OpenCode с Claude: подключение и безопасная настройка в 2026

Что построить с API-ключом

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

Если до агентов пока далеко, начните с более простого проекта: сайта, собранного в диалоге с Claude. Пошаговый разбор: как сделать сайт с помощью Claude.