Claude Code для начинающих: установка и первая готовая функция

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

Поэтому первое знакомство лучше провести на отдельной учебной папке. Не берите рабочий сайт, базу клиентов или единственную копию важного проекта. Наша цель скромнее: установить Claude Code, дать ему маленькую задачу, увидеть каждое изменение и сохранить рабочую версию.

Anthropic описывает Claude Code как агентный инструмент для разработки. Он читает кодовую базу, выполняет обычные задачи, объясняет код и работает с Git через команды на естественном языке. В отличие от веб-чата, агент действует в выбранной папке: может читать файлы, предлагать правки и запускать команды.

Это удобно, но именно поэтому папка имеет значение. Если запустить claude в каталоге рабочего проекта, этот проект станет контекстом сеанса. Для первого раза нужна отдельная учебная директория или копия проекта, которую не страшно испортить.

Для входа понадобится подходящий аккаунт. Согласно актуальной инструкции Anthropic, Claude Code доступен с подписками Pro, Max, Team, Enterprise или через Console; бесплатный план Claude.ai в этот список не входит. Цены и лимиты меняются, поэтому перед началом проверьте их на официальной странице, а не в старом обзоре.

В ранних инструкциях Claude Code часто устанавливали глобально через npm. Сейчас официальный репозиторий помечает этот способ как устаревший и рекомендует native installer.

На macOS, Linux или внутри WSL откройте терминал и выполните:

В Windows PowerShell команда другая:

Устанавливать программу от имени администратора не требуется. На macOS можно выбрать официальный Homebrew cask, а на Windows использовать пакет WinGet, но для первого запуска достаточно одного способа из инструкции выше.

Закройте и снова откройте терминал, затем проверьте установку:

Команды по порядку:

Первая команда должна вывести версию. Вторая проверяет установку и конфигурацию. Если терминал не находит claude, не переходите к проекту: сначала откройте раздел устранения проблем с установкой и исправьте окружение.

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

Команды по порядку:

Откройте папку в любом текстовом редакторе и сохраните в ней index.html:

Для учебной страницы достаточно минимального index.html с кодировкой UTF-8, заголовком «Учебная страница» и исходным абзацем, который нужно сохранить.

Откройте файл в браузере. До работы агента на странице должны быть видны заголовок и строка «Исходный текст нужно сохранить».

Теперь зафиксируйте эту версию:

Команды по порядку:

Если Git просит указать имя и почту, выполните команды из его сообщения и повторите commit. В конце git status должен сообщить, что незакоммиченных изменений нет. Это исходная точка, с которой можно сравнить работу Claude Code и к которой можно вернуться.

Откройте терминал именно в папке claude-first-task и запустите:

Команда для этого шага:

В plan mode Claude Code может читать файлы и исследовать проект, но не редактирует исходники. В обычном сеансе режимы можно переключать клавишами Shift+Tab; текущий режим виден в строке состояния.

Первый запрос нужен не для кода. Попросите агента объяснить, что уже лежит в папке:

Изучи файлы в этой папке. Пока ничего не меняй.

Объясни простыми словами:

1. из каких частей состоит страница;

2. как открыть её для ручной проверки;

3. какие файлы понадобятся для небольшой интерактивной функции.

Если информации не хватает, сначала задай вопросы.

Сопоставьте ответ с тем, что видите сами. Если в папке один index.html, а план упоминает React, сервер и базу данных, агент неверно понял проект или раздувает решение. Исправьте это сейчас, пока файловые правки запрещены.

Учебная задача: добавить на страницу кнопку «Показать подсказку». После нажатия под ней появляется текст «Проверяйте результат, а не ответ агента». Повторное нажатие скрывает текст. До клика подсказка не видна.

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

Составь минимальный план для одной функции.

Нужно добавить на существующую страницу кнопку «Показать подсказку».

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

«Проверяйте результат, а не ответ агента».

Повторное нажатие скрывает текст.

Ограничения:

- сохрани существующий текст и оформление страницы;

- не добавляй библиотеки и сборщик;

- не создавай сервер;

- меняй только файлы, без которых функция не работает.

Готово, если:

- до клика подсказка скрыта;

- первый клик показывает точный текст;

- второй клик снова его скрывает;

- в консоли браузера нет новой ошибки.

Пока не вноси изменения. Назови файлы, которые хочешь изменить,

и объясни, как проверишь каждый критерий.

Хороший план для такой задачи короткий. Если Claude Code предлагает сменить стек, установить зависимости или переписать страницу, попросите сократить решение до существующего HTML, CSS и JavaScript. План нужен не для солидности документа: на нём дешевле всего остановить лишнюю работу.

