Установка Claude Code в России

Как установить Claude Code в России и что упирается в страну?

Коротко: Команды установки для России те же, что и для остального мира. Но серверы Anthropic проверяют страну при скачивании программы, при входе в аккаунт и на запросах к модели, а России в списке поддерживаемых стран нет. Порядок такой: поставить программу, задать терминалу сетевой маршрут переменными из документации, войти и проверить. Риски для аккаунта - в конце, прочитай их до оплаты.

Как установить Claude Code в России: поставить программу официальным способом, до первого запуска задать терминалу прокси переменной HTTPS_PROXY, войти по подписке claude.ai или через Claude Console и проверить результат командой /status.

Живу я в Москве, так что проверка страны касается и меня. Инструкцию собрал по документации Anthropic 21 сентября 2026 года и сверил на своём Mac, где claude --version отвечает 2.1.278 (Claude Code). Экран входа заново не проходил, поэтому вход описан по официальным страницам.

Claude Code, клод код, клауд код - три написания одного агента Anthropic: он работает в терминале и сам правит файлы проекта. Если слово пустое, начни с разбора, что это такое.

Когда агент вышел в сеть, начинается обычная работа. Правила проекта, разрешения и настройки на каждый день разобраны в ClaudeBase отдельными уроками и материалами.

Где вы сейчас

Коротко: Найди свою ситуацию и прыгай к нужному разделу. Установка по системам и оплата вынесены в отдельные статьи, здесь их не пересказываю. Эта инструкция закрывает сеть терминала, вход в аккаунт и ошибки, которые появляются именно из-за страны. Если программа уже отвечает, переходи сразу к проверке в шаге 4.

• Claude Code ещё не стоит. Общий маршрут - как установить Claude Code, для Windows подробно - Claude Code на Windows.
• Установщик падает с непонятной ошибкой. Смотри первые три случая в разделе про ошибки.
• Программа стоит, но вход не проходит. Тебе нужны шаги 2 и 3: прокси для терминала и вход.
• Нет подписки или ключа. Начни с оплаты Claude из России.

Где именно Claude Code проверяет страну?

Коротко: На трёх участках: сервер загрузки отдаёт установщик, сервер входа выдаёт токен, API отвечает на запросы к модели. У каждого участка свой адрес и своя ошибка. Список стран Anthropic держит на открытой странице, и России там нет ни в перечне для claude.ai, ни в перечне для коммерческого API.

В системных требованиях Claude Code стоит строка Location со ссылкой на страницу поддерживаемых стран. Я открыл её 21 сентября 2026 года. Перечней там два: для коммерческого доступа к API и для claude.ai. России и Беларуси нет ни в одном, Армения, Грузия, Казахстан, Киргизия и Узбекистан есть в обоих.

Адреса по шагам - из таблицы сетевых требований документации:

Оплата - отдельная стена, она разобрана в статье про оплату Claude из России.

Я сам плачу за Claude картой для подписок «Плати по миру»: выпускается за пару минут, пополняется рублями через СБП. Оформить карту

Реклама. ООО «КАПИБАРА», ИНН 9703231520. erid: 2W5zFGnh2G9

Почему браузер пускает, а терминал получает отказ?

Коротко: Браузер и терминал выходят в сеть разными программами, и настройка одной на другую не переносится. В трекере Claude Code участник проекта ответил прямо: процессы в терминале не наследуют системные настройки прокси macOS. Поэтому claude.ai в браузере открывается, а команда claude на том же компьютере получает отказ. Терминалу маршрут задают отдельно.

Эту жалобу разобрали в обращении 30318 в публичном трекере anthropics/claude-code. Ответ участника проекта:

Claude Code reads HTTPS_PROXY / HTTP_PROXY (and lowercase variants) from your shell environment or from the env block in settings.json, since terminal processes don’t inherit macOS system proxy settings.

«Claude Code читает HTTPS_PROXY и HTTP_PROXY (и варианты строчными буквами) из окружения оболочки или из блока env в settings.json, потому что процессы в терминале не наследуют системные настройки прокси macOS.»

• участник проекта, anthropics/claude-code, обращение 30318

Для Windows такой фразы в документации нет, но переменные задаются там так же. У Codex картина обратная: переменные прокси он для своего трафика не читает, это есть в разборе сетевого доступа к Codex.

