Как ставить задачу Claude Code

Главный навык в работе с агентом — не код и не знание команд. Это умение поставить задачу так, чтобы тебя нельзя было понять неправильно. Агент силён ровно настолько, насколько ясно ты объяснил, чего хочешь. Большинство провалов новичка — это не «тупой агент», а размытая задача.

Почему постановка задачи — это всё

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

Подумай об агенте как о толковом, быстром, но новом сотруднике. Он умный, он старательный, он знает технологии лучше тебя. Но он впервые видит твой проект и читает ровно то, что ты написал — ни больше, ни меньше. Если ты скажешь живому стажёру «сделай нормально», ты получишь его представление о «нормально», а не своё. С агентом точно так же. Это не программирование. Это управление исполнителем. И навык тут — не технический, а человеческий: ясно сформулировать, чего ты хочешь.

Из чего состоит хорошая задача

Хорошая задача почти всегда содержит четыре вещи. Не обязательно все четыре в каждом случае, но чем сложнее задача — тем нужнее каждая.

• Конкретный результат. Что именно должно появиться или измениться. Не «улучши», а «добавь кнопку выхода в шапке».
• Нужный контекст. Где это живёт. Какие файлы и папки трогать, как у тебя устроен проект, на что опираться. Агент не обязан угадывать структуру — покажи её.
• Критерий готовности. Как ты поймёшь, что готово. «Форма отправляет данные и показывает сообщение об успехе» — это критерий. «Сделай форму» — нет.
• Границы. Что НЕ делать. Это новички пропускают чаще всего, а зря — именно тут агент уходит в самодеятельность.

Правило простое: если ты сам не можешь одним предложением сказать, как проверишь результат, — задача ещё не готова к отправке. Сначала допиши критерий, потом жми Enter.

Плохо против хорошо: живые примеры

Теория скучна, поэтому смотри на парах. Слева — как пишет новичок, справа — как надо.

Плохо: «Сделай мне лендинг». Агент не знает ни о чём: ни тема, ни цвета, ни что на странице. Получишь усреднённую болванку, и будешь переделывать всё.

Хорошо:

Сделай одностраничный лендинг для курса по фотографии.
Секции по порядку: заголовок с оффером, 3 преимущества,
отзывы (заглушки), цена, кнопка "Записаться".
Стиль — светлый, минималистичный, один акцентный цвет.
Всё в одном файле index.html, без внешних библиотек.

Плохо: «Почини баг, форма не работает». Какая форма? Какой баг? Что значит «не работает»?

Хорошо:

В файле src/contact.js форма обратной связи не отправляется:
при клике на "Отправить" ничего не происходит, в консоли
ошибка "handleSubmit is not defined". Найди причину и почини.
Не меняй вёрстку и стили — только логику отправки.

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

Декомпозиция: режь слона на кусочки

Вторая частая ошибка — вывалить всё одной простынёй. «Сделай мне интернет-магазин с каталогом, корзиной, оплатой и админкой». Агент возьмётся, но результат будет рыхлым: где-то недоделал, где-то понял по-своему, и ты потеряешься в том, что проверять.

Большую задачу разбивай на маленькие проверяемые шаги. Проверяемый — ключевое слово. После каждого шага ты должен суметь посмотреть и сказать «да, это работает» или «нет, вот тут не так». Тот же магазин ставится так:

1. Сначала каталог товаров — карточки с названием, ценой, картинкой.
2. Проверил, что каталог отображается. Дальше — кнопка «В корзину» и сама корзина.
3. Проверил корзину. Дальше — страница оформления заказа.
4. И только потом — оплата, админка, остальное.

Так у тебя на каждом шаге есть твёрдая точка, к которой можно вернуться, если следующий шаг что-то сломает. Маленькие ошибки дешёвые, большие — дорогие.

Проси план до действия

На сложной задаче не давай агенту сразу кидаться в код. Сначала попроси план. Это секунда твоего времени, которая экономит часы переделок.

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

План — это твой шанс поймать недопонимание ДО того, как агент перелопатил пол-проекта. Если в плане он собрался трогать файл, который трогать нельзя, или понял задачу не так — ты ловишь это на словах, а не на сломанном коде. Дёшево.

Контекст вместо «догадайся»

Агент не читает твои мысли и не помнит вчерашний разговор по умолчанию. Каждый раз, когда ты ловишь себя на мысли «ну это же очевидно» — это сигнал, что нужно дать контекст явно. Очевидно тебе, потому что ты живёшь в проекте. Ему — нет.

Не заставляй угадывать. Назови файлы. Покажи пример того, как у тебя уже сделано похожее («сделай новую страницу по образцу src/pages/about.js»). Скажи, какие инструменты использовать, а какие нет. Чем больше нужного контекста ты дал, тем меньше агент фантазирует.

Совет: если объясняешь то же самое второй раз — это не агент бестолковый, это контекст недосказан. Лучшая инвестиция — один раз чётко описать, чем десять раз поправлять последствия.

Цикл работы: правь словами, а не руками

Не жди идеального результата с первого раза — его почти не бывает, и это нормально. Работа с агентом — это цикл:

1. Поставил задачу.
2. Посмотрел результат своими глазами.
3. Поправил словами — сказал, что не так, и что хочешь вместо этого.

Главное здесь — поправил словами, а не руками. Новичка тянет залезть и переписать самому, потому что «быстрее». Но так ты теряешь главное преимущество: агент учится на твоих правках в рамках задачи. Скажи «отступы между карточками слишком большие, сделай вдвое меньше» — и он поправит, а заодно поймёт твой вкус. Это и есть управление, а не ручной труд.

Проверяй глазами, не доверяй слепо

Агент звучит уверенно всегда — и когда прав, и когда ошибся. «Готово, всё работает» из его уст — это не доказательство, это намерение. Проверяй сам: запусти, открой, нажми, посмотри. Особенно на важном. Слепое доверие к «готово» — самый быстрый способ собрать кучу скрытых багов и потом долго их выкапывать. Твои глаза на результате — обязательная часть цикла, а не опция.

Шаблоны, которые можно забрать себе

Чтобы не сочинять каждый раз с нуля, держи под рукой каркас:

Задача: [что должно получиться, одним предложением]
Контекст: [какие файлы/папки, как устроено, на что опираться]
Готово, когда: [как я проверю результат]
Не трогай: [что должно остаться как есть]

А для сложного добавляй сверху: «Сначала покажи план, я подтвержу». Этих двух заготовок хватает на 90% задач новичка.

Мостик: один раз записал — больше не повторяешь

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

Именно для этого есть файл CLAUDE.md в корне проекта. Это память агента, которую он читает в начале каждой сессии. Запиши туда постоянный контекст один раз — структуру проекта, правила, твои предпочтения — и больше не повторяй. Тогда в самих задачах останется только то, что меняется от раза к разу: конкретный результат, который ты хочешь сегодня. Про то, как собрать хороший CLAUDE.md, — отдельный разговор, но начни прямо сейчас: каждый раз, когда ловишь себя на «я это уже объяснял», — это кандидат в твой CLAUDE.md.