★ Обновлено 20 ноября 2026
Как установить Claude Code в 2026: команды для Windows, Mac и Linux, проверка и разбор 8 сбоев установки
Claude Code ставится одной командой в терминале, своей для каждой системы. После установки версию проверяют командой, а вход делается через браузер: нужен платный аккаунт или Console. Требования: 4 ГБ памяти, macOS 13 или Windows 10 версии 1809 и новее. Сверка по официальной странице 17 ноября 2026.
Время чтения: 11 минут
Как установить Claude Code: открыть терминал, выполнить одну команду установки для своей системы, проверить результат командой claude --version и войти в аккаунт через браузер. Нужны 4 ГБ памяти и платный аккаунт. Ниже команды для 5 способов установки и разбор 8 типичных сбоев.
Эта статья только про установку. Официальный статус сервиса, подписку и доступ по странам читай в материале Claude Code в России. Как оплатить подписку, смотри в статье как оплатить Claude из России. Выбор между Claude Code и Cursor разобран в статье Claude Code или Cursor. Все обзоры собраны в хабе Инструменты ИИ. Команды сверены с официальной страницей 17 ноября 2026.
Что проверить до установки
Я открыл страницу Advanced setup в документации Claude Code 17 ноября 2026 и выписал требования. Пять пунктов, которые стоит пройти до первой команды.
| Что | Требование по документации | Как проверить |
|---|---|---|
| Система | macOS 13.0+, Windows 10 версии 1809+ или Windows Server 2019+, Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+ | Версия системы в настройках |
| Память | 4 ГБ и больше, процессор x64 или ARM64 | Сведения о системе |
| Сеть | Нужен интернет | Открывается ли сайт, с которого качается установщик |
| Оболочка | Bash, Zsh, PowerShell или CMD | Как выглядит приглашение в терминале |
| Аккаунт и страна | Pro, Max, Ultra, Team, Enterprise или Console; страна из списка Anthropic | Тариф аккаунта и официальный список стран |
Последняя строка решает всё. Бесплатный план claude.ai Claude Code не включает: на странице так и написано. А в строке про местоположение документация отсылает к списку стран Anthropic. На 3 ноября 2026 России в этом списке нет. Подробности и официальную позицию я собрал в статье про Claude Code в России. Способы обхода региональных ограничений здесь не описываются.
Установка сама по себе бесплатна и ничего не стоит проверить. Платный аккаунт нужен на этапе входа, поэтому мораль простая: сначала убедись, что у тебя законно есть аккаунт и доступ, потом трать время на установку.
Хочешь, чтобы ИИ-инструменты в компании внедрялись по порядку, с проверкой доступа и запасным вариантом, а не «поставили и забыли»? Можно разобрать ваш процесс и собрать план запуска.

Команды установки для каждой системы
Официально рекомендован Native Install. Это установка одной командой, которая потом сама обновляется в фоне. Остальные способы нужны, если у тебя уже есть менеджер пакетов и ты хочешь им пользоваться.
| Система и способ | Команда | Обновление |
|---|---|---|
| macOS, Linux, WSL (native) | curl -fsSL https://claude.ai/install.sh | bash |
Автоматически в фоне |
| Windows PowerShell (native) | irm https://claude.ai/install.ps1 | iex |
Автоматически в фоне |
| Windows CMD (native) | curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd |
Автоматически в фоне |
| Homebrew | brew install --cask claude-code |
Вручную: brew upgrade claude-code |
| WinGet | winget install Anthropic.ClaudeCode |
Вручную: winget upgrade Anthropic.ClaudeCode |
| npm | npm install -g @anthropic-ai/claude-code@latest |
Той же командой, не через npm update -g |
Что важно про выбор. Для большинства людей лучший вариант это Native Install: одна команда и ни одной зависимости. Homebrew и WinGet подойдут, если у тебя уже налажено обновление программ через них. Варианты через apt, dnf и apk тоже есть, их ставят с подписанными репозиториями, это путь для администраторов. Через npm ставь только если Node.js у тебя уже есть: пакету нужен Node.js версии 22 или новее.
У Homebrew два варианта: claude-code идёт на стабильном канале и обычно отстаёт примерно на неделю, а claude-code@latest получает версии сразу после выхода. Если ты не гонишься за новыми функциями, бери стабильный: он пропускает релизы с серьёзными ошибками.
Какой способ выбрать за 1 минуту
Иди по вопросам. Нужен самый простой путь и нет своих правил по программам? Native Install. Все программы на компьютере у тебя ставятся через Homebrew или WinGet, и ты хочешь видеть Claude Code в том же списке? Менеджер пакетов. Компьютер управляется администратором и обновления идут через общую систему? Пакеты apt, dnf или apk. Node.js уже стоит и ты ставишь на нём все инструменты разработки? npm. Если сомневаешься, бери Native Install: переход на другой способ потом занимает несколько минут, а выбор между ними редко влияет на работу.
Источник: официальная страница установки Claude Code. Копируй команды оттуда, а не из пересказов: если они изменятся, там обновится первым.

