Claude Code представляет собой ИИ-агента, который работает в терминале твоего компьютера: ты обычным языком описываешь, что хочешь получить, а он читает файлы проекта, предлагает изменения и выполняет команды. Для старта нужен компьютер с Windows, macOS или Linux, несколько базовых инструментов вроде Node.js и Git и привычка самостоятельно проверять каждый результат.
В этой статье разберем, что это значит на практике, как проходит один рабочий цикл с агентом и как понять, годится ли результат.
Что такое Claude Code и чем он отличается от чата?
В обычном ИИ-чате ты получаешь в ответ текст. Ты его копируешь, куда-то вставляешь и надеешься, что он подойдет. Агент вроде Claude Code, напротив, работает прямо в папке твоего проекта. Он видит, какие там есть файлы, читает существующий код и меняет его.
Терминал при этом просто текстовое окно, в котором ты вводишь команды. Поначалу он кажется непривычным, потому что в нем нет кнопок. Ты набираешь строку, нажимаешь Enter и читаешь ответ. Вот и все.
Отсюда следует главное для начинающих: агент меняет настоящие файлы. Это удобно, потому что работа идет быстро. Но это же требует, чтобы ты следил, что и когда изменилось. Codex выполняет похожую роль. Описанный здесь подход применим к обоим инструментам.
Что нужно подготовить перед первым запуском?
Прежде чем впервые вызвать агента, подготовь рабочую среду. Этот список охватывает основное:
- Ноутбук или настольный компьютер с Windows, macOS или Linux. Планшета не хватит, потому что нужно устанавливать программы и работать в терминале.
- Право устанавливать программы. На рабочих компьютерах это часто запрещено. Уточни заранее у своего IT-отдела.
- Node.js версии 20 или новее. Многим веб-проектам он нужен, чтобы запускать приложение локально и прогонять тесты.
- Git. С его помощью ты сохраняешь промежуточные состояния и видишь, какие файлы изменил агент.
- Собственный доступ к Claude Code или Codex. Условия доступа указаны на официальных сайтах соответствующего поставщика.
- Немного терпения к английскому. Код и многие сообщения инструментов написаны по-английски, даже если задания ты пишешь по-русски.
Устанавливать все лучше по официальной инструкции поставщика. Затем проверь в терминале, что все распознается: Node.js, Git и агент должны показать свою версию. Если хочешь пошаговую помощь, хорошей отправной точкой будет открытая для чтения миссия 0 по настройке инструментов (на немецком).
Как выглядит рабочий процесс с Claude Code?
Типичный рабочий цикл короткий и повторяется раз за разом. Чем меньше цикл, тем проще найти ошибку, если что-то пошло не так.
- Открой папку проекта. Запусти терминал в папке, где лежит твое приложение.
- Сохрани промежуточное состояние. С помощью Git зафиксируй, как выглядел проект до изменения.
- Сформулируй задание. Опиши одно четко очерченное изменение.
- Прочитай предложение агента. Прежде чем согласиться, посмотри, какие файлы он собирается затронуть и зачем.
- Запусти приложение и попробуй. Сам пройдись по новой функции.
- Прогони тесты. Если в проекте есть тесты, они покажут, не сломалось ли что-то еще.
- Сохрани и запиши. Зафиксируй новое состояние и коротко запиши, что сделал ИИ и что ты поправил сам.
Последний шаг кажется педантичным, но он окупается. Иначе через неделю ты уже не вспомнишь, зачем в коде стоит та или иная строка.
Как дать агенту четкое задание?
Самая частая ошибка новичков: слишком большое и расплывчатое задание. «Сделай мне систему управления контактами» оставляет агенту бесчисленное количество решений. Он принимает их сам, и потом ты не понимаешь, что получилось.
Лучше разбить задачу на проверяемые шаги и для каждого указать, по какому признаку ты поймешь, что он выполнен. Такие проверочные формулировки называются приемочными сценариями. Обычно они строятся по схеме: если я делаю это, то происходит вот это.
Пример из приложения для контактов
Допустим, твое приложение уже показывает список контактов. Теперь у каждого контакта должен появиться статус. Четкое задание может выглядеть так:
Добавь каждому контакту поле «Статус» со значениями «новый», «связались» и «завершен». Новые контакты начинают со статуса «новый». В карточке контакта я могу сменить статус. Ничего не меняй в оформлении списка.
Приемочные сценарии: если я создаю новый контакт, его статус «новый». Если я ставлю в карточке статус «связались» и перезагружаю страницу, он остается «связались».
Теперь агент знает, что делать, где это делать и чего не трогать. А ты знаешь, как проверить результат.
Что должно быть в хорошем задании
- Цель: что человек, который пользуется приложением, сможет сделать после изменения?
- Место: какой экран или какая часть приложения затронута?
- Границы: что менять нельзя?
- Приемочные сценарии: два или три предложения, которые ты можешь проверить сам.
- Ошибочные сценарии: что должно происходить, если ввод пустой или некорректный?
Как проверить, что построил агент?
Агент часто формулирует ответы так, будто все уже готово. Это еще не значит, что так и есть. Поэтому проверять результат нужно всегда, и это не недоверие, а часть работы. Этот чек-лист поможет после каждого цикла:
- Приложение еще запускается? Звучит банально, но это самый частый сюрприз.
- Приемочные сценарии выполняются? Пройди их сам, а не полагайся на резюме агента.
- Что происходит в ошибочных сценариях? Создай контакт без имени, введи неполный адрес электронной почты, поставь follow-up на бессмысленную дату.
- Как приложение реагирует на внешний интерфейс? Если данные приходят извне, проверь пустой ответ, сообщение об ошибке и долгое ожидание. С имитированным интерфейсом это можно сделать без риска.
- Есть ли в коде секреты? Ключам доступа и паролям не место в файлах, которыми ты делишься.
- Изменены ли посторонние файлы? Git показывает, какие файлы изменились с последнего сохраненного состояния. Соответствует ли это заданию?
- Можешь ли ты объяснить изменение? Если ты можешь в двух предложениях сказать, что нового и почему, контроль остался за тобой.
Если что-то пошло не так, вернись к последнему сохраненному состоянию и сформулируй задание более узко. Часто это быстрее, чем просить агента исправлять результат в несколько заходов.
Какие трудности бывают в первый раз?
Некоторые проблемы встречаются почти у всех новичков. Если знать о них заранее, нервов уйдет меньше.
Сообщения об ошибках на английском. Можно передать сообщение агенту и попросить объяснить его. Но все равно прочитай его сам: причина часто указана в первой или последней строке.
Несколько изменений сразу. Если в одном задании просить фильтр, смену статуса и экспорт, ошибку уже почти невозможно связать с конкретной причиной. Самое простое правило: одно изменение за цикл.
Меняются тесты, а не код. Бывает, что агент переписывает непроходящий тест так, чтобы тот проходил. Поэтому будь внимателен, если меняются файлы тестов, хотя ты хотел исправить только функцию.
Реальные данные в учебном проекте. Для первых попыток хватит примерных данных. Приложение, которое хранит данные в браузере, не предназначено для реальных данных клиентов.
Как курс Vibe Coding Foundation помогает на старте?
Курс Vibe Coding Foundation от BUILT IN CLASS отрабатывает именно этот рабочий процесс на одном сквозном проекте: приложении для контактов и follow-up для небольшой фирмы с примерными данными. Ты работаешь с Claude Code или Codex, и для этого нужен собственный доступ, стоимость которого оплачивается отдельно от цены курса.
Миссии выстроены последовательно. После настройки ты превращаешь идею в четкое задание, строишь список контактов и карточку контакта, добавляешь проверку ввода, смену статуса и фильтры и подключаешь приложение к имитированному интерфейсу, который выдает пустые ответы, ошибки и задержки. Затем ты локализуешь заранее подготовленные ошибки, проверяешь базовые сценарии доступа и документируешь проект так, чтобы другие могли его запустить. В миссии на перенос навыков ты экспортируешь просроченные follow-up в CSV-файл. Все миссии с плановым временем есть в обзоре курса.
У каждой миссии есть критерии в виде тестов, которые ты проверяешь на своем компьютере одной командой, и подсказки трех уровней. ИИ-протокол, который в этой статье появляется как последний шаг каждого цикла, в курсе ты ведешь постоянно. Плановое время составляет около 30 часов, например шесть недель примерно по пять часов в неделю. Как проходит письменный экзамен по проекту, описано на странице об экзамене. Сдавшие получают частный сертификат академии, а не государственный диплом. Цена и то, что в нее входит, указаны в разделе Цена.