Как установить Claude Code в России: приложение и терминал, 2026

Claude Code ставится на компьютер двумя способами: через приложение Claude для Windows и macOS (для Linux есть бета-версия), где агент открывается на вкладке Code и терминал не нужен, или одной командой в терминале. Из России к этому добавляются три условия. Нужен VPN, который работает для всей системы, а не только в браузере, аккаунт Claude и платная подписка от Pro: бесплатный тариф Claude Code не включает (документация Anthropic).

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

Без чего Claude Code из России не заработает

Anthropic не включает Россию в список поддерживаемых стран, и ограничение касается всех её продуктов, в том числе Claude Code. Поэтому из России через VPN проходит всё: регистрация, оплата, установка и каждый рабочий сеанс, ведь агент постоянно обращается к серверам Anthropic, пока выполняет задачу. Риск у такой схемы один: сервис вправе ограничить аккаунт из неподдерживаемого региона, и на этот случай у Anthropic есть порядок апелляции.

• Компьютер с macOS 13.0 или новее, Windows 10 версии 1809 или новее, Ubuntu 20.04+ или Debian 10+ и хотя бы 4 ГБ оперативной памяти (системные требования).
• VPN, который включается для всей системы. Расширение VPN в браузере не поможет: приложение Claude и терминал выходят в сеть мимо браузера. Подходящий VPN и стабильный вход в Claude Code из России лучше настроить до установки.
• Аккаунт Claude. Регистрация из России и проверка номера делаются один раз.
• Подписка Pro, Max, Team или Enterprise. Без неё вкладка Code вместо работы предлагает оформить платный план (инструкция Anthropic).

Приложение или терминал: что выбрать

Если вы не работали с командной строкой, ставьте приложение. Внутри него работает тот же Claude Code: он читает файлы в выбранной папке, правит их и запускает команды, а изменения показывает в окне сравнения с кнопками принять и отклонить, причём для вкладки Code не нужно отдельно ставить ни Node.js, ни консольную версию (документация).

Терминальная версия пригодится, когда хочется запускать агента командой claude в любой папке, работать прямо в консоли сервера или из редактора кода. Приложение читает те же файлы настроек, что и консольная версия (раздел о десктопе), поэтому начать с приложения, а терминал добавить позже можно без перенастройки.

По теме: Claude Code в России в 2026: VPN, вход и оплата подписки или API

Как установить приложение Claude с вкладкой Code

В приложении Claude три вкладки: Chat для обычной переписки, Cowork для фоновых задач и Code, где Claude Code работает с файлами на вашем компьютере (официальная инструкция).

1. Включите VPN для всей системы и убедитесь, что сайт claude.ai открывается.
2. Скачайте установщик со страницы загрузки Claude. Для macOS есть одна сборка для процессоров Intel и Apple Silicon, для Windows отдельные установщики под x64 и ARM64.
3. Запустите установщик, откройте Claude из папки «Программы» на Mac или из меню «Пуск» на Windows и войдите в свой аккаунт.
4. Нажмите вкладку Code вверху по центру окна. Если приложение предлагает перейти на платный тариф, на аккаунте нет подписки; если просит войти через браузер, войдите и перезапустите приложение.
5. Выберите режим Local, нажмите Select folder и укажите папку проекта. Для первого раза создайте пустую папку, например test-claude на рабочем столе.
6. Выберите модель в списке рядом с кнопкой отправки, проверьте режим разрешений (о нём ниже) и напишите первую задачу.

Перед первой задачей посмотрите на переключатель режима рядом с кнопкой отправки. В режиме Manual Claude предлагает каждое изменение и ждёт вашего согласия, в Accept edits правит файлы сам, а вы просматриваете результат потом, в Auto тоже правит сам, но рискованные действия вместо вас останавливает встроенный проверяющий, а в Plan только описывает, что собирается сделать, и файлы не трогает (режимы разрешений). Для знакомства удобнее Manual: видно, что именно агент меняет в каждом файле.

На Windows приложение иногда просит установить Git. Git нужен для сессий в отдельных рабочих копиях проекта, а версии приложения до 1.49585.0 спрашивали его перед любой локальной сессией, так что сначала обновите его, а если просьба осталась, поставьте Git for Windows (устранение неполадок).

