Лучшие практики создания промптов

Это руководство содержит специальные техники инженерии промптов для моделей Claude 4.x с конкретными рекомендациями для Sonnet 4.5 и Haiku 4.5. Эти модели обучены более точному следованию инструкциям, чем предыдущие поколения моделей Claude.

Общие принципы

Будьте явными в своих инструкциях

Модели Claude 4.x хорошо реагируют на четкие, явные инструкции. Конкретизация желаемого результата может помочь улучшить результаты. Клиенты, которые хотят получить поведение "сверх ожиданий" от предыдущих моделей Claude, могут потребоваться более явные запросы этого поведения с новыми моделями.

Добавьте контекст для улучшения производительности

Предоставление контекста или мотивации за вашими инструкциями, такие как объяснение Claude, почему такое поведение важно, может помочь моделям Claude 4.x лучше понять ваши цели и предоставить более целевые ответы.

Claude достаточно умен, чтобы обобщить из объяснения.

Будьте внимательны с примерами и деталями

Модели Claude 4.x уделяют пристальное внимание деталям и примерам как части своих возможностей точного следования инструкциям. Убедитесь, что ваши примеры соответствуют поведению, которое вы хотите поощрять, и минимизируют поведение, которое вы хотите избежать.

Долгосрочное рассуждение и отслеживание состояния

Модели Claude 4.5 превосходны в задачах долгосрочного рассуждения с исключительными возможностями отслеживания состояния. Они сохраняют ориентацию на протяжении расширенных сеансов, сосредоточиваясь на постепенном прогрессе — делая устойчивые успехи в нескольких вещах одновременно, а не пытаясь сделать все сразу. Эта возможность особенно проявляется на нескольких окнах контекста или итерациях задач, где Claude может работать над сложной задачей, сохранять состояние и продолжать с новым окном контекста.

Осведомленность о контексте и многооконные рабочие процессы

Модели Claude 4.5 имеют осведомленность о контексте, позволяя модели отслеживать оставшееся окно контекста (т.е. "бюджет токенов") на протяжении всего разговора. Это позволяет Claude выполнять задачи и управлять контекстом более эффективно, понимая, сколько места у него есть для работы.

Управление ограничениями контекста:

Если вы используете Claude в агентском фреймворке, который сжимает контекст или позволяет сохранять контекст во внешние файлы (как в Claude Code), мы предлагаем добавить эту информацию в ваш промпт, чтобы Claude мог действовать соответственно. В противном случае Claude может иногда естественно попытаться завершить работу по мере приближения к ограничению контекста. Ниже приведен пример промпта:

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

Инструмент памяти естественно сочетается с осведомленностью о контексте для плавных переходов контекста.

Многооконные рабочие процессы контекста

Для задач, охватывающих несколько окон контекста:

1. Используйте другой промпт для самого первого окна контекста: Используйте первое окно контекста для установки фреймворка (написание тестов, создание скриптов установки), затем используйте будущие окна контекста для итерации по списку дел.

2. Попросите модель написать тесты в структурированном формате: Попросите Claude создать тесты перед началом работы и отслеживать их в структурированном формате (например, tests.json). Это приводит к лучшей долгосрочной способности к итерации. Напомните Claude о важности тестов: "Неприемлемо удалять или редактировать тесты, так как это может привести к отсутствию или ошибочной функциональности."

3. Установите инструменты для улучшения качества жизни: Поощряйте Claude создавать скрипты установки (например, init.sh) для корректного запуска серверов, запуска наборов тестов и линтеров. Это предотвращает повторную работу при продолжении с новым окном контекста.

4. Начало с нуля против сжатия: Когда окно контекста очищается, рассмотрите возможность начать с совершенно новым окном контекста вместо использования сжатия. Модели Claude 4.5 чрезвычайно эффективны в обнаружении состояния из локальной файловой системы. В некоторых случаях вы можете захотеть использовать это вместо сжатия. Будьте предписывающими о том, как это должно начинаться:

   • "Вызовите pwd; вы можете только читать и писать файлы в этом каталоге."
   • "Просмотрите progress.txt, tests.json и логи git."
   • "Вручную пройдите через фундаментальный интеграционный тест перед переходом к реализации новых функций."

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

6. Поощряйте полное использование контекста: Попросите Claude эффективно завершить компоненты перед переходом:

Это очень длинная задача, поэтому может быть полезно четко спланировать вашу работу. Рекомендуется потратить весь выходной контекст на задачу - просто убедитесь, что вы не исчерпаете контекст со значительной незафиксированной работой. Продолжайте работать систематически, пока не завершите эту задачу.