Windows: PowerShell, CMD, Git и WSL
На Windows путаются чаще всего, и причина всегда одна: не та оболочка. Приглашение PowerShell выглядит как PS C:\, у CMD оно без PS. Команда зависит от этого.
- В PowerShell запускай команду с
irm. Если пишет, что&&не является допустимым разделителем, ты в PowerShell, а команда от CMD. - В CMD запускай команду с
curlиinstall.cmd. Если пишет, чтоirmне опознана, ты в CMD, а команда от PowerShell. - Права администратора не нужны. Установка идёт в профиль пользователя.
- Git for Windows необязателен. Он рекомендован: с ним Claude Code использует Bash-инструмент. Без него команды выполняются через PowerShell.
- WSL ставит отдельно. Если работаешь внутри WSL, запускай установщик для Linux внутри терминала WSL, а не из PowerShell.
Какой вариант выбрать. Если проекты лежат в обычных папках Windows, ставь нативно. Если твои инструменты живут в Linux-среде или нужна песочница для выполнения команд, ставь в WSL 2: по документации, песочница поддерживается именно там.

Проверка: версия и диагностика
После установки открой новое окно терминала. Это важно: в старом окне переменные окружения не обновились. Дальше две команды.
- Версия. Запусти
claude --version. Рабочая установка печатает номер версии. Если оболочка пишет, чтоclaudeне найден, каталог установки ещё не попал в PATH. - Диагностика. Запусти
claude doctor. Команда только читает данные и печатает состояние установки, ошибки в файлах настроек и предупреждения с советами. Сессию она не открывает.
Привычка, которая сэкономит время: после любого сбоя сначала claude doctor, потом поиск решения. Он показывает, какая именно установка у тебя активна и обновляется ли она.

Вход в аккаунт и первый запуск
Перейди в папку проекта и запусти claude. При первом запуске программа предложит войти: следуй подсказкам в браузере. Если у тебя задан ключ ANTHROPIC_API_KEY и ты подтверждаешь его использование, окно входа пропускается. Для обычной работы нужен один из аккаунтов: Pro, Max, Ultra, Team, Enterprise или Console.
Claude Code работает не только в терминале: есть расширения для VS Code и JetBrains, десктопное приложение и версия в браузере. Для приложения нужна платная подписка. Если терминал тебе непривычен, десктопное приложение это легальный способ начать без командной строки.
Первые 3 задачи на безопасном проекте
Не запускай агента в рабочем репозитории с первого дня. Возьми копию небольшого проекта или пустую папку. Три задачи для знакомства:
Задача 1, чтение. Прочитай структуру проекта и объясни простыми словами, что где лежит. Ничего не меняй.
Задача 2, малое изменение. Добавь в файл [имя файла] функцию [название] с проверкой [условие] и напиши к ней тест. Покажи, что собираешься изменить, до правки.
Задача 3, проверка. Запусти тесты и перечисли, что упало и почему. Исправления пока не вноси.
Смысл порядка: сначала чтение, потом малая правка, потом запуск. Так ты видишь, как агент работает с файлами и командами, и ничего не теряешь. Хорошая привычка с первого дня: правила проекта лежат в файле CLAUDE.md, который читается в начале каждой сессии.

Обновление и удаление
Native Install обновляется сам: проверка идёт при запуске и периодически во время работы, обновление применяется при следующем запуске. Принудительно: claude update. Для Homebrew и WinGet обновление делается вручную командами из таблицы выше.
Канал обновлений выбирается в настройках: latest по умолчанию, stable это версия примерно недельной давности без релизов с серьёзными ошибками. Команде, которой нужна предсказуемость, подойдёт stable.
Удаление зависит от способа установки. Для Native Install на macOS, Linux и WSL это удаление двух путей: rm -f ~/.local/bin/claude и rm -rf ~/.local/share/claude. Для Homebrew brew uninstall --cask claude-code, для WinGet winget uninstall Anthropic.ClaudeCode. Настройки и история лежат отдельно в каталоге ~/.claude, и удаление программы их не трогает. Сначала сохрани то, что нужно, потом чисть.
Устанавливаешь ИИ-инструмент для команды и хочешь заранее знать, кому он даст доступ, что будет видеть в проекте и как это контролировать? Можно составить правила работы и пилот на 2 недели.

