Claude Code в России в 2026: установка, API-ключ и оплата в рублях

Короткий ответ

Пользоваться Claude Code в России можно. Сама программа ставится как обычно — через npm, — а работать ей нужен доступ к моделям Claude. Официальный путь через аккаунт Anthropic из России закрыт: Россия не входит в список поддерживаемых стран, поэтому не проходят регистрация и оплата подписки. Claude Code умеет работать через сторонний API-шлюз: вы задаёте две переменные окружения — адрес шлюза и ключ, — и программа обращается к моделям Claude через него, без входа в аккаунт Anthropic. Ниже — установка на трёх системах, подключение через TeamoRouter, первый запуск и разбор ошибок, которые чаще всего встречаются на этом пути. Оплата — в рублях или в USDT.

Что такое Claude Code

Claude Code — AI-агент для программирования от Anthropic, который работает в терминале. В отличие от Claude в браузере, он видит ваш проект целиком: читает файлы, запускает команды, правит код сразу в нескольких местах и проверяет результат тестами. Вы ставите задачу обычными словами — «найди, почему падает этот тест, и почини» — а Claude Code сам решает, какие файлы открыть и что поменять, и показывает изменения перед тем, как их применить.

Работает он на моделях Claude: по умолчанию на Sonnet, для сложных задач можно переключиться на Opus.

Что не работает из России и почему

Узкое место — не сама программа, а аккаунт и оплата. Поэтому решение — взять модели из другого источника, а не через аккаунт Anthropic. Claude Code официально поддерживает работу через LLM-шлюзы: достаточно указать адрес шлюза в ANTHROPIC_BASE_URL и ключ в ANTHROPIC_AUTH_TOKEN. TeamoRouter — такой шлюз: вы регистрируетесь у нас, пополняете баланс в рублях и получаете ключ, а Claude Code ходит к моделям Claude через api.teamorouter.com. VPN для этого не нужен.

Шаг 1. Установка

Что нужно заранее

• Node.js 22 или новее. Скачайте LTS-версию с nodejs.org или на macOS выполните brew install node. Проверка: node --version должна показать v22 или выше.
• Windows: Git for Windows. Скачайте с git-scm.com и установите с настройками по умолчанию — Claude Code использует его оболочку.

Установка

Откройте терминал (на Windows — PowerShell или «Терминал») и выполните:

npm install -g @anthropic-ai/claude-code

Проверьте версию:

claude --version

Должно появиться что-то вроде 2.1.284 (Claude Code). Если у вас уже стоял Claude Code, обновитесь: новые модели появляются в программе вместе с новыми версиями, и старая версия может их не узнать (подробнее — в разделе об ошибках).

claude update

У Anthropic есть и отдельный установщик, который скачивается с сайта claude.ai. Если этот сайт у вас не открывается, используйте npm — результат тот же.

Пошаговая инструкция со скриншотами для каждой системы — в руководстве по установке Claude Code.

Шаг 2. Ключ и подключение

Получите ключ

Зарегистрируйтесь на TeamoRouter, пополните баланс (как — ниже, в разделе об оплате) и создайте API-ключ в консоли. Ключ показывается один раз — сохраните его.

Пропишите переменные окружения

macOS и Linux — добавьте в ~/.zshrc (или ~/.bashrc, если у вас bash):

export ANTHROPIC_BASE_URL=https://api.teamorouter.com
export ANTHROPIC_AUTH_TOKEN="ваш ключ TeamoRouter"
export ANTHROPIC_MODEL=claude-sonnet-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Затем выполните source ~/.zshrc.

Windows (PowerShell):

setx ANTHROPIC_BASE_URL "https://api.teamorouter.com"
setx ANTHROPIC_AUTH_TOKEN "ваш ключ TeamoRouter"
setx ANTHROPIC_MODEL "claude-sonnet-5-5"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "claude-sonnet-5-5"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "claude-opus-5-5"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "claude-haiku-4-5"

setx записывает переменные навсегда, но только для новых окон: закройте терминал и откройте заново.

Что означает каждая строка:

• ANTHROPIC_BASE_URL — куда Claude Code отправляет запросы. Адрес указывается без /v1 на конце.
• ANTHROPIC_AUTH_TOKEN — ваш ключ. Когда он задан, входить в аккаунт через /login не нужно.
• ANTHROPIC_MODEL — модель, на которой стартует сессия. Мы ставим Sonnet 5.5: быстрая и вдвое дешевле Opus.
• ANTHROPIC_DEFAULT_SONNET_MODEL / ..._OPUS_MODEL / ..._HAIKU_MODEL — во что разрешаются пункты sonnet, opus и haiku в меню /model.

Шаг 3. Первый запуск

Перейдите в папку проекта и запустите Claude Code:

cd ~/projects/my-app
claude

Что сделать в первые десять минут:

