Дмитрий Анашкин

Как писать промпты для Claude Code: канон сильного запроса

Опубликовано 3 авг. 2026 г.Обновлено 15 нояб. 2026 г.11 мин чтенияНачальный
Как писать промпты для Claude Code: канон сильного запроса
Рецепт
Как писать промпты для Claude Code
Дмитрий Анашкин · 11 мин
Чему вы научитесь
  • Почему агент выдаёт кашу - и как это чинится не сменой модели, а сменой запроса
  • Канон промпта из 7 деталей: роль, задача, контекст, цифры, ограничения, формат, критерий «сделано»
  • Готовый шаблон промпта, который копируешь и подставляешь свою задачу
  • Три спасательных промпта, когда агент застрял, зациклился или уверенно ошибается
  • Чем контекст-инжиниринг важнее промпт-инжиниринга в 2026 году
Начальный
1просмотров

Коротко

Почему агент выдаёт кашу - дело не в модели

Дело не в модели.

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

У меня для этого есть короткая формула, которую я повторяю на каждом обучении: качество твоего вопроса равно качеству ответа. Многие говорят «сделай мне пост» и получают ерунду. А описать задачу чётко - людям лень. В этой лени и прячется весь разрыв между теми, у кого ИИ работает, и теми, у кого «не взлетело».

Разберём простым языком. Промпт - это не заклинание, которое надо угадать. Промпт - это брифинг новому сотруднику. Представь, что к тебе вышел толковый стажёр: способный, быстрый, но про твой бизнес не знает ничего. Если ты скажешь ему «сделай красиво» - он сделает по-своему. Если положишь бриф с ролью, задачей, цифрами и примером - принесёт то, что нужно, с первого раза. С ИИ-агентом ровно так же.

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

И вот тут самое интересное: этому можно научиться за один вечер. Есть канон - набор деталей, из которых собирается сильный запрос. Дальше по нему.

Канон промпта: 7 деталей сильного запроса

Я объясняю структуру запроса через образ сборочной линии: есть роль - ты эксперт по маркетингу; задача - сделать стратегию; контекст - для фитнеса; метрики - бюджет до 10 тысяч долларов; дальше ограничения и формат ответа. Это как сборочная линия - каждый элемент играет свою роль. Убери одну деталь - изделие поедет кривым.

Вот полный канон. Шесть деталей работают в любой нейросети, седьмая критична именно для агента, который не отвечает, а действует.

ДетальЧто кладёшьПример
РольКем должен быть агент, в какой области он эксперт«Ты senior-разработчик на Next.js»
ЗадачаГлагол действия + конечная цель«Собери форму подписки и подключи её к базе»
КонтекстИз какой области задача, детали бизнеса, что уже есть«Проект на Prisma + Postgres, форма живёт на лендинге»
Метрики / цифрыИзмеримые параметры: бюджет, сроки, размеры, лимиты«Не больше 3 полей, грузиться меньше секунды»
ОграниченияЧто делать НЕ нужно или прямо запрещено«Не тащи новые библиотеки, только то, что уже в проекте»
Формат ответаКак выдать результат: текст, буллеты, таблица, код, план«Сначала план по шагам, код не пиши, пока не утвержу»
Критерий «сделано»По какому признаку понятно, что задача закрыта«Готово, когда форма отправляет тест-заявку в базу»

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

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

Не обязательно каждый раз выкладывать все семь. Для мелкой задачи хватит роли, задачи и критерия. Но если результат раз за разом мимо - почти всегда выпала одна деталь. Пройди по списку сверху вниз и найди, какую ты не дал.

Официальная документация Claude Code говорит ровно то же, только другими словами.

Чем точнее твои инструкции, тем меньше правок тебе потребуется.

- Anthropic, Best practices for Claude Code

Хорошая новость: канон не надо держать в голове. Он ложится в один шаблон.

Готовый шаблон промпта, который можно скопировать

Вот рабочий каркас. Он выглядит длинным, но заполняется за минуту - особенно если диктовать голосом, а не печатать.

