Адаптивное мышление

Адаптивное мышление — это рекомендуемый способ использования расширенного мышления с Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5 и Claude Sonnet 4.6. В Claude Fable 5 и Claude Mythos 5 мышление всегда включено и не может быть отключено; адаптивное мышление — единственный режим мышления. В Claude Mythos Preview адаптивное мышление является режимом по умолчанию и применяется автоматически, когда параметр thinking не задан. Вместо ручной установки бюджета токенов мышления адаптивное мышление позволяет Claude динамически определять, когда и в каком объёме использовать расширенное мышление, исходя из сложности каждого запроса. В Claude Opus 4.8 и Claude Opus 4.7 адаптивное мышление — единственный поддерживаемый режим мышления; ручная настройка thinking: {type: "enabled", budget_tokens: N} больше не принимается. В Claude Sonnet 5 адаптивное мышление включено по умолчанию; передайте thinking: {type: "disabled"}, чтобы отключить его, а ручная настройка {type: "enabled", budget_tokens: N} отклоняется с ошибкой 400.



Поддерживаемые модели

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

• Claude Fable 5 (claude-fable-5) и Claude Mythos 5 (claude-mythos-5) — адаптивное мышление всегда включено; thinking: {type: "disabled"} не поддерживается
• Claude Mythos Preview (claude-mythos-preview) — адаптивное мышление используется по умолчанию; thinking: {type: "disabled"} не поддерживается
• Claude Opus 4.8 (claude-opus-4-8) — адаптивное мышление является единственным поддерживаемым режимом мышления. Мышление отключено, если вы явно не укажете thinking: {type: "adaptive"} в своём запросе; ручная настройка thinking: {type: "enabled"} отклоняется с ошибкой 400.
• Claude Opus 4.7 (claude-opus-4-7) — адаптивное мышление является единственным поддерживаемым режимом мышления. Мышление отключено, если вы явно не укажете thinking: {type: "adaptive"} в своём запросе; ручная настройка thinking: {type: "enabled"} отклоняется с ошибкой 400.
• Claude Opus 4.6 (claude-opus-4-6)
• Claude Sonnet 5 (claude-sonnet-5) — адаптивное мышление включено по умолчанию; ручная настройка {type: "enabled"} отклоняется с ошибкой 400.
• Claude Sonnet 4.6 (claude-sonnet-4-6)



Как работает адаптивное мышление

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

Адаптивное мышление также автоматически включает чередующееся мышление («interleaved thinking»). Это означает, что Claude может размышлять между вызовами инструментов, что делает его особенно эффективным для агентных рабочих процессов.



Как использовать адаптивное мышление

Установите thinking.type в значение "adaptive" в вашем запросе к API:

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    thinking={"type": "adaptive"},
    messages=[
        {
            "role": "user",
            "content": "Explain why the sum of two even numbers is always even.",
        }
    ],
)

for block in response.content:
    if block.type == "thinking":
        print(f"\nThinking: {block.thinking}")
    elif block.type == "text":
        print(f"\nResponse: {block.text}")



Адаптивное мышление с параметром effort

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

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    thinking={"type": "adaptive"},
    output_config={"effort": "medium"},
    messages=[{"role": "user", "content": "What is the capital of France?"}],
)

print(response.content[0].text)



Потоковая передача с адаптивным мышлением

Адаптивное мышление без проблем работает с потоковой передачей. Блоки мышления передаются потоком через события thinking_delta так же, как и в ручном режиме мышления:

client = anthropic.Anthropic()

with client.messages.stream(
    model="claude-opus-4-8",
    max_tokens=16000,
    thinking={"type": "adaptive"},
    messages=[
        {
            "role": "user",
            "content": "What is the greatest common divisor of 1071 and 462?",
        }
    ],
) as stream:
    for event in stream:
        if event.type == "content_block_start":
            print(f"\nStarting {event.content_block.type} block...")
        elif event.type == "content_block_delta":
            if event.delta.type == "thinking_delta":
                print(event.delta.thinking, end="", flush=True)
            elif event.delta.type == "text_delta":
                print(event.delta.text, end="", flush=True)



Адаптивное, ручное и отключённое мышление



Важные соображения



Изменения валидации

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



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

