Как установить Claude Code: пошагово для Mac и Windows

Установка Claude Code это одна строка в терминале и пара минут времени. Сложное начинается раньше и позже: до установки нужна платная подписка, а после первого запуска человек смотрит на мигающий курсор и не понимает, что писать. Здесь разберу саму установку по шагам, для Mac и Windows, и что делать, когда команда не срабатывает. Все команды взял из официальной документации Anthropic и сверил 16 августа 2026 года.

Что нужно до установки

Три вещи:

платная подписка Claude: Pro, Max или Team. На бесплатном тарифе Claude Code недоступен, тарифы и лимиты я разбирал в отдельной статье
поддерживаемая страна. Россия в список Anthropic не входит, про обходные пути писал здесь
компьютер не древний: macOS 13 и новее, Windows 10 версии 1809 и новее, 4 ГБ оперативной памяти

Чего не нужно, вопреки половине статей в интернете:

Node.js (среда для запуска программ на JavaScript). Нужен только тем, кто ставит через npm
Git
WSL на Windows (Linux внутри Windows). Раньше требовался, сейчас нет

Mac: одна команда

Откройте Терминал (Cmd+Пробел, наберите «Терминал») и вставьте:

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

Команда скачивает установщик с сайта Claude и сразу его запускает. Через минуту программа стоит и дальше обновляется сама.

Если пользуетесь Homebrew (менеджер программ для Mac, ставит приложения одной командой), подойдёт и он:

brew install --cask claude-code

Разница в обновлениях. Версия из Homebrew сама себя не обновляет, придётся иногда набирать brew upgrade claude-code.

Windows: тоже одна команда

Откройте PowerShell (кнопка Пуск, наберите «PowerShell») и вставьте:

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

WSL сегодня не нужен, всё работает напрямую в Windows. Кому привычнее WinGet, есть вариант через него:

winget install Anthropic.ClaudeCode

Честная пометка: я работаю на Mac, поэтому команды для Windows привожу по официальной документации Anthropic, своими руками их не проверял.

Linux

Здесь работает та же команда, что и на Mac:

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

Официально поддерживаются Ubuntu 20.04 и новее, Debian 10 и новее, Alpine 3.19 и новее. У Anthropic есть и обычные репозитории для apt, dnf и apk, но там добавляются шаги с ключами подписи, так что для первого раза проще команда выше.

Если терминал пугает

У Claude Code есть настольное приложение с обычным окном и кнопками. Возможностей у него меньше, но для знакомства хватает, и терминал открывать не придётся. Ссылка на него лежит на той же странице документации, что и остальные способы установки.

Через npm: если Node.js уже стоит

npm install -g @anthropic-ai/claude-code

Требуется Node.js версии 22 или новее. Anthropic вынес этот способ в раздел для продвинутых: обычный установщик проще и лишнего с собой не тащит. Отдельно предупрежу про sudo. Ставить глобальные пакеты через него не надо, это ломает права на папки и потом мешает обновлять программу.

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

Наберите:

claude

Откроется браузер, там подтверждаете вход в свой аккаунт Claude. Пароль в терминал вводить не придётся. После подтверждения возвращаетесь в терминал и работаете.

У тех, кто платит по токенам через кабинет разработчика, вход устроен иначе. В системе прописан ключ доступа ANTHROPIC_API_KEY, браузер тогда не открывается, программа просто спросит подтверждение на использование этого ключа.

Две команды пригодятся сразу: /login меняет аккаунт, /logout выходит из него.

Где хранится вход: на Mac в связке ключей (системное хранилище паролей), на Linux и Windows в файле внутри папки .claude в вашем профиле. Поэтому логиниться каждый раз заново не нужно.

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

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

Первое правило: Claude Code работает с той папкой, из которой вы его запустили. Поэтому сначала переходите в папку проекта командой cd и только потом набираете claude. Если запустить из пустой папки, помогать ему будет нечем.

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

Проверить, что всё встало

claude --version покажет номер версии. Номер меняется постоянно, обновления выходят почти каждую неделю, так что запоминать конкретную цифру смысла нет.

claude doctor запускает диагностику: проверяет установку и настройки, показывает найденные проблемы. Набирать в обычном терминале, это спасает, когда claude вообще не стартует. Внутри уже запущенной сессии то же самое делает команда /doctor.

Пять мест, где застревают

Список собран из официального разбора проблем у Anthropic:

Ответ command not found: claude. Программа встала, но система её не видит. Папка ~/.local/bin не попала в PATH (список мест, где система ищет команды). Лечится строчкой в файле ~/.zshrc и перезапуском терминала.
Вместо установки сыпется HTML или ошибка 403. Обычно упирается в блокировку по стране или в корпоративный прокси. Обходной путь: поставить через Homebrew или WinGet.
Ошибка прав доступа. Система не даёт писать в папку установки. Команда sudo mkdir -p ~/.local/bin && sudo chown -R $(whoami) ~/.local возвращает вам права на вашу же папку.
Две установки конфликтуют между собой. Частая история у тех, кто сначала ставил через npm, а потом поставил обычным установщиком. Команда which -a claude покажет все копии, лишнюю удаляем.
Команда вставлена в другой терминал. На Windows команду для PowerShell вставляют в CMD и наоборот. Смотрите на строку приглашения: PS C:\ означает PowerShell.

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

Обычная установка обновляется сама. Принудительно можно набрать claude update. Для Homebrew это brew upgrade claude-code, для WinGet winget upgrade Anthropic.ClaudeCode, для npm npm install -g @anthropic-ai/claude-code@latest.

Удалить с Mac полностью:

rm -f ~/.local/bin/claude

rm -rf ~/.local/share/claude

Если хотите стереть заодно все настройки и историю, добавьте rm -rf ~/.claude. Отменить это нельзя, поэтому набирайте осознанно.

Итог

Сама установка честно занимает две минуты: одна команда, вход через браузер, готово. Основные потери времени случаются на трёх вещах: подписка не оформлена, страна не поддерживается, команда вставлена не в тот терминал.

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