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

Это справочник по инженерии подсказок (prompt engineering) для актуальных моделей Claude, включая Claude Fable 5.1, Claude Mythos 5.1, Claude Fable 5, Claude Mythos 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5, Claude Sonnet 4.6 и Claude Haiku 4.5. Страница состоит из трёх частей:

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

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

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

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

Техники в этом разделе и в последующих разделах применимы к актуальным моделям Claude, включая Claude Fable 5.1, Claude Mythos 5.1, Claude Fable 5 и Claude Mythos 5. Если в технике названа конкретная модель, считайте, что она измерена на этой модели, и перепроверьте её на собственных оценках, прежде чем применять к другой модели.

Будьте ясны и прямолинейны

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

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

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

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

Create an analytics dashboard

Create an analytics dashboard. Include as many relevant features and interactions as possible. Go beyond the basics to create a fully-featured implementation.

Добавляйте контекст для повышения качества

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

NEVER use ellipses

Your response will be read aloud by a text-to-speech engine, so never use ellipses since the text-to-speech engine will not know how to pronounce them.

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

Эффективно используйте примеры

Примеры — один из самых надёжных способов управлять форматом, тоном и структурой вывода Claude. Несколько хорошо составленных примеров (так называемое few-shot или multishot prompting — подсказки с несколькими примерами) повышают точность и согласованность.

Добавляя примеры, делайте их:

• Релевантными: максимально близкими к вашему реальному сценарию использования.
• Разнообразными: охватывающими пограничные случаи и достаточно различающимися, чтобы Claude не усвоил непредусмотренные закономерности.
• Структурированными: оборачивайте примеры в теги <example> (несколько примеров — в теги <examples>), чтобы Claude мог отличать их от инструкций.

Структурируйте подсказки с помощью XML-тегов

XML-теги помогают Claude однозначно разбирать сложные подсказки, особенно когда в подсказке смешаны инструкции, контекст, примеры и переменные входные данные. Оборачивание каждого типа содержимого в собственный тег (например, <instructions>, <context>, <input>) снижает вероятность неверной интерпретации.

Лучшие практики:

• Используйте согласованные, описательные имена тегов во всех ваших подсказках.
• Вкладывайте теги, когда у содержимого есть естественная иерархия (документы внутри <documents>, каждый внутри <document index="n">).

Задайте Claude роль

Задание роли в системной подсказке (system prompt) фокусирует поведение и тон Claude под ваш сценарий использования. Даже одно предложение имеет значение:

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    system="You are a helpful coding assistant specializing in Python.",
    messages=[
        {"role": "user", "content": "How do I sort a list of dictionaries by key?"}
    ],
)

print(message.content)

Подсказки с длинным контекстом

При работе с большими документами или насыщенными данными входами (20 тыс.+ токенов) тщательно структурируйте подсказку для получения лучших результатов:

• Размещайте объёмные данные в начале: помещайте длинные документы и входные данные ближе к началу подсказки, над вашим запросом, инструкциями и примерами. Это улучшает результаты на всех моделях.

• Структурируйте содержимое документов и метаданные с помощью XML-тегов: при использовании нескольких документов оборачивайте каждый документ в теги <document> с подтегами <document_content> и <source> (и другими метаданными) для ясности.

  Пример многодокументной структуры

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

  Пример извлечения цитат

Знание модели о себе

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

The assistant is Claude, created by Anthropic. The current model is Claude Opus 5.

Для приложений на базе «large language model» (большой языковой модели), или LLM, которым нужно указывать строки моделей:

When an LLM is needed, please default to Claude Opus 5 unless the user requests
otherwise. The exact model string for Claude Opus 5 is claude-opus-5.

Вывод и форматирование

Стиль общения и многословность

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

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

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

After completing a task that involves tool use, provide a quick summary of the work you've done.

Claude Opus 5 — исключение в отношении многословности: его ответы пользователю по умолчанию длиннее, чем у предыдущих моделей, а повышение или понижение уровня усилий не меняет надёжно длину видимого ответа. Вместо этого явно запрашивайте краткость в подсказке. Пример инструкции см. в разделе Составление подсказок для Claude Opus 5. У Claude Fable 5.1 противоположная тенденция во время агентной работы: он пишет меньше обновлений для пользователя между вызовами инструментов. Явно запрашивайте текст о ходе работы и удалите любые инструкции, предписывающие делать этот текст кратким. См. Запрашивайте обновления о ходе работы для пользователя.

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

Есть несколько особенно эффективных способов управлять форматированием вывода:

