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

[cybercobra]

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

Подписка Pro сама по себе не оплачивает API-запросы. У некоторых других планов есть программа включённых API-кредитов с отдельными условиями. Ориентируйтесь на реальное начисление в Console, а не только на название подписки.

Где взять API-ключ Claude​

1. Войдите в platform.claude.com и выберите нужную организацию.
2. Откройте API keys и нажмите Create key.
3. Укажите понятное имя, срок действия и связанный аккаунт. Для личной разработки используйте личный ключ; для общего сервиса — ключ сервисного аккаунта.
4. Для примера ниже обязательно ограничьте ключ выбранным workspace, рабочим пространством, в котором будет выполняться запрос.
5. Сохраните секрет в надёжном хранилище. Не вставляйте его в публичный репозиторий, скриншот или сообщение на форуме.

Если приложение стороннее, сначала выясните, где оно хранит ключ и кто получает к нему доступ. Не передавайте рабочий ключ случайному «проверяльщику API».

Первый запрос на Python без ключа в исходнике​

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

В отдельном окружении Python установите официальный пакет командой python -m pip install anthropic. Сохраните следующий код в first_request.py. Он запросит ключ скрытым вводом, поэтому вставлять секрет в сам файл не требуется.

from getpass import getpass
import anthropic

client = anthropic.Anthropic(api_key=getpass("API key: "))
message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=128,
    messages=[{"role": "user", "content": "Ответь одним словом: готово"}],
)
for block in message.content:
    if block.type == "text":
        print(block.text)
print(message.usage)

Запустите python first_request.py. Модель взята из актуального официального Quickstart; перед запуском проверьте её доступность и тариф. Запрос платный, если не покрыт доступными кредитами. max_tokens ограничивает длину ответа, а не весь счёт или число будущих запросов.

Это пример для проверки подключения, а не выполненный нами платный тест. В некоторых средах разработки скрытый ввод работает иначе; запускайте скрипт в обычном терминале, не публикуя его ввод и журналы.

Как понять, что подключение работает​

Успех — это ответ API, текстовый блок и сведения usage о расходе. Сохраните название модели и время проверки. Затем сопоставьте использование с той организацией, где создавали ключ.

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

Что изменить перед подключением сайта или бота​

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

Первую проверку проведите на коротком нейтральном тексте. Конфиденциальные документы подключайте только после проверки правил хранения и доступа.

Источники: создание ключей, официальный Quickstart, условия API-кредитов подписчиков.