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

Из России можно отправлять запросы к Claude через Anthropic-compatible API BetterToken. Для этого нужны собственный аккаунт BetterToken, положительный баланс и API Key. Подключение к BetterToken API работает без VPN и не требует иностранной виртуальной карты. Ниже — минимальный запрос в формате Anthropic Messages API и проверка результата в Dashboard.

1. Создайте аккаунт и API Key

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

BetterToken работает по модели Pay-as-you-go: фиксированная месячная подписка не нужна, а пополненный баланс не обнуляется в конце месяца. Пошаговые скриншоты есть в быстром старте BetterToken.

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

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

https://www.bettertoken.ai

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

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

export ANTHROPIC_API_KEY="ваш_ключ_bettertoken"
export ANTHROPIC_BASE_URL="https://www.bettertoken.ai"

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-sonnet-4-6",
    "max_tokens": 64,
    "messages": [{"role": "user", "content": "ping"}]
  }'

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

Идентификаторы моделей меняются. Перед запросом сверьте модель с текущей страницей цен 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

Чем этот доступ отличается от подписки и общего аккаунта

  • Официальный список регионов Claude API не включает Россию.
  • Подписка Claude.ai и API-доступ — разные продукты: подписка к веб-интерфейсу не заменяет API Key.
  • BetterToken не продаёт общие аккаунты Claude.ai. Вы используете собственный аккаунт BetterToken и самостоятельно созданный API Key.

Чтобы начать, создайте аккаунт BetterToken, выпустите API Key и перед запросом ещё раз сверьте Base URL и модель с актуальной документацией.