В предыдущей главе мы разделили ИИ-инструменты на три типа и выбрали главным героем курса Claude Code — тот, кому можно во многом доверить реализацию. В этой главе наконец-то начнём работать руками. Мы бережно, вместе с типичными местами затыков, пройдём всю цепочку установка → запуск → вход → первое указание → одобрение правок и доведём дело до того, что Claude Code заработает в вашем терминале.
Цель — «заставить Claude Code выполнить первое задание в своём окружении»
Что такое Claude Code (повторение предыдущей главы)
Если сказать одной фразой, Claude Code — это «CLI-агент» от Anthropic. Вместо того чтобы копировать код в чат браузера, он прямо внутри вашего терминала читает и переписывает файлы проекта, выполняет команды и прогоняет тесты. Достаточно обычным языком сказать «хочу вот так» — и ИИ сам составит план и продвинет работу сразу через несколько файлов. Настоящий напарник, который сидит рядом и работает вместе с вами.
📖 Два официальных источника для начала. Шаги этой главы — вводный ориентир. Точные системные требования, актуальный способ установки и тарифы обязательно сверяйте по первоисточнику — добавьте в закладки две страницы: официальную документацию code.claude.com/docs и страницу продукта anthropic.com/claude-code. Они пригодятся вам ещё много раз.
Устанавливаем — инсталляция
Claude Code устанавливается и работает в окружении Node.js. Сложной подготовки не требуется. Сначала приготовим две базовые вещи.
Основа, на которой работает Claude Code. Если ещё нет — поставьте LTS-версию с официального сайта nodejs.org. Проверить, установлен ли, можно командой node -v — если показывает версию, всё в порядке.
Экран для ввода команд. На macOS — «Терминал», на Windows — «PowerShell» или WSL, на Linux подойдёт стандартный терминал. Достаточно уметь базовые операции, о которых говорилось в прошлой главе.
Когда всё готово, введите в терминал одну строку. Всё, что нужно, — с помощью npm (менеджера пакетов, идущего в комплекте с Node.js) установить Claude Code так, чтобы он был доступен во всём терминале.
npm install -g @anthropic-ai/claude-code
-g означает «установить глобально (то есть чтобы вызывать из любой папки)». По завершении запустите следующей командой.
claude
⚠️ Если появилось claude: command not found. Установка прошла успешно, но команда не распознаётся — это классический затык, на который новички натыкаются в первую очередь. Чаще всего причина в настройках PATH для Node.js/npm, и способ решения устоявшийся. В статье «command not found / ошибка установки» собраны варианты решения для каждой ОС.
Детальные системные требования, рекомендованные шаги для каждой ОС и альтернативные способы установки меняются в зависимости от окружения. Актуальную и точную информацию обязательно сверяйте по официальной документации code.claude.com/docs.
Первый запуск и вход
При первом запуске командой claude вас попросят войти (пройти аутентификацию) под учётной записью Anthropic. Достаточно следовать подсказкам на экране: в большинстве случаев откроется браузер, вы входите в аккаунт, аутентификация завершается — и вы возвращаетесь в терминал.
Введите в терминале claude. При первом запуске появится экран выбора способа входа.
Следуя подсказкам, войдите в аккаунт Anthropic в браузере. Дайте разрешение — и аутентификация пройдёт.
Вернувшись в терминал, вы увидите экран ожидания ввода. Это вход в диалог. Дальше — первое указание.
Для входа есть два способа: под подпиской Claude с подходящим тарифом и по API-ключу. Какой из них доступен и как начисляется плата — зависит от тарифа, поэтому здесь мы не утверждаем однозначно. Подходящий вашему договору способ сверяйте по официальной документации.
🔑 Если не удаётся войти или возникает ошибка аутентификации. Браузер не открывается, вставленный код отклоняется, процесс застревает на полпути — вход и аутентификация тоже классические места затыков. Решения по типам причин собраны в статье «Ошибка входа / аутентификации». Если это не помогло, загляните также в главу 5 «Выбираться из тупика», где затыки разбираются системно.
Даём первое указание — базовый цикл
После аутентификации начинается самое главное. Первое, что важно, — запускать Claude Code внутри папки того проекта, над которым вы хотите работать. Claude Code воспринимает «текущую папку» как объект работы, поэтому ошибка здесь приведёт к правкам не в том месте.
cd my-project
claude
Дальше — просто обычным языком скажите, что хотите сделать. Можно просить как в разговоре: «Прочитай README и объясни, что делает этот проект», «Добавь форму обратной связи на главную страницу». Отсюда следующие 4 шага станут базовым циклом, который повторяется постоянно.
Скажите обычным языком, что нужно. Чем конкретнее, а не туманнее, тем точнее выйдет результат.
ИИ читает нужные файлы, выстраивает порядок — что и как менять — и приступает к делу.
Отображается, какие строки и как будут изменены, в виде различий (diff). Зелёное — добавление, красное — удаление.
Если довольны — одобрите, и правки применятся. Если нет — отклоните, словами объясните исправление и повторите.
Ключевой момент — «проверка различий» в ЦИКЛЕ 3. Прежде чем переписать файл, Claude Code сначала показывает различия «вот здесь изменю так» и применяет их только после вашего одобрения. Прочитать содержимое и решить, соответствует ли оно замыслу, — роль человека. Как говорилось в прошлой главе, читать полученный код и судить, хорош он или плох — ваша работа.
✅ Первый ход — с «малого и проверяемого». Не просите сразу большую переделку, а привыкайте на маленьких запросах, результат которых видно глазами: «объясни этот файл», «добавь одну небольшую функцию». Если получилось — постепенно расширяйте круг доверяемого. В этом секрет пути без крюков.
Сам способ просить (выбор между «вайб-кодингом», когда доверяешь примерно, и «спец-ориентированной разработкой», когда сначала фиксируешь спецификацию) мы обстоятельно разберём в главе 4 «Грамотно просить». Для начала достаточно, чтобы крутился этот цикл из 4 шагов.
Основы режимов прав — доверять безопасно
«А не удалит ли ИИ файлы по своей воле, не выполнит ли опасную команду?» — вполне резонное беспокойство. Claude Code продуман именно на этот счёт: он устроен так, что перед действиями с последствиями — правкой файлов или выполнением команд — обязательно вставляет подтверждение. Это и есть режимы прав.
Поведение делится на несколько уровней. Здесь усвоим лишь общую концепцию, в общих чертах.
Запрашивает подтверждение перед каждой правкой или выполнением команды. Одобряете по одному — самый безопасный. Начните привыкать с него.
Ничего не меняет на деле, а только составляет план «что будет сделано». Удобно, когда перед крупной работой хочется зафиксировать курс.
Пропускает подтверждения и автоматически продвигает операции в заданных рамках. Быстро, но реже видишь содержимое, поэтому осторожнее.
Мощный режим, пропускающий все подтверждения. Новичкам разумнее избегать. О случаях применения и опасностях — в предупреждении ниже.
💡 «Подтверждать лень, включу всё в обход» — так нельзя. Режим, пропускающий все подтверждения, мощен, но обратная сторона в том, что вы не сможете остановить нежелательное удаление или выполнение команды. Если нужна и безопасность, и скорость, правильный путь — не переключаться сразу в обход, а сперва настроить правила прав, разрешающие только доверенные операции. Есть и вариант «песочницы» — изолировать работу и выполнять её безопасно.
Здесь достаточно запомнить лишь: «Claude Code не выходит из-под контроля по своей воле, он вставляет подтверждения» и «это поведение регулируется режимом». Подробнее можно углубиться в специальных статьях и руководствах.
Различия режимов и переключение — в детальном разборе режимов прав.
Как писать правила разрешения и запрета — в правилах прав и настройках.
Идея песочницы — во введении в песочницу.
CLAUDE.md и основы настройки
Когда начинаешь плотно пользоваться Claude Code, появляется чувство: «надоело каждый раз повторять одни и те же напоминания». «Отступ — два пробела», «эту папку не трогай», «отвечай по-русски» — просить о таких общих для проекта правилах каждый раз неэффективно.
Тут и выходит на сцену CLAUDE.md. Если положить файл с таким именем в корень проекта, Claude Code автоматически прочитает его при запуске и будет работать с учётом записанных правил. Это, если угодно, «инструкция к проекту», которую вы вручаете напарнику.
# Об этом проекте
- Язык: TypeScript / фреймворк: Next.js
- Ответы и комментарии писать по-русски
- Отступ — два пробела
- Не трогать всё, что под src/legacy/
- Перед коммитом прогонять npm run lint
Главное — писать «коротко, конкретно и только то, что действительно нужно соблюдать». Если слишком длинно или туманно, правила, наоборот, соблюдаются хуже. Начните с нескольких строк и дописывайте то, что «замечаете, что повторяете каждый раз» — так его удобнее всего растить.
💡 Записал в CLAUDE.md, а он не соблюдает? Частые случаи — правил слишком много, они слишком абстрактны или противоречат друг другу. Причины и способы исправления собраны в статье «Когда правила CLAUDE.md не работают». Зная «приёмы, чтобы они срабатывали», вы заметно стабилизируете точность ИИ.
Настройки не ограничиваются CLAUDE.md. Упомянутые правила прав, выбор модели и разное поведение тонко регулируются в файлах настроек, но это можно освоить постепенно. Сначала достаточно «записать в CLAUDE.md несколько строк правил проекта» — и ощущения от работы изменятся.
- Claude Code — это CLI-агент от Anthropic. Ставится в окружение Node.js командой
npm install -g @anthropic-ai/claude-codeи запускается черезclaude. - При первом запуске — вход (аутентификация) под учётной записью Anthropic. Застряли — к статьям про command not found / ошибку аутентификации.
- Основа — цикл просить → планировать → проверить различия (diff) → одобрить. Читать различия и судить, хорошо ли, — работа человека.
- Режимы прав удерживают ИИ от выхода из-под контроля. Новичкам стоит избегать обхода и расширять круг доверяемого, проверяя правки.
- Несколько строк правил проекта в CLAUDE.md — и ИИ следует им охотнее.
Теперь Claude Code работает в вашем терминале, и вы можете доверить ему первое задание. В следующей главе 3 «Сравнить и выбирать инструменты» мы разложим по полкам отличия от «собратьев» — Cursor, GitHub Copilot и Codex — и освоим выбор под каждую ситуацию.