Шаг 1. Поставить программу и проверить версию

Коротко: Ставь официальным способом для своей системы, подробные маршруты вынесены в отдельные статьи. Если сервер не пускает по стране, установка ломается одинаково: вместо скрипта приходит страница о недоступности в регионе или код 403. До установки полезно одной командой проверить, доходит ли терминал до сервера загрузки.

Проверка из документации (в PowerShell пиши curl.exe вместо curl, иначе Windows подставит свою команду):

curl -sI https://downloads.claude.ai/claude-code-releases/latest

Смотри на первую строку ответа:

• HTTP/2 200 на macOS и Linux или HTTP/1.1 200 OK на Windows - сервер доступен;
• 403 - обычно прокси или сетевой фильтр, либо Claude Code недоступен в твоём регионе;
• пустой ответ, Could not resolve host или таймаут - сеть блокирует соединение.

Через прокси можно пустить и саму установку: по документации задаёшь две переменные и в том же окне запускаешь установщик.

export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash

$env:HTTP_PROXY = 'http://proxy.example.com:8080'
$env:HTTPS_PROXY = 'http://proxy.example.com:8080'
irm https://claude.ai/install.ps1 | iex

Адрес proxy.example.com:8080 взят из документации для примера, подставь свой.

В конце шага:

claude --version

Пришёл номер версии - шаг закрыт. Команда не найдена - дело в переменной PATH, разбор в статье про установку.

Шаг 2. Как задать прокси для терминала?

Коротко: Claude Code понимает стандартные переменные окружения HTTPS_PROXY, HTTP_PROXY и NO_PROXY. Задавать их надо до запуска программы: значения читаются один раз, при старте. Подходит только HTTP или HTTPS прокси, SOCKS программа не поддерживает. Чтобы настройка не пропадала с закрытием окна, её кладут в профиль оболочки или в файл настроек.

Claude Code respects standard proxy environment variables.

«Claude Code учитывает стандартные переменные окружения для прокси.»

• Anthropic, Enterprise network configuration

Страница называется «корпоративная настройка сети» и описывает прокси компаний. Чей прокси у тебя, решаешь ты, сервисов я не называю.

На macOS и Linux переменная задаётся в том же окне, перед запуском:

export HTTPS_PROXY=http://proxy.example.com:8080
claude

Она действует до закрытия окна. Чтобы подхватывалась всегда, строку с export добавляют в ~/.zshrc (Zsh стоит на Mac по умолчанию) или в ~/.bashrc для Bash.

В PowerShell:

$env:HTTPS_PROXY = 'http://proxy.example.com:8080'
claude

Навсегда в PowerShell - так, потом новое окно. В CMD ту же роль играют set и setx.

[Environment]::SetEnvironmentVariable("HTTPS_PROXY", "http://proxy.example.com:8080", "User")

Удобнее всего блок env в ~/.claude/settings.json: его программа берёт при любом способе запуска.

{
  "env": {
    "HTTPS_PROXY": "http://proxy.example.com:8080"
  }
}

Где спотыкаются:

1. SOCKS не подходит. В документации одной строкой: «Claude Code does not support SOCKS proxies».
2. Схема обязательна. Адрес без http:// программа не разберёт и остановит запуск с ошибкой, где названа переменная.
3. Логин и пароль пишутся в адрес: http://username:password@proxy.example.com:8080.
4. NO_PROXY перечисляет адреса мимо прокси, например localhost.
5. Поменял значение - перезапусти claude. Открытая сессия его не подхватит.

Сетевая часть есть и в материалах первого модуля курса. «Аккаунт Claude из России, оплата и установка» проводит от регистрации до поставленного агента, а подписчикам рядом доступен «Claude через прокси: работа из России без VPN»: свой прокси для Claude Code и приложения Claude без VPN на весь компьютер. Он открывается после подключения к ClaudeBase.

Шаг 3. Чем войти: подписка или ключ Console?

Коротко: Для одного человека вариантов два: аккаунт claude.ai с подпиской Pro или Max либо Claude Console с оплатой по расходу. При первом запуске программа сначала проверяет связь с api.anthropic.com и platform.claude.com и только потом открывает браузер. Прокси из шага 2 должен быть задан до этого запуска. Ключ ANTHROPIC_API_KEY в окружении перебивает подписку.

