Первый запрос к Claude API: API Key, Base URL и проверка

Ниже — короткий воспроизводимый путь от API Key до проверенного ответа в формате Anthropic Messages API. Если вы ещё выбираете способ покупки и подключения Claude API, сначала откройте страницу Claude API для России; эта инструкция начинается с уже созданного аккаунта и показывает только первый технический запрос.

Сценарий использования	Рекомендуемая конфигурация	Что проверить в первую очередь
Интерактивная разработка в терминале	Конфигурационный файл и переменные окружения	Проверьте статус и доступность Model ID
Автоматизированные пайплайны и CI/CD	Headless-режим с прямым endpoint	Убедитесь в корректной обработке таймаутов

1. Подготовьте API Key и Model ID

1. Зарегистрируйтесь на bettertoken.ai.
2. Пополните баланс и убедитесь, что сумма появилась в Dashboard.
3. В блоке Your API keys нажмите Create API key.
4. После создания ключа скопируйте API Key и Base URL из окна настройки. Затем откройте текущий каталог моделей и скопируйте Model ID выбранной модели. Храните ключ в менеджере секретов или локальном .env-файле и не добавляйте его в Git.

Чтобы создать API Key, нужен собственный аккаунт BetterToken. Создать аккаунт BetterToken

Пошаговые скриншоты создания ключа есть в быстром старте BetterToken.

2. Выберите Anthropic-compatible Base URL

Для запроса в формате Anthropic используйте:

https://bettertoken.ai

Base URL для Anthropic SDK и Claude Code остаётся без суффикса /v1: https://bettertoken.ai. Но в исходном HTTP-запросе версия протокола входит в путь. Полный адрес Messages API: https://www.bettertoken.ai/v1/messages. Anthropic SDK добавляет этот путь автоматически.

3. Отправьте первый запрос

export ANTHROPIC_API_KEY="ваш_ключ_bettertoken"
export ANTHROPIC_BASE_URL="https://bettertoken.ai"
export CLAUDE_MODEL_ID="скопируйте_Model_ID_из_текущего_каталога"

curl --fail-with-body "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d "{
    \"model\": \"$CLAUDE_MODEL_ID\",
    \"max_tokens\": 64,
    \"messages\": [{\"role\": \"user\", \"content\": \"ping\"}]
  }"

Строка -H "x-api-key: $ANTHROPIC_API_KEY" передаёт значение уже заданной переменной окружения и не записывает ключ в текст запроса. Перед выполнением замените значения-заглушки для ключа и Model ID в своей локальной сессии. Не публикуйте команду после подстановки реального ключа.

Идентификаторы моделей меняются. Перед запросом сверьте модель с текущей страницей цен BetterToken и API Reference.

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

Успешный запрос возвращает HTTP 200 и JSON-объект сообщения. Проверьте три поля:

• type имеет значение message;
• массив content содержит ответ модели;
• объект usage содержит количество входных и выходных токенов.

Формат ответа описан в официальном Anthropic Messages API.

Затем откройте Dashboard BetterToken и найдите запрос по времени. В записи видны модель, статус, input/output/cache tokens и соответствующее списание. Так можно проверить не только ответ curl, но и фактический учёт запроса.

5. Исправьте типовые ошибки

• 404 или неверный маршрут. Для исходного Anthropic-compatible HTTP-запроса нужен путь /v1/messages. Путь /messages неполный.
• 400. Проверьте anthropic-version, content-type, model, max_tokens и массив messages.
• 401 или 403. Проверьте API Key, выбранную для него группу и Base URL. Не отправляйте ключ в поддержку или скриншот.
• 429. Прочитайте тело ответа и повторяйте запрос только после указанной паузы. Отдельно проверьте баланс и историю запросов в Dashboard.

Если в текущей shell-сессии остались переменные другого провайдера, очистите их перед повторной настройкой:

unset ANTHROPIC_API_KEY
unset ANTHROPIC_BASE_URL

После исправления повторите тот же короткий запрос и снова сопоставьте HTTP-ответ с записью в Dashboard. Для следующего шага — SDK, streaming и production-конфигурации — используйте актуальную API Reference.

Как проверить стоимость без устаревших цифр

Model ID, доступность и ставки могут меняться. Перед расчётом возьмите текущие цены input, output и cache Token из каталога BetterToken, подставьте объём своего запроса, а после минимального теста сверьте фактическое списание в Dashboard. Не переносите цену или cache discount одной модели на другую.