Установка и первый запуск

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

Что нужно приготовить до старта

Установка занимает минут пять. Давай по порядку — что понадобится и что, вопреки слухам, не понадобится.

Терминал — это не страшно

Claude Code запускается в терминале. Если ты раньше с ним не дружил — ничего, это просто окно, куда ты пишешь команды текстом, а компьютер их выполняет. На macOS он называется «Терминал», на Linux — «Terminal» или «Консоль», на Windows мы до него ещё дойдём. Тебе не нужно знать сотни команд. Для старта хватит уметь открыть терминал, перейти в нужную папку и нажать Enter. Всё остальное за тебя будет делать сам Claude.

Node.js — нужен не всегда

Частый миф: «Claude Code — это пакет Node.js, поэтому сначала обязательно ставить Node». Это не так. У Anthropic есть родной установщик (native installer), который ставит инструмент одной командой и никакого Node.js не требует — он же сам обновляется в фоне. Node.js нужен только если ты сознательно выберешь установку через npm (об этом ниже) — тогда пригодится Node версии 18 или выше. Идёшь родным установщиком — про Node можешь вообще забыть.

Доступ к модели

Сам инструмент бесплатный, но мозги ему даёт модель Claude, а за неё нужен доступ. Вариантов два: либо платная подписка Claude (входишь в свой аккаунт Anthropic при первом запуске), либо API-ключ (отдельный режим с оплатой за использование). Какой выбрать и сколько это стоит — смотри на официальном сайте Anthropic, цены и условия меняются, и я не буду их выдумывать. Главное сейчас: заведи аккаунт Anthropic заранее, чтобы на шаге авторизации не отвлекаться.

Для ежедневной работы бери подписку Claude (Pro или Max), а не API-ключ. Разница в модели оплаты: подписка — фиксированная цена за месяц с лимитами, а API тарифицируется за каждый токен. Агент на каждую задачу читает и пишет тысячи токенов, поэтому при регулярной, плотной работе счёт по API выходит существенно дороже подписки. API-ключ хорош под автоматизацию и разовые интеграции; для живой ежедневной работы в терминале почти все берут подписку. Актуальные цены и лимиты — на сайте Anthropic.

Установка: как поставить

Самый простой и рекомендуемый способ — родной установщик. Одна строка в терминал, Node.js не нужен, а дальше инструмент сам обновляется в фоне.

На macOS, Linux и WSL вставь в терминал:

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

На Windows открой PowerShell и вставь:

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

Жмёшь Enter, установщик скачивает инструмент и раскладывает файлы — через минуту команда claude готова к работе. Если по ходу мелькают строчки с warning (предупреждениями) — обычно это нормально, важна только итоговая строка об успешной установке.

Родной установщик — не единственный путь без Node. Есть ещё пакетные менеджеры: Homebrew на macOS (brew install --cask claude-code), WinGet на Windows (winget install Anthropic.ClaudeCode), apt/dnf на Linux (после подключения репозитория Anthropic). Бери тот, которым уже привык пользоваться.

Вариант через npm (если ты уже живёшь в npm)

Если Node.js у тебя и так стоит, а привычный процесс крутится вокруг npm, можно поставить и так:

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

Это единственный способ, которому реально нужен Node.js (версии 18 или выше). Важная деталь: npm здесь — просто способ доставки. Он ставит тот же самый нативный бинарник, и сама команда claude потом работает не на Node. Поэтому «сначала обязательно поставь Node» — правда только для этого варианта, а не в общем случае. Не живёшь в npm — бери родной установщик выше, он проще.

Команды выше — официальные и стабильные, их можно вставлять как есть. Но если что-то пошло не так или хочется свериться — актуальные системные требования и полный список способов установки всегда лежат в официальной документации Claude Code (раздел Installation / Setup). Это источник, который не устаревает.

Дальше логика одинаковая для всех систем:

1. Ставишь Claude Code одной командой — родным установщиком или любым из вариантов выше. После этого команда claude доступна в любой папке.
2. Запускаешь claude в папке своего проекта.
3. При первом запуске проходишь авторизацию — входишь в аккаунт Anthropic или подключаешь API-ключ.