Набираешь claude в папке проекта. Программа даёт каждому адресу 10 секунд и при неудаче закрывается с причиной на экране. Если связь есть, открывается браузер. Дальше по документации:

1. Браузер не открылся - нажми c, адрес входа скопируется.
2. Браузер показал код вместо возврата в терминал - вставь его на строке Paste code here if prompted.
3. Вход закончен, когда терминал пишет Login successful и просит нажать Enter.

Страница входа открывается по маршруту браузера, а код на токен меняет сама программа запросом на platform.claude.com, по переменным из шага 2.

Способ входа можно выбрать явно. Справка claude auth login --help в версии 2.1.278 печатает оба ключа:

claude auth login --claudeai
claude auth login --console

--claudeai - «Use Claude subscription (default)», вход по подписке, стоит по умолчанию. --console - вход через консоль с оплатой по расходу, с версии 2.1.242 туда можно войти и без создания ключа.

Если в окружении задан ANTHROPIC_API_KEY, программа пропускает вход и просит одобрить ключ, после одобрения он работает вместо подписки. Активный способ входа покажет /status. Порядок, в котором агент выбирает, чем платить, разобран в статье Claude Code API.

Шаг 4. Как проверить, что всё работает?

Коротко: Пять проверок по порядку, от программы к сети и входу. Номер версии значит, что программа на месте, claude doctor проверяет установку, curl из того же окна показывает, доходит ли терминал до API. Команда /status внутри сессии показывает способ входа и прокси, а последняя проверка - настоящий запрос агенту.

1. claude --version печатает номер версии.
2. claude doctor проверяет установку, полную проверку с исправлениями даёт /doctor в сессии.
3. curl -I https://api.anthropic.com из того же окна. Важен сам факт ответа: у меня пришло HTTP/2 404, то есть сервер ответил. Таймаут значит, что до API терминал не доходит.
4. /status в сессии: там виден активный способ входа и строка Proxy с адресом прокси. Значение, которое программа не разобрала, строка помечает как неверное.
5. Попроси агента описать, что лежит в папке проекта. Ответил - всё собрано.

Если что-то не сходится, запусти claude --debug: журнал пишется в ~/.claude/debug/<session-id>.txt. Как читать экран сессии и отвечать на запросы разрешений, разобрано в статье Claude Code в терминале.

Какие ошибки бывают из России и что они значат?

Коротко: Строки ошибок приведены так, как их печатает программа, и к каждой - что она значит по документации Anthropic. Сначала найди свою строку и только потом переустанавливай. Почти все эти случаи про сеть, страну или ключ в окружении, и переустановка их не лечит: та же строка вернётся на том же шаге.

App unavailable in region

Страница, которую серверы Anthropic отдают вместо сайта или установщика. По таблице ошибок документации это значит одно: Claude Code недоступен в твоей стране.

syntax error near unexpected token ‘<’

bash: line 1: syntax error near unexpected token `<'
bash: line 1: `<!DOCTYPE html>'

Установщик получил веб-страницу вместо скрипта. Если внутри «App unavailable in region», причина в стране, как в обращении 17813.

curl: (22) The requested URL returned error: 403

Тот же отказ без тела страницы. Причина часто та же, бывает и прокси, который режет загрузку.

Unable to connect to Anthropic services

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ECONNREFUSED

Проверка перед входом не достучалась до api.anthropic.com или platform.claude.com. Упомянут HTTPS_PROXY - смотри на прокси. Если сеть открыта, а ошибка не уходит, документация допускает, что Claude Code недоступен в твоей стране.

Couldn’t connect through your proxy (ERR_PROXY_TUNNEL)

Прокси отказался строить туннель: проверь логин и пароль и пускает ли он на нужный адрес.

API Error: 403 {“error”:{“type”:“forbidden”,“message”:“Request not allowed”}}

Появляется после входа. У Pro и Max проверь, активна ли подписка, у Console - роль Claude Code или Developer, за прокси - настройку сети. Эту строку видел автор обращения 30318, пока терминал ходил в сеть напрямую.

This organization has been disabled

