Как установить Claude Code на Mac, Windows, Linux

Q: Куда устанавливается Claude Code?

На macOS и Linux — в `~/.local/`: сам файл запуска в `bin`, версии в `share/claude`. Настройки отдельно, в `~/.claude` и `~/.claude.json`. На Windows — в соответствующие папки профиля пользователя.

Claude Code install — это одна команда в терминале, и дальше программа ставит себя сама. Node.js для неё не нужен, собирать ничего не надо. Ниже порядок действий для macOS, Windows и Linux, требования к системе, вход в аккаунт и проверка, что всё работает. Все команды взяты из официальной документации и действительны на 1 октября 2026 года.

Сразу уточним, чтобы не путаться: это установка самого Claude Code. Если он у вас уже стоит и вы ищете, как добавить ему скиллы, это отдельная инструкция.

Что такое Claude Code и чем он отличается от приложения Claude

Claude Code — это Claude, который живёт в вашем терминале и работает с файлами проекта напрямую. Формально это claude code cli, то есть программа командной строки. Он читает код, правит его, запускает команды, делает коммиты.

Разница с приложением claude.ai простая. В приложении вы разговариваете: задаёте вопрос, получаете текст, переносите его к себе руками. В терминале Claude сам открывает нужные файлы, вносит правки и проверяет результат. Поэтому для работы над проектом берут Claude Code, а для разовых вопросов и документов — приложение.

Есть и третий вариант: Claude Desktop, оконное приложение для тех, кому терминал неудобен. Возможности те же, вид другой.

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

Прежде чем ставить, проверьте по списку — он короткий.

macOS 13.0 и новее;
Windows 10 версии 1809 и новее либо Windows Server 2019 и новее;
Linux: Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+;
Память: 4 ГБ и больше;
Процессор: x64 или ARM64;
Оболочка: Bash, Zsh, PowerShell или CMD;
Интернет нужен постоянно, офлайн Claude Code не работает.

И отдельная строка, которая стоит в официальных требованиях наравне с остальными: местоположение из списка поддерживаемых стран Anthropic. России в этом списке нет, подробнее об этом — в статье про Claude Code в России.

Как установить Claude Code: основная команда

Рекомендуемый способ — родной установщик. Он сам скачивает готовую программу под вашу систему.

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 приглашение начинается с PS C:\, в CMD — просто C:\. Если видите ошибку про && как недопустимый разделитель, вы в PowerShell, а взяли команду для CMD. Если irm не распознан — наоборот.

Родной установщик обновляется сам в фоне, следить за версиями не нужно.

Другие способы установки

Homebrew на macOS:

brew install --cask claude-code

У Homebrew две сборки: claude-code — стабильный канал, отстаёт примерно на неделю и пропускает выпуски с крупными поломками; claude-code@latest — всё сразу. Обновлять придётся руками: brew upgrade claude-code.

WinGet на Windows:

winget install Anthropic.ClaudeCode

Тоже без автообновления, обновление командой winget upgrade Anthropic.ClaudeCode.

Через npm, если вы и так живёте в этой экосистеме:

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

Для этого пути нужен Node.js 22 или новее. Важная деталь: npm ставит ту же самую готовую программу, что и родной установщик, и запущенный claude сам Node не использует. То есть Node нужен только для установки этим способом, а не для работы.

Через sudo npm install -g ставить не надо — так появляются проблемы с правами и лишние риски.

Для Debian, Fedora, RHEL и Alpine есть подписанные репозитории apt, dnf и apk — команды лежат в той же официальной документации.

Как установить Claude Code на Windows: нативно или через WSL

claude code windows — частый запрос, и выбор тут между двумя путями.

Нативно. Запускаете команду из PowerShell или CMD, права администратора не нужны. Отдельно стоит поставить Git for Windows: он не обязателен, но с ним Claude получает Bash, а без него работает через PowerShell. Песочница для безопасного запуска команд в этом режиме не поддерживается.

Через WSL 2. Ставите линуксовой командой внутри WSL и запускаете claude оттуда же, а не из PowerShell. Этот путь выбирают, если проекты линуксовые или нужна песочница — в WSL 2 она работает. Git for Windows при этом не нужен.

Коротко: проекты под Windows — нативно, линуксовые инструменты и изоляция — WSL 2.

Запуск и проверка, что всё получилось

Откройте терминал в папке проекта и наберите:

claude

Откроется диалоговая сессия прямо в терминале. Проверить версию:

claude --version