Windows — нативно, WSL по желанию

Ещё один миф, который стоит развеять: раньше говорили, что на Windows Claude Code живёт только через WSL. Сейчас это не так — у него есть нативная поддержка Windows. Ставишь через PowerShell командой выше и работаешь напрямую. Единственная рекомендация — поставить Git for Windows: тогда Claude Code сможет пользоваться его Bash для своих команд (без него он возьмёт в качестве оболочки PowerShell — тоже рабочий вариант).

WSL («Linux внутри Windows», официальная штука от Microsoft) остаётся валидным путём, но уже не обязателен. Он удобен, если ты и так живёшь в Linux-процессе: тогда внутри WSL получаешь нормальный Linux-терминал и ставишь родным установщиком для macOS/Linux/WSL. Не живёшь — просто ставь нативно.

Где его запускать

Классика — обычный терминал, и для старта это самый простой путь. Но вариантов больше:

• Встроенный терминал VS Code. Открываешь терминал прямо внутри редактора и запускаешь claude там же, где пишешь код.
• Расширения для IDE. Есть интеграции для VS Code и JetBrains — Claude Code встраивается в редактор, которым ты уже пользуешься.
• Десктоп-приложение. Отдельное приложение под macOS и Windows, плюс веб-версия — если не хочешь возиться с терминалом вообще.

Для первого раза не усложняй: открой обычный терминал (или терминал внутри VS Code) и набери claude. Остальные способы попробуешь позже, когда освоишься.

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

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

cd ~/projects/my-first-project
claude

Первая строка переводит тебя в папку проекта, вторая запускает агента. При самом первом запуске Claude попросит авторизоваться: откроет вход в аккаунт Anthropic или спросит API-ключ — следуй подсказкам на экране. Это разовый шаг, дальше он тебя помнит.

Первая безопасная задача — почувствовать инструмент

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

• «Расскажи, что лежит в этой папке и для чего эти файлы» — он осмотрится и опишет содержимое своими словами. Ты сразу увидишь, что он реально читает твои файлы, а не фантазирует.
• «Создай тестовый файл hello.txt с одной строчкой внутри» — простая задача на запись. Проверишь, что агент умеет не только читать, но и менять файлы.

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

Как понять, что всё работает

Признаки, что установка прошла как надо: команда claude запускается без ошибки «command not found»; ты прошёл авторизацию один раз и больше она не всплывает; на первую простую просьбу агент осмысленно ответил — описал папку или создал файл, который ты потом реально видишь на диске. Если все три пункта сошлись — поздравляю, инструмент стоит и слушается.

Типичные затыки новичка

Почти все спотыкаются об одно и то же. Вот короткий чек-лист, если что-то пошло не так.

• «command not found» при запуске claude. Если ставил родным установщиком — Node тут ни при чём, почти всегда дело в PATH: закрой терминал и открой заново (установщик прописывает путь, но текущей сессии он ещё не виден). Не помогло — свериться с разделом установки в официальной документации. Если ты выбрал вариант через npm — проверь, что стоит Node 18+ командой node --version.
• Агент «не видит» твои файлы или работает не с тем проектом. Ты запустил claude не из той папки. Выйди, перейди в нужную папку через cd, запусти снова. Claude всегда смотрит туда, откуда стартовал.
• Запустился, но отказывается работать и просит вход. Ты не завершил авторизацию. Доведи до конца вход в аккаунт Anthropic или подключение API-ключа — без доступа к модели агент думать не может.
• На Windows что-то не ставится. Проверь, что запускаешь установщик именно в PowerShell (командой irm https://claude.ai/install.ps1 | iex). Для команд агенту пригодится Git for Windows. А если тебе привычнее Linux-процесс — поставь WSL и работай из Linux-терминала родным установщиком.

Золотое правило при любой ошибке: прочитай, что именно написано в терминале, и не паникуй. Сообщение почти всегда подсказывает причину. А за точными командами и системными требованиями возвращайся в официальную документацию Anthropic — это единственный источник, который не устаревает.

Что дальше

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