1. Попросите описать проект. Например: «Кратко опиши, как устроен этот проект и где точка входа». Это быстрый способ убедиться, что подключение работает, и заодно посмотреть, как агент читает код.
2. Выполните /init. Claude Code изучит репозиторий и создаст файл CLAUDE.md с описанием проекта — его он будет читать в начале каждой сессии. Поправьте файл руками: добавьте команды сборки и тестов, правила кода.
3. Дайте небольшую задачу. Например: «Добавь проверку пустой строки в функцию parse_date и тест на это». Claude Code покажет изменения и попросит подтверждение перед записью файлов и запуском команд.
4. Проверьте /model. В списке должны быть sonnet (→ claude-sonnet-5-5) и opus (→ claude-opus-5-5). На Opus стоит переключаться под сложную задачу — большой рефакторинг, незнакомый код — и возвращаться обратно.
5. Посмотрите /cost. Команда показывает, сколько токенов и денег ушло за текущую сессию. Так проще почувствовать реальный расход, чем по таблицам.

Сколько это стоит

Оплата за токены, без подписки: вы платите только за то, что модель прочитала и написала. Обычная рабочая сессия на среднем проекте на Sonnet 5.5 стоит десятки центов, на Opus 5.5 — примерно вдвое дороже. Большую часть входа при повторных запросах составляет один и тот же код, и он тарифицируется по сниженной цене чтения кэша, поэтому длинные сессии дешевле, чем кажется по прайсу.

Точные цены — на странице цен, разбор на типичных задачах — в статье «Сколько стоит Claude Code на самом деле».

Как оплатить из России

Баланс пополняется в консоли, списание — только за фактически использованные токены; минимального пакета и «сгорающих» тарифов нет.

• Рубли — в окне пополнения нажмите «Оплатить» и выберите способ: СБП, Т-Банк, карта Visa / Mastercard / Мир, ЮMoney или SberPay. Платёж проводит платёжный сервис Payssion. Минимальное пополнение — $5.
• USDT — кнопка «Оплатить криптовалютой» в том же окне: переведите USDT на показанный адрес, зачисление занимает от одной до пяти минут.

Частые ошибки

Ниже — сообщения в том виде, в каком их выводит Claude Code. Первые четыре мы воспроизвели сами, намеренно ошибаясь в настройке.

Not logged in · Please run /login Claude Code не видит ключ и предлагает войти в аккаунт Anthropic. Не входите — это официальный путь, который из России не работает. Причина в том, что переменная ANTHROPIC_AUTH_TOKEN не задана в этом терминале. Проверьте: echo $ANTHROPIC_AUTH_TOKEN (на Windows — echo $env:ANTHROPIC_AUTH_TOKEN). Если пусто — выполните source ~/.zshrc или, на Windows, откройте новое окно после setx.

Failed to authenticate. API Error: 401 The provided bearer token could not be validated as either a Teamo API key or an OAuth/session token. Ключ дошёл до TeamoRouter, но не подошёл. Чаще всего ключ скопирован не полностью или с пробелом, либо ключ удалён в консоли. Создайте новый ключ и вставьте его заново.

There's an issue with the selected model (...). It may not exist or you may not have access to it. Две частые причины. Первая — в ANTHROPIC_BASE_URL на конце стоит /v1: Claude Code сам добавляет нужный путь, адрес должен быть ровно https://api.teamorouter.com. Вторая — опечатка в имени модели: проверьте, что пишете claude-sonnet-5-5 через дефисы, а не claude-sonnet-5.5.

"claude-sonnet-5-5" isn't described by this version's model catalog; update Claude Code… Ваша версия Claude Code старше модели. Программа продолжит работать, но будет считать контекст равным 200 тысячам токенов и раньше сжимать сессию. Выполните claude update и проверьте claude --version: Sonnet 5.5 знают версии начиная с 2.1.284.

claude: command not found (на Windows — «Имя "claude" не распознано…») Терминал не видит глобально установленные npm-пакеты. Закройте и снова откройте терминал после установки; если не помогло — проверьте, что папка из npm config get prefix добавлена в PATH.

Частые вопросы

Нужен ли VPN? Нет. Claude Code обращается к api.teamorouter.com, а не к серверам Anthropic, и вход в аккаунт Anthropic не нужен.

Это те же модели Claude, что у Anthropic? Да: запросы уходят к моделям Claude, TeamoRouter их не подменяет. Идентификаторы те же, что в официальной документации: claude-sonnet-5-5, claude-opus-5-5.

Можно ли пользоваться Claude Code в России бесплатно? Сама программа бесплатна, а работа моделей оплачивается по токенам. Бесплатного безлимита нет ни у Anthropic, ни у шлюзов; зато нет и подписки — если за месяц Claude Code не запускали, вы ничего не платите.

Работает ли расширение для VS Code и JetBrains? Расширения используют тот же Claude Code. Если переменные окружения заданы в системе, как выше, перезапустите редактор, чтобы он их подхватил; для одного проекта настройки можно положить в .claude/settings.json в корне репозитория.

Есть ли лимиты? Лимитов подписки, которые «сгорают» за пять часов или неделю, нет — есть ограничения на частоту запросов для каждой модели, они указаны на странице лимитов.

Что дальше

• Claude Sonnet 5.5: цена и настройка — модель по умолчанию и когда переключаться на Opus.
• Claude Opus 5.5 через API — для самых сложных задач.
• Codex в России — если хотите попробовать агент от OpenAI с тем же ключом.
• Создать API-ключ.