Claude Code можно использовать в России без постоянно включённого VPN: вместо прямого доступа к Claude.ai или официальному Anthropic API инструмент подключается к BetterToken — независимому провайдеру с собственным Anthropic-совместимым API, а не к официальному сервису Anthropic. Дальше — минимальный путь: аккаунт и API Key группы Claude, ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, запуск и проверка первого ответа.

Что понадобится для подключения

Перед настройкой должно быть готово:

Установленный Claude Code.
Аккаунт BetterToken с достаточным балансом для первого запроса.
API Key BetterToken группы Claude — именно эта группа предназначена для Claude Code.

Группу ключа нужно выбрать сразу правильно, потому что от неё зависит конфигурация Claude Code. Эта статья описывает только путь для ключа группы Claude — он настраивается по шагам ниже без дополнительных model-переменных. Если ваш ключ создан для группы GPT, для Claude Code потребуется отдельная конфигурация с указанием моделей — это отдельный сценарий, который здесь не рассматривается.

Как настроить Claude Code через BetterToken

Зарегистрируйтесь на BetterToken. Откройте страницу регистрации на bettertoken.ai и создайте аккаунт.
Проверьте баланс. Если его недостаточно для первого запроса, в консоли откройте карточку «Аккаунт», нажмите «Пополнить» и после оплаты убедитесь, что баланс обновился.
Создайте API Key группы Claude. В блоке «Ваши API-ключи» нажмите «Создать API-ключ», укажите название и выберите группу Claude. Скопируйте ключ сразу после создания и сохраните его в надёжном месте — не в коде и не в конфигурационных файлах.
Очистите старые переменные окружения, чтобы они не перекрыли конфиг-файл:

unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_BASE_URL

Откройте конфиг-файл Claude Code. Расположение зависит от системы:

macOS / Linux: ~/.claude/settings.json
Windows: %USERPROFILE%\.claude\settings.json

Пропишите Base URL и токен. Для ключа группы Claude конфиг простой — модельные переменные не нужны, Claude Code сам управляет выбором модели:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://bettertoken.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "3000000"
  }
}

Важно: ANTHROPIC_BASE_URL — это https://bettertoken.ai без /v1 в конце. Это самая частая ошибка при настройке.

Перезапустите Claude Code. Полностью закройте инструмент и откройте заново, чтобы конфиг подхватился.

Если вы работаете в VS Code через расширение Claude Code, те же четыре переменные (ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, API_TIMEOUT_MS) задаются в настройках расширения claudeCode.environmentVariables, а не в settings.json.

Как проверить подключение

Запустите Claude Code и отправьте любое сообщение — например, попросите объяснить один файл из вашего проекта. Обычный содержательный ответ означает, что Base URL и токен настроены верно и запрос ушёл через BetterToken. Если вместо ответа приходит ошибка авторизации, таймаут или модель не находится — переходите к разделу ниже.

Что делать при ошибке авторизации или старых переменных

Если после перезапуска Claude Code не отвечает или выдаёт ошибку, проверьте по порядку:

ANTHROPIC_AUTH_TOKEN в конфиге содержит именно API Key BetterToken, без лишних пробелов и кавычек.
ANTHROPIC_BASE_URL равен ровно https://bettertoken.ai — без /v1 и без завершающего слэша.
Ключ создан именно для группы Claude и не содержит ANTHROPIC_MODEL и других model-переменных. Если ключ относится к группе GPT, конфигурация другая и в этой статье не рассматривается.
В окружении не остались старые ANTHROPIC_AUTH_TOKEN или ANTHROPIC_BASE_URL, заданные ранее через export или профиль оболочки — они перекрывают значения из settings.json. Если сомневаетесь, выполните unset из шага 4 ещё раз и перезапустите терминал вместе с Claude Code.

Проверяйте эти пункты по порядку — от токена и Base URL до группы ключа и старых переменных окружения: так быстрее всего найти причину ошибки.

Почему это работает без VPN

Официальная подписка Anthropic — это подписочная модель, и из России доступ к ней обычно требует VPN как отдельный шаг. Подключение через BetterToken построено на pay-as-you-go: с баланса списываются токены по факту использования, а сам баланс не сгорает, если его не потратили сразу — вернуться к работе можно спустя недели без повторной оплаты.

Это же даёт запасной путь, если лимит официальной подписки Claude Code закончился раньше срока: можно на время переключить ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN на конфигурацию BetterToken из этого гайда и продолжить работу, не дожидаясь обновления лимита.

Что смотреть в документации дальше

Эта статья закрывает базовый путь для ключа группы Claude — от регистрации до первого проверенного ответа. Часть деталей может меняться быстрее, чем публикуется статья: ID моделей для группы GPT, поведение CC Switch и настройка VS Code extension. Актуальные версии смотрите в документации BetterToken: Быстрый старт и Claude Code.