Как установить Claude Code: полный гайд по всем системам

Коротко (TL;DR)

Claude Code — это ИИ-агент от Anthropic на основе моделей Claude, который работает прямо в терминале и в редакторе кода: вы пишете задачу словами, а он читает файлы проекта, правит их и запускает команды. Чтобы им пользоваться, программу нужно один раз установить. Установка Claude Code занимает 10–15 минут и на всех системах сводится к одной команде.

Что важно знать до старта:

• Бесплатного доступа нет. Нужна подписка Claude Pro ($20/мес) или Max ($100–200/мес), либо аккаунт Claude Console с оплатой API по токенам. Бесплатный тариф Claude.ai доступ к Claude Code не даёт (на 9 июля 2026).
• Рекомендуемый способ — нативный установщик. Одна строка в терминале, никаких дополнительных программ. Метод через npm официально помечен как устаревший.
• IDE — по желанию. Claude Code работает и в чистом терминале. Расширение для VS Code и плагин для JetBrains добавляют панель чата внутри редактора, но это отдельный, необязательный шаг.

Ниже — как установить Claude Code на Windows, macOS и Linux, как подключить его к VS Code и JetBrains, как войти в аккаунт и что делать, если после установки команда claude «не найдена». Все команды и требования сверены с официальной документацией Anthropic на 9 июля 2026 (актуальная версия — v2.1.205).

Подготовка: аккаунт и системные требования

Claude Code — это программа-агент (её ещё называют CLI, от command-line interface — «интерфейс командной строки»). Она запускается в терминале — текстовом окне, куда вводят команды: на macOS это приложение «Терминал», на Windows — PowerShell, на Linux — любой эмулятор терминала.

Какой аккаунт нужен

Войти в Claude Code можно с одним из вариантов доступа:

Как устроены лимиты Claude Code и как их растянуть

Как диктовать промпты и вставлять скриншоты в Claude Code

Как сделать сайт с помощью Claude Code за 30 минут

Сколько стоит Claude Code и как оплатить подписку

Почему ИИ забывает и путается в длинном диалоге: контекстное окно простыми словами

Одна подписка Pro или Max сразу открывает и Claude в вебе/приложении, и Claude Code в терминале — это единый доступ. Отдельные нюансы оплаты и доступа из Украины разбираем в гайде про подписку и оплату Claude Code.

Системные требования

Отдельная третичная статья указывала macOS 12+ вместо 13.0+ — это устаревшая формулировка, официальная страница требований (сверено 9 июля 2026) называет минимумом именно macOS 13.0.

Установка Claude Code на Windows

Установка Claude Code на Windows проще всего проходит нативным установщиком. Откройте PowerShell (нажмите «Пуск», начните печатать PowerShell, откройте приложение) и выполните одну команду:

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

Установщик скачает бинарный файл и положит его в папку C:\Users\ВашеИмя\.local\bin. После завершения перезапустите PowerShell, чтобы система «увидела» новую команду.

Миф про обязательный Git for Windows

В нескольких свежих гайдах за 2026 год встречается утверждение: «на Windows сначала обязательно установите Git for Windows, иначе установщик упадёт». Это неверно. По официальной документации (сверено 9 июля 2026) Git for Windows рекомендуется, но не обязателен: с ним Claude Code использует Bash как инструмент запуска команд, а без него — просто переключается на PowerShell. Установка и вход работают в обоих случаях, так что новичку не нужно пугаться лишнего шага.

Native Windows, WSL2 или WSL1

WSL (Windows Subsystem for Linux) — это встроенная в Windows возможность запускать Linux-окружение. Claude Code работает во всех трёх режимах, но они отличаются по одному важному пункту — поддержке песочницы (sandboxing, изоляции, в которой агент безопаснее выполняет незнакомый код):

Вывод простой: если вы планируете давать агенту автономно выполнять незнакомый код, ставьте Claude Code внутри WSL 2. Для обычной работы «правим свой проект» хватит и нативной установки на Windows. Внутри WSL команда установки — как для Linux (см. ниже).

Есть и альтернатива через менеджер пакетов WinGet — но он, в отличие от нативного установщика, не обновляется автоматически (об этом ниже в разделе про обновление).

Установка Claude Code на macOS

На macOS откройте «Терминал» и выполните нативную установку — одна строка:

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

Бинарник попадёт в ~/.local/bin. Это тот же путь, что и на Linux, поэтому и решение типичной ошибки с PATH будет одинаковым (см. раздел про ошибки).

Второй вариант — Homebrew (популярный менеджер пакетов для macOS): brew install --cask claude-code. У Homebrew-версии есть нюанс: она не обновляется сама, и для самой свежей сборки предусмотрен отдельный cask. Точные имена cask’ов приведены на официальной странице setup — если не пользуетесь Homebrew специально, берите нативный установщик, он проще и автообновляется.

