Effort

Параметр «effort» (усилие) позволяет контролировать, сколько токенов Claude тратит при ответе на запросы. Вы можете балансировать между полнотой ответа и эффективностью использования токенов в рамках одной модели. Параметр effort доступен для всех поддерживаемых моделей без необходимости указывать бета-заголовок.



Как работает effort

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

Параметр effort влияет на все токены в ответе, включая:

• Текстовые ответы и пояснения
• Вызовы инструментов и аргументы функций
• Мышление (когда оно активно)

У этого подхода есть два основных преимущества:

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



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

xhigh — более новый уровень; некоторые модели, поддерживающие max, не поддерживают xhigh.



Рекомендуемые уровни усилия для Claude Sonnet 5

Claude Sonnet 5 по умолчанию использует уровень усилия high в Claude API и Claude Code.

• Высокий уровень (по умолчанию): Подходит для сложных рассуждений, программирования и агентных задач, где качество важнее скорости или стоимости.
• Уровень xhigh: Для самых сложных задач программирования и агентных задач. См. Создание подсказок для Claude Sonnet 5.
• Средний уровень: Экономичный шаг вниз от значения по умолчанию. Сопоставим с Claude Sonnet 4.6 на высоком уровне усилия.
• Низкий уровень: Для высоконагруженных или чувствительных к задержкам рабочих нагрузок. Подходит для чата и сценариев, не связанных с программированием, где приоритетом является более быстрый отклик.
• Уровень max: Для задач, требующих абсолютно максимальных возможностей без ограничений на расход токенов.



Рекомендуемые уровни усилия для Claude Sonnet 4.6

Sonnet 4.6 по умолчанию использует уровень усилия high. Явно задавайте effort при использовании Sonnet 4.6, чтобы избежать неожиданных задержек:

• Средний уровень (рекомендуемое значение по умолчанию): Наилучший баланс скорости, стоимости и производительности для большинства приложений. Подходит для агентного программирования, рабочих процессов с интенсивным использованием инструментов и генерации кода.
• Низкий уровень: Для высоконагруженных или чувствительных к задержкам рабочих нагрузок. Подходит для чата и сценариев, не связанных с программированием, где приоритетом является более быстрый отклик.
• Высокий уровень: Для сложных рассуждений и задач, где качество важнее скорости или стоимости.
• Уровень max: Для задач, требующих абсолютно максимальных возможностей без ограничений на расход токенов.



Рекомендуемые уровни усилия для Claude Opus 4.7

Начинайте с xhigh для задач программирования и агентных сценариев и используйте high как минимум для большинства рабочих нагрузок, чувствительных к интеллектуальным возможностям. Переходите на medium для рабочих нагрузок, чувствительных к стоимости, или повышайте до max только тогда, когда ваши оценки показывают измеримый запас на уровне xhigh.

Значение по умолчанию в API — high. Чтобы использовать xhigh, задайте effort явно; переданное вами значение переопределяет значение по умолчанию.

Claude Opus 4.7 также строже соблюдает уровни усилия, чем Claude Opus 4.6, особенно на уровнях low и medium. При более низких уровнях усилия модель ограничивает свою работу тем, что было запрошено, а не делает больше, чем требуется. Если вы наблюдаете поверхностные рассуждения по сложным задачам с Claude Opus 4.7, повысьте уровень усилия, а не пытайтесь обойти это с помощью подсказок. Если вам необходимо сохранить низкий уровень усилия ради задержки, добавьте целевые указания вроде «Эта задача включает многошаговое рассуждение. Тщательно подумайте перед ответом».

При запуске Claude Opus 4.7 с уровнем усилия xhigh или max задайте большое значение max_tokens, чтобы у модели было пространство для размышления и действий через субагентов и вызовы инструментов. Начать с 64k токенов и настраивать дальше — разумное значение по умолчанию.



Рекомендуемые уровни усилия для Claude Opus 4.8

Рекомендации для Claude Opus 4.7 также применимы к Claude Opus 4.8. Начинайте с xhigh для задач программирования и агентных сценариев, используйте high для большинства других рабочих нагрузок, чувствительных к интеллектуальным возможностям, и переходите на medium или low только тогда, когда вы измерили, что более низкий уровень сохраняет качество на ваших оценках.

Значение по умолчанию в API — high. Задайте effort явно, чтобы использовать другой уровень; переданное вами значение переопределяет значение по умолчанию.

При запуске Claude Opus 4.8 с уровнем усилия xhigh или max задайте большое значение max_tokens, чтобы у модели было пространство для размышления и действий через субагентов и вызовы инструментов. Начать с 64k токенов и настраивать дальше — разумное значение по умолчанию.



Рекомендуемые уровни усилия для Claude Opus 5

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

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

Значение по умолчанию в API — high. Задайте effort явно, чтобы использовать другой уровень; переданное вами значение переопределяет значение по умолчанию.

В Claude Opus 5 мышление нельзя отключить на уровнях усилия xhigh или max: запросы, устанавливающие thinking: {"type": "disabled"} на этих уровнях, возвращают ошибку 400. См. Effort с мышлением.