8 сбоев установки и что с ними делать
| Что видишь | Причина | Что делать |
|---|---|---|
claude не найден после установки |
Каталог установки не в PATH или окно терминала старое | Открой новое окно, затем разделы про PATH в документации |
Сообщение про разделитель && в PowerShell |
Запущена команда CMD | Используй команду с irm |
irm не опознана |
Ты в CMD, команда от PowerShell | Используй команду с curl и install.cmd |
Ошибка syntax error near unexpected token или код 403 |
Установщик не скачался: сеть, ответ сервера, региональное ограничение | Раздел про устранение неполадок установки, альтернативные способы |
В Alpine команда падает с not found |
Нет bash и curl |
Выполни apk add bash curl и повтори |
После npm предупреждение EBADENGINE |
Версия Node.js ниже 22 | Установка завершается, claude работает; для порядка обнови Node.js |
| Отказ npm по правам | Установка через sudo |
Не используй sudo npm install -g, разбери права каталога |
| В нижней строке сессии «Auto-update failed» | Не прошло фоновое обновление | claude doctor покажет причину, затем claude update |
Если сбой не из списка, не гадай. Запусти claude doctor, перепиши текст ошибки дословно и сверь с разделом Troubleshoot installation в документации. Пересказ ошибки своими словами не ищется, а дословный текст ищется.
5 ошибок при установке
- Копируют команду из чата. Команда устарела или подменена. Бери с официальной страницы.
- Путают PowerShell и CMD. Приглашение с
PSэто PowerShell, без него CMD. - Не открывают новое окно после установки. PATH обновляется только в новых сессиях.
- Ставят двумя способами сразу. Потом
claudeзапускается не из того места, а обновление работает только у одного.claude doctorпокажет конфликт. - Начинают в боевом репозитории. Первые три задачи делай на копии.
Если ты хочешь не просто поставить инструмент, а встроить ИИ в работу компании, начни со страницы внедрение ИИ в бизнес: там описан порядок работы. Не строй империю до первых подтверждений: сначала одна установка, одна безопасная задача, одна неделя пробы.
Нужно, чтобы сотрудники работали с ИИ-помощником безопасно и по одним правилам, а не каждый по-своему? Можно собрать инструкцию, права доступа и тест приёмки под вашу команду.
Частые вопросы про установку Claude Code
Как установить Claude Code на Windows?
Открой PowerShell и выполни irm https://claude.ai/install.ps1 | iex, либо в CMD команду с curl и install.cmd из официальной документации. Затем открой новое окно и проверь установку командой claude --version. Git for Windows необязателен.
Какая команда устанавливает Claude Code на Mac и Linux?
Для macOS, Linux и WSL: curl -fsSL https://claude.ai/install.sh | bash. Есть также Homebrew: brew install --cask claude-code. После установки проверь версию командой claude --version.
Что нужно для работы Claude Code кроме установки?
Аккаунт Pro, Max, Ultra, Team, Enterprise или Console. Бесплатный план claude.ai Claude Code не включает. Также документация требует, чтобы страна входила в список Anthropic, об этом читай в статье про Claude Code в России.
Как проверить, что Claude Code установился?
Открой новое окно терминала и выполни claude --version: рабочая установка печатает номер версии. Для подробной проверки есть claude doctor, он печатает диагностику установки и настроек без запуска сессии.
Почему после установки пишет, что claude не найден?
Обычно каталог установки ещё не в PATH или открыто старое окно терминала. Открой новое окно и повтори. Если не помогло, запусти установку заново и сверься с разделом Fix your PATH в документации.
Нужен ли Node.js для Claude Code?
Для Native Install, Homebrew и WinGet нет. Node.js версии 22 или новее нужен только если ставишь через npm. Установленный claude запускает собственный бинарный файл и Node.js при работе не использует.
Как обновить или удалить Claude Code?
Native Install обновляется сам, принудительно командой claude update. Homebrew и WinGet обновляются вручную. Удаление зависит от способа установки, настройки и история лежат отдельно в каталоге .claude и сами не удаляются.
Внедрить ИИ в ваш бизнес?
Бесплатная Zoom-диагностика, 40 минут: задаём уточняющие вопросы, определяем задачи и цели, и по глубине потребностей формируем коммерческое предложение. Артур ответит лично в течение 2 часов в рабочее время.