Как установить Claude Code в терминале на Windows и Mac

Ставить Node.js заранее не нужно: Anthropic рекомендует нативный установщик, который скачивает готовую программу и сам обновляет её в фоне (руководство по установке). Чем консольная версия отличается от приложения и какие у неё первые команды, собрано в обзоре Claude CLI.

Терминал на Mac называется «Терминал» (найдите его через Cmd + Пробел), на Windows откройте PowerShell из меню «Пуск». Если окно команд вы видите впервые, знакомство с терминалом с нуля поможет не запутаться в первых шагах. Включите VPN и выполните команду для своей системы.

macOS, Linux и WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows, PowerShell (в начале строки видно PS C:\):

irm https://claude.ai/install.ps1 | iex

Windows, командная строка CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

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

claude --version

Рабочая установка печатает номер версии вида 2.1.211 (Claude Code). Подробную проверку запускает команда claude doctor: она только читает установку и выводит её состояние и предупреждения с подсказками (раздел о проверке).

Запускать установщик от имени администратора на Windows не нужно, и Git для терминальной версии там необязателен. Без него Claude Code выполняет команды через PowerShell, а с Git for Windows получает Git Bash, который нужен части инструментов агента (установка на Windows).

Другие способы тоже есть: brew install --cask claude-code на Mac, winget install Anthropic.ClaudeCode на Windows и npm install -g @anthropic-ai/claude-code, которому нужен Node.js 22 или новее. Установки через Homebrew и WinGet по умолчанию сами не обновляются (руководство), поэтому без особой причины выбирайте нативный установщик.

По теме: Как установить Codex в 2026: приложение на Windows и Mac, CLI и IDE

Первый запуск и вход в аккаунт

1. Создайте папку для проекта и перейдите в неё командой cd, например cd ~/Desktop/test-claude на Mac.
2. Наберите claude и нажмите Enter.
3. Выберите способ входа: аккаунт Claude с подпиской Pro, Max, Team или Enterprise либо аккаунт Console, где оплата идёт по расходу (документация).
4. В браузере подтвердите вход. Если браузер не открылся сам, нажмите c в терминале: ссылка скопируется, и её можно вставить в браузер вручную (вход и авторизация).

Если вход сорвался и причина непонятна, выполните /logout, закройте Claude Code и снова запустите claude. Такой чистый повторный вход, по словам Anthropic, решает большинство проблем с авторизацией (раздел о входе).

Как проверить, что Claude Code работает

Проверить установку проще всего маленькой задачей, результат которой видно глазами. В пустой папке дайте агенту такое задание:

Создай файл index.html: страница с заголовком «Привет», кнопкой и счётчиком нажатий. Без внешних библиотек.

Claude Code покажет, какой файл собирается создать, и после вашего согласия запишет его в папку. Откройте index.html двойным щелчком: если кнопка считает нажатия, вся цепочка от вашей фразы до работающей страницы прошла, а значит, VPN, вход и подписка настроены правильно.

Для первых задач берите отдельную пустую папку, а не папку с документами или рабочий проект без резервной копии. Агент правит файлы по-настоящему, и в пустой папке любую неудачу легко исправить: удалить всё и начать заново.

По теме: Как установить Claude в 2026: веб, приложение, доступ из России

Ошибки при установке из России и что с ними делать

Ищите свою ошибку по тексту, который видите на экране. Первые две почти всегда связаны с сетью, остальные с настройкой.

App unavailable in region во время установки означает, что сервер Anthropic видит адрес из неподдерживаемой страны, и curl: (22) The requested URL returned error: 403 из России почти всегда значит то же самое (реже его даёт прокси или файрвол рабочей сети) (таблица ошибок). Проверьте, что VPN включён для всей системы, а не только в браузере, и повторите команду в новом окне терминала.

syntax error near unexpected token '<', а в PowerShell ошибка со словами System.Xml.XmlDocument появляются, когда вместо скрипта установки скачалась веб-страница. Повторите команду через несколько минут с включённым VPN; если не помогает, поставьте Claude Code через Homebrew или WinGet (варианты в документации).

command not found: claude или 'claude' is not recognized после успешной установки говорят о том, что папка с программой не попала в переменную PATH. Сначала откройте новое окно терминала, а если не помогло, добавьте путь командами для своей системы (исправление PATH).