Рабочая установка печатает номер версии вида 2.1.211 (Claude Code). Если терминал отвечает, что команда не найдена, папка установки ещё не попала в PATH — это частая и лечимая вещь, решение есть в документации.

Для подробной диагностики без запуска сессии:

claude doctor

Эта команда показывает состояние установки, ошибки в файлах настроек и предупреждения с подсказками. С неё стоит начинать, когда что-то ведёт себя странно.

Вход в аккаунт: что нужно, чтобы Claude Code заработал

Установить программу мало, ей нужен доступ к модели. Подходит один из вариантов:

подписка Pro, Max, Team или Enterprise;
аккаунт Console с оплатой по API;
доступ через стороннюю платформу — Amazon Bedrock, Google Cloud или Microsoft Foundry.

Бесплатный тариф claude.ai Claude Code не открывает. Это самая частая причина, по которой установка «не работает»: программа встала нормально, а доступа нет.

Вход после установки: запускаете claude, он открывает браузер, вы подтверждаете. Если в системе уже задана переменная ANTHROPIC_API_KEY, браузер не откроется — Claude Code один раз спросит разрешение использовать этот ключ.

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

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

claude update

Homebrew, WinGet и системные пакеты сами не обновляются — для них команды обновления свои, они выше.

Канал обновлений переключается в настройках: latest даёт новые возможности сразу, stable — версию примерно недельной давности без выпусков с крупными поломками. Для рабочей машины, где важна предсказуемость, разумнее stable.

Удаление родной установки на macOS и Linux — это снять сам файл запуска и папку с версиями из ~/.local/; для Homebrew, WinGet и npm есть свои команды удаления. Настройки лежат отдельно, в ~/.claude и ~/.claude.json, и удаляются только вместе с историей сессий и подключениями MCP, так что торопиться с ними не стоит.

Claude Code в VS Code и других редакторах

Если вы не хотите уходить в терминал, есть claude code vscode — расширение для VS Code, и плагин для редакторов JetBrains. Claude работает с теми же файлами, но живёт в панели редактора: видно, какие файлы он правит, и правки можно просматривать привычным образом.

Важно помнить, что расширение, плагин и оконное приложение пишут в ту же папку ~/.claude, что и терминальная версия. Поэтому настройки у них общие, а при полном удалении убирать нужно всё вместе, иначе папка появится снова.

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

Пустой Claude Code работает, но вполнакала. Два шага, которые дают больше всего:

Поставить скиллы. Они задают Claude порядок действий: уточнить задачу, написать план, проверить результат. Как это делается — в инструкции по установке скиллов, а что именно ставить — в списке скиллов Claude Code.
Подключить свои сервисы через MCP. Тогда Claude видит ваши таблицы, почту и GitHub, а не только файлы проекта. Разобрали в статье про MCP в Claude Code.

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

Нужен ли Node.js для Claude Code? Для родного установщика нет: он скачивает готовую программу, которая Node не использует. Node.js 22 или новее нужен только при установке через npm, и то лишь на этапе установки — запущенный claude работает без него.

Работает ли Claude Code на Windows? Да, двумя способами: нативно из PowerShell или CMD, либо внутри WSL. Нативно нужна Windows 10 версии 1809 или новее. Git for Windows не обязателен, но с ним Claude получает Bash вместо PowerShell.

Чем отличается Claude Code от приложения Claude? Claude Code работает в терминале и правит файлы вашего проекта сам. Приложение claude.ai — это диалог в браузере, оттуда результат вы переносите руками. Скиллы и настройки у них хранятся отдельно: поставили скилл в терминале — в приложении его не будет.

Сколько стоит Claude Code? Сама программа бесплатна, платить нужно за доступ к модели: подписка Pro от $20 в месяц или оплата по API по факту использования. Подробнее про тарифы — в статье про Claude Code в России.

Куда устанавливается Claude Code? На macOS и Linux — в ~/.local/: сам файл запуска в bin, версии в share/claude. Настройки отдельно, в ~/.claude и ~/.claude.json. На Windows — в соответствующие папки профиля пользователя.

Можно ли поставить конкретную версию? Да, родной установщик принимает и номер версии, и название канала. Это нужно, когда свежая версия ломает рабочий процесс и надо откатиться.

Установка — самая простая часть. Дальше начинается то, ради чего всё затевалось: научить Claude работать по вашим регламентам, а не по общим советам из интернета. Опишите процесс, цену назовём до старта. Что входит в работу — на странице ИИ-агент для бизнеса под ключ.