Составление подсказок для 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 силён в понимании графиков, документов и диаграмм, а также в визуальном воспроизведении пользовательских интерфейсов и фронтенда. Перепроверьте любые обходные решения для зрения на стороне подсказки, которые вы настраивали для предыдущих моделей; возможно, они больше не нужны. Производительность зрения наиболее высока, когда у модели есть инструменты для итеративного анализа, обрезки и визуальной проверки своей работы, а «tool use» (использование инструментов) — более экономичный рычаг, чем одно лишь мышление.
• Работа с длинным контекстом: Claude Opus 5 имеет «context window» (контекстное окно) размером 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, а их удаление сокращает напрасный расход токенов без потери качества. То же относится к устаревшей обвязке среды выполнения, добавляющей отдельные шаги проверки.

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 Code или Claude Agent SDK, детерминированными ограничениями служат переменные окружения CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH и CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS, а также опция SDK max_budget_usd. Они требуют Claude Code версии 2.1.217 или новее, поэтому обновите закреплённую версию SDK, прежде чем направлять её на Claude Opus 5. Claude Code добавляет собственную инструкцию о делегировании для Claude Opus 5 только при использовании пресета системной подсказки claude_code; при пользовательской или отсутствующей системной подсказке добавьте инструкцию о делегировании, подобную примеру в этом разделе, самостоятельно. См. Ограничение глубины, параллелизма и расходов субагентов в документации Agent SDK.

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

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.

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