Mac (оболочка zsh):

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Windows (PowerShell), затем перезапустите терминал:

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

irm is not recognized или The token '&&' is not a valid statement separator выдают команду не для той оболочки: первая ошибка возникает в CMD, вторая в PowerShell. Возьмите команду для своей оболочки из раздела про терминал.

Error 403: Forbidden во вкладке Code лечится выходом из аккаунта и повторным входом через меню приложения. Если не помогло, проверьте, что подписка активна и VPN включён, а когда в терминале Claude Code работает, а в приложении нет, закройте приложение полностью, не только окно, и откройте снова (советы Anthropic).

OAuth error: Invalid code при входе значит, что код устарел или обрезался при копировании. Нажмите Enter и пройдите вход заново, на этот раз без пауз (вход и авторизация).

Сколько стоит подписка и как оплатить её из России

Claude Code входит в платные тарифы Claude. Pro стоит $20 в месяц при помесячной оплате или $17 в месяц при оплате за год ($200 сразу), а бесплатный тариф Claude Code не включает (цены Claude). Max бывает двух видов, Max 5x за $100 и Max 20x за $200 в месяц, и оплачивается только помесячно (справка Anthropic о Max).

Для установки и первых проектов хватает Pro. Max нужен, когда вы регулярно упираетесь в лимит посреди работы, и прежде чем платить в пять раз больше, разберитесь, как устроены лимиты Claude: часть упоров снимается сменой модели или короткими сессиями.

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

Как обновить и удалить Claude Code

Версия из нативного установщика обновляется сама в фоне, а сразу поставить свежую версию можно командой claude update. Установки через Homebrew и WinGet по умолчанию обновляются вручную: brew upgrade claude-code и winget upgrade Anthropic.ClaudeCode (раздел об обновлениях). Приложение Claude на macOS и Windows обновляется само при запуске, а вкладка Code держит собственную копию Claude Code, поэтому её версия может не совпадать с командой claude в терминале (раздел о десктопе). Нативная установка удаляется двумя командами.

Mac и Linux:

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Windows (PowerShell):

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Настройки и история сессий остаются в папке ~/.claude и файле ~/.claude.json. Удаляйте их, только если хотите стереть всё вместе с подключёнными серверами MCP и разрешениями, и сначала удалите приложение Claude: оно тоже пишет в эту папку и создаст её заново (удаление Claude Code).

Что делать после установки

Claude Code лучше всего осваивается на настоящей задаче: странице для своего дела, телеграм-боте, таблице, которая сама собирает данные. Как ставить задачи агенту, когда включать режим плана и зачем держать в папке файл CLAUDE.md с правилами проекта, объясняет руководство по работе в Claude Code.

Если хочется пройти путь от установки до опубликованного проекта с разбором ошибок, этим занимается Submarine School: обучение вайбкодингу прошли или проходят более 2 500 человек, работы выпускников открыты и работают, а отзывы собраны в Telegram. Начать можно с бесплатного мастер-класса, на котором проект собирают вживую.

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

Можно ли пользоваться Claude Code бесплатно?

Нет. На бесплатном тарифе Claude Code недоступен: нужен Pro, Max, Team или Enterprise либо аккаунт разработчика Console с оплатой по расходу через API (документация). Ключ для работы через Console получают в кабинете разработчика Anthropic.

Нужно ли ставить Node.js?

Для приложения и нативного установщика нет. Node.js 22 или новее понадобится, только если вы ставите Claude Code через npm (установка через npm).

Работает ли Claude Code в России без VPN?

Нет. Россия не входит в список стран, где Anthropic предоставляет свои продукты, поэтому без VPN не проходят ни установка, ни вход, ни работа агента над задачей (список стран).

Как установить Claude Code в VS Code или Cursor?

Отдельным расширением. В VS Code 1.94 или новее нажмите Cmd+Shift+X на Mac или Ctrl+Shift+X на Windows, найдите «Claude Code» и нажмите Install, а для Cursor на странице расширения есть своя ссылка установки (расширение для VS Code). Консольную версию заранее ставить не нужно, подойдёт любой платный тариф Claude или аккаунт Console. Расширение обращается к тем же серверам Anthropic, поэтому VPN для него нужен так же, как для приложения.