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

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

Если вы ещё не знакомы с тем, что такое Claude Code и чем он отличается от чата, — начните с той статьи. Установка без ментальной модели не даёт результата.

Принцип установки: один установщик или npm

Не стоит запоминать команды наизусть — они обновляются. Запомните принцип: есть официальный установщик одной строкой, есть альтернатива через npm. Актуальные команды всегда на официальном сайте code.claude.com/docs.

На дату публикации (и сверены с официальной документацией):

macOS, Linux и WSL:

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

Windows (PowerShell, нативно):

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

Любая ОС — через npm (нужен Node.js):

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

npm-вариант удобен, если у вас уже настроено Node.js-окружение и вы привыкли управлять глобальными пакетами через него. Функционально — без разницы.

Особенности по ОС

macOS и Linux — обычно без сюрпризов. Запускаете установщик, он кладёт бинарь в PATH, готово.

Windows — установщик не требует прав администратора. Одна нюанс: без дополнительных инструментов команды Claude Code будут идти через PowerShell-инструмент, а не Bash. Для совместимости с типичными проектами (и с материалами курса) поставьте Git for Windows — он приносит Git Bash. Это необязательно, но избавит от головной боли с путями и командами.

WSL (Windows Subsystem for Linux) — устанавливается командой для Linux (install.sh). Если вы Windows-разработчик и работаете в WSL, это самый ровный путь: среда ведёт себя как Linux, совместимость максимальная.

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

После установки убедитесь, что бинарь доступен в терминале:

claude --version

Если видите версию — установка прошла успешно. Для расширенной диагностики окружения:

claude doctor

Эта команда проверяет, всё ли на месте: Node.js, PATH, права, соединение. Если что-то не так — укажет, что именно.

Первый запуск

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

cd my-project
claude

При первом запуске Claude Code попросит пройти аутентификацию — войти в аккаунт Anthropic и предоставить доступ. Это разовая процедура.

После аутентификации попробуйте безопасный первый промпт:

Опиши коротко структуру этого проекта

Понаблюдайте, что происходит: агент сам читает файлы (инструмент Read), не спрашивая вас, что именно подгрузить. Он собирает контекст — ровно то, о чём шла речь в модели из урока 1. Это принципиальное отличие от чата: вы не копируете код в диалог, агент сам его находит.

Режимы работы и как между ними переключаться

После первого запуска стоит сразу познакомиться с тремя режимами доверия. Переключаются они в сессии клавишами Shift+Tab — циклически.

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

Auto-accept edits — агент применяет правки файлов сам, без вопросов на каждую. В строке статуса появляется ⏵⏵ auto-accept edits on. Важный нюанс: это не «делай что хочешь» — опасные команды (git push, удаление и т.д.) и ваши правила deny по-прежнему требуют подтверждения. Режим для рутинных задач, когда вы доверяете задаче и устали от прерываний.

Plan mode — агент сначала предлагает план изменений и не трогает файлы, пока вы не одобрите. Полезен для архитектурных решений, рефакторинга крупных блоков, любой ситуации с высокой ценой ошибки. Можно запустить сразу в этом режиме:

claude --permission-mode plan

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

Продолжение сессии

Не всегда нужно начинать с нуля. Claude Code умеет продолжать предыдущий контекст:

claude --continue          # продолжить последнюю сессию
claude --resume <id>       # продолжить конкретную сессию по ID

Это особенно удобно для долгих задач, которые не заканчиваются за один сеанс.

Базовая гигиена контекста с первого дня

Контекст — ограниченный ресурс. Чем чище и релевантнее он наполнен, тем лучше работает агент и тем дешевле обходится сессия. Три практики, которые стоит ввести сразу:

Подгружайте файлы точечно через @-ссылки. В промпте можно сослаться на конкретный файл:

Поправь валидацию в @backend/src/orders/orders.service.ts

Не заставляйте агента искать по проекту — дайте точный адрес.

Очищайте контекст между несвязанными задачами. Закончили одну задачу, начинаете другую — очистите:

/clear

Один из самых частых промахов новичков — тянуть весь день в одной замусоренной сессии. Старый контекст путает агента.

Смотрите, чем занят контекст:

/context

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

Если хотите сразу «научить» агента правилам проекта — запустите:

/init

Он просканирует структуру проекта и сгенерирует черновик CLAUDE.md. Это тема следующего шага — детально о настройке в статье настройка CLAUDE.md.

На реальном проекте: пример с CoffeeCRM

Вот как выглядит старт с нуля на учебном проекте CoffeeCRM (Next.js + NestJS + PostgreSQL):

cd coffeecrm
claude

Первый промпт:

Опиши структуру проекта — что за стек, где бэкенд, где фронт

Агент прочитает package.json, основные папки, README — и даст точный ответ. Никакого ручного копирования. Затем сразу переходите к задаче:

@backend/src/orders/ — добавь endpoint GET /orders, который возвращает список заказов из БД (NestJS, TypeScript, без any)

Это и есть рабочий процесс: точный контекст через @ + конкретная задача + проверяемый критерий («без any»).

Итог

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

Если хотите пройти путь системно — от установки до полноценного AI-агента на реальном fullstack-проекте — посмотрите полный курс по Claude Code.