Как правильно писать промпты для Claude: полное руководство с примерами

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

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

Правило первое: говорите конкретно

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

У Anthropic есть «золотое правило»: покажите свой промпт коллеге, который ничего не знает о задаче. Если он запутается — Claude тоже запутается.

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

Что не так? Claude не знает, для чего дашборд, какие данные, какие фичи важны. Он сделает что-то абстрактное и минимальное.

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

Объясняйте «зачем», а не только «что»

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

Разница колоссальная. В первом случае Claude запомнит одно правило. Во втором — он поймёт принцип и самостоятельно уберёт любые другие символы, которые плохо озвучиваются: эмодзи, спецсимволы, скобки с пояснениями. Вы получите не слепое следование букве, а осмысленное применение духа правила.

Покажите примеры — это мощнее любых инструкций

Anthropic называет это few-shot prompting и считает одним из самых надёжных способов управления качеством. 3–5 хороших примеров стабилизируют формат, тон и структуру ответа лучше, чем страница инструкций.

Но не все примеры одинаково полезны. Anthropic выделяет три критерия:

• Релевантность — примеры должны быть из реальной задачи, а не абстрактные
• Разнообразие — покрывайте крайние случаи, иначе Claude зацепится за один паттерн и будет генерировать однотипные ответы
• Чёткое оформление — оборачивайте примеры в XML-теги, чтобы Claude не перепутал их с инструкциями

Вот как это выглядит на практике. Допустим, вы хотите, чтобы Claude классифицировал обращения клиентов:

Без примеров Claude мог бы выдать длинное рассуждение вместо одного слова-категории. С примерами — он точно понимает формат и выдаёт ровно то, что нужно.

XML-теги: секретное оружие сложных промптов

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

Это не программирование и не код — это просто разметка для ясности. Claude обучен понимать теги как структурные разделители.

Каждый блок — в своём теге. Claude точно знает, где роль, где инструкции, где контекст, а где входные данные. Никакой путаницы, никаких интерпретаций.

Используйте понятные названия: <instructions>, <context>, <input>, <examples>. Можно вкладывать теги друг в друга — например, несколько документов внутри <documents>.

Роль меняет всё

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

Вы получите учебный ответ — корректный, но базовый.

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

Большие документы: правило 30%

Anthropic провели тесты и выяснили удивительную вещь: простое перемещение вопроса в конец промпта (после документа) улучшает качество ответа на 30%. Тридцать процентов! Бесплатно. Просто поменяв местами блоки.

Три правила для работы с большими документами:

1. Длинные данные — сверху, вопрос — снизу. Не наоборот. Claude лучше «запоминает» то, что прочитал последним, и применяет это к документу выше.

2. Структурируйте документы XML-тегами. Если у вас несколько документов — оберните каждый в теги с номером и источником:

3. Попросите Claude сначала процитировать. Это мощный приём: перед тем как делать выводы, попросите найти и выписать релевантные цитаты из документа. Это «заземляет» ответ — Claude строит выводы на реальных фрагментах текста, а не на своих фантазиях.

Формат ответа: 4 приёма, которые работают

Claude очень чувствителен к формату. Anthropic выявили 4 надёжных способа управления тем, как выглядит ответ.

Приём 1: говорите, что делать, а не чего НЕ делать.

Запреты создают «дыру» — Claude знает, чего не делать, но не знает, чем это заменить. Позитивные инструкции дают чёткое направление.

Приём 2: стиль промпта = стиль ответа. Если вы пишете промпт маркдауном со списками — Claude ответит так же. Хотите обычный текст — пишите промпт обычным текстом. Модель зеркалит стиль входа.

Приём 3: XML-теги для секций ответа. Скажите Claude писать разные части ответа в определённых тегах — и вы получите чётко структурированный результат, который легко парсить программно.

Приём 4: детальные правила форматирования. Если вам нужен конкретный стиль (например, минимум маркдауна), опишите его подробно: «Пиши плавной прозой. Используй абзацы. Маркдаун — только для кода. Не используй жирный, курсив и списки.»

«Сделай» vs «предложи» — Claude различает

Это ловушка, в которую попадают многие. Claude обучен точно следовать формулировкам. Если вы скажете «можешь предложить изменения?» — он именно предложит. Текстом. Не сделает.

Одно слово меняет результат с «вот список идей» на реальный код. Если вы работаете с Claude Code или API с инструментами — это критически важно.

Хотите, чтобы Claude по умолчанию действовал? Добавьте в системный промпт:

Мышление вслух: пусть Claude рассуждает

У Claude есть режим «thinking» — расширенное мышление, где модель рассуждает перед тем, как дать ответ. Это драматически улучшает качество на сложных задачах: математика, код, многошаговый анализ.

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

Три практических совета:

• Примеры с мышлением. Вставьте теги <thinking> в ваши few-shot примеры, показывая ход рассуждения — Claude обобщит этот стиль
• Самопроверка. Добавьте в конец: «Перед ответом проверь свой результат по критериям X, Y, Z.» Это надёжно ловит ошибки, особенно в коде и математике
• Не переборщите. На простых задачах мышление только замедляет. Используйте его для того, что действительно требует рассуждения

Агентные системы: когда Claude работает долго и автономно

Это самый продвинутый раздел — и самый полезный для тех, кто использует Claude Code, API с инструментами или строит AI-агентов.

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

Проблема контекста. У Claude есть ограничение на длину разговора (контекстное окно). Когда оно заканчивается, модель может попытаться «свернуть» работу раньше времени. Anthropic рекомендует явно сказать:

Отслеживание состояния. Для долгих задач Anthropic рекомендует три инструмента:

• JSON-файлы — для структурированных данных (статусы тестов, прогресс задач)
• Текстовые заметки — для описания общего прогресса и контекста
• Git — для отслеживания изменений и создания точек восстановления

Безопасность. Без ограничений Claude может удалить файлы, сделать force-push или отправить сообщение — и это будет необратимо. Anthropic рекомендует явно разделить действия на безопасные и опасные:

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

Anthropic честно признаёт два слабых места Claude и даёт конкретные решения.

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

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

Бонус: как избежать «AI-дизайна»

Если вы используете Claude для создания фронтенда, у Anthropic есть отдельный совет. Без специальных инструкций Claude создаёт то, что пользователи называют «AI slop» — одинаковые шрифты Inter, фиолетовые градиенты на белом фоне, предсказуемые layouts.

Решение — явно попросить креативности:

Что вынести из этой статьи

Промпт-инжиниринг — это не магия и не «секретные слова». Это навык коммуникации с очень умным, но не имеющим контекста собеседником. Главные принципы просты:

Будьте конкретны. Объясняйте причины. Показывайте примеры. Структурируйте XML-тегами. Задавайте роль. Ставьте данные сверху, вопрос — снизу. Говорите, что делать, а не чего не делать.

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

Начните с одного-двух приёмов, которые показались самыми полезными. Попробуйте на реальной задаче. Сравните результат с вашим обычным промптом. Разница вас удивит.