Из России можно отправлять запросы к Claude через Anthropic-compatible API BetterToken. Для этого нужны собственный аккаунт BetterToken, положительный баланс и API Key. Подключение к BetterToken API работает без VPN и не требует иностранной виртуальной карты. Ниже — минимальный запрос в формате Anthropic Messages API и проверка результата в Dashboard.
1. Создайте аккаунт и API Key
- Зарегистрируйтесь на bettertoken.ai.
- Пополните баланс и убедитесь, что сумма появилась в Dashboard.
- В блоке Your API keys нажмите Create API key.
- После создания ключа скопируйте 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 и модель с актуальной документацией.