Промптинг для Claude Code:как ставить задачи агенту

Самая частая жалоба новичков на Claude Code звучит так: «он сделал не то, что я просил». Почти всегда дело не в модели, а в постановке. Агент — это очень способный исполнитель, но он работает по тексту задачи и по тем файлам, которые ты ему показал. Что не сказано — то додумано по-своему. Хорошая новость: промтингу для агента можно научиться за один вечер, и это окупается каждой следующей сессией.

Часть 1 · Принцип

Почему промт решает больше, чем модель

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

Сравни две формулировки одной и той же задачи. Левая оставляет десяток открытых вопросов, и агент решит их сам — возможно, не так, как ты хотел. Правая закрывает их сразу.

Агент не читает мысли. Он читает задачу. Чем меньше пробелов — тем меньше доделок.

Часть 2 · Структура

Анатомия сильной задачи

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

1. Цель. Что должно получиться в итоге. Не «процесс», а результат: «пользователь видит ошибку, если email пустой».
2. Контекст. Где это живёт и по какому образцу делать. Назови файлы через @, сошлись на похожий уже работающий кусок: «как в соседнем компоненте».
3. Границы. Что трогать нельзя. «Не меняй API», «вёрстку оставь как есть», «миграции не применяй». Границы экономят больше всего нервов.
4. Критерий готовности. Как проверить, что сделано правильно. «Старый логин по паролю должен продолжать работать», «typecheck зелёный».

Вот как это выглядит одним промтом. Не длинно — но каждая опора на месте:

# Цель + контекст + границы + проверка в одном абзаце:

В @app/login/page.tsx кнопка «Войти через Google» ничего не делает —
сессия не создаётся. Найди причину и почини по образцу обычного
логина в этом же файле. Не трогай вёрстку и стили. После правки
проверь, что вход по паролю продолжает работать.

Часть 3 · Контекст

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

В Claude Code ты подтягиваешь файл в задачу символом @ перед путём: @app/feed/page.tsx. Агент откроет его и увидит реальную структуру — какие там импорты, как названы функции, какой стиль. Это гораздо надёжнее, чем по памяти описывать, «там примерно такой компонент».

# Плохо — агент гадает, как устроен код:
Сделай карточку товара похожей на остальные.

# Хорошо — агент видит образец и факты:
Сделай карточку товара @components/product-card.tsx по образцу
@components/post-card.tsx — те же отступы, радиусы и типографика.

Постоянный контекст — правила всего проекта, стиль кода, табу — не стоит повторять в каждой задаче. Его место в файле CLAUDE.md: Claude читает его сам в начале сессии. Как собрать такой файл, разобрано в гайде про настройку памяти проекта. А когда контекста накапливается слишком много и ответы плывут — это уже тема контекст-инжиниринга.

Часть 4 · Контроль

Режим плана: посмотреть до правок

Включается режим плана клавишами Shift+Tab прямо в сессии (жми, пока в строке статуса не появится «plan»), либо запуском claude с флагом режима плана. Дальше ты ставишь задачу как обычно, но вместо правок получаешь план: «трону вот эти три файла, сделаю то-то». Читаешь, и если видишь, что агент собрался не туда, — поправляешь на словах. Это дешевле, чем откатывать готовый код.

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

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

Часть 5 · Масштаб

Дроби большое на шаги

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

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

Бонус разбивки — контекст остаётся чистым. Когда задача маленькая, агент не тонет в деталях и не теряет нить. Если же чат всё-таки разросся, помогут /clear и /compact — про них в гайде как не сжечь лимиты.

Вопросы

Частые вопросы

Читать дальше

Соседние гайды