При запуске Claude Opus 5 с уровнем усилия xhigh или max задайте большое значение max_tokens, чтобы у модели было пространство для размышления и действий через субагентов и вызовы инструментов. Начать с 64k токенов и настраивать дальше — разумное значение по умолчанию.



Рекомендуемые уровни усилия для Claude Fable 5

Effort — это основной инструмент для балансировки интеллектуальных возможностей, задержки и стоимости в Claude Fable 5. Начинайте с high, значения по умолчанию, для большинства задач, используйте xhigh для рабочих нагрузок, наиболее чувствительных к возможностям, и переходите на medium или low для рутинной работы. Более низкие настройки effort в Claude Fable 5 по-прежнему работают хорошо и часто превосходят производительность xhigh на предыдущих моделях. На уровнях high и xhigh задавайте большое значение max_tokens: это жёсткое ограничение на общий вывод — мышление плюс текст ответа. См. Контроль затрат.

Снижайте effort, если задача выполняется, но занимает больше времени, чем необходимо, или если вам нужен более быстрый, более интерактивный стиль работы. Те же рекомендации применимы к Claude Mythos 5. Более полные рекомендации см. в разделе Создание подсказок для Claude Fable 5.



Базовое использование

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-5",
    max_tokens=4096,
    messages=[
        {
            "role": "user",
            "content": "Analyze the trade-offs between microservices and monolithic architectures",
        }
    ],
    output_config={"effort": "medium"},
)

for block in response.content:
    if block.type == "text":
        print(block.text)



Когда настраивать параметр effort

• Используйте уровень max, когда вам нужны абсолютно максимальные возможности без ограничений: наиболее тщательное рассуждение и глубочайший анализ. Доступен для моделей Claude 4.6 и более поздних, а также Claude Mythos Preview.
• Используйте уровень xhigh для продвинутого программирования и сложной агентной работы, требующей расширенного исследования, например многократных вызовов инструментов и детального поиска. Доступен для Claude Fable 5, Claude Mythos 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7 и Claude Sonnet 5.
• Используйте высокий уровень (по умолчанию) для сложных рассуждений, тонкого анализа, трудных задач программирования или любых задач, где качество важнее скорости или стоимости.
• Используйте средний уровень как сбалансированный вариант, когда вам нужна надёжная производительность без полного расхода токенов, характерного для высокого уровня.
• Используйте низкий уровень, когда вы оптимизируете скорость (поскольку Claude отвечает меньшим количеством токенов) или стоимость. Например, для простых задач классификации, быстрых справок или высоконагруженных сценариев, где незначительные улучшения качества не оправдывают дополнительную задержку или расходы.



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

При использовании инструментов параметр effort влияет как на пояснения вокруг вызовов инструментов, так и на сами вызовы инструментов. Более низкие уровни усилия, как правило:

• Объединяют несколько операций в меньшее число вызовов инструментов
• Делают меньше вызовов инструментов
• Переходят непосредственно к действию без вступления
• Используют краткие подтверждающие сообщения после завершения

Более высокие уровни усилия могут:

• Делать больше вызовов инструментов
• Объяснять план перед выполнением действия
• Предоставлять подробные сводки изменений
• Включать более полные комментарии к коду



Effort с мышлением

Параметр thinking управляет тем, думает ли Claude в блоках мышления перед ответом; параметр effort управляет тем, сколько работы Claude вкладывает во весь ответ, что в адаптивном режиме включает то, как часто и насколько глубоко он думает. Не передавайте adaptive в качестве значения effort: adaptive — это режим мышления, а не уровень усилий.

При более высоких уровнях усилия Claude размышляет над большинством запросов и более подробно; при более низких уровнях он может полностью пропустить мышление для более простых задач. См. Мышление и effort для полного руководства о том, как эти два элемента управления работают вместе.

В Claude Opus 4.5 — единственной модели только с расширенным мышлением, поддерживающей effort, — он работает совместно с budget_tokens: задайте уровень усилия для вашей задачи, затем установите бюджет токенов мышления в зависимости от того, какая глубина рассуждения требуется задаче.

О доступности мышления для каждой модели см. в таблице конфигурации по моделям. Effort работает как с мышлением, так и без него; см. Как работает effort.



Изменение effort в ходе разговора

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



Рекомендации

1. Задавайте effort явно: API по умолчанию использует high, но правильная отправная точка зависит от вашей модели и рабочей нагрузки.
2. Используйте низкий уровень для чувствительных к скорости или простых задач: Когда важна задержка или задачи просты, низкий уровень усилия может значительно сократить время отклика и затраты.
3. Тестируйте свой сценарий использования: Влияние уровней усилия варьируется в зависимости от типа задачи. Оцените производительность на ваших конкретных сценариях использования перед развёртыванием.
4. Рассмотрите динамический effort: Настраивайте effort в зависимости от сложности задачи. Простые запросы могут требовать низкого уровня усилия, тогда как агентное программирование и сложные рассуждения выигрывают от высокого уровня. См. следующий пункт, прежде чем варьировать его в рамках одного разговора.
5. Сохраняйте effort постоянным в кэшированных разговорах: Изменение значения effort между запросами делает недействительным кэширование подсказок, поэтому варьируйте effort между рабочими нагрузками, а не внутри разговора, который полагается на попадания в кэш. См. Мышление и кэширование подсказок.



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