1. Говорите Claude, что делать, а не чего не делать

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

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

   • Попробуйте: «Пиши прозаические части ответа в тегах <smoothly_flowing_prose_paragraphs>.»

3. Согласуйте стиль подсказки с желаемым выводом

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

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

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

<avoid_excessive_markdown_and_bullet_points>
When writing reports, documents, technical explanations, analyses, or any long-form
content, write in clear, flowing prose using complete paragraphs and sentences. Use
standard paragraph breaks for organization and reserve markdown primarily for `inline
code`, code blocks (```...```), and simple headings (## and ###). Avoid using **bold**
and *italics*.

DO NOT use ordered lists (1. ...) or unordered lists (*) unless: a) you're presenting
truly discrete items where a list format is the best option, or b) the user explicitly
requests a list or ranking

Instead of listing items with bullets or numbers, incorporate them naturally into
sentences. This guidance applies especially to technical writing. Using prose instead of
excessive formatting will improve user satisfaction. NEVER output a series of overly
short bullet points.

Your goal is readable, flowing text that guides the reader naturally through ideas
rather than fragmenting information into isolated points.
</avoid_excessive_markdown_and_bullet_points>

Claude Fable 5.1 уже форматирует меньше, чем более ранние модели, поэтому на этой модели подобный блок может подавить структуру, которая нужна содержимому. Удалите его или замените более коротким правилом из раздела Форматирование в чате.

Вывод LaTeX

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

Format your response in plain text only. Do not use LaTeX, MathJax, or any markup
notation such as \( \), $, or \frac{}{}. Write all math expressions using standard text
characters (e.g., "/" for division, "*" for multiplication, and "^" for exponents).

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

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

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

Create a professional presentation on [topic]. Include thoughtful design elements,
visual hierarchy, and engaging animations where appropriate.

Отказ от предзаполненных ответов

Начиная с моделей Claude 4.6 и Claude Mythos Preview, предзаполненные ответы (предоставление частичного сообщения ассистента, которое Claude должен продолжить) в последнем ходе ассистента больше не поддерживаются. Запросы с предзаполненными сообщениями ассистента к этим моделям возвращают ошибку 400. Интеллект моделей и следование инструкциям продвинулись настолько, что большинство сценариев использования предзаполнения больше в нём не нуждаются. Более ранние модели продолжают поддерживать предзаполнение, а добавление сообщений ассистента в других местах разговора не затрагивается.

Вот распространённые сценарии предзаполнения и способы отказаться от них:

Использование инструментов

Применение инструментов

Новейшие модели Claude обучены точному следованию инструкциям и выигрывают от явных указаний использовать конкретные инструменты. Если вы скажете «можешь предложить некоторые изменения», Claude иногда предложит изменения, а не реализует их, даже если вы имели в виду именно внесение изменений. Чтобы узнать, как определять инструменты и устранять проблемы с их запуском, см. Использование инструментов (tool use) с Claude.

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

Can you suggest some changes to improve this function?

Change this function to improve its performance.

Make these edits to the authentication flow.

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

<default_to_action>
By default, implement changes rather than only suggesting them. If the user's intent is
unclear, infer the most useful likely action and proceed, using tools to discover any
missing details instead of guessing. Try to infer the user's intent about whether a tool
call (e.g., file edit or read) is intended or not, and act accordingly.
</default_to_action>

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

<do_not_act_before_instructions>
Do not jump into implementation or change files unless clearly instructed to make
changes. When the user's intent is ambiguous, default to providing information, doing
research, and providing recommendations rather than taking action. Only proceed with
edits, modifications, or implementations when the user explicitly requests them.
</do_not_act_before_instructions>

Claude Opus 4.5 и Claude Opus 4.6 также более отзывчивы к системной подсказке, чем предыдущие модели. Если ваши подсказки были разработаны для уменьшения недостаточного срабатывания инструментов или навыков, эти модели теперь могут срабатывать избыточно. Решение — смягчить любые агрессивные формулировки. Там, где вы могли написать «КРИТИЧЕСКИ ВАЖНО: ты ОБЯЗАН использовать этот инструмент, когда...», можно использовать более обычную формулировку вроде «Используй этот инструмент, когда...».

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

Новейшие модели Claude выполняют независимые вызовы инструментов параллельно. Эти модели будут:

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

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