Роль: ты [кто, эксперт в какой области].
Задача: [глагол действия + что именно сделать + зачем].
Контекст: [что за проект, что уже есть, какие детали важны].
Цифры: [бюджет, сроки, размеры, лимиты - всё измеримое].
Ограничения: [что делать НЕ нужно, чего избегать].
Формат ответа: [план / таблица / код / текст; сначала план, код после утверждения].
Критерий «сделано»: [по какому признаку понятно, что задача закрыта].
Если чего-то не хватает - не выдумывай, задай мне уточняющие вопросы.

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

Сравни на живом примере, что даёт каждый подход.

Запрос в одну строкуЗапрос по канону
«Сделай лендинг»«Роль: веб-дизайнер. Задача: собрать одностраничный лендинг под запись на консультацию. Контекст: эксперт по недвижимости, аудитория - инвесторы 35+. Цифры: один экран, одна кнопка, грузится меньше 2 секунд. Ограничения: без стоковых картинок и лишних библиотек. Формат: сначала структура блоков на утверждение, потом код. Готово, когда кнопка ведёт на форму заявки»
«Почини баг»«У меня ошибка при отправке формы. Контекст: [вставляю текст ошибки]. Что делал: нажал "отправить". Что ждал: заявка ушла. Что получил: белый экран. Найди корневую причину, не глуши симптом. Готово, когда форма отправляет тест-заявку»

Левая колонка запускает лотерею. Правая - управляемый результат. При этом ты не написал ни строчки кода: ты выступил заказчиком, который умеет ставить задачу. Это ровно тот навык, о котором я говорю в гайде про 12 принципов вайбкодинга - ты архитектор, а не исполнитель.

Четыре уровня запроса: от вопроса до управленческого брифа

Канон не обязательно раскрывать целиком с первого слова. Есть лестница из четырёх ступеней - я показываю её на каждом воркшопе, и после неё у людей щёлкает.

  1. Уровень 1. Вопрос

    «Как разработать маркетинговую стратегию?» - получишь общие советы ни о чём.
  2. Уровень 2. Задача

    «Разработай стратегию для фитнес-приложения» - появляется отрасль и каналы.
  3. Уровень 3. Задача + контекст

    «...для мужчин 25-35 лет, бюджет 10 тысяч долларов» - появляются сегменты, KPI, логика.
  4. Уровень 4. Управленческий бриф

    «Ты эксперт по маркетингу. Разработай... включи каналы и план действий. Результат дай таблицей» - детальный план с ролью, ограничениями и форматом.

Разница между первым и четвёртым уровнем - это разница между «что-то общее» и «готово к работе». Главный вывод, который я даю аудитории: ответ зависит не только от модели, но и от качества постановки задачи. Для рабочих задач стремись к уровню 3-4.

Заметь: четвёртый уровень - это и есть наш канон, просто собранный в живую фразу. Роль, задача, контекст, цифры, формат - всё на месте.

Маленький приём, который экономит нервы

Когда даёшь агенту готовый текст для обработки - заключи его в кавычки, а инструкцию вынеси отдельно. Я ставлю двоеточие и кавычки. Так модель понимает: то, что в кавычках, - это объект, с которым надо что-то сделать, а ниже - что именно. Без этого она путает, где данные, а где команда.

Промпт-инжиниринг умер? От формулировки к контексту

Пару лет назад все учились «правильно формулировать промпт»: волшебные слова, хитрые обороты. Сегодня это уже почти неважно.

Если коротко, суть такая. Раньше был важен навык промпт-инжиниринга - сейчас важнее контекст-инжиниринг. Модели любой нормальный промпт уже понимают, а вот контекст важно правильно предоставить. Мы переходим от «как красиво спросить» к «что положить агенту перед глазами».

Секрет не в промпте, а в том, что ты положишь в папке. Это звучит буднично, но это и есть методология, которую почти никто из работающих с ИИ-агентами не использует - и упирается в потолок «модель тупая». Модель не тупая. Ей просто не дали контекст.

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

