Промпты для Claude Opus 5.5: effort, агенты, отказы и шаблоны

Чтобы хорошо писать промпты для Claude Opus 5.5, сохраните промпты, которыми пользовались с Claude Opus 5, задайте уровень effort до того, как менять формулировки, а затем добавляйте в системный промпт по одной целевой строке на каждое поведение, которое хотите изменить. Руководство Anthropic говорит, что существующие промпты для Claude Opus 5 «должны хорошо работать без изменений», а effort — это «первая настройка, которую стоит менять, чтобы балансировать интеллект, задержку и стоимость». Большая часть новых советов касается агентов: как не дать автономному запуску остановиться, как получать отчёты о ходе работы в длинных ходах и как задать темп команде агентов. Всё ниже взято из руководства Anthropic «Prompting Claude Opus 5.5» и справочника API модели, проверено 3 октября 2026 года.

Правила запросов, общие с Claude Fable 5.1, например запрет на предзаполнение ответа ассистента и на собственную temperature, разобраны в руководстве по промптам для Claude Fable 5.1. В этой статье — то, что относится только к Claude Opus 5.5.

Работают ли промпты для Claude Opus 5 с Claude Opus 5.5?

Да. Anthropic говорит, что они «должны хорошо работать без изменений», а приёмы промптинга для Claude Opus 5 «остаются разумной отправной точкой». Меняется то, как модель распределяет усилия. Claude Opus 5.5 генерирует выходные токены более чем на 30 % быстрее, чем Claude Opus 5, и обычно решает ту же задачу меньшим числом токенов.

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

• Агентное программирование и код-ревью. Многошаговая работа в реальном репозитории, долгие автономные запуски с субагентами и код-ревью, которое находит больше багов при меньшем числе ложных тревог.
• Работа со знаниями. Модель гораздо реже называет неверную цифру или ссылается не на тот источник и замечает мелкие несостыковки в больших объёмах данных, например дату, которая приходится не на тот день недели.
• Коммуникация. Отчёты о ходе работы и итоговые отчёты прямо говорят, что модель сделала, что нашла и что ей нужно от вас.
• Графики, диаграммы, скриншоты и работа с компьютером. Модель читает визуальные материалы точнее, чем Claude Opus 5, даже на самом низком уровне effort.

Если ваши промпты в основном для чата, прочитайте разделы про effort и чат. Если вы запускаете агентов, новые советы — в разделах про агентов.

Какой уровень effort использовать с Claude Opus 5.5?

Начните с medium — это значение по умолчанию для Claude Opus 5.5 (у Claude Opus 5 по умолчанию high). Задайте его явно и проверьте несколько уровней на своих задачах, а не переносите значение, которое использовали с Claude Opus 5. Названия уровней effort не означают одинаковый объём рассуждений у разных моделей: в тестах Anthropic Claude Opus 5.5 на medium «не уступает или превосходит Claude Opus 5 на high в оценках по программированию и работе со знаниями», а в ряде оценок по программированию low приближается к этому результату при гораздо меньшей стоимости.

Явно заданный medium работает точно так же, как отсутствие effort в запросе.

На том же уровне Claude Opus 5.5 обычно рассуждает за ход больше, чем Claude Opus 5, особенно на xhigh и max. Учтите три момента:

• Оставляйте запас в max_tokens. Рассуждения входят в max_tokens, даже если вы их не видите, поэтому лимит, рассчитанный на Claude Opus 5 без рассуждений, может обрезать ответы. Для длинных ходов в агентном программировании, по данным Anthropic, хорошо работает max_tokens 128 000 — максимум модели.
• Снижайте effort, прежде чем писать «думай меньше». Снижение effort надёжнее сокращает рассуждения, стоимость и задержку, чем инструкции в промпте.
• Не меняйте effort, если полагаетесь на кэш промптов. Изменение значения effort верхнего уровня между запросами делает кэш промптов недействительным.

Effort задаётся в output_config:

{
  "model": "claude-opus-5-5",
  "max_tokens": 128000,
  "output_config": {"effort": "medium"},
  "messages": [{"role": "user", "content": "Review this pull request for bugs and explain each one."}]
}

Можно ли отключить рассуждения в Claude Opus 5.5?

Нет. Claude Opus 5 принимал "thinking": {"type": "disabled"} на уровне effort high и ниже; Claude Opus 5.5 этого не принимает, и такой запрос возвращает ошибку 400. Рассуждения адаптивные и всегда включены. Если ваша интеграция работала без рассуждений, Anthropic советует четыре изменения:

1. Начните с effort low и измеряйте. На low модель рассуждает коротко. Если время до первого токена всё ещё важно, строка в системном промпте вроде «Answer directly without deliberating.» может ещё сократить рассуждения, но после её добавления проверьте качество.
2. Уберите инструкции, которые заменяли рассуждения. Если промпт просил модель расписывать ход мыслей в ответе, удалите эту строку и читайте рассуждения из сводки. Промпт, который подталкивает модель воспроизводить свои рассуждения в ответе, теперь может получить отказ (см. раздел об отказах ниже).
3. Перепроверьте старые обходные приёмы. Правила, добавленные против артефактов работы без рассуждений, возможно, больше не нужны. Удалите любое правило, которое запрещает модели думать.
4. Читайте ответ по типам блоков. Ответ может начинаться с блока thinking, а может и нет, поэтому проверяйте тип каждого блока, а не считайте первый блок текстом.

Чтобы увидеть рассуждения, запросите сводку рассуждений:

{
  "model": "claude-opus-5-5",
  "max_tokens": 16000,
  "thinking": {"type": "adaptive", "display": "summarized"},
  "output_config": {"effort": "low"},
  "messages": [{"role": "user", "content": "Which of these three invoices has a total that does not match its line items?"}]
}

Как не дать автономному агенту на Claude Opus 5.5 остановиться раньше времени?

В длинных задачах Claude Opus 5.5 держит пользователя в курсе по ходу работы, и некоторые такие сообщения завершают ход текстом, а не вызовом инструмента (stop_reason: "end_turn"). Цикл агента, который считает каждый такой ход «задача выполнена», останавливается на полпути. Решение Anthropic состоит из части в обвязке (harness) и части в промпте.

В обвязке считайте ход, завершившийся только текстом, отчётом, а не доказательством того, что работа закончена. Ведите части задачи в чек-листе, который обновляет модель, например в инструменте задач или в файле. Если ход закончился, а открытые пункты остались и блокер не назван, отправьте короткое сообщение пользователя с их перечнем:

Your task list still has open items: migrate the remaining two endpoints and update their tests. Continue with them. If one is blocked, say what is blocking it.

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

В системном промпте назовите виды преждевременной остановки, которых вы не хотите. Пример Anthropic написан для полностью автономных агентов и ставится в конец системного промпта с первого запроса сессии. Если добавить его на полпути, системный промпт изменится, и прежние блоки рассуждений в разговоре станут недействительными.

A standing instruction from the user, the person you are working for. It is about how your turns end. A message with no tool call in it ends your turn, and the work stops there until you are asked to continue. The user has seen you end turns in four ways while work they asked for was still owed, and does not want any of them. One: a long summary of what was done that closes by announcing the next step and has no tool call, so the next thing never starts. Two: an offer to carry on with something unless the user would prefer otherwise, which stops to wait for an answer the user was not going to give. Three: a list of decisions for the user when, by your own account, none of them blocks the rest of the work. Four: deciding that this is a good place to report, because the turn has been long or a milestone is done. Status notes are welcome, and so are your recommendations on open decisions, but put them in the same message as your next tool call and carry on with whatever does not depend on the user's answer. If you notice yourself inviting the user to redirect you or offering to wait, delete it and do the next thing. The stops the user does want are the ones where nothing can move without them, or where the thing blocking you is deliberately protected from you. This does not override the need for confirmation on risky or destructive actions.

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