<use_parallel_tool_calls>
If you intend to call multiple tools and there are no dependencies between the tool
calls, make all of the independent tool calls in parallel. Prioritize calling tools
simultaneously whenever the actions can be done in parallel rather than sequentially.
For example, when reading 3 files, run 3 tool calls in parallel to read all 3 files into
context at the same time. Maximize use of parallel tool calls where possible to increase
speed and efficiency. However, if some tool calls depend on previous calls to inform
dependent values like the parameters, do NOT call these tools in parallel and instead
call them sequentially. Never use placeholders or guess missing parameters in tool
calls.
</use_parallel_tool_calls>

Execute operations sequentially with brief pauses between each step to ensure stability.

На Claude Fable 5.1 в длинных агентных циклах отправляйте инструкцию о параллельных вызовах как системное сообщение в рамках хода после каждого раунда результатов инструментов. См. Пакетируйте независимые вызовы инструментов в агентных циклах.

Мышление и рассуждение

Чрезмерное обдумывание и избыточная тщательность

Claude Opus 4.6 проводит больше предварительного исследования, чем предыдущие модели, особенно при более высоких настройках effort. Эта начальная работа часто помогает оптимизировать конечные результаты, но модель может собирать обширный контекст или вести несколько направлений исследования без запроса. Если ваши подсказки ранее побуждали модель быть более тщательной, вам следует скорректировать эти указания для Claude Opus 4.6:

• Замените общие установки по умолчанию более целенаправленными инструкциями. Вместо «По умолчанию используй [tool]» добавьте указание вроде «Используй [tool], когда это улучшит твоё понимание проблемы.»
• Уберите избыточные подсказки. Инструменты, которые недостаточно срабатывали в предыдущих моделях, теперь, скорее всего, срабатывают адекватно. Инструкции вроде «Если сомневаешься, используй [tool]» вызовут избыточное срабатывание.
• Используйте effort как запасной вариант. Если Claude продолжает быть чрезмерно агрессивным, используйте более низкую настройку effort.

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

When you're deciding how to approach a problem, choose an approach and commit to it.
Avoid revisiting decisions unless you encounter new information that directly
contradicts your reasoning. If you're weighing two approaches, pick one and see it
through. You can always course-correct later if the chosen approach fails.

Если вам нужен жёсткий потолок затрат на мышление, расширенное мышление (extended thinking) с ограничением budget_tokens всё ещё работает на Opus 4.6 и Sonnet 4.6, но объявлено устаревшим. На моделях Claude 4.7 и более поздних установка budget_tokens возвращает ошибку 400. Предпочтительнее понизить настройку effort или использовать max_tokens как жёсткий лимит с адаптивным мышлением.

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

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

Модели Claude 4.6 и более поздние, а также Claude Mythos Preview используют адаптивное мышление (thinking: {type: "adaptive"}), при котором Claude динамически решает, когда и сколько думать. На Claude Fable 5.1, Claude Mythos 5.1, Claude Fable 5 и Claude Mythos 5 мышление всегда включено, и адаптивное мышление — единственный режим. Claude калибрует своё мышление на основе двух факторов: параметра effort и сложности запроса. Более высокий уровень усилий вызывает больше мышления, как и более сложные запросы. На более простых запросах, не требующих мышления, модель отвечает напрямую. Во внутренних оценках адаптивное мышление стабильно обеспечивает лучшие результаты, чем расширенное мышление. Рассмотрите переход на адаптивное мышление.

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

Вы можете направлять поведение мышления Claude:

After receiving tool results, carefully reflect on their quality and determine optimal
next steps before proceeding. Use your thinking to plan and iterate based on this new
information, and then take the best next action.

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

Thinking adds latency and should only be used when it will meaningfully improve
answer quality - typically for problems that require multistep reasoning. When in
doubt, respond directly.

Если вы мигрируете с расширенного мышления с budget_tokens, замените конфигурацию мышления и перенесите управление бюджетом в effort. Следующие примеры показывают один и тот же запрос до и после миграции (доступные уровни и доступность по моделям см. в разделе effort):

# До: расширенное мышление с ручным бюджетом (старые модели)
client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 10000},
    messages=[{"role": "user", "content": "..."}],
)

# После: адаптивное мышление с параметром effort
client.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    thinking={"type": "adaptive"},
    output_config={"effort": "high"},
    messages=[{"role": "user", "content": "..."}],
)

