Как установить Claude Code: пошаговая инструкция

Claude Code ставится одной командой: на macOS и Linux — curl -fsSL https://claude.ai/install.sh | bash, в Windows PowerShell — irm https://claude.ai/install.ps1 | iex. Установка занимает минуту и не требует Node.js. Проверка — claude --version.

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

Требования к системе

По документации Anthropic на 10 сентября 2026 года.

Последняя строка — та, из-за которой инструкция для России не заканчивается на установке. К ней вернёмся ниже.

Команды установки

Основной способ — нативный установщик, он же рекомендованный вендором.

macOS, Linux, WSL:

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

Windows PowerShell:

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

Windows CMD:

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

Если PowerShell ругается The token '&&' is not a valid statement separator — вы запустили команду для CMD не в той оболочке. Признак: в PowerShell приглашение начинается с PS C:\, в CMD — просто C:\.

Нативные установки обновляются в фоне сами.

Альтернативные способы

Четыре варианта, если нативный не подходит.

Homebrew на macOS: brew install --cask claude-code. Есть два бочонка: claude-code — стабильный канал с отставанием примерно на неделю, claude-code@latest — свежие версии сразу. Автообновления нет, нужен brew upgrade.

WinGet на Windows: winget install Anthropic.ClaudeCode. Тоже без автообновления.

Пакетные менеджеры Linux: apt, dnf и apk с подписанными репозиториями. Отпечаток ключа подписи — 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE, его стоит сверить перед добавлением репозитория.

npm: npm install -g @anthropic-ai/claude-code. Начиная с версии 2.1.198 требуется Node.js 22 или новее. Ставится тот же нативный бинарник — Node при работе не используется. sudo npm install -g использовать не надо: это создаёт проблемы с правами.

Проверка установки

Две команды.

claude --version

Рабочая установка печатает номер вроде 2.1.211 (Claude Code). Если получаете command not found — бинарник не попал в PATH.

claude doctor

Показывает диагностику установки и настроек без запуска сессии: состояние установки, ошибки в файлах конфигурации и предупреждения с подсказками.

Установка на Windows: нативно или через WSL

Выбор зависит от того, где лежат ваши проекты.

Про Git for Windows: без него Claude Code выполняет команды через PowerShell, с ним — через Git Bash. Если Git установлен, но не находится, путь задаётся в settings.json:

{ "env": { "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe" } }

Что делать с авторизацией

Здесь установка упирается в то, что командой не решается.

По документации вендора вход требует аккаунта уровня Pro, Max, Team, Enterprise или Console. Бесплатный план Claude.ai доступа к Claude Code не даёт. Плюс работа ограничена списком поддерживаемых стран, и Россия в него не входит — то есть ни оплатить подписку российской картой, ни авторизоваться напрямую не получится.

Документация называет и второй путь: Claude Code умеет работать не только с аккаунтом, но и с ключом. Дословно — если задана переменная окружения ANTHROPIC_API_KEY, программа один раз спросит подтверждение ключа вместо открытия браузера. Там же перечислены сторонние провайдеры доступа как поддерживаемый сценарий.

Это и есть рабочий вариант из России: свой ключ вместо подписки. Подробный разбор экономики — подписка или свой API-ключ, а про оплату вообще — как оплатить API нейросети из России.

Что нужно для работы по ключу

Три вещи.

Ключ. Заводится за минуту, оплата российской картой в рублях.

Адрес совместимого интерфейса. Claude Code обращается по родному протоколу Anthropic.

Модель с открытым протоколом. В каталоге KeyDealer на 10 сентября 2026 года anthropic_messages открыт у всех восьми позиций Claude:

Ставка одинакова на вход и на выход. Статусы протоколов читаются в GET /v1/models без ключа и без регистрации — как читать эти поля.

Обновление и удаление

Коротко.

Обновление. Нативные установки обновляются сами; принудительно — claude update. Канал обновлений переключается настройкой autoUpdatesChannel: latest по умолчанию или stable с отставанием примерно на неделю. Отключить фоновую проверку — DISABLE_AUTOUPDATER в settings.json.

Удаление. Для нативной установки: rm -f ~/.local/bin/claude и rm -rf ~/.local/share/claude. Для Homebrew — brew uninstall --cask claude-code, для WinGet — winget uninstall Anthropic.ClaudeCode, для npm — npm uninstall -g @anthropic-ai/claude-code.

Настройки лежат отдельно в ~/.claude и ~/.claude.json; их удаление стирает историю сессий и конфигурацию MCP-серверов.

Типовые ошибки установки

Пять, по частоте обращений.

Команда для CMD запущена в PowerShell. Ошибка The token '&&' is not a valid statement separator. Признак оболочки виден в приглашении: PS C:\ — это PowerShell, просто C:\ — CMD.

irm не распознан. Обратная ситуация: команду PowerShell выполнили в CMD.

command not found после установки. Бинарник встал, но каталог не попал в PATH. Проверяется claude doctor, он покажет состояние установки.

Установка через sudo npm install -g. Так делать не надо: это создаёт проблемы с правами и рисками безопасности. Если права уже сломаны, документация вендора описывает отдельный порядок починки.

Alpine Linux без подготовки. Дистрибутив не содержит bash и curl по умолчанию, поэтому команда падает с not found. Нужно поставить bash, curl, libgcc, libstdc++ и ripgrep, а затем выставить USE_BUILTIN_RIPGREP в 0.

Отдельная ситуация — две установки сразу. Если после удаления команда claude продолжает работать, скорее всего осталась вторая установка другим способом или алиас в оболочке от старого установщика.

Чего мы не утверждаем

Команды и требования приведены по документации вендора на 10 сентября 2026 года. Они меняются — проверяйте актуальные на странице установки.

Мы не обещаем работоспособности конкретной сборки на вашей системе. Отвечаем за статус протоколов в своём каталоге, совместимость клиента проверяйте у себя.

Не даём советов по обходу страновых ограничений. Описанный сценарий с ключом — задокументированный вендором способ работы, а не обход.

Цифры каталога — на дату. 49 позиций в пятнадцати семействах; актуальное всегда в живой выдаче.

Что нужно, чтобы начать

Ключ заводится за минуту на keydealer.ru/login — почта и пароль, без документов и без зарубежной карты. Оплата российской картой в рублях, один ключ на весь каталог.

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

Отдельно про обновления: нативная установка обновляется сама, а Homebrew, WinGet и пакетные менеджеры Linux — нет. Если ставили через них, обновление придётся запускать руками, иначе вы месяцами останетесь на версии дня установки.

Что держать в голове

Установка — одна команда и минута времени, и на всех платформах она работает одинаково. Node.js для этого не нужен.

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

Как мы проверяем факты и почему у каждой цифры стоит дата — на странице о проекте и в llms.txt. Завести ключ: keydealer.ru/login.