Расширенные размышления
Настройте ручные расширенные размышления с фиксированным бюджетом budget_tokens на моделях Claude, которые их поддерживают, и перейдите на адаптивные размышления.
Расширенные размышления (thinking.type: "enabled" с budget_tokens) устарели. Модели Claude 4.7 и более новые их не поддерживают и отклоняют запросы, которые их используют, возвращая ошибку 400.
«Extended thinking» (расширенные размышления) в ручном режиме дают вам прямой контроль над тем, сколько Claude думает. Вы задаёте бюджет токенов размышлений в каждом запросе с помощью thinking: {type: "enabled", budget_tokens: N}, и Claude думает в рамках этого бюджета, прежде чем приступить к окончательному ответу. Ручной режим остаётся полезным, когда ваша рабочая нагрузка требует предсказуемой задержки или точного контроля над затратами на размышления. На этой странице рассказывается, как задавать и настраивать бюджет, как ручной режим взаимодействует с чередующимися размышлениями и «prompt caching» (кэшированием подсказок), а также как перейти на адаптивные размышления.
Чтобы узнать, как работают сами размышления, включая блоки размышлений и форму ответа, параметр display, «streaming» (потоковую передачу), размышления с «tool use» (использованием инструментов) и шифрование, см. Размышления.
Поддерживаемые модели
Доступность расширенных размышлений для каждой модели, включая модели, в которых расширенные размышления являются единственным режимом, указана в таблице конфигурации по моделям.
Как использовать расширенные размышления
Вот пример использования расширенных размышлений в Messages API:
client = anthropic.Anthropic()
response = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=16000,
thinking={"type": "enabled", "budget_tokens": 10000},
messages=[
{
"role": "user",
"content": "Are there an infinite number of prime numbers such that n mod 4 == 3?",
}
],
)
# Ответ содержит блоки с кратким изложением размышлений и текстовые блоки
for block in response.content:
match block.type:
case "thinking":
print(f"\nThinking summary: {block.thinking}")
case "text":
print(f"\nResponse: {block.text}")Чтобы включить ручные расширенные размышления, добавьте объект thinking с параметром type, установленным в enabled, и значением budget_tokens.
Параметр budget_tokens задаёт целевое количество токенов, которое Claude может использовать для своего внутреннего процесса рассуждения. Больший бюджет может улучшить качество ответа, позволяя проводить более тщательный анализ сложных задач.
Правила и настройка бюджета
budget_tokens должен удовлетворять следующим ограничениям:
- Минимум 1 024 токена. API отклоняет меньшие значения.
- Меньше
max_tokens. Токены размышлений учитываются в лимитеmax_tokensдля хода, поэтому бюджет должен оставлять место для окончательного ответа. Единственное исключение — чередующиеся размышления в ручном режиме, гдеbudget_tokensможет превышатьmax_tokens, поскольку бюджет охватывает все блоки размышлений в пределах одного хода ассистента. - Без предварительного прогрева кэша. Поскольку
budget_tokensдолжен быть меньшеmax_tokens, расширенные размышления нельзя сочетать сmax_tokens: 0(предварительный прогрев кэша).
Бюджет является целевым значением, а не строгим ограничением. Фактическое использование токенов зависит от задачи, и Claude может прекратить рассуждение задолго до исчерпания бюджета; max_tokens остаётся жёстким пределом общего вывода.
На Claude Opus 4.5 — единственной модели, поддерживающей только расширенные размышления, которая поддерживает уровень усилий, — уровень усилий определяет ответ в целом, тогда как budget_tokens задаёт глубину размышлений; задавайте оба параметра.
Чтобы настроить бюджет:
- Подбирайте начальное значение под задачу. Для простых задач начните около минимума в 1 024 токена и постепенно увеличивайте его, чтобы найти оптимальный диапазон для вашего сценария. Для сложных задач начните с большего бюджета — 16 000 токенов или более — и корректируйте его в соответствии с вашими требованиями к задержке и качеству. Более высокие бюджеты позволяют проводить более всестороннее рассуждение, но с убывающей отдачей, зависящей от задачи, и ценой увеличения задержки. Для критически важных задач протестируйте разные настройки, чтобы найти правильный баланс.
- Для бюджетов размышлений свыше 32k используйте пакетную обработку, чтобы избежать сетевых проблем. Принуждение модели думать более чем на 32k токенов порождает длительные запросы, которые могут столкнуться с системными тайм-аутами и лимитами открытых соединений.
Чтобы отслеживать, во что вам фактически обходится бюджет, следите за полем usage.output_tokens_details.thinking_tokens в ответе, которое сообщает, сколько из оплачиваемых выходных токенов пришлось на внутреннее рассуждение. При потоковой передаче эта разбивка появляется только в финальном событии message_delta.
Когда вы будете готовы отказаться от ручных бюджетов, см. раздел Переход на адаптивные размышления.
Чередующиеся размышления в ручном режиме
«Interleaved thinking» (чередующиеся размышления) позволяют Claude размышлять между вызовами инструментов в пределах одного хода ассистента, рассуждая о каждом результате инструмента, прежде чем решить, что делать дальше. О самой концепции, структуре хода и поведении на моделях с адаптивными размышлениями см. раздел чередующиеся размышления в обзоре размышлений. В этом разделе описано, как включить их при использовании ручных размышлений type: "enabled".
На Claude Opus 4.5, Claude Sonnet 4.5 (устарела) и более ранних моделях Claude 4 добавьте «beta header» (бета-заголовок) interleaved-thinking-2025-05-14 в ваш запрос к API.
Поколение 4.6 в ручном режиме разделяется:
- Claude Sonnet 4.6: бета-заголовок с ручным
type: "enabled"по-прежнему работает, но объявлен устаревшим. Предпочитайте адаптивные размышления, которые чередуются автоматически без заголовка. - Claude Opus 4.6: в ручном режиме чередующихся размышлений нет вообще. Чередуется только его адаптивный режим, поэтому переключитесь на
thinking: {type: "adaptive"}, если вам нужно рассуждение между вызовами инструментов на этой модели.
Claude Haiku 4.5 не поддерживает чередующиеся размышления. В Claude API бета-заголовок принимается, но игнорируется.
Ещё два соображения для чередующихся размышлений в ручном режиме:
budget_tokensздесь может превышатьmax_tokens; правила бюджета объясняют это исключение.- Чередующиеся размышления поддерживаются только для инструментов, используемых через Messages API.
Платформы по-разному обрабатывают бета-заголовок. Claude API, Claude Platform on AWS и Claude Models on Google Cloud (Anthropic managed) принимают interleaved-thinking-2025-05-14 для любой модели и игнорируют его там, где он не поддерживается. Принятие заголовка не означает, что он действует: на моделях, которые отклоняют type: "enabled" (4.7 и более поздние) или не поддерживают чередование в ручном режиме (Claude Opus 4.6), заголовок не влияет на ручной режим; на этих моделях адаптивные размышления выполняют чередование автоматически.
Платформы, управляемые партнёрами, — Claude Models on Google Cloud (Google managed) и Amazon Bedrock (bedrock-mantle) — принимают этот заголовок для любой модели, не возвращая ошибку, и игнорируют его для моделей, которые не поддерживают чередующиеся размышления.
Структура хода в ручном режиме
Общие правила структуры хода, включая цикл использования инструментов в рамках одного хода, обработку конфликтов в середине хода и переключение размышлений между ходами, описаны в разделе Размышления при использовании инструментов.
Ручной режим добавляет одно требование: последний ход ассистента в запросе с включёнными размышлениями должен начинаться с блока размышлений (адаптивные размышления снимают это требование). Изменение конфигурации размышлений между ходами также делает недействительным кэширование подсказок; см. следующий раздел.
Кэширование подсказок в ручном режиме
Ручной режим добавляет одно правило поверх не зависящего от режима поведения кэширования, описанного в разделе Размышления и кэширование подсказок: изменение budget_tokens между запросами делает недействительными точки останова кэша, так же как и переключение режимов размышлений, поскольку значение бюджета отображается в подсказке. Точки останова на уровне сообщений всегда дают промах после изменения бюджета; дадут ли промах также точки останова инструментов и системной подсказки, зависит от того, где модель отображает конфигурацию.
На практике выберите бюджет и держите его стабильным на протяжении всей жизни кэшированного разговора. Запуск многоходового разговора с кэшированием на уровне сообщений на Claude Sonnet 4.6 и изменение бюджета в третьем запросе с 4 000 до 8 000 токенов наглядно показывает инвалидацию:
First request - establishing cache
First response usage: { cache_creation_input_tokens: 1370, cache_read_input_tokens: 0, input_tokens: 17, output_tokens: 700 }
Second request - same thinking parameters (cache hit expected)
Second response usage: { cache_creation_input_tokens: 0, cache_read_input_tokens: 1370, input_tokens: 303, output_tokens: 874 }
Third request - different thinking budget (cache miss expected)
Third response usage: { cache_creation_input_tokens: 1370, cache_read_input_tokens: 0, input_tokens: 747, output_tokens: 619 }Третий запрос заново создаёт кэш (cache_creation_input_tokens=1370, cache_read_input_tokens=0), поскольку бюджет изменился между запросами. Запускаемую версию того же эксперимента в адаптивном режиме, где уровень усилий играет ту же роль для кэша, что и budget_tokens здесь, см. в разделе Кэширование подсказок на странице управления размышлениями.
Общая механика
Большая часть поведения размышлений не зависит от режима и документирована один раз на странице Размышления. Эти разделы применимы и в ручном режиме:
- Управление отображением размышлений
- Потоковая передача размышлений
- Размышления при использовании инструментов, включая сохранение блоков размышлений
- Размышления и кэширование подсказок
- Размышления и контекстное окно
- Шифрование размышлений
- Цены (на странице Управление размышлениями)
Переход на адаптивные размышления
Если ваша модель поддерживает только расширенные размышления, никаких действий не требуется. Это модели Claude Sonnet 4.5 (устарела), Claude Opus 4.5, Claude Haiku 4.5 и более ранние модели Claude 4. Адаптивные размышления на них недоступны, и type: "adaptive" возвращает ошибку 400. Сохраняйте budget_tokens, пока не перейдёте на модель, поддерживающую адаптивные размышления, а затем примените приведённое ниже сопоставление.
Вам необходимо отказаться от type: "enabled", если:
- Вы используете Claude Opus 4.6 или Claude Sonnet 4.6, где
budget_tokensустарел. - Вы используете модель с номером 4.7 или выше, где
type: "enabled"возвращает ошибку 400. Примеры включают Claude Opus 5.5, Claude Sonnet 5, Claude Sonnet 5.5, Claude Fable 5.2, Claude Fable 5.1 и Claude Haiku 5.5.
Сопоставление простое: удалите budget_tokens, задайте thinking: {type: "adaptive"} и управляйте глубиной рассуждения с помощью output_config: {effort: ...} вместо бюджета токенов.
{
"model": "claude-sonnet-4-6",
"max_tokens": 16000,
"thinking": {
"type": "enabled",
"budget_tokens": 10000
}
}превращается в:
{
"model": "claude-sonnet-4-6",
"max_tokens": 16000,
"thinking": {
"type": "adaptive"
},
"output_config": {
"effort": "high"
}
}effort: "high" является значением по умолчанию на Claude Sonnet 4.6, поэтому, если его здесь опустить, поведение не изменится; оно указано только для того, чтобы показать, где в адаптивном режиме задаётся глубина рассуждения. Claude Opus 5.5 и Claude Haiku 5.5 по умолчанию используют "medium", а другие модели, поддерживающие уровень усилий, по умолчанию используют "high" (см. Уровни усилий).
Ожидайте изменения поведения, а не только синтаксиса. При фиксированном бюджете Claude размышляет в каждом запросе. При адаптивных размышлениях Claude сам определяет, размышлять ли и насколько в каждом запросе, а при более низких настройках уровня усилий может полностью пропускать размышления на простых входных данных. После перехода вы также можете удалить бета-заголовок interleaved-thinking-2025-05-14: адаптивные размышления чередуются автоматически, а Claude API игнорирует этот заголовок на этих моделях. Меняется и сохранение блоков размышлений. Claude Opus 4.5 и модели с номером 4.6 и выше сохраняют блоки размышлений предыдущих ходов в контексте и выставляют за них счёт как за входные токены. Claude Sonnet 4.5 (устарела), Claude Haiku 4.5 и более ранние модели их удаляют. См. сохранение блоков размышлений по моделям.
Переключение режимов является изменением конфигурации размышлений, поэтому первый запрос после переключения делает недействительными точки останова кэша, как описано в разделе Кэширование подсказок в ручном режиме.
Полное руководство см. на страницах Размышления, Уровень усилий и Руководства по миграции.
Следующие шаги
Узнайте, как работают размышления: блоки, отображение, потоковая передача и использование инструментов.
Позвольте Claude определять, когда и насколько размышлять в каждом запросе.
Сохраняйте блоки размышлений и управляйте размышлениями между вызовами инструментов и ходами.
Доступность
Claude API
- Статус
- Устаревшее
- API
- Messages API
- Managed Agents Не поддерживается
- Модели
- Claude Mythos Preview
- Claude Opus 4.6 Не рекомендуется
- Claude Opus 4.5
- Claude Sonnet 4.6 Не рекомендуется
- Claude Sonnet 4.5
- Claude Haiku 4.5
Amazon Bedrock
- Статус
- Устаревшее
- API
- Messages API
- Модель
- Claude Haiku 4.5
Amazon Bedrock (bedrock-runtime)
- Статус
- Устаревшее
- API
- Messages API
- Модели
- Claude Opus 4.6 Не рекомендуется
- Claude Opus 4.5
- Claude Sonnet 4.6 Не рекомендуется
- Claude Sonnet 4.5
- Claude Haiku 4.5
Claude Platform on AWS
- Статус
- Устаревшее
- API
- Messages API
- Managed Agents Не поддерживается
- Модели
- Claude Opus 4.6 Не рекомендуется
- Claude Opus 4.5
- Claude Sonnet 4.6 Не рекомендуется
- Claude Sonnet 4.5
- Claude Haiku 4.5
Claude Models on Google Cloud (Anthropic managed)
- Статус
- Устаревшее
- API
- Messages API
- Managed Agents Не поддерживается
- Модели
- Claude Opus 4.6 Не рекомендуется
- Claude Opus 4.5
- Claude Sonnet 4.6 Не рекомендуется
- Claude Sonnet 4.5
- Claude Haiku 4.5
Claude Models on Google Cloud (Google managed)
- Статус
- Устаревшее
- API
- Messages API
- Модели
- Claude Opus 4.6 Не рекомендуется
- Claude Opus 4.5
- Claude Sonnet 4.6 Не рекомендуется
- Claude Sonnet 4.5
- Claude Haiku 4.5
Microsoft Foundry (hosted on Azure)
- Статус
- Устаревшее
- API
- Messages API
- Модель
- Claude Haiku 4.5
Microsoft Foundry (hosted on Anthropic)
- Статус
- Устаревшее
- API
- Messages API
- Модели
- Claude Opus 4.6 Не рекомендуется
- Claude Opus 4.5
- Claude Sonnet 4.6 Не рекомендуется
- Claude Sonnet 4.5
- Claude Haiku 4.5
Эта страница была полезной?