Если вы не используете расширенное мышление, никаких изменений не требуется. На моделях от Claude Opus 4.6 до Claude Opus 4.8 и на Claude Sonnet 4.6 мышление выключено, если вы опускаете параметр thinking. На Claude Opus 5 и Claude Sonnet 5 мышление включено по умолчанию, если вы опускаете параметр thinking. На Claude Opus 5 вы можете отключить его только при уровне усилий high или ниже. На Claude Fable 5.1, Claude Mythos 5.1, Claude Fable 5 и Claude Mythos 5 мышление всегда включено, независимо от того, задаёте ли вы параметр thinking.

• Предпочитайте общие инструкции предписывающим шагам. Подсказка вроде «подумай тщательно» часто даёт лучшие рассуждения, чем написанный вручную пошаговый план. Рассуждения Claude нередко превосходят то, что предписал бы человек.
• Примеры multishot работают с мышлением. Используйте теги <thinking> внутри ваших few-shot примеров, чтобы показать Claude шаблон рассуждений. Он обобщит этот стиль на собственные блоки расширенного мышления.
• Ручная подсказка с цепочкой рассуждений (chain-of-thought, CoT) как запасной вариант. Когда мышление выключено, вы всё равно можете поощрять пошаговые рассуждения, попросив Claude обдумать проблему. Используйте структурированные теги вроде <thinking> и <answer>, чтобы чётко отделить рассуждения от финального вывода. На Claude Opus 5 вместо этого предпочтительнее оставить мышление включённым на более низком уровне усилий: при отключённом мышлении модель может изредка выводить внутренние XML-теги в видимый вывод, поэтому см. Работа с отключённым мышлением, прежде чем применять этот шаблон там.
• Попросите Claude проверить себя. Добавьте что-то вроде «Прежде чем закончить, проверь свой ответ по [критериям теста].» Это надёжно выявляет ошибки, особенно в программировании и математике. Claude Opus 5 — исключение: он хорошо проверяет свою работу без явных инструкций, а инструкции по проверке, перенесённые из подсказок, настроенных для более ранних моделей, могут вызывать избыточную проверку, добавляя токены и задержку. При миграции на Claude Opus 5 удалите эти инструкции, а не переписывайте их. См. Объём задачи и избыточная проверка.

Агентные системы

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

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

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

Claude Sonnet 5, Claude Sonnet 4.6, Claude Sonnet 4.5 и Claude Haiku 4.5 обладают осведомлённостью о контексте, позволяющей модели отслеживать оставшееся контекстное окно (context window), то есть свой «бюджет токенов», на протяжении разговора. Это позволяет Claude выполнять задачи и управлять контекстом эффективнее, понимая, сколько места у него есть для работы.

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

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

Your context window will be automatically compacted as it approaches its limit, allowing
you to continue working indefinitely from where you left off. Therefore, do not stop
tasks early due to token budget concerns. As you approach your token budget limit, save
your current progress and state to memory before the context window refreshes. Always be
as persistent and autonomous as possible and complete tasks fully, even if the end of
your budget is approaching. Never artificially stop any task early regardless of the
context remaining.

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

Рабочие процессы на протяжении нескольких контекстных окон

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

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

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

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

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

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

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

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

This is a very long task, so it may be beneficial to plan out your work clearly. It's
encouraged to spend your entire output context working on the task - just make sure you
don't run out of context with significant uncommitted work. Continue working
systematically until you have completed this task.

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

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

{
  "tests": [
    { "id": 1, "name": "authentication_flow", "status": "passing" },
    { "id": 2, "name": "user_management", "status": "failing" },
    { "id": 3, "name": "api_endpoints", "status": "not_started" }
  ],
  "total": 200,
  "passing": 150,
  "failing": 25,
  "not_started": 25
}