Чаще всего старый ANTHROPIC_API_KEY из отключённой организации перебил подписку. Убери переменную из окружения и профиля и запусти claude заново.

Your account is on hold and can’t use Claude Code

Аккаунт приостановлен, повторный вход не поможет. Подробности и форма обжалования - по ссылке https://claude.ai/restricted из сообщения.

Чем рискует аккаунт и что пишет Anthropic?

Коротко: Условия Anthropic разрешают пользоваться сервисом только в соответствии с политикой поддерживаемых регионов, а России в ней нет. Там же написано, что компания может приостановить или закрыть доступ без уведомления, если считает условия нарушенными, а при закрытии за нарушение деньги за подписку не возвращают. Как обходить проверки, я не рассказываю. Решение и ответственность остаются за тобой.

Для Free, Pro и Max действуют Consumer Terms, для Team, Enterprise и API - Commercial Terms, по разделу Legal and compliance документации. Цитата из Consumer Terms в редакции от 8 октября 2025 года:

You may access and use our Services only in compliance with our Terms, including our Acceptable Use Policy, the policy governing the countries and regions Anthropic currently supports (“Supported Regions Policy”)…

«Получать доступ к Сервисам и пользоваться ими можно только в соответствии с нашими Условиями, включая Политику допустимого использования и политику о странах и регионах, которые Anthropic сейчас поддерживает (Политика поддерживаемых регионов)…»

• Anthropic, Consumer Terms of Service

Пункт о прекращении доступа там же разрешает Anthropic приостановить или закрыть доступ, включая подписку, без уведомления, если компания считает условия нарушенными. В Commercial Terms условие о регионах стоит в пункте D.2.

Страницы Anthropic здесь расходятся. Документация по установке при региональных ограничениях советует «try a VPN or alternative network», то есть попробовать VPN или другую сеть. Справка про ошибку соединения с API пишет обратное: «Ensure you’re not using a VPN when running the request», то есть запрос должен идти без VPN. А в обращении 30318 участник проекта ответил: «We don’t document workarounds for regions where Claude isn’t available», обходы для регионов Anthropic не описывает.

В обращении 51583 подписчик связывает отключение аккаунта с корпоративным VPN, но Anthropic причину там не подтверждал.

Сервисы, которые дают вместо аккаунта Anthropic свой ключ, подменяют переменную ANTHROPIC_BASE_URL, и весь твой код уходит через чужой сервер. Legal and compliance запрещает посредникам перепродавать доступ к Claude. Если риск неприемлем, посмотри аналоги Claude Code.

Чек-лист

Коротко: Порядок проверок тот же, что у шагов, их шесть, и у каждой есть команда или строка на экране. Если все шесть сходятся, программа стоит, терминал ходит в сеть нужным маршрутом и вход привязан к правильному аккаунту. Иначе вернись к шагу, где пункт разобран.

• claude --version печатает номер версии.
• curl -sI https://downloads.claude.ai/claude-code-releases/latest и curl -I https://api.anthropic.com из того же окна отвечают без таймаута.
• Прокси задан адресом http:// или https://, переменная лежит в профиле оболочки или в ~/.claude/settings.json.
• Вход закончился строкой Login successful.
• /status показывает нужный способ входа и адрес прокси, лишнего ANTHROPIC_API_KEY в окружении нет.
• Агент ответил на первый запрос в папке проекта.

Claude Code запустился - что дальше?

Коротко: Агент стоит и отвечает, дальше его стоит научить твоему проекту. Первый шаг - файл правил, который агент читает в начале каждой сессии. Второй - разрешения, память между сессиями и скиллы. Третий - слэш-команды, которые сокращают рутину. Все три темы разобраны в статьях ниже.

1. Правила проекта. Что писать в CLAUDE.md и как проверить, что агент его прочитал, - в статье CLAUDE.md: как задать правила проекта.
2. Настройки. Разрешения, память и скиллы по шагам - в статье Claude Code: настройка с нуля.
3. Команды. Слэш-команды и флаги собраны в шпаргалке по командам Claude Code.

В курсе ClaudeBase уроки выходят по порядку: способы работать с Claude, настройка VS Code, правила проекта и разрешения. Листать материалы глазами не придётся: агент получает базу через MCP и выбирает из неё нужное сам. Как подключиться, написано на странице ClaudeBase.