Рекомендации разработчика · все модели Claude
Как писать запросы к моделям Claude
Пересказ на русском. Оригинал: «Prompting best practices» ↗ — Anthropic, на английском.
Для тех, кто пишет запросы к нынешним моделям Claude: как ставить задачу, управлять форматом, инструментами и размышлением, вести долгую агентную работу и переходить со старых моделей.
Коротко
- Говорите точно, чего хотите, и объясняйте, зачем: из причины модель выводит остальные правила.
- Формат задавайте примерами и тем, что делать, а не чего не делать.
- Глубину размышления задаёт
effort, потолок расходов —max_tokens. - Старые приёмы против лени и дописывание начала ответа за модель теперь вредят.
Как ставить задачу
Модель — сильный, но новый сотрудник, не знающий ваших порядков: покажите запрос коллеге не в теме, и если он запутается, запутается и модель.
- Опишите формат и ограничения результата; нужен размах — попросите его прямо.
- Порядок шагов задавайте нумерованным списком.
- Объясняйте причину правила: модель обобщает её на похожие случаи.
- Дайте три-пять примеров в тегах
<example>: близких к задаче и достаточно разных, чтобы модель не выучила случайную закономерность. - Сложный запрос размечайте XML-тегами (пометками в угловых скобках): инструкции, контекст и данные отдельно, с постоянными названиями.
- Задайте роль в системном запросе, хотя бы одной фразой.
- Документы от 20 тысяч токенов ставьте наверх, вопрос вниз: по замерам Anthropic, это улучшает ответы до 30 процентов. Каждый документ — в своём теге с источником; перед задачей попросите выписать нужные цитаты.
ВместоНе пиши длинных ответов.
ЛучшеОтвет покажут во всплывающем уведомлении на телефоне, куда помещаются две строки, поэтому отвечай не длиннее двух коротких предложений.
ПримерСначала три договора, каждый в своём теге с именем файла, потом вопрос: где самый короткий срок уведомления о расторжении? Перед ответом выпиши фразы об этом сроке.
Формат ответа
Нынешние модели пишут короче и естественнее прежних и могут пропустить итог после работы с инструментами: нужен итог — попросите.
- Что делать: вместо запрета опишите желаемый вид ответа.
- Тег и стиль: попросите положить ответ в тег; меньше разметки в запросе — меньше её в ответе.
- Развёрнутое правило: опишите, где допустимы заголовки и списки, а где нужна проза.
ВместоНе используй таблицы и списки.
ЛучшеСравни тарифы связным текстом: по абзацу на тариф, цена в первом предложении.
Чем заменить дописывание:
- JSON и классификация — структурированный ответ (режим, который держит модель в заданной схеме) или инструмент с перечнем допустимых меток;
- вступления вроде «Вот запрошенный итог» — прямая инструкция в системном запросе;
- оборванный ответ — сообщение пользователя с последними словами обрыва.
Инструменты
Модели натренированы точно следовать инструкциям, поэтому действие просите прямо: на вопрос, не предложит ли модель правки, она часто именно предложит.
ВместоМожешь посмотреть, что не так с этим тестом?
ЛучшеНайди причину падения теста test_login и исправь её в коде.
- Поведение по умолчанию настраивается в обе стороны: системный запрос велит делать, а не советовать, либо запрещает менять файлы без просьбы.
- Не давите: «ОБЯЗАН использовать инструмент», написанное против старых моделей, теперь даёт лишние вызовы; хватает «используй, когда…».
- Независимые вызовы модели и так делают параллельно; инструкция вызывать всё независимое в одном ответе, а зависимое по очереди и без выдуманных параметров доводит долю таких вызовов, по замерам Anthropic, почти до 100 процентов.
Размышление
Блок размышления — часть ответа, где модель рассуждает, прежде чем ответить. С Claude 4.6 оно адаптивное (thinking: {type: "adaptive"}): модель сама решает, когда и сколько думать, по effort и сложности вопроса; по оценкам Anthropic, это стабильно лучше ручного лимита budget_tokens.
- У Fable 5.1, Mythos 5.1, Fable 5, Mythos 5 и Opus 5.5 оно включено всегда; у Opus 5 и Sonnet 5 — по умолчанию; у Opus 4.6–4.8 и Sonnet 4.6 — по запросу.
- Общая просьба подумать как следует обычно работает лучше расписанного по шагам плана.
- Просьба проверить ответ перед завершением надёжно ловит ошибки в коде и математике.
- Думает чаще, чем нужно, — скажите, когда размышление уместно; нужна рефлексия после инструментов — попросите её.
ПримерРазмышление добавляет задержку. Включай его только для задач с несколькими шагами, например при расчёте доставки с трёх складов; на вопрос о часах работы отвечай сразу.
Долгая агентная работа
Модели уверенно ведут долгие задачи, если двигаться понемногу: несколько дел за раз, сохранить состояние, продолжить в новом контекстном окне, то есть с чистой памятью разговора.
- Первое окно — на каркас: тесты, скрипты запуска и проверки; дальше идите по списку задач.
- Тесты держите в структурированном файле и запретите их править и удалять.
- Состояние — в JSON, заметки — свободным текстом, историю — в git: модели хорошо восстанавливают состояние из файлов и git.
- Вместо сжатия иногда начинайте с чистого окна, точно сказав, с чего начать: заметки, тесты, журнал git.
- Если обвязка сжимает контекст, скажите модели не останавливаться заранее, а перед концом окна записать прогресс.
Что ещё настраивается инструкцией:
- Обратимость: попросите спрашивать перед удалением, перезаписью истории git и действиями, видимыми другим, а на препятствиях не обходить проверки.
- Помощники: модели сами поручают работу вспомогательным агентам, иногда чрезмерно; скажите, когда это уместно.
- Код: временные файлы-черновики помогают; мешают — попросите убирать их в конце. Против лишних абстракций просите минимум, против подгонки под тесты — общее решение, против домыслов — читать файл, прежде чем о нём говорить.
ПримерПомощников запускай, когда три модуля можно проверять независимо и параллельно. Одну функцию в одном файле правь сам, не теряя контекста.
Переход со старых моделей
- Описывайте желаемый результат точно; нужен размах — добавьте усилители вроде «сделай полноценную реализацию».
- Замените ручное размышление адаптивным с
effort. - Откажитесь от дописывания начала ответа за модель.
- Смягчите прежние приёмы против лени: модели с 4.6 сами инициативны.
- Возвращайте в историю ходы модели без изменений, вместе с блоками размышления.
Источник: Prompting best practices (Anthropic). Пересказ ИИтак.