Как получать отчёты о ходе работы от агента на Claude Opus 5.5 в долгих запусках?

Между вызовами инструментов Claude Opus 5.5 пишет короткие заметки о ходе работы: что только что нашёл и что сделает дальше. У этой модели такие заметки приходят как блоки thinking, а не text, и по умолчанию их текст пуст, поэтому клиент, который показывает только блоки text, во время длинного хода может казаться зависшим. Anthropic описывает бета-режим отображения, который возвращает сводку каждой заметки; значения thinking.display, описанные для эндпоинта, перечислены в справочнике API Claude Opus 5.5.

Три рычага в промпте и обвязке работают без особых настроек:

• Дайте модели инструмент для дословной передачи. Если ей может понадобиться передать пользователю что-то точное посреди хода, например фрагмент кода, дайте простой инструмент «отправить сообщение пользователю» и скажите использовать его только для этого. Объявите инструмент с первого запроса; если добавить его позже, прежние блоки рассуждений станут недействительными.
• Просите отчитываться в определённые моменты. Например, одной фразой описать намерение перед первым вызовом инструмента и кратко подвести итог в конце. Модель точно следует таким инструкциям, что особенно полезно, когда за работой кто-то наблюдает.
• Подталкивайте «молчащий» ход из обвязки. Считайте подряд идущие шаги с вызовами инструментов, которые ничего не дают пользователю прочитать. После нескольких, например пяти, добавьте напоминание после последних результатов инструментов, а после двух-трёх напоминаний остановитесь. Формулировка Anthropic:

The user hasn't heard from you in a while — say in a few words what you're doing, then continue.

В тестах Anthropic на задачах агентного программирования это напоминание примерно вдвое сократило долю задач с долгим молчанием, без измеримого изменения стоимости.

Как заставить агента на Claude Opus 5.5 изучить контекст перед действием?

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

Before taking any action, explore broadly with tool calls: list and open the emails, documents, spreadsheet tabs and records across the available apps that could be relevant to this task, including ones the task does not explicitly mention, and use what you find.

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

Как ускорить работу команды агентов на Claude Opus 5.5?

Claude Opus 5.5 внимательно следит за прошедшим временем. В схеме, где главный агент раздаёт работу субагентам, дайте ему бюджет времени: пусть ваша обвязка добавляет в конец каждого сообщения, которое возвращается модели, короткую строку вроде elapsed 340s / 1200s. Модель распределяет работу так, чтобы уложиться в бюджет, и обычно заканчивает заметно раньше, поэтому задавайте бюджет чуть выше времени, которое вы на самом деле готовы потратить. Если оценить бюджет нельзя, показывайте только прошедшее время и добавьте в системный промпт фразу:

Time matters here: do not spend time that can be avoided, and the earlier a correct result is obtained, the better.

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

Стоит ли в системном промпте чата просить Claude Opus 5.5 «хорошо подумать»?

Нет. Anthropic советует убирать из системных промптов чата строки вроде «think carefully before answering» («подумай хорошенько, прежде чем отвечать»): модель сама решает, сколько думать, а регулятор для этого — effort. В тестах Anthropic в чат-продукте после удаления такой строки ответы начинались раньше без заметной потери качества.

Есть ещё две строки для чата, о которых стоит знать. Одна заставляет модель считать прежние ответы окончательными, чтобы следующие ходы начинались быстрее. Другая помечает текст, вставленный пользователем, чтобы модель не выполняла инструкции, спрятанные в письме или на веб-странице. Обе строки дословно приведены в разделе о Claude Opus 5.5 руководства по Fable 5.1. Не используйте строку про «окончательные ответы» в длинных аналитических и агентных задачах, где более поздний шаг может выявить ошибку в раннем.

Как получить более точные ответы по графикам, диаграммам и скриншотам?