После согласования плана выйдите из plan mode и выберите режим с видимой меткой Manual: в конфигурации он называется `default`. В нём без отдельного подтверждения выполняется только чтение. Не полагайтесь на то, какой режим открылся автоматически: стартовый выбор может зависеть от аккаунта и настроек. Для первого проекта ручное подтверждение даёт полезную паузу перед каждым изменяющим действием.

Не включайте bypassPermissions ради удобства. Anthropic рекомендует этот режим только для изолированных контейнеров и виртуальных машин: он пропускает весь слой разрешений. Режим acceptEdits тоже лучше оставить до момента, когда вы научитесь уверенно читать diff после работы.

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

Когда Claude Code закончит, выполните:

Команды по порядку:

git status покажет, какие файлы изменились или появились. git diff покажет строки, которые отличаются от исходной версии. Для каждого изменения задайте простой вопрос: без него кнопка или подсказка действительно не заработает? Если связи нет, попросите агента откатить лишнюю правку либо верните файл вручную из Git.

Затем откройте страницу в браузере и пройдите критерии буквально:

1. Обновите страницу: подсказка скрыта.

2. Нажмите кнопку: появился точный текст.

3. Нажмите ещё раз: текст исчез.

4. Откройте консоль браузера: новой ошибки нет.

5. Посмотрите остальную страницу: прежний текст и оформление сохранились.

Это ручная проверка, которую читатель выполняет у себя. Она не доказывает, что Claude Code всегда пишет правильный код, и не заменяет тесты в более сложном проекте. Первые четыре пункта проверяют критерии функции, а пятый защищает исходную страницу от случайной поломки.

Если проверка не проходит, не пишите «почини всё». Передайте один наблюдаемый симптом:

После первого клика текст появляется, но после второго не скрывается.

Ожидание: второй клик снова скрывает подсказку.

Найди причину в текущих изменениях. Сначала объясни её, затем предложи

минимальную правку. Остальную страницу не меняй.

Повторите тот же сценарий после исправления. Когда все пункты проходят и diff не содержит посторонней работы, сохраните состояние отдельным коммитом. Следующую функцию начинайте уже от этой рабочей точки.

Один такой цикл знакомит только с инструментом. В реальном продукте к нему добавляются устройство проекта, Git, чтение логов, база данных, деплой и защита. Эти части собраны в программе курса «Вайбкодинг на максималках»: там участники проходят цикл разработки фичи и доводят собственный сайт, бот или приложение до работающего проекта. Курс не отменяет проверку результата и не делает Claude Code безошибочным; он даёт более широкий маршрут, чем одна функция в учебной папке.

Проблема первого запуска может находиться как в окружении, так и в постановке задачи. Проверьте её по порядку.

claude не найден. Перезапустите терминал после установки. Если shell всё равно возвращает command not found, сначала исправьте путь или установку по официальной диагностике. Не ставьте поверх native-версии ещё несколько копий через npm: документация отдельно описывает конфликты старых установок. Команду claude doctor запускайте после того, как бинарник уже открывается, но остаётся проблема конфигурации.

Windows не понимает команду. У PowerShell строка начинается с PS C:\, у CMD такого префикса нет. Команда с irm предназначена для PowerShell. Для native Windows Git for Windows рекомендован, хотя без него Claude Code может использовать PowerShell как shell-инструмент. В WSL установку и запуск проводят внутри самой Linux-среды.

Агент предлагает слишком много файлов. Вернитесь в plan mode, повторите ограничения и попросите минимальный вариант без новой библиотеки. Не лечите раздутый план серией уточнений уже после десятка правок.

Claude Code просит секрет или токен. Не вставляйте рабочий API-ключ в промпт, исходный код или CLAUDE.md. Для первой статической страницы секреты вообще не нужны. Если задача требует внешнего сервиса, сначала разберитесь с переменными окружения и исключением секретных файлов из Git.

Агент забывает команды и правила проекта. После первого успешного цикла можно создать короткий CLAUDE.md. Официальная документация рекомендует хранить там команды сборки и тестов, соглашения по коду и важные архитектурные правила. Не превращайте файл в дневник всех прошлых разговоров: короткие конкретные инструкции выполняются надёжнее.

Не расширяйте учебную страницу сразу до приложения с аккаунтами и оплатой. Добавьте ещё одну наблюдаемую функцию: например, счётчик открытий подсказки, который сбрасывается после обновления страницы. Сначала запишите ожидаемое поведение и ограничения, затем получите план, разрешите небольшую правку и повторите те же проверки.

После двух таких циклов главный результат находится в репозитории: две маленькие функции, два понятных diff и две рабочие точки в Git. Это уже основа, на которой можно усложнять проект, не отдавая агенту право решать за вас, что считать готовым.