// Progress notes (progress.txt)
Session 3 progress:
- Fixed authentication token validation
- Updated user model to handle edge cases
- Next: investigate user_management test failures (test #2)
- Note: Do not remove tests as this could lead to missing functionality

Баланс автономии и безопасности

Без указаний Claude Opus 4.6 может предпринимать действия, которые трудно отменить или которые затрагивают общие системы, например удаление файлов, принудительный push или публикацию во внешних сервисах. Если вы хотите, чтобы Claude Opus 4.6 запрашивал подтверждение перед потенциально рискованными действиями, добавьте указания в подсказку:

Consider the reversibility and potential impact of your actions. You are encouraged to
take local, reversible actions like editing files or running tests, but for actions that
are hard to reverse, affect shared systems, or could be destructive, ask the user before
proceeding.

Examples of actions that warrant confirmation:
- Destructive operations: deleting files or branches, dropping database tables, rm -rf
- Hard to reverse operations: git push --force, git reset --hard, amending published commits
- Operations visible to others: pushing code, commenting on PRs/issues, sending
messages, modifying shared infrastructure

When encountering obstacles, do not use destructive actions as a shortcut. For example,
don't bypass safety checks (e.g. --no-verify) or discard unfamiliar files that may be
in-progress work.

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

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

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

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

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

Search for this information in a structured way. As you gather data, develop several
competing hypotheses. Track your confidence levels in your progress notes to improve
calibration. Regularly self-critique your approach and plan. Update a hypothesis tree or
research notes file to persist information and provide transparency. Break down this
complex research task systematically.

Этот структурированный подход помогает Claude методично прорабатывать большие корпуса и итеративно критически оценивать свои выводы.

Оркестрация субагентов

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

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

1. Обеспечьте чётко определённые инструменты субагентов: сделайте инструменты субагентов доступными и описанными в определениях инструментов.
2. Позвольте Claude оркестрировать естественно: Claude будет делегировать уместно без явных инструкций.
3. Следите за чрезмерным использованием: Claude Opus 4.6 имеет сильную склонность к субагентам и может порождать их в ситуациях, где достаточно более простого, прямого подхода. Например, модель может порождать субагентов для исследования кода, когда прямой вызов grep быстрее и достаточен. Claude Opus 5 также делегирует субагентам охотнее, чем предыдущие модели; рекомендации и пример сдерживающей подсказки см. в разделе Управление порождением субагентов.

Если вы наблюдаете чрезмерное использование субагентов, добавьте явные указания о том, когда субагенты оправданы, а когда нет:

Use subagents when tasks can run in parallel, require isolated context, or involve
independent workstreams that don't need to share state. For simple tasks, sequential
operations, single-file edits, or tasks where you need to maintain context across steps,
work directly rather than delegating.

Связывайте сложные подсказки в цепочки

Благодаря адаптивному мышлению и оркестрации субагентов Claude обрабатывает большинство многошаговых рассуждений внутренне. Явное связывание подсказок в цепочки (разбиение задачи на последовательные вызовы API) по-прежнему полезно, когда вам нужно проверять промежуточные результаты или обеспечивать определённую структуру конвейера.

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

Сократите создание файлов при агентном программировании

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

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

If you create any temporary new files, scripts, or helper files for iteration, clean up
these files by removing them at the end of the task.

Чрезмерное усердие

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

Например:

Avoid over-engineering. Only make changes that are directly requested or clearly
necessary. Keep solutions simple and focused:

- Scope: Don't add features, refactor code, or make "improvements" beyond what was
asked. A bug fix doesn't need surrounding code cleaned up. A simple feature doesn't need
extra configurability.

- Documentation: Don't add docstrings, comments, or type annotations to code you didn't
change. Only add comments where the logic isn't self-evident.

- Defensive coding: Don't add error handling, fallbacks, or validation for scenarios
that can't happen. Trust internal code and framework guarantees. Only validate at system
boundaries (user input, external APIs).

- Abstractions: Don't create helpers, utilities, or abstractions for one-time
operations. Don't design for hypothetical future requirements. The right amount of
complexity is the minimum needed for the current task.

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

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

Please write a high-quality, general-purpose solution using the standard tools
available. Do not create helper scripts or workarounds to accomplish the task more
efficiently. Implement a solution that works correctly for all valid inputs, not just
the test cases. Do not hard-code values or create solutions that only work for specific
test inputs. Instead, implement the actual logic that solves the problem generally.

Focus on understanding the problem requirements and implementing the correct algorithm.
Tests are there to verify correctness, not to define the solution. Provide a principled
implementation that follows best practices and software design principles.

If the task is unreasonable or infeasible, or if any of the tests are incorrect, please
inform me rather than working around them. The solution should be robust, maintainable,
and extendable.

Минимизация галлюцинаций при агентном программировании

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

<investigate_before_answering>
Never speculate about code you have not opened. If the user references a specific file,
you MUST read the file before answering. Make sure to investigate and read relevant
files BEFORE answering questions about the codebase. Never make any claims about code
before investigating unless you are certain of the correct answer - give grounded and
hallucination-free answers.
</investigate_before_answering>

Советы по конкретным возможностям

Улучшенные возможности зрения

Claude Opus 4.5 и Claude Opus 4.6 обладают улучшенными возможностями зрения по сравнению с предыдущими моделями Claude. Они лучше справляются с задачами обработки изображений и извлечения данных, особенно когда в контексте присутствует несколько изображений. Эти улучшения распространяются на использование компьютера, где модели надёжнее интерпретируют скриншоты и элементы UI. Вы также можете использовать эти модели для анализа видео, разбивая его на кадры.

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

Дизайн фронтенда

Claude Opus 4.5 и Claude Opus 4.6 создают сложные, реальные веб-приложения с сильным дизайном фронтенда. Однако без указаний модели могут по умолчанию использовать шаблонные паттерны, создающие то, что пользователи называют эстетикой «AI slop» (ИИ-халтуры). Чтобы создавать самобытные, креативные фронтенды, которые удивляют и радуют:

Для работы над дизайном фронтенда вне API Claude Design предоставляет холст и инструменты дизайна, где Claude генерирует дизайны и итеративно дорабатывает их в интерактивном режиме.

Вот фрагмент «system prompt» (системной подсказки), который вы можете использовать, чтобы стимулировать более качественный дизайн фронтенда:

<frontend_aesthetics>
You tend to converge toward generic, "on distribution" outputs. In frontend design, this
creates what users call the "AI slop" aesthetic. Avoid this: make creative, distinctive
frontends that surprise and delight.

Focus on:
- Typography: Choose fonts that are beautiful, unique, and interesting. Avoid generic
fonts like Arial and Inter; opt instead for distinctive choices that elevate the
frontend's aesthetics.
- Color & Theme: Commit to a cohesive aesthetic. Use CSS variables for consistency.
Dominant colors with sharp accents outperform timid, evenly-distributed palettes. Draw
from IDE themes and cultural aesthetics for inspiration.
- Motion: Use animations for effects and micro-interactions. Prioritize CSS-only
solutions for HTML. Use Motion library for React when available. Focus on high-impact
moments: one well-orchestrated page load with staggered reveals (animation-delay)
creates more delight than scattered micro-interactions.
- Backgrounds: Create atmosphere and depth rather than defaulting to solid colors. Layer
CSS gradients, use geometric patterns, or add contextual effects that match the overall
aesthetic.

Avoid generic AI-generated aesthetics:
- Overused font families (Inter, Roboto, Arial, system fonts)
- Clichéd color schemes (particularly purple gradients on white backgrounds)
- Predictable layouts and component patterns
- Cookie-cutter design that lacks context-specific character

Interpret creatively and make unexpected choices that feel genuinely designed for the
context. Vary between light and dark themes, different fonts, different aesthetics. You
still tend to converge on common choices (Space Grotesk, for example) across
generations. Avoid this: it is critical that you think outside the box!
</frontend_aesthetics>

Вы также можете обратиться к полному определению навыка.

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

При миграции на текущие модели Claude с более ранних поколений:

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

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

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

4. Обновите конфигурацию мышления: модели Claude 4.6 используют адаптивное мышление (thinking: {type: "adaptive"}) вместо ручного мышления с budget_tokens. Используйте параметр effort для управления глубиной мышления.

5. Откажитесь от предзаполненных ответов: предзаполненные ответы в последнем ходе ассистента больше не поддерживаются, начиная с моделей Claude 4.6 и Claude Mythos Preview. Подробные рекомендации по альтернативам см. в разделе Отказ от предзаполненных ответов.

6. Настройте подсказки против «лени»: если ваши подсказки ранее побуждали модель быть более тщательной или активнее использовать инструменты, ослабьте эти указания. Модели Claude 4.6 более проактивны и могут чрезмерно реагировать на инструкции, которые были нужны для предыдущих моделей.

7. Передавайте блоки мышления обратно без изменений и ведите историю только с добавлением: добавляйте каждый ход ассистента точно в том виде, в каком его вернул API, включая блоки мышления. В Claude Fable 5.1 изменение разговора перед блоком мышления приводит к ошибке или к отбрасыванию блока, если вы выбрали такой вариант: редактирование более ранних сообщений, пересборка system или tools либо суммаризация старых ходов на месте между запросами делает недействительными все последующие блоки мышления, поэтому перенесите такие изменения в системные сообщения в середине разговора и серверное управление контекстом. См. Ведите историю разговора только с добавлением.

Подробные шаги миграции см. в Руководстве по миграции.

Миграция на Claude Sonnet 5 с Claude Sonnet 4.5 или более ранних версий

См. раздел Миграция на Claude Sonnet 5 с Claude Sonnet 4.5 или более ранних версий в руководстве по миграции, где рассматриваются изменение значения effort по умолчанию и удаление ручного «extended thinking» (расширенного мышления) (budget_tokens).

Следующие шаги