Промпт для агента - это задание
В чате ты спрашиваешь, модель отвечает текстом, и дальше всё зависит от тебя: скопировать, проверить, вставить. У агента другое устройство. Claude Code или Codex получает промпт и сам идёт работать в твоей папке: ищет нужные файлы, читает их, правит, запускает команды и тесты. Документация Claude Code описывает это как цикл из трёх фаз - собрать контекст, сделать, проверить результат - и агент крутит его, пока не решит, что задача закрыта.
Отсюда главное отличие. В чате слабый промпт даёт слабый ответ, который ты просто не используешь. У агента он превращается в изменения в файлах: лишние правки, тронутые соседние модули, код, который выглядит готовым, но не работает. Поэтому промпт агенту пишут как короткое техническое задание подрядчику, которого ты видишь первый раз.
Чем промпт агенту отличается от промпта в чате
| Промпт в чате | Промпт агенту | |
|---|---|---|
| Что получаешь | текст ответа | изменения в файлах и отчёт |
| Где контекст | всё, что ты вставил в окно | весь проект - агент читает сам |
| Кто проверяет | ты | агент, если дал ему способ проверки |
| Цена ошибки | лишний абзац | лишние правки в коде |
| Что повторяется | промпт пишешь заново | повторяющееся уходит в CLAUDE.md и скиллы |
Отдельно про контекст. В чате модель знает только то, что ты вставил. Агенту не нужно вставлять файлы целиком: достаточно назвать путь, и он откроет файл сам. Справка Anthropic по лимитам так и советует: указывай файл по пути. Вставленный текст лежит в контексте до конца сессии и расходует лимит.
Из чего состоит рабочий промпт агенту
Документация Claude Code в разделе лучших практик сводит хороший промпт к конкретике: назвать файл, сценарий, ограничения и пример, на который равняться. На практике это пять частей.
- Результат. Что должно появиться или измениться. Глаголом: добавь, исправь, перенеси, найди.
- Место. Файл, папка, функция. Например, «форма входа в
src/auth/login.ts» - так агент сразу откроет нужный файл. - Границы. Что трогать нельзя. «Тесты не меняй», «папку
legacy/не трогай», «новых библиотек не ставь». - Образец. На что равняться внутри проекта. «Сделай так же, как устроен виджет на главной».
- Проверка. Как агент поймёт, что закончил. Тест, сборка, скриншот, команда.
Последний пункт - самый недооценённый. В документации Claude Code ему отведён отдельный раздел: без проверки агент останавливается, когда работа «выглядит готовой», и дальше проверяешь ты. С проверкой он сам запускает тесты, читает результат и исправляет, пока тесты не пройдут.
Пример: было и стало
Было:
почини форму входа, что-то не работаетАгент получит такое задание и начнёт читать весь проект подряд, чтобы понять, что именно «не работает». Это дорого по лимиту и почти всегда уводит в сторону.
Стало:
После истечения сессии форма входа не пускает пользователя: кнопка
«Войти» крутится бесконечно. Смотри src/auth/, особенно обновление токена.
Сначала напиши тест, который воспроизводит ошибку, потом исправь.
Тесты в папке e2e/ не трогай. Готово - когда npm test проходит.Во втором промпте есть симптом, место, порядок действий, граница и признак готовности. Такой пример почти дословно разобран в документации Claude Code: описать симптом, вероятное место и то, как выглядит «починено».
Промпт, который пишется один раз
Если ты в каждой сессии повторяешь одно и то же - «пиши на TypeScript», «перед коммитом прогоняй тесты», «не трогай конфиги», - это уже правила проекта. Их выносят в файлы, которые агент читает сам.
- CLAUDE.md - правила проекта для Claude Code. Читается в начале каждой сессии. Документация советует держать его короче двухсот строк: длинный файл агент начинает читать невнимательно. Как его устроить - в статье про CLAUDE.md.
- AGENTS.md - то же для Codex.
- Скиллы - инструкции под отдельные задачи: разбор пулл-реквеста, вёрстка страницы, проверка текста. Подгружаются, только когда нужны, и не занимают место постоянно. Подробнее - в статье про скиллы Claude Code.
Когда правила вынесены, промпт в сессии становится коротким: «добавь страницу оплаты по брифу в docs/brief.md». Всё остальное агент уже знает.
Частые ошибки
Желание вместо результата. «Сделай красиво», «улучши код» - непроверяемо. Агент сделает что-то, и спорить будет не с чем. Пиши, по какому признаку ты примешь работу.
Нет границ. Без запретов агент честно улучшит всё, до чего дотянется, включая то, что трогать было нельзя. Одна строка «меняй только этот файл» экономит час отката.
Расследование без рамок. «Разберись, почему тормозит» - и агент читает сотни файлов, забивая контекст. Сужай: какой экран, какое действие, где искать в первую очередь.
Поправки по кругу. Агент ошибся, ты поправил, он снова ошибся. Документация Claude Code советует после двух неудачных поправок очистить сессию через /clear и написать промпт заново: чистая сессия с хорошим промптом почти всегда лучше длинной с накопленными ошибками.
Всё в одной сессии. Начал с формы, спросил про базу, вернулся к форме. Контекст забит посторонним, и агент путается. Одна задача - одна сессия.
Ключи и пароли в тексте промпта. Промпт уходит в модель и остаётся в истории сессии. Секреты передают через переменные окружения и настройки.
Когда длинный промпт всё-таки нужен
Для большой задачи, которая затрагивает много файлов, работает другой приём: сначала план. Переключи агента в режим плана (Shift+Tab в Claude Code) или попроси прямо: «прежде чем менять, перечисли файлы, которые тронешь, и что сделаешь в каждом». Прочитай список, поправь словами и только потом дай команду выполнять. План стоит несколько сотен токенов, а неверная правка на четыреста строк стоит в разы дороже.
Что почитать дальше
- Claude Code: что это и как пользоваться - если агента ещё нет.
- CLAUDE.md: правила проекта - куда выносить то, что повторяется.
- Скиллы Claude Code - инструкции под отдельные задачи.
- Агент для кода - чем агент отличается от чата и почему ему нужен другой промпт.