Последовательные запросы с использованием adaptive мышления сохраняют точки разрыва кэша подсказок. Однако переключение между режимами мышления adaptive и enabled/disabled нарушает точки разрыва кэша для сообщений. Системные подсказки и определения инструментов остаются кэшированными независимо от смены режима.



Настройка поведения мышления

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

Extended thinking adds latency and should only be used when it
will meaningfully improve answer quality, typically for problems
that require multi-step reasoning. When in doubt, respond directly.

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

This task involves multi-step reasoning. Think carefully before responding.

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

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



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

Используйте max_tokens как жёсткое ограничение на общий вывод (мышление + текст ответа). Параметр effort предоставляет дополнительное мягкое указание на то, сколько мышления выделяет Claude. Вместе они дают вам эффективный контроль над затратами.

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



Работа с блоками мышления

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



Суммаризированное мышление

При включённом расширенном мышлении Messages API для моделей Claude 4 возвращает сводку полного процесса мышления Claude. Суммированное мышление обеспечивает все интеллектуальные преимущества расширенного мышления, одновременно предотвращая злоупотребления. Это поведение по умолчанию для моделей Claude 4, когда поле display в конфигурации мышления не задано или установлено в значение "summarized". В Claude Fable 5, Claude Mythos 5, Claude Sonnet 5, Claude Opus 4.8, Claude Opus 4.7 и Claude Mythos Preview значение display по умолчанию равно "omitted", поэтому для получения суммированного мышления необходимо явно задать display: "summarized".

Вот несколько важных соображений относительно суммированного мышления:

• Плата взимается за полное количество токенов мышления, сгенерированных исходным запросом, а не за токены сводки.
• Количество выходных токенов, за которые выставляется счёт, не будет совпадать с количеством токенов, которые вы видите в ответе.
• В моделях Claude 4 первые несколько строк вывода мышления более подробны и содержат детальные рассуждения, что особенно полезно для целей инженерии подсказок. Claude Mythos Preview суммирует с первого токена, поэтому его блоки мышления не содержат этой подробной преамбулы.
• Поскольку Anthropic стремится улучшать функцию расширенного мышления, поведение суммирования может изменяться.
• Суммирование сохраняет ключевые идеи процесса мышления Claude с минимальной дополнительной задержкой, обеспечивая возможность потоковой передачи для пользователя.
• Суммирование обрабатывается моделью, отличной от той, которую вы указываете в своих запросах. Модель мышления не видит суммированный вывод.



Управление отображением мышления

Поле display в конфигурации мышления управляет тем, как содержимое мышления возвращается в ответах API. Оно принимает два значения:

• "summarized": блоки мышления содержат обобщённый текст мышления. Подробнее см. в разделе Обобщённое мышление. Это значение по умолчанию для Claude Opus 4.6, Claude Sonnet 4.6 и более ранних моделей Claude 4.
• "omitted": блоки мышления возвращаются с пустым полем thinking. Поле signature по-прежнему содержит зашифрованное полное мышление для обеспечения непрерывности в многоходовых диалогах (см. Шифрование мышления). Это значение по умолчанию для Claude Fable 5, Claude Mythos 5, Claude Sonnet 5, Claude Opus 4.8, Claude Opus 4.7 и Claude Mythos Preview.

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

Вот несколько важных соображений относительно опущенного мышления:

• Вы по-прежнему оплачиваете полное количество токенов мышления. Опущение снижает задержку, но не стоимость.
• Если вы передаёте блоки мышления обратно в многоходовых диалогах, передавайте их без изменений. Сервер расшифровывает signature, чтобы восстановить исходное мышление для построения подсказки (см. Сохранение блоков мышления). Любой текст, который вы помещаете в поле thinking возвращаемого опущенного блока, игнорируется.
• Параметр display недопустим при thinking.type: "disabled" (отображать нечего).
• При использовании thinking.type: "adaptive", если модель пропускает мышление для простого запроса, блок мышления не создаётся независимо от значения display.

thinking = {
    "type": "adaptive",
    "display": "summarized",
}

Примеры кода и поведение потоковой передачи с display: "omitted" см. в разделе Управление отображением мышления на странице расширенного мышления. В примерах там используется type: "enabled"; с адаптивным мышлением используйте:

thinking = {"type": "adaptive", "display": "omitted"}



Шифрование мышления

Полное содержимое мышления шифруется и возвращается в поле signature. Это поле используется для проверки того, что блоки мышления были сгенерированы Claude, когда они передаются обратно в API.

Вот несколько важных соображений относительно шифрования мышления:

• При потоковой передаче ответов подпись добавляется через signature_delta внутри события content_block_delta непосредственно перед событием content_block_stop.
• Значения signature в моделях Claude 4 значительно длиннее, чем в предыдущих моделях.
• Поле signature является непрозрачным полем и не должно интерпретироваться или анализироваться.
• Значения signature совместимы между платформами (API Claude, Amazon Bedrock и Google Cloud). Значения, сгенерированные на одной платформе, будут совместимы с другой.



Вывод мышления в Claude Fable 5 и Claude Mythos 5

В Claude Fable 5 и Claude Mythos 5 необработанная цепочка рассуждений никогда не возвращается. Блоки мышления, которые вы получаете, — это обычные блоки thinking, а не redacted_thinking. Настройка thinking.display работает так же, как и в других моделях:

• "summarized" возвращает читаемую сводку рассуждений.
• "omitted" (значение по умолчанию в этих моделях) по-прежнему включает блоки thinking в ответы, но их поле thinking является пустой строкой.

Форму ответа для блоков мышления см. в справочнике Messages API.

При продолжении разговора на той же модели передавайте каждый блок мышления обратно в API точно в том виде, в каком он был получен, включая блоки, у которых поле thinking пустое. Не редактируйте и не реконструируйте их. Чтение текста сводки для отображения допустимо: API отклоняет блоки, содержимое которых было изменено, а не блоки, которые вы прочитали.

При переключении моделей, например после резервного переключения при отказе классификатора, удалите блоки thinking и redacted_thinking из предыдущих ходов ассистента. Блоки мышления привязаны к модели, которая их создала. Другие модели молча игнорируют их, а не отклоняют запрос, но игнорируемые блоки всё равно добавляют входные токены.

Два исключения, описанные в разделе Кредит резервного переключения:

• Повторные попытки с кредитом резервного переключения должны передавать тело отклонённого запроса без изменений.
• Блоки fallback от резервного переключения посреди вывода остаются там, где они появились.

Чтобы получить представление о рассуждениях модели, читайте блоки thinking, описанные в этом разделе, вместо того чтобы запрашивать рассуждения в тексте ответа. В Claude Fable 5 запрос, который пытается извлечь внутренние рассуждения модели как часть текста ответа, может быть отклонён с stop_details.category: "reasoning_extraction". См. Категории отказов для справки по полям и рекомендаций по обработке.



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

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

Процесс мышления влечёт за собой расходы за:

• Токены, использованные во время мышления (выходные токены)
• Блоки мышления из предыдущих ходов ассистента, сохранённые в контексте: только последний ход в более ранних моделях Opus/Sonnet и во всех моделях Haiku; все ходы по умолчанию в Opus 4.5+ и Sonnet 4.6+ (входные токены)
• Стандартные текстовые выходные токены

При использовании суммаризированного мышления:

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

При использовании display: "omitted":

• Входные токены: токены в вашем исходном запросе (так же, как при суммаризации)
• Выходные токены (тарифицируемые): исходные токены мышления, которые Claude сгенерировал внутренне (так же, как при суммаризации)
• Выходные токены (видимые): ноль токенов мышления (поле thinking пустое)

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

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

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



Дополнительные темы

Страница расширенного мышления более подробно рассматривает несколько тем с примерами кода для конкретных режимов:

• Использование инструментов с мышлением: те же правила применяются для адаптивного мышления: сохраняйте блоки мышления между вызовами инструментов и учитывайте ограничения tool_choice, когда мышление активно.
• Кэширование подсказок: при адаптивном мышлении последовательные запросы с использованием одного и того же режима мышления сохраняют точки разрыва кэша. Переключение между режимами adaptive и enabled/disabled нарушает точки разрыва кэша для сообщений (системные подсказки и определения инструментов остаются кэшированными).
• Контекстные окна: как токены мышления взаимодействуют с max_tokens и ограничениями контекстного окна.



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