Подсказки для Claude Opus 5

Это руководство охватывает паттерны подсказок, специфичные для Claude Opus 5. О возможностях модели и изменениях в API см. Что нового в Claude Opus 5. О техниках, применимых ко всем текущим моделям Claude, см. Лучшие практики подсказок.

Claude Opus 5 создан для сложного агентного программирования и корпоративной работы, с особыми сильными сторонами в долгосрочных агентных задачах. Он хорошо работает «из коробки» на существующих подсказках для Claude Opus 4.8. Следующие паттерны охватывают поведение, которое чаще всего требует настройки.



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

По сравнению с Claude Opus 4.8, наиболее значимые для подсказок улучшения:

• Агентное программирование: Claude Opus 5 наиболее силён в сложных задачах программирования: многофайловые функции, крупные рефакторинги и сквозная работа над функциональностью. Он выполняет задачи полностью, а не оставляет заглушки или плейсхолдеры, и лучше всего работает, когда ему сразу дают полную спецификацию задачи и позволяют работать. Он также хорошо справляется с более простыми задачами, такими как однократные правки, где разница с предыдущими моделями меньше.
• Ревью кода и поиск ошибок: Claude Opus 5 проверяет код с высокой точностью и полнотой: он находит реальные ошибки с высокой частотой за один проход, и его дополнительные находки — это в основном реальные проблемы, а не ложные срабатывания. Точность сохраняется при более низких уровнях усилий, что позволяет делать быстрый проход во время ревью и более тщательный проход позже. Если ваша подсказка для ревью говорит «сообщай только о проблемах высокой серьёзности» или «будь консервативен», модель может следовать этой инструкции буквально и сообщать меньше; вместо этого попросите её сообщать обо всём и фильтруйте отдельным проходом.
• Эффективность при низких усилиях: уровни effort low и medium дают высокое качество при доле токенов и задержки по сравнению с более высокими настройками. Начните со значения по умолчанию (high) и корректируйте на основе ваших оценок: свободно используйте low и medium как основной инструмент управления стоимостью токенов и временем ответа везде, где качество сохраняется, и переходите на xhigh для требовательных задач программирования и агентной работы. Если вы перенесли значения усилий по умолчанию с предыдущей модели, повторно проведите перебор уровней усилий на ваших собственных оценках. Полные рекомендации см. в разделе Effort.
• Зрение: Claude Opus 5 силён в понимании графиков, документов и диаграмм, а также в визуальном воспроизведении UI и фронтенда. Перепроверьте любые обходные решения для зрения на стороне подсказок, которые вы настраивали для предыдущих моделей; они могут больше не понадобиться. Производительность зрения наиболее высока, когда у модели есть инструменты для итеративного анализа, обрезки и визуальной проверки своей работы, и использование инструментов — более экономичный рычаг, чем одно лишь мышление.
• Работа с длинным контекстом: Claude Opus 5 имеет контекстное окно в 1M токенов как по умолчанию, так и в качестве максимума, и его следование инструкциям, вызов инструментов и рассуждения остаются стабильными на протяжении всего окна.
• Офисные и документные задачи: Claude Opus 5 генерирует и работает со сложными многостраничными электронными таблицами с нетривиальными формулами и создаёт хорошо структурированные презентации. Указывайте в подсказке любые конкретные стили или шаблоны, которым он должен следовать.
• Координация нескольких агентов: Claude Opus 5 хорошо координирует команды субагентов, с эффективными паттернами «писатель-проверяющий» и редкими случаями, когда агенты перезаписывают работу друг друга. Для чувствительных к стоимости рабочих нагрузок ограничьте делегирование; см. Управление порождением субагентов.



Длина ответа и многословность

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

Короткая инструкция о лаконичности эффективна. Например, для пользовательского многоходового продукта:

Keep responses focused, brief, and concise. Keep disclaimers and caveats short, and spend most of the response on the main answer. When asked to explain something, give a high-level summary unless an in-depth explanation is specifically requested.

В длинной системной подсказке сочетайте инструкцию с коротким напоминанием ближе к концу подсказки:

<tone_preference>
Keep outputs reasonably concise.
</tone_preference>



Обновления о прогрессе для пользователя

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

Before your first tool call, say in one sentence what you're about to do. While working, give a brief update only when you find something important or change direction. When you finish, lead with the outcome: your first sentence should answer "what happened" or "what did you find," with supporting detail after it for readers who want it.

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



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

Отдельно от разговорной многословности: файлы, которые Claude Opus 5 записывает на диск (отчёты, документы Markdown, сводки), часто длиннее, чем у предыдущих моделей. Если ваш продукт включает документы, созданные Claude, добавьте явную калибровку длины:

Match the length of written documents to what the task needs: cover the substance, but do not pad with filler sections, redundant summaries, or boilerplate.



Объём задачи и избыточная проверка

Claude Opus 5 проверяет свою работу без указаний. Если ваша подсказка содержит явные инструкции по проверке («включи финальный шаг проверки для любой нетривиальной задачи», «используй субагента для проверки»), удалите их: такие инструкции вызывают избыточную проверку у Claude Opus 5, а их удаление сокращает потраченные впустую токены без потери качества. То же относится к устаревшей обвязке (harness), добавляющей отдельные шаги проверки.

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

Deliver what was asked, at the scope intended. Make routine judgment calls yourself, and check in only when different readings of the request would lead to materially different work. If the request seems mistaken or a better approach exists, say so in a sentence and continue with the task as asked rather than quietly narrowing, widening, or transforming it. Finish the whole task, and stop short of actions that are clearly beyond what was asked.



Управление порождением субагентов

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

Delegate to a subagent only for large tasks that are genuinely independent and parallelizable, such as a wide multi-file investigation. Do not delegate work you can finish yourself in a handful of tool calls, and do not use subagents to verify or double-check your own work. If one subagent can complete the task, use one rather than several, and keep spawn counts low.



Самокоррекция

Claude Opus 5 хорошо обнаруживает и исправляет собственные ошибки без подсказок. Избегайте инструкций о повторных проверках, которые он уже выполняет («перепроверь свой ответ», «проверь ещё раз перед ответом»); как и инструкции по верификации, они накладываются на собственное поведение модели и увеличивают стоимость без улучшения результатов.

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

Only correct an earlier statement when the error would change the user's code, conclusions, or decisions. State corrections plainly and briefly, then continue the task. For slips that change nothing for the user, make the fix and move on without noting it.



Работа с отключённым мышлением

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

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

Внутренние XML-теги в выводе. При отключённом мышлении модель может выдавать теги <thinking> или другие внутренние XML-теги в своём видимом ответе. Если ваша системная подсказка содержит правило, предписывающее модели не думать или не рассуждать, удалите его; такого рода инструкции увеличивают утечку тегов.

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

When you use a tool, you may say a brief sentence first. If no tool can express what the user asked for, say so instead of guessing. Do not include internal or system XML tags in your response.

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