Сначала перепроверьте. Без дополнительных инструментов Claude Opus 5.5 читает плотные графики, блок-схемы и скриншоты календаря гораздо точнее, чем Claude Opus 5; в тестах Anthropic даже на самом низком уровне effort он считывал значения с плотных графиков точнее, чем Claude Opus 5 на самом высоком. Вспомогательные решения, построенные для прежних моделей, возможно, уже не нужны.

Для самых плотных входных данных по-прежнему помогают две вещи:

• Изображения более высокого разрешения, особенно для технических чертежей.
• Инструменты для работы с изображениями. Запустите модель как агента с контейнером, где лежат исходные изображения и установлены PIL или OpenCV, чтобы она могла обрезать, увеличивать и измерять. Если это слишком тяжело, помогает даже один инструмент обрезки. На более высоких уровнях effort модель лучше пользуется этими инструментами.

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

Как сделать так, чтобы фронтенд от Claude Opus 5.5 не выглядел шаблонно?

Назовите шаблоны, которых вы не хотите. Без указаний по дизайну Claude Opus 5.5 скатывается к нескольким стилям по умолчанию, а общая фраза вроде «избегай типичного ИИ-вида» обычно лишь меняет один стиль по умолчанию на другой. Пример Anthropic перечисляет конкретные вещи, которых надо избегать:

Output a vanilla HTML/CSS personal website with placeholder data. Do not use a cream or off-white background, italic accent words in headlines, numbered "01/02/03" section labels, monospace labels, or pill-shaped buttons.

Работайте итерациями: посмотрите, какие стили первый результат использовал вместо этого, и добавьте их в список.

Почему Claude Opus 5.5 возвращает stop_reason "refusal"?

Запрос отклонил классификатор безопасности. Claude Opus 5.5 использует классификаторы по биологии, кибербезопасности и извлечению рассуждений; отказ приходит как обычный ответ с stop_reason: "refusal" и объектом stop_details, где указана категория.

Об отказах на безобидные запросы в целом см. раздел почему Claude отклоняет безобидный запрос в руководстве по Fable 5.1.

Частые вопросы

Есть ли официальное руководство по промптам для Claude Opus 5.5?

Да. Anthropic публикует «Prompting Claude Opus 5.5» в документации для разработчиков, а также общую страницу с лучшими практиками для всех актуальных моделей Claude. Эта статья пересказывает руководство по Opus 5.5 по состоянию на 3 октября 2026 года и приводит шаблоны дословно.

Какой уровень effort у Claude Opus 5.5 по умолчанию?

medium. У Claude Opus 5 по умолчанию high. Уровни: low, medium, high, xhigh и max, задаются в output_config.effort.

Сколько выходных токенов может написать Claude Opus 5.5?

До 128 000 токенов на запрос, включая рассуждения. Контекстное окно — 1M токенов.

Можно ли предзаполнить ответ Claude Opus 5.5 или задать temperature?

Нет. Предзаполнение ответа ассистента и любая temperature, кроме значения по умолчанию, возвращают ошибку 400, а принудительный вызов конкретного инструмента не поддерживается. Опишите нужный формат в промпте. Чем заменить каждый из этих приёмов, объясняет руководство по промптам для Claude Fable 5.1.

Что лучше для агентов: Claude Opus 5.5 или Claude Fable 5.1?

Зависит от задачи и бюджета; как выбрать, рассказывает сравнение моделей Claude. Советы по промптам различаются в основном значениями по умолчанию: Claude Opus 5.5 начинает с effort medium, Claude Fable 5.1 — с high.

Попробуйте промпты

Запускайте эти шаблоны на Claude Opus 5.5 с ключом SeedRouter через Anthropic SDK или форматы OpenAI Chat Completions и Responses. В справочнике API Claude Opus 5.5 перечислены все параметры, а на странице модели показаны актуальные цены за токен. SeedRouter работает по модели оплаты по факту: одно пополнение, кредиты не сгорают, а неудачные запросы не оплачиваются.