Claude Platform Docs
СообщенияРазмышления

Управление размышлениями

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

Размышления Claude адаптивны: модель оценивает каждый запрос и решает, размышлять ли и в каком объёме. Вы задаёте намерение, при желании указываете уровень усилий, и модель распределяет рассуждения туда, где они, скорее всего, помогут.

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

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

Как Claude решает, когда размышлять

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

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

Основным инструментом управления этим решением является параметр effort (уровень усилий), который служит мягким ориентиром того, как часто и насколько глубоко Claude использует размышления; что делает каждый уровень, см. в разделе Уровни усилий на этой странице.

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

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

Полные сведения о взаимодействии конфигурации размышлений и параметра effort см. в разделе Размышления и уровень усилий.

Управление тем, как часто Claude размышляет

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

Используйте оба рычага вместе в следующем порядке:

  1. Установите уровень усилий, соответствующий балансу качества и задержки по умолчанию для вашей нагрузки.
  2. Добавляйте указания в подсказку только в том случае, если на этом уровне срабатывание размышлений Claude всё ещё не соответствует вашим потребностям.

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

Уровни усилий

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

Уровень усилийПоведение размышлений
maxClaude размышляет наиболее охотно и с наибольшей глубиной, без ограничений на длину размышлений.
xhighClaude размышляет охотнее и глубже, чем на уровне high; подходит для расширенного исследования.
high (по умолчанию для большинства моделей)Claude размышляет в большинстве запросов, которым это полезно. Обеспечивает глубокие рассуждения в сложных задачах.
medium (по умолчанию для Claude Opus 5.5 и Claude Haiku 5.5)Claude использует умеренные размышления. Может пропускать размышления для простых запросов.
lowClaude сводит размышления к минимуму. Пропускает размышления в простых задачах, где важнее всего скорость.

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

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

Уровень усилий задаётся в output_config.effort, а не внутри объекта thinking; полные примеры для каждого языка см. в разделе Установка уровня усилий.

{
  "model": "claude-opus-5-5",
  "max_tokens": 4096,
  "output_config": { "effort": "medium" },
  "messages": [{ "role": "user", "content": "..." }]
}

Доступность уровней зависит от модели; таблица доступности уровней усилий на странице об уровне усилий является источником сведений о том, какие уровни поддерживает каждая модель.

Указания в системной подсказке

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

Extended 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.

Чтобы, наоборот, поощрить размышления, используйте фразу, например:

This task involves multistep reasoning. Think carefully before responding.

Эффективность управления может зависеть от точной формулировки. Если одна формулировка не даёт нужного поведения, попробуйте более прямой вариант.

Управление на уровне отдельных сообщений

Вы также можете управлять размышлениями на уровне отдельных сообщений из хода пользователя, независимо от системной подсказки. Добавление "Please think hard before responding." к сообщению пользователя побуждает Claude размышлять на этом ходе; "Answer directly without deliberating." — отбивает у него такое желание.

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

В Claude Haiku 5.5 и Claude Fable 5.2 отговаривающая фраза не сокращает размышления надёжно. В тестах Anthropic она не останавливала размышления Claude Fable 5.2 на уровне усилий medium и выше. Там, где ваша платформа это поддерживает, вместо этого выполняйте рутинные ходы на этих моделях с меньшим объёмом размышлений, используя изменение уровня усилий для отдельного сообщения. Эта бета-функция также сохраняет prompt cache (кэш подсказок).

Проверка управления на вашей нагрузке

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

Механизмы

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

Валидация ходов

Ходы ассистента не обязаны начинаться с блока размышлений. (Модели, использующие устаревший ручной бюджет размышлений, требуют, чтобы последний ход ассистента в запросе с включёнными размышлениями начинался с такого блока; см. Структура ходов в ручном режиме.)

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

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

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

Кэширование подсказок

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

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

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

Контроль затрат

Вы не задаёте бюджет токенов на размышления. Затраты ограничивают два механизма:

  • max_tokens — жёсткий предел общего вывода для запроса, включая размышления и текст ответа. Claude никогда не генерирует сверх него. В цикле использования инструментов у каждого запроса в ходе свой max_tokens, поэтому он не ограничивает расход всего хода.
  • effort — мягкий ориентир того, какую часть этого вывода Claude отводит на размышления. Он формирует поведение, но не гарантирует определённого количества токенов.

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

На уровне усилий high и выше Claude может размышлять обширно и с большей вероятностью исчерпать бюджет. Если вы видите в ответах stop_reason: "max_tokens", у вас есть два варианта решения:

  • Увеличьте max_tokens, чтобы дать модели больше места для размышлений и ответа.
  • Понизьте уровень усилий, чтобы Claude размышлял меньше и оставлял большую часть бюджета для текста ответа.

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

Ценообразование

Размышления влекут за собой оплату:

  • Токенов, которые Claude использует во время размышлений (оплачиваются как выходные токены)
  • Блоков размышлений из предыдущих ходов ассистента, остающихся в контексте, согласно поведению сохранения по умолчанию: по умолчанию все ходы на моделях, сохраняющих все блоки, и только последний ход на остальных (оплачиваются как входные токены)
  • Стандартных выходных текстовых токенов

То, за что выставляется счёт, не зависит от настройки display; меняется только то, что вы видите:

display: "summarized"display: "omitted"
Входные токеныТокены в вашем исходном запросеТак же, как при summarized
Выходные токены (оплачиваемые)Все токены размышлений, сгенерированные Claude внутреннеТак же, как при summarized
Выходные токены (видимые)Сводный текст размышленийНоль токенов размышлений (поле thinking пустое)
Генерация сводкиБесплатноНеприменимо

Чтобы узнать, сколько оплачиваемых выходных токенов было потрачено на внутренние рассуждения, прочитайте usage.output_tokens_details.thinking_tokens в ответе. Это значение отражает необработанные рассуждения, сгенерированные моделью (а не сводный текст, возвращаемый в теле ответа), и всегда меньше или равно output_tokens. Вычтите его из output_tokens, чтобы приблизительно оценить часть вывода, не относящуюся к рассуждениям. При использовании «streaming» (потоковая передача) эта разбивка появляется только в последнем событии message_delta.

{
  "usage": {
    "input_tokens": 25,
    "output_tokens": 348,
    "output_tokens_details": {
      "thinking_tokens": 312
    }
  }
}

output_tokens остаётся итоговым, авторитетным общим значением, используемым для выставления счетов. output_tokens_details — разбивка только для чтения, предназначенная для наблюдаемости. Полную информацию о ценах, включая базовые ставки, запись в кэш, попадания в кэш и выходные токены, см. на странице Цены.

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

Включайте размышления, читайте их вывод и проверяйте поддержку для каждой модели.

Сохраняйте блоки размышлений между вызовами инструментов и управляйте размышлениями в многоходовых диалогах.

Управляйте тем, сколько размышлений и вывода Claude выделяет на каждый запрос.

Эта страница была полезной?