Установка Claude Code на Linux

На Linux работает та же нативная команда, что и на macOS:

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

Доступны и системные пакеты через apt (Debian/Ubuntu), dnf (Fedora) и apk (Alpine) — точные команды и репозиторий Anthropic указаны на официальной странице setup. Помните: пакеты из менеджеров не автообновляются, в отличие от нативного бинарника.

Alpine и другие musl-дистрибутивы требуют доустановить зависимости вручную:

apk add libgcc libstdc++ ripgrep

и выставить в settings.json параметр USE_BUILTIN_RIPGREP в значение 0 — встроенный ripgrep (утилита быстрого поиска по коду) на musl не работает.

Метод через npm (устаревший, но иногда нужен)

Раньше Claude Code часто ставили через npm — менеджер пакетов Node.js. Сейчас официальный README репозитория прямо помечает этот способ как Deprecated (устаревший) в пользу нативного установщика. Команда всё ещё работает:

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

Два важных момента:

• Node.js нужен версии 22 и новее — начиная с v2.1.198. Многие сторонние гайды за март–май 2026 до сих пор пишут «Node 18+»: это устаревшая цифра. На старом Node установка не упадёт: npm выведет предупреждение EBADENGINE, но сама команда claude всё равно заработает — пакет ставит нативный бинарник, который во время работы Node.js не использует. Актуальное требование >=22.0.0 подтверждается прямым запросом к реестру npm (сверено 9 июля 2026), и обновить Node всё же стоит — ради чистой установки без лишних предупреждений.
• Зачем он тогда нужен. Разумных сценария два: у вас уже настроено окружение Node и хочется единообразия, либо установка в CI (автоматической сборке). В остальных случаях нативный установщик лучше — он не тянет Node вообще и обновляется сам.

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

После установки перейдите в папку любого проекта и просто запустите:

claude

При первом запуске откроется браузер с окном авторизации Anthropic — войдите под своим аккаунтом Pro/Max или Console, подтвердите доступ, и терминал сам продолжит работу. Сменить аккаунт позже можно командой /login уже внутри сессии.

Ещё один растиражированный миф — будто для установки «обязательно подключить GitHub». Это не так: GitHub нужен только для отдельных функций (например, автоматических проверок кода в CI), но не для самой установки и не для входа. Не подключайте его, если он вам не нужен, — на лишнем шаге легко застрять на пустом месте.

VS Code: расширение Claude Code

Если вы работаете в редакторе VS Code, к нему есть расширение Claude Code — оно добавляет панель чата с агентом прямо в окно редактора. Что нужно знать:

• Версия VS Code — 1.98.0 или новее. API-ключ не требуется: достаточно платной подписки (Pro, Max, Team, Enterprise) или аккаунта Console.
• Установка — как у любого расширения: откройте вкладку Extensions (Ctrl+Shift+X), найдите «Claude Code», нажмите Install.
• Тонкость про «расширение vs отдельный CLI». Расширение VS Code содержит собственную встроенную копию CLI для панели чата — то есть чат заработает и без отдельной установки. Но если вы хотите запускать команду claude во встроенном терминале VS Code, standalone-CLI (тот, что ставится нативным установщиком выше) всё равно нужен отдельно. Проще поставить нативный CLI сразу — тогда работают оба варианта.

JetBrains: плагин Claude Code

Для сред разработки JetBrains есть плагин Claude Code. Он поддерживает большинство IDE семейства: IntelliJ IDEA, PyCharm, Android Studio, WebStorm, PhpStorm, GoLand.

Главное отличие от VS Code: плагин JetBrains не содержит CLI внутри себя. Он запускает команду claude во встроенном терминале IDE и подключается к ней — поэтому обе части нужны обязательно: сначала поставьте нативный CLI (команда установки выше), затем плагин через Settings → Plugins → Marketplace → «Claude Code».

Грабли на WSL2. Если IDE стоит в Windows, а Claude Code — внутри WSL2, плагин часто выдаёт «No available IDEs detected». Причина — сетевая изоляция WSL2 (NAT) и брандмауэр Windows. Лечится либо ручным правилом в брандмауэре, либо включением зеркального режима сети (mirrored networking доступен в Windows 11 22H2 и новее).

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

Убедиться, что установка Claude Code прошла успешно, можно двумя командами:

claude --version   # быстрая проверка: покажет номер версии
claude doctor      # подробная диагностика

claude doctor — недооценённый инструмент: он проверяет конфигурацию, корректность PATH и результат последнего автообновления одной командой. Если что-то работает не так, начинайте диагностику именно с него.

Типичные ошибки и как их починить

Самая частая проблема сразу после установки — Claude Code не запускается: терминал отвечает command not found: claude (macOS/Linux) или claude is not recognized (Windows). Причина почти всегда одна: нативный установщик кладёт бинарник в ~/.local/bin, а этой папки может не быть в PATH — списке каталогов, где система ищет команды.

Если ни одно из решений не подошло — запустите claude doctor, он покажет, что именно не так с конфигурацией и путями.

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

Способ, которым вы поставили Claude Code, определяет, обновляется ли он сам. Это ключевой момент, который почти нигде не сводят в одну таблицу:

Вывод: если не хотите думать про обновления вообще — ставьте нативным установщиком, он обновляется сам.

Полное удаление нативной установки на macOS/Linux/WSL:

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude
rm -rf ~/.claude && rm ~/.claude.json   # конфиги и настройки

Важный нюанс: папку ~/.claude/ пишет не только CLI, но и расширение VS Code, плагин JetBrains и десктоп-приложение Claude. Если что-то из них осталось установленным, каталог ~/.claude/ пересоздастся при следующем запуске — удаляйте CLI и IDE-интеграции вместе, если хотите вычистить всё.

Продвинутые приёмы

Три вещи сверх базовой установки, которые пригодятся, когда освоитесь:

• Закрепить версию или канал обновлений. В settings.json есть параметры autoUpdatesChannel (стабильный или свежий канал) и minimumVersion — полезно в команде, чтобы у всех была одинаковая, проверенная сборка, а не «последняя случайная».
• Проверить подлинность бинарника по GPG. Для параноидальных или корпоративных сценариев Anthropic публикует GPG-подпись установщика. Отпечаток ключа для сверки — 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE.
• Нестандартный путь к Git на Windows. Если Git for Windows установлен не в стандартную папку, укажите путь к bash.exe через переменную окружения CLAUDE_CODE_GIT_BASH_PATH — тогда Claude Code найдёт Bash-инструмент.

Риски и меры предосторожности

Установка Claude Code безопасна, но пара моментов заслуживает внимания — особенно если вы новичок.

• Команда curl … | bash (и irm … | iex) запускает скрипт из интернета напрямую. Для официального адреса claude.ai/install.sh это норма, но берите команду только из официальной документации Anthropic — не из случайных статей и не из чужих репозиториев. Поддельные «установщики Claude Code» — реальный риск заражения системы.
• Агент выполняет команды на вашем компьютере. По умолчанию Claude Code спрашивает подтверждение перед действиями. Но если планируете давать ему автономно запускать незнакомый код (как это делают более самостоятельные терминальные агенты вроде OpenClaw), включайте песочницу — то есть ставьте Claude Code в WSL 2 на Windows. На нативном Windows изоляции нет.
• Для корпоративных и параноидальных сценариев — проверка подписи. Имеет смысл сверить GPG-подпись установщика (отпечаток — в разделе про продвинутые приёмы), чтобы убедиться, что бинарник подлинный.

Ни один из этих рисков не мешает обычной установке — это меры на будущее, когда начнёте давать агенту больше свободы.

FAQ

Можно ли пользоваться Claude Code бесплатно? Нет. Нужна подписка Pro ($20/мес) или Max ($100–200/мес), либо аккаунт Console с оплатой API по токенам. Бесплатный тариф Claude.ai доступ к Claude Code не открывает (на 9 июля 2026).

Нужно ли уметь программировать, чтобы установить Claude Code? Нет. Установка — это одна команда в терминале, скопировать и вставить. Уметь писать код для самой установки не требуется; агент как раз и нужен, чтобы помогать тем, кто кодом владеет не глубоко.

Обязателен ли Git для установки на Windows? Нет. Git for Windows рекомендуется (даёт Bash-инструмент), но не обязателен: без него Claude Code использует PowerShell. Установка и вход работают и без Git.

Какой способ установки выбрать новичку? Нативный установщик (irm … на Windows, curl … на macOS/Linux). Он не требует Node.js, ставится одной командой и обновляется сам. Метод через npm официально устарел.

Claude Code не запускается после установки — что делать? Скорее всего, папки ~/.local/bin нет в PATH. Добавьте её командой из таблицы ошибок выше под вашу систему и перезапустите терминал. Если не помогло — запустите claude doctor.

Как обновить Claude Code? Нативная установка обновляется сама. Для Homebrew, WinGet, apt/dnf/apk и npm нужна ручная команда — см. таблицу обновления выше.

Чем расширение VS Code отличается от плагина JetBrains? Расширение VS Code содержит встроенную копию CLI для панели чата (чат заработает и без отдельной установки). Плагин JetBrains CLI не бандлит — для него нативный claude нужно ставить отдельно всегда.