Руководства по моделям

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

Как писать промпты для Claude. XML-теги, где размещать длинные документы, примеры, расширенное мышление, явные инструкции и ошибки, характерные именно для Claude.

  • Автор: Vijayraj Palanisamy
  • Обновлено
  • 4 мин чтения

Перевод английского оригинала. Код, промпты и вывод моделей оставлены на английском.

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

Названия и ограничения моделей меняются, поэтому советы здесь касаются стабильного поведения. Актуальные модели смотрите в документации Anthropic.

Будьте чёткими, прямыми и конкретными

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

Современные модели Claude следуют инструкциям точно. У этого два последствия, которые стоит учитывать:

  • Просите то, что хотите. Если вы хотите, чтобы Claude вышел за пределы буквального запроса, например реализовал изменение, а не только предложил его, скажите об этом.
  • Уберите эмфазу. Заглавные буквы и «CRITICAL» не нужны и могут привести к слишком широкому применению правила. Достаточно простого предложения.

Объясняйте почему

Claude хорошо обобщает на основе причины. Сравните:

  • Never use ellipses.
  • Your response will be read aloud by a text-to-speech engine, so never use ellipses, because the engine cannot pronounce them.

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

Структурируйте промпты XML-тегами

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

Review the contract in <contract> tags against the checklist in
<checklist> tags. Put your findings in <findings> tags.

<contract>
{{contract_text}}
</contract>

<checklist>
{{checklist}}
</checklist>

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

Ставьте длинные документы наверх

При длинных входах размещайте документы ближе к началу промпта, а вопрос или инструкции — в конце. Anthropic сообщает, что запрос, помещённый после длинных документов, может заметно улучшить качество ответа.

Для нескольких документов оберните каждый в отдельные теги с метаданными источника:

<documents>
  <document index="1">
    <source>q3-report.pdf</source>
    <document_content>{{report}}</document_content>
  </document>
</documents>

Using the documents above, list the three largest risks.

Для задач над длинным материалом попросите Claude сначала процитировать релевантные фрагменты, а затем отвечать на основе цитат. См. промптинг для RAG.

Используйте примеры

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

Дайте Claude роль в системном промпте

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

Расширенное мышление

Модели Claude могут рассуждать перед ответом — эта функция называется расширенным мышлением (extended thinking). Когда оно включено:

  • Давайте высокоуровневые указания («тщательно обдумай граничные случаи») вместо предписания каждого шага. Собственный подход Claude часто лучше сценарного.
  • Не просите дополнительно пошагового рассуждения в ответе, если только не нужно его показывать.
  • Просите Claude проверить свою работу перед завершением в задачах, где ошибки дорого обходятся.

Когда мышление выключено, просьба рассуждать внутри тегов <thinking> перед ответом в тегах <answer> даёт сходный эффект. См. промптинг цепочкой рассуждений.

Управляйте форматом

  • Говорите, что делать, а не чего избегать. «Пиши плавными абзацами» работает лучше, чем «не используй markdown».
  • Подбирайте стиль. Оформление вашего промпта влияет на оформление ответа. Промпт простой прозой обычно получает прозу в ответ.
  • Просите теги для частей, которые будете разбирать.
  • Для строгого JSON используйте вызов инструментов со схемой входа или функцию структурированного вывода и проверяйте результат. См. промпты для структурированного вывода.

Инструменты и агенты

Claude широко используется в агентных сценариях, в том числе через Model Context Protocol, который представила Anthropic.

  • Подробно описывайте каждый инструмент: что он делает, когда его использовать и что возвращает.
  • Укажите, должен ли Claude действовать или только предлагать. Он внимательно следует этому указанию.
  • Для долгих задач пусть Claude ведёт заметки в файле, чтобы прогресс пережил сброс контекста.
  • Независимые вызовы инструментов могут выполняться параллельно; скажите об этом, если нужна скорость.

См. промпты для ИИ-агентов. MCP-сервер PromptFlowEngine можно добавить в Claude Desktop или Claude Code, чтобы Claude мог анализировать, реструктурировать и очищать промпты как инструменты.

Подсчёт токенов и кеширование

Anthropic не публикует офлайн-токенизатор для актуальных моделей, поэтому офлайн-подсчёты — приближения. PromptFlowEngine по этой причине помечает свои подсчёты для Claude как приблизительные. Для точного числа используйте конечную точку подсчёта токенов Anthropic.

Кеширование промптов включается явно: вы отмечаете конец стабильной части промпта, и повторные запросы читают её по сниженной ставке. Держите стабильное содержимое первым. См. оптимизацию токенов.

Типичные ошибки с Claude

Ошибка Что происходит Исправление
«Крик» правил заглавными буквами Чрезмерное применение Простые утверждения с причиной
Вопрос перед длинным документом Хуже используется документ Сначала документы, вопрос в конце
Вставленное содержимое без разметки Инструкции и данные смешиваются Оберните в XML-теги
Только однотипные примеры Копируется непреднамеренный шаблон Разнообразьте примеры
Расплывчатый запрос в расчёте на инициативу Буквальный минимальный ответ Явно просите дополнительную работу
Правила формата в отрицательной форме Непоследовательное оформление Назовите нужный формат

Оптимизация промпта для Claude

  1. Сформулируйте задачу и её цель.
  2. Оберните каждый вход в описательные теги.
  3. Переместите длинные документы наверх, а вопрос — в конец.
  4. Добавьте два-три разнообразных примера, если важны формат или тон.
  5. Уберите повторы и эмфазу.

Оптимизатор промптов PromptFlowEngine в структурированном режиме оборачивает переменные шаблона в теги и удаляет повторяющиеся инструкции, а затем проверяет, что ничего не потеряно. Расширение для Chrome делает то же самое внутри claude.ai.

Сравните с руководством по промптингу для ChatGPT и OpenAI и руководством по промптингу для Gemini.

Применить на практике

Попробуйте: оптимизатор промптов

Меньше токенов и больше структуры — с доказательством, что все требования сохранились. Бесплатно, детерминированно и без аккаунта.

Связанные инструменты PromptFlowEngine