samlee

Как подключить Claude Code в России в 2026 году: 4 способа и чек-лист выбора шлюза

Актуально на 9 ноября 2026 года.

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

Почему одной установки мало

Россия не входит в список стран, где Anthropic официально предоставляет свои сервисы (anthropic.com/supported-countries). Это касается и Claude.ai, и Claude Code, и API. В начале октября 2026 года пользователи из России снова пожаловались на блокировки аккаунтов Claude, в том числе платных (The Moscow Times со ссылкой на The Bell, 02.10.2026). А в конце октября Claude начал запрашивать у части пользователей паспорт и блокировать аккаунты с российскими документами (The Moscow Times, 29.10.2026).

При этом сам Claude Code не обязательно привязан к аккаунту Anthropic. Он умеет отправлять запросы на сторонний адрес — так называемый LLM-шлюз. Именно на этом построено большинство рабочих вариантов.

Как Claude Code работает со сторонним API

Адрес и ключ задаются переменными окружения:

  • export ANTHROPIC_BASE_URL="https://адрес-шлюза"
  • export ANTHROPIC_AUTH_TOKEN="ключ-шлюза"

Главное требование к шлюзу — формат Anthropic Messages API (/v1/messages). В документации Claude Code для шлюзов, которые подключают через ANTHROPIC_BASE_URL, описан именно он (code.claude.com/docs/en/llm-gateway-protocol). Если сервис умеет только формат OpenAI (/v1/chat/completions), понадобится промежуточный конвертер — например, claude-code-router или LiteLLM. Это лишнее звено, и часть возможностей (кэширование, расширенное мышление) через него может работать не так, как у Anthropic.

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

1. Аккаунт Anthropic (Pro / Max).

  • Что нужно: аккаунт и оплата из поддерживаемой страны.
  • Плюсы: официально, все функции.
  • Минусы: Россия не поддерживается, аккаунты блокируют; Pro — $20 в месяц, Max — от $100, российские карты не принимаются.

2. Облака: Amazon Bedrock, Google Vertex AI, Microsoft Foundry.

  • Что нужно: аккаунт в облаке.
  • Плюсы: подходит компаниям (SLA и счета от облака); Claude Code поддерживает их из коробки.
  • Минусы: регистрация и оплата из России там недоступны; сложная настройка.

3. OpenRouter.

  • Что нужно: аккаунт OpenRouter.
  • Плюсы: много моделей, есть официальная инструкция для Claude Code.
  • Минусы: с российских IP отвечает ошибкой 403 (проверка 09.11.2026 из пяти российских сетей).

4. API-шлюз, доступный из России.

  • Что нужно: регистрация и пополнение баланса.
  • Плюсы: работает из России напрямую, без иностранной карты, оплата только за использованные токены.
  • Минусы: нужно доверять посреднику; шлюзы сильно отличаются по возможностям.

Для большинства разработчиков в России реальный выбор — между шлюзами для русскоязычных пользователей. Их уже немало (например, AITUNNEL, ProxyAPI, RuAPI), и устроены они по-разному.

Как выбрать шлюз: чек-лист

  1. Нативный Anthropic Messages API. Проверьте в документации, принимает ли шлюз /v1/messages. Если только OpenAI-формат — придётся ставить конвертер.
  2. Инструменты и потоковые ответы. Claude Code постоянно вызывает инструменты (чтение файлов, команды) и ждёт потоковый ответ. Без этого он не работает.
  3. Кэширование промптов. Claude Code на каждом шаге заново отправляет весь контекст проекта. Если шлюз поддерживает кэширование Anthropic (метки cache_control), повторно отправленный контекст обходится примерно в 10 раз дешевле. Без кэша длинная сессия может стоить в разы больше.
  4. Оплата. Рубли, USDT, иностранная карта — что подходит именно вам. Посмотрите минимальное пополнение и нет ли абонентской платы.
  5. Модели. Нужны только Claude или ещё DeepSeek, GPT, Gemini? Некоторые шлюзы умеют запускать Claude Code и на других моделях — для простых задач это заметно дешевле.
  6. Прозрачность. Хороший признак — понятная документация, страница статуса и поддержка, которая отвечает.

Настройка по шагам

Шаги одинаковые для любого шлюза с нативным Anthropic API — меняются только адрес и ключ.

1. Установите Claude Code через npm (нужен Node.js 22 или новее):

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

Команда одинаковая для macOS, Linux и Windows (PowerShell). Официальный установщик с claude.ai из России обычно не открывается, а npm ставит ту же программу.

2. Получите ключ в личном кабинете шлюза.

3. Задайте адрес и ключ. Адрес берите из документации шлюза; обычно он указывается без /v1 в конце.

macOS и Linux:

  • export ANTHROPIC_BASE_URL="https://адрес-шлюза"
  • export ANTHROPIC_AUTH_TOKEN="ваш-ключ"
  • claude

Windows (PowerShell):

  • $env:ANTHROPIC_BASE_URL = "https://адрес-шлюза"
  • $env:ANTHROPIC_AUTH_TOKEN = "ваш-ключ"
  • claude

Чтобы не вводить переменные каждый раз, впишите их в блок "env" файла ~/.claude/settings.json (в Windows — %USERPROFILE%\.claude\settings.json):

  • { "env": { "ANTHROPIC_BASE_URL": "https://адрес-шлюза", "ANTHROPIC_AUTH_TOKEN": "ваш-ключ" } }

4. Проверьте. В Claude Code введите /status. В строке Anthropic base URL должен быть указан адрес шлюза. Если этой строки нет — переменные не подхватились, откройте новый терминал.

5. Выберите модель, например /model claude-sonnet-5-5 для повседневной работы или /model claude-opus-5-5 для сложных задач. Точные названия моделей смотрите в документации шлюза.

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

  • «Invalid API key» или 401. Запросы ушли не на шлюз (не задан ANTHROPIC_BASE_URL), ключ неверный или в окружении остался старый ANTHROPIC_API_KEY. Уберите его, а ключ шлюза держите в ANTHROPIC_AUTH_TOKEN.
  • 404. Чаще всего лишний /v1 в конце адреса: Claude Code сам добавляет /v1/messages.
  • «Unable to connect to Anthropic services» при первом запуске. В некоторых версиях Claude Code при первом запуске проверяет связь с api.anthropic.com, даже если задан ANTHROPIC_BASE_URL. Обход: добавьте "hasCompletedOnboarding": true в файл ~/.claude.json (Windows: %USERPROFILE%\.claude.json) и перезапустите claude. Если файла нет или он пустой, его содержимое должно быть таким: { "hasCompletedOnboarding": true }.

Как не переплатить

  • Проверьте, что кэширование действительно работает: в статистике шлюза у запросов должна быть заметная доля «кэшированных» токенов.
  • Для простых задач (переименования, тесты, мелкие правки) переключайтесь на более дешёвую модель через /model, если шлюз это позволяет.
  • Длинные сессии периодически сжимайте командой /compact: чем короче контекст, тем дешевле каждый шаг.

Итог

Официальный путь из России сейчас закрыт, OpenRouter с российских IP отвечает ошибкой 403, а в облаках AWS, Google и Microsoft регистрация и оплата из России недоступны. Рабочий вариант — API-шлюз, доступный из России напрямую, с нативным Anthropic Messages API и кэшированием. Перед оплатой проверьте его по чек-листу выше: от этих деталей зависят и стабильность, и итоговая цена.