Спасательные промпты: что писать, когда агент застрял

Бывает так: запрос сильный, а агент всё равно буксует. Зациклился, чинит одно и ломает другое, или выдаёт ответ с уверенностью, которой ты не доверяешь. Это нормально. На такие моменты у меня есть три спасательных промпта - держи их под рукой.

Первый - «прожарь свой ответ». Самый простой лайфхак: после ответа напиши «прожарь свой ответ» или «проверь себя, ты уверен, что это соответствует действительности?». Практически всегда агент сам начинает себя критиковать. Если запрос был сильным - он поставит себе четыре с половиной из пяти и оставит как есть. Если слабым - сильно покритикует и переделает. Ты бесплатно получаешь второе мнение от того же агента.

Второй - «я застрял». Универсальная выручалка на любой технический затык. Копируешь шаблон:

У меня ошибка: [вставь текст ошибки или опиши словами].
Объясни простыми словами, что это и почему так происходит.
Можешь исправить сам - исправляй.
Нужны мои действия - дай по одному шагу за раз.

Этот промпт снимает панику непрограммиста. Ты не обязан понимать ошибку - твоя задача передать её агенту структурно: что делал, что ждал, что получил. Дальше он либо чинит сам, либо ведёт тебя за руку по одному шагу.

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

Ты чинишь эту ошибку по кругу, и не помогает. Стоп.
Не исправляй прямо сейчас. Сначала назови три РАЗНЫЕ гипотезы,
почему это происходит, и как проверить каждую по отдельности.
Начни с самой вероятной. Потом проверим по одной.

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

Тот же приём - на крупных решениях

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

Заметь общую логику всех трёх: ты не давишь на агента и не злишься. Ты меняешь постановку задачи. Как говорится, если на пути забор - надо его обойти, а не биться в него лбом.

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

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

Главный вывод

Сведём в одну мысль. Промпт для агента - это не магическое заклинание, которое надо угадать. Это брифинг: роль, задача, контекст, цифры, ограничения, формат и критерий «сделано». Собери его по канону - и получишь результат с первого-второго захода, а не с пятнадцатого. Застрял - не бейся в стену, а смени постановку: «прожарь свой ответ», «я застрял, объясни по шагам», «назови три гипотезы».

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

Как думаешь: канон промпта - это временный навык, который через год возьмут на себя сами модели, или базовая грамотность, которая останется с нами надолго, как умение гуглить?

Если хочешь не просто прочитать про это, а собрать систему работы с ИИ под свою команду - я провожу интенсив по нейросетям для бизнеса: без магии, по делу, с результатом, который остаётся у вас.

Источники

Отправь другу или себе в избранное в Telegram, чтобы не потерять.

Поделиться в Telegram
Было полезно?
Автор
Дмитрий Анашкин
Практик-интегратор ИИ в бизнес

Основатель NeuroDA и SMAIPL. Корпоративные воркшопы по ИИ, внедрение AI в бизнес-процессы.

Похожие гайды

Альтернативы Claude Code в 2026: OpenCode, Qwen Code и GigaCode - в чём уступают и когда хватает

С 12 ноября 2026 года Anthropic отдельно прописал правило для компаний из неподдерживаемых регионов и их сотрудников. Сравниваю три альтернативы Claude Code: модель, куда уходят данные, лицензия, что проверить. Показываю, когда замены хватает и как проверить её за вечер на своей задаче.

12 мин

Мультиагентные системы: как несколько ИИ работают над одной задачей

Одна модель тянет простую задачу, но сложный проект требует команды. Разбираем, как мультиагентные системы делят работу между несколькими ИИ, какие архитектуры для этого есть и когда несколько агентов реально нужны, а когда это лишнее усложнение.

12 мин

Замена ИИ-модели: как проверить её на своих задачах до перехода

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

9 мин

Мониторинг задач по расписанию: как поймать сбой, если скрипт молчит

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

8 мин

Связанные понятия