Как установить Claude Code в России и что упирается в страну?
Как установить Claude Code в России - вопрос не только о команде установки. России нет в официальной справке доступности Claude. Установленный клиент или оплаченный тариф сами по себе не подтверждают право аккаунта пользоваться сервисом из неподдерживаемой страны.
Сначала определите свою ситуацию: программа не установлена, нет соединения, не получается войти или аккаунт приостановлен. Сетевые настройки для корпоративных сетей ниже не меняют правила Anthropic и не дают гарантии сохранения аккаунта.
Документация проверена 26.10.2026. Новую установку и вход в аккаунт при подготовке правки не проходили.
Claude Code, клод код, клауд код - три написания одного агента Anthropic: он работает в терминале и сам правит файлы проекта. Если слово пустое, начните с разбора, что это такое.
Когда агент вышел в сеть, начинается обычная работа. Правила проекта, разрешения и настройки на каждый день разобраны в ClaudeBase отдельными уроками и материалами.
Доступ и состояние аккаунта: с чего начать
| Что видно | Что это означает | Следующий шаг |
|---|---|---|
claude не найден |
Терминал не нашёл программу | Проверить установку и PATH |
App unavailable in region |
Сервис недоступен в стране | Сверить официальный перечень; покупка подписки не меняет региональную политику |
Unable to connect to Anthropic services |
Не прошла проверка соединения | Проверить сеть и текст причины; это сообщение само по себе не доказывает бан |
Login expired |
Сохранённый вход не обновился | Выполнить /login; старые версии могли показывать так и hold |
Your account is on hold |
Приостановлен аккаунт | Подробности и апелляция |
| Организация on hold на claude.ai | Приостановлена организация, личный аккаунт может быть в порядке | Request a review у нужной организации |
Поэтому перед тем, как установить Claude Code в России заново, сохраните точный текст ошибки. Переустановка не снимает hold.
Где вы сейчас
Коротко: Найдите свою ситуацию и перейдите к нужному разделу. Установка по системам и оплата вынесены в отдельные статьи, здесь их не пересказываю. Эта инструкция закрывает сеть терминала, вход в аккаунт и ошибки сети, входа и доступности сервиса. Если программа уже отвечает, переходите сразу к проверке в шаге 4.
- Claude Code ещё не стоит. Общий маршрут - как установить Claude Code, для Windows подробно - Claude Code на Windows.
- Установщик падает с непонятной ошибкой. Смотрите первые три случая в разделе про ошибки.
- Программа стоит, но вход не проходит. Вам нужны шаги 2 и 3: прокси для терминала и вход.
- Нет подписки или ключа. Начните с оплаты Claude из России.
Доступность по странам и этапы подключения
В системных требованиях есть пункт Location со ссылкой на поддерживаемые страны. России нет в отдельной справке Claude о доступных странах, прочитанной 26.10.2026. Это ограничение сервиса; оно не исчезает после скачивания клиента.
Не следует по любой сетевой ошибке угадывать причину ограничения. Официальная документация позволяет проверить этап, на котором возникла ошибка:
| Этап | Что проверить | Чего результат не доказывает |
|---|---|---|
| Скачивание | Установщик получен как скрипт, а не HTML-страница | Загрузка не подтверждает допуск аккаунта |
| Первый запуск | Соединение с api.anthropic.com и platform.claude.com |
Сетевой ответ не означает успешный вход |
| Вход | Тот ли аккаунт выбран и закончилась ли авторизация | Успешный вход не отменяет региональные правила |
| Запрос модели | Активный способ оплаты и полный текст ответа | Один HTTP-код не раскрывает причину hold |
Проверка первого запуска описана в официальном разделе ошибок. Региональную недоступность и голый 403 документация разбирает отдельно в ошибках установки.
Я сам плачу за Claude картой для подписок «Плати по миру»: выпускается за пару минут, пополняется рублями через СБП. Оформить картуРеклама. ООО "Капибара". ИНН 9703231520. erid: CQH36pWzJqNS1hfhQNyQNjbmhaUSfywWpWF3LE48uoYyEF
Тот же вопрос про агента OpenAI: Codex в России.
Почему браузер работает, а терминал получает ошибку
Настройка сети в браузере не подтверждает настройки CLI. Документация Anthropic для корпоративных сетей описывает переменные HTTPS_PROXY, HTTP_PROXY и NO_PROXY. Проверять их нужно для того процесса, где запущен claude.
Используйте настройки, которые выдал администратор вашей сети. Они помогают проверить соединение, но не меняют статус аккаунта и правила стран. Соседняя тема - сетевая настройка Claude.
Шаг 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"
}
}
Где спотыкаются:
- SOCKS не подходит. В документации одной строкой: «Claude Code does not support SOCKS proxies».
- Схема обязательна. Адрес без
http://программа не разберёт и остановит запуск с ошибкой, где названа переменная. - Логин и пароль пишутся в адрес:
http://username:password@proxy.example.com:8080. - NO_PROXY перечисляет адреса мимо прокси, например
localhost. - Поменял значение - перезапустите
claude. Открытая сессия его не подхватит.
Если задача - как установить Claude Code в России, сначала сверяйте ограничения страны. Материалы курса не дают права обходить ограничения Anthropic.
Шаг 3. Чем войти: подписка или ключ Console?
Коротко: Для одного человека вариантов два: свой аккаунт Claude с доступной ему подпиской либо Claude Console с оплатой по расходу. При первом запуске программа сначала проверяет связь с api.anthropic.com и platform.claude.com и только потом открывает браузер. Прокси из шага 2 должен быть задан до этого запуска. Ключ ANTHROPIC_API_KEY в окружении перебивает подписку.
Набираете claude в папке проекта. Программа даёт каждому адресу 10 секунд и при неудаче закрывается с причиной на экране. Если связь есть, открывается браузер. Дальше по документации:
- Браузер не открылся - нажмите
c, адрес входа скопируется. - Браузер показал код вместо возврата в терминал - вставьте его на строке
Paste code here if prompted. - Вход закончен, когда терминал пишет
Login successfulи просит нажатьEnter.
Страница входа открывается по маршруту браузера, а код на токен меняет сама программа запросом на platform.claude.com, по переменным из шага 2.
Способ входа можно выбрать явно. Официальная документация описывает явный выбор входа:
claude auth login --claudeai
claude auth login --console
--claudeai - «Use Claude subscription (default)», вход по подписке, стоит по умолчанию. Чем Max 5x и 20x отличаются от Pro по лимитам в терминале, разобрано в статье Claude Max под Claude Code. --console - вход через консоль с оплатой по расходу, документация также описывает вход Console без создания API-ключа.
Если в окружении задан ANTHROPIC_API_KEY, программа пропускает вход и просит одобрить ключ, после одобрения он работает вместо подписки. Активный способ входа покажет /status. Порядок, в котором агент выбирает, чем платить, разобран в статье Claude Code API.
Шаг 4. Как проверить, что всё работает?
Коротко: Пять проверок по порядку, от программы к сети и входу. Номер версии значит, что программа на месте, claude doctor проверяет установку, curl из того же окна показывает, доходит ли терминал до API. Команда /status внутри сессии показывает способ входа и прокси, а последняя проверка - настоящий запрос агенту.
claude --versionпечатает номер версии.claude doctorпроверяет установку, параметры диагностики уточняйте в справке своей версии.curl -I https://api.anthropic.comиз того же окна. HTTP-ответ подтверждает только ответ сервера. Он не проверяет подписку, учётную запись и доступ к модели. Таймаут означает, что соединение не удалось./statusв сессии: там виден активный способ входа и строка Proxy с адресом прокси. Значение, которое программа не разобрала, строка помечает как неверное.- Попросите агента описать, что лежит в папке проекта. Ответил - всё собрано.
Если что-то не сходится, запустите 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», документация указывает на недоступную страну. Голый 403 также может быть связан с прокси или сетевым фильтром.
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 Request not allowed
Появляется после входа. У Pro и Max проверьте, активна ли подписка, у Console - роль Claude Code или Developer, за прокси - настройку сети. Полный текст сообщения и активный способ входа важнее одного кода 403.
This organization has been disabled
Чаще всего старый ANTHROPIC_API_KEY из отключённой организации перебил подписку. Если есть рабочий вход по подписке, уберите переменную и запустите claude заново. Если ключ был единственным способом входа, после его отключения потребуется /login или ключ действующей организации.
Your account is on hold and can’t use Claude Code
Аккаунт приостановлен, повторный вход не поможет. Подробности и форма обжалования - по ссылке https://claude.ai/restricted из сообщения. Как подать апелляцию и что будет с подпиской, разобрано в статье Your account is on hold.
Для Codex есть отдельный разбор регионального отказа: ошибка 403 unsupported country region territory.
Чем рискует аккаунт и что пишет Anthropic
Consumer Terms требуют соблюдать поддерживаемые регионы и запрещают обходить защитные меры сервиса. В справке об апелляциях создание аккаунта из неподдерживаемого региона названо среди возможных причин блокировки. Как установить Claude Code в России и как получить допустимый доступ - разные вопросы.
Точная причина конкретного ограничения из кода 403 не следует. Если сообщение содержит on hold, открывайте подробности и апелляцию для своего аккаунта. Покупка другого аккаунта или смена прокси не является подтверждённым способом восстановления. Чужие аккаунты здесь не продаём; сохранность аккаунта не обещаем.
При прекращении доступа из-за существенного нарушения условий Consumer Terms исключают возврат подписки. Другие случаи и применимые права нужно уточнять в поддержке. Вопросы оплаты отделяйте от установки и от апелляции.
Если доступ неприемлем по условиям, можно сравнить аналоги 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 запустился - что дальше?
Коротко: Агент стоит и отвечает, дальше его стоит научить вашему проекту. Первый шаг - файл правил, который агент читает в начале каждой сессии. Второй - разрешения, память между сессиями и скиллы. Третий - слэш-команды, которые сокращают рутину. Все три темы разобраны в статьях ниже.
- Правила проекта. Что писать в CLAUDE.md и как проверить, что агент его прочитал, - в статье CLAUDE.md: как задать правила проекта.
- Настройки. Разрешения, память и скиллы по шагам - в статье Claude Code: настройка с нуля.
- Команды. Слэш-команды и флаги собраны в шпаргалке по командам Claude Code.
В курсе ClaudeBase уроки выходят по порядку: способы работать с Claude, настройка VS Code, правила проекта и разрешения. Листать материалы глазами не придётся: агент получает базу через MCP и выбирает из неё нужное сам. Как подключиться, написано на странице ClaudeBase.
Смотрите также
Источники
Проверено 26.10.2026. Как установить Claude Code в России: команды установки сверяются с setup, сообщения - с errors, состояние аккаунта - со справкой об апелляциях.