Лучшие практики управления состоянием

• Используйте структурированные форматы для данных состояния: При отслеживании структурированной информации (например, результатов тестов или статуса задачи) используйте JSON или другие структурированные форматы, чтобы помочь Claude понять требования схемы
• Используйте неструктурированный текст для заметок о прогрессе: Свободные заметки о прогрессе хорошо работают для отслеживания общего прогресса и контекста
• Используйте git для отслеживания состояния: Git предоставляет журнал того, что было сделано, и контрольные точки, которые можно восстановить. Модели Claude 4.5 особенно хорошо работают при использовании git для отслеживания состояния на нескольких сеансах.
• Подчеркивайте постепенный прогресс: Явно попросите Claude отслеживать свой прогресс и сосредоточиться на постепенной работе

Стиль общения

Модели Claude 4.5 имеют более лаконичный и естественный стиль общения по сравнению с предыдущими моделями:

• Более прямой и обоснованный: Предоставляет отчеты о фактическом прогрессе, а не самовосхваляющиеся обновления
• Более разговорный: Немного более беглый и разговорный, менее машинообразный
• Менее многословный: Может пропустить подробные резюме для эффективности, если не запрошено иное

Этот стиль общения точно отражает то, что было достигнуто, без ненужного уточнения.

Рекомендации для конкретных ситуаций

Сбалансируйте многословность

Модели Claude 4.5 склоняются к эффективности и могут пропустить словесные резюме после вызовов инструментов, переходя непосредственно к следующему действию. Хотя это создает упорядоченный рабочий процесс, вы можете предпочесть большую видимость его процесса рассуждения.

Если вы хотите, чтобы Claude предоставлял обновления во время работы:

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

Паттерны использования инструментов

Модели Claude 4.5 обучены точному следованию инструкциям и выигрывают от явного направления на использование конкретных инструментов. Если вы скажете "можете ли вы предложить некоторые изменения", это иногда предоставит предложения, а не реализует их — даже если внесение изменений может быть тем, что вы имели в виду.

Чтобы Claude предпринял действие, будьте более явными:

Чтобы сделать Claude более проактивным в принятии действий по умолчанию, вы можете добавить это в ваш системный промпт:

<default_to_action>
По умолчанию реализуйте изменения, а не только предлагайте их. Если намерение пользователя неясно, выведите наиболее полезное вероятное действие и продолжайте, используя инструменты для обнаружения любых недостающих деталей вместо угадывания. Попытайтесь вывести намерение пользователя о том, предназначен ли вызов инструмента (например, редактирование или чтение файла) или нет, и действуйте соответственно.
</default_to_action>

С другой стороны, если вы хотите, чтобы модель была более осторожной по умолчанию, менее склонна к прямому переходу к реализациям и предпринимала действия только при запросе, вы можете направить это поведение с помощью промпта, подобного приведенному ниже:

<do_not_act_before_instructions>
Не переходите к реализации или изменению файлов, если не указано явно внести изменения. Когда намерение пользователя неоднозначно, по умолчанию предоставляйте информацию, проводите исследования и предоставляйте рекомендации, а не предпринимайте действия. Продолжайте с правками, модификациями или реализациями только когда пользователь явно их запрашивает.
</do_not_act_before_instructions>

Контролируйте формат ответов

Есть несколько способов, которые мы обнаружили, что особенно эффективны при управлении форматированием выходных данных в моделях Claude 4.x:

1. Скажите Claude, что делать, вместо того, что не делать

   • Вместо: "Не используйте markdown в вашем ответе"
   • Попробуйте: "Ваш ответ должен состоять из плавно текущих абзацев прозы."

2. Используйте индикаторы формата XML

   • Попробуйте: "Напишите разделы прозы вашего ответа в тегах <smoothly_flowing_prose_paragraphs>."

3. Соответствуйте стилю вашего промпта желаемому выходу

   Стиль форматирования, используемый в вашем промпте, может повлиять на стиль ответа Claude. Если вы все еще испытываете проблемы с управляемостью форматирования выходных данных, мы рекомендуем, насколько это возможно, соответствовать стилю вашего промпта желаемому стилю выходных данных. Например, удаление markdown из вашего промпта может уменьшить объем markdown в выходных данных.

4. Используйте подробные промпты для конкретных предпочтений форматирования

   Для большего контроля над использованием markdown и форматирования предоставьте явное руководство:

<avoid_excessive_markdown_and_bullet_points>
При написании отчетов, документов, технических объяснений, анализов или любого длинного контента пишите четкой, текущей прозой, используя полные абзацы и предложения. Используйте стандартные разрывы абзацев для организации и зарезервируйте markdown в основном для `встроенного кода`, блоков кода (```...```), и простых заголовков (###, и ###). Избегайте использования **жирного** и *курсива*.

НЕ используйте упорядоченные списки (1. ...) или неупорядоченные списки (*), если только: a) вы представляете действительно дискретные элементы, где формат списка является лучшим вариантом, или b) пользователь явно запрашивает список или рейтинг

Вместо перечисления элементов с пулями или цифрами, включите их естественно в предложения. Это руководство особенно применимо к техническому письму. Использование прозы вместо чрезмерного форматирования улучшит удовлетворение пользователя. НИКОГДА не выводите серию чрезмерно коротких пулевых точек.

Ваша цель — читаемый, текущий текст, который естественно направляет читателя через идеи, а не фрагментирует информацию на изолированные точки.
</avoid_excessive_markdown_and_bullet_points>

Исследование и сбор информации

Модели Claude 4.5 демонстрируют исключительные возможности агентского поиска и могут эффективно находить и синтезировать информацию из нескольких источников. Для оптимальных результатов исследования:

1. Предоставьте четкие критерии успеха: Определите, что представляет собой успешный ответ на ваш исследовательский вопрос

2. Поощряйте проверку источников: Попросите Claude проверить информацию из нескольких источников

3. Для сложных исследовательских задач используйте структурированный подход:

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

Этот структурированный подход позволяет Claude находить и синтезировать практически любую информацию и итеративно критиковать свои выводы, независимо от размера корпуса.

Оркестровка подагентов

Модели Claude 4.5 демонстрируют значительно улучшенные встроенные возможности оркестровки подагентов. Эти модели могут распознавать, когда задачи выигрывают от делегирования работы специализированным подагентам, и делают это проактивно без требования явной инструкции.

Чтобы воспользоваться этим поведением:

1. Убедитесь в хорошо определенных инструментах подагентов: Имейте доступные инструменты подагентов и описанные в определениях инструментов
2. Позвольте Claude оркестровать естественно: Claude будет делегировать соответственно без явной инструкции
3. Отрегулируйте консервативность при необходимости:

Делегируйте подагентам только когда задача явно выигрывает от отдельного агента с новым окном контекста.

Самопознание модели

Если вы хотите, чтобы Claude правильно идентифицировал себя в вашем приложении или использовал конкретные строки API:

Помощник — это Claude, созданный Anthropic. Текущая модель — Claude Sonnet 4.5.

Для приложений на основе LLM, которым нужно указать строки модели:

Когда требуется LLM, пожалуйста, по умолчанию используйте Claude Sonnet 4.5, если пользователь не запрашивает иное. Точная строка модели для Claude Sonnet 4.5 — claude-sonnet-4-5-20250929.

Используйте возможности мышления и чередующегося мышления

Модели Claude 4.x предлагают возможности мышления, которые могут быть особенно полезны для задач, включающих размышление после использования инструментов или сложное многошаговое рассуждение. Вы можете направить его начальное или чередующееся мышление для лучших результатов.

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

Создание документов

Модели Claude 4.5 превосходны в создании презентаций, анимаций и визуальных документов. Эти модели соответствуют или превосходят Claude Opus 4.1 в этой области с впечатляющим творческим мастерством и более сильным следованием инструкциям. Модели производят отполированный, пригодный для использования выход с первой попытки в большинстве случаев.

Для лучших результатов при создании документов:

Создайте профессиональную презентацию на [тему]. Включите продуманные элементы дизайна, визуальную иерархию и привлекательные анимации, где это уместно.

Оптимизируйте параллельные вызовы инструментов

Модели Claude 4.x превосходны в параллельном выполнении инструментов, причем Sonnet 4.5 особенно агрессивна при запуске нескольких операций одновременно. Модели Claude 4.x будут:

• Запускать несколько спекулятивных поисков во время исследования
• Читать несколько файлов одновременно для более быстрого построения контекста
• Выполнять команды bash параллельно (что может даже создать узкое место производительности системы)

Это поведение легко управляемо. Хотя модель имеет высокий уровень успеха при параллельных вызовах инструментов без подсказки, вы можете повысить это до ~100% или отрегулировать уровень агрессии:

<use_parallel_tool_calls>
Если вы намереваетесь вызвать несколько инструментов и между вызовами инструментов нет зависимостей, сделайте все независимые вызовы инструментов параллельно. Приоритизируйте одновременный вызов инструментов всякий раз, когда действия могут быть выполнены параллельно, а не последовательно. Например, при чтении 3 файлов запустите 3 вызова инструментов параллельно, чтобы прочитать все 3 файла в контекст одновременно. Максимизируйте использование параллельных вызовов инструментов, где это возможно, для увеличения скорости и эффективности. Однако если некоторые вызовы инструментов зависят от предыдущих вызовов для информирования зависимых значений, таких как параметры, НЕ вызывайте эти инструменты параллельно и вместо этого вызывайте их последовательно. Никогда не используйте заполнители и не угадывайте недостающие параметры в вызовах инструментов.
</use_parallel_tool_calls>

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

Уменьшите создание файлов в агентском кодировании

Модели Claude 4.x могут иногда создавать новые файлы для целей тестирования и итерации, особенно при работе с кодом. Этот подход позволяет Claude использовать файлы, особенно скрипты python, как "временный блокнот" перед сохранением окончательного результата. Использование временных файлов может улучшить результаты, особенно для случаев использования агентского кодирования.

Если вы предпочитаете минимизировать создание новых файлов, вы можете указать Claude очистить после себя:

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

Улучшите генерацию визуального и фронтенд-кода

Модели Claude 4.x могут генерировать высококачественные, визуально отличительные, функциональные пользовательские интерфейсы. Однако без руководства фронтенд-код может по умолчанию использовать общие паттерны, которые не хватает визуального интереса. Чтобы получить исключительные результаты пользовательского интерфейса:

1. Предоставьте явное поощрение творчеству:

Не сдерживайтесь. Отдайте все. Создайте впечатляющую демонстрацию, демонстрирующую возможности веб-разработки.

1. Укажите эстетическое направление и ограничения дизайна:

Создайте профессиональную панель управления, используя темно-синюю и голубую цветовую палитру, современную типографию без засечек (например, Inter для заголовков, системные шрифты для основного текста) и макеты на основе карточек с тонкими тенями. Включите продуманные детали, такие как состояния наведения, переходы и микровзаимодействия. Применяйте принципы дизайна: иерархия, контраст, баланс и движение.

1. Поощряйте разнообразие дизайна и эстетику слияния:

Предоставьте несколько вариантов дизайна. Создайте эстетику слияния, объединив элементы из разных источников — одну цветовую схему, другую типографию, другой принцип макета. Избегайте общих центрированных макетов, упрощенных градиентов и единообразного стиля.

1. Явно запросите конкретные функции:

• "Включите как можно больше релевантных функций и взаимодействий"
• "Добавьте анимации и интерактивные элементы"
• "Создайте полнофункциональную реализацию, выходящую за рамки основ"

Избегайте сосредоточения на прохождении тестов и жесткого кодирования

Модели Claude 4.x иногда могут слишком сосредоточиться на прохождении тестов в ущерб более общим решениям или могут использовать обходные пути, такие как вспомогательные скрипты для сложного рефакторинга, вместо использования стандартных инструментов напрямую. Чтобы предотвратить это поведение и обеспечить надежные, обобщаемые решения:

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

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

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

Минимизация галлюцинаций в агентском кодировании

Модели Claude 4.x менее подвержены галлюцинациям и дают более точные, обоснованные, интеллектуальные ответы на основе кода. Чтобы поощрить это поведение еще больше и минимизировать галлюцинации:

<investigate_before_answering>
Никогда не спекулируйте о коде, который вы не открывали. Если пользователь ссылается на конкретный файл, вы ДОЛЖНЫ прочитать файл перед ответом. Убедитесь, что вы исследуете и читаете релевантные файлы ПЕРЕД ответом на вопросы о кодовой базе. Никогда не делайте никаких утверждений о коде перед исследованием, если вы не уверены в правильном ответе - давайте обоснованные и свободные от галлюцинаций ответы.
</investigate_before_answering>

Соображения по миграции

При миграции на модели Claude 4.5:

1. Будьте конкретны в отношении желаемого поведения: Рассмотрите описание того, что вы хотели бы видеть в выходных данных.

2. Оформите ваши инструкции с модификаторами: Добавление модификаторов, которые поощряют Claude повысить качество и детализацию своего выходного результата, может помочь лучше сформировать производительность Claude. Например, вместо "Создайте аналитическую панель", используйте "Создайте аналитическую панель. Включите как можно больше релевантных функций и взаимодействий. Выходите за рамки основ, чтобы создать полнофункциональную реализацию."

3. Явно запросите конкретные функции: Анимации и интерактивные элементы должны быть явно запрошены при необходимости.