Размышления
Узнайте, как работают размышления Claude: как их включить, читать вывод размышлений, управлять их глубиной с помощью уровня усилий и использовать размышления вместе с инструментами, кэшированием и потоковой передачей.
Использование зависит от продукта
thinking: {"type": "disabled"} отключает размышления на моделях, которые принимают это значение. Там, где они по умолчанию отключены, задайте thinking, чтобы их включить.thinking.Модель, которая отвечает за один проход, должна сделать всё правильно с первой попытки: без черновых вычислений, без проверки, без смены подхода на полпути. Для доказательства, сложной ошибки или длинной агентной задачи первый подход часто оказывается не лучшим.
«Thinking» (размышления) снимает это ограничение. Когда размышления активны, Claude прорабатывает задачу своими словами перед тем, как ответить: переформулирует, что от него требуется, пробует разные подходы, проверяет промежуточные результаты и отказывается от путей, которые не выдерживают проверки. Эти предварительные размышления поступают в блоках содержимого thinking перед ответом, и Claude опирается на них, чтобы сформировать итоговый ответ. Именно поэтому размышления повышают качество работы на сложных задачах, таких как математика, программирование, анализ и длительная агентная работа, где качество ответа зависит от промежуточной работы, которая иначе была бы сжата в сам ответ или пропущена.
У размышлений есть цена: токены, которые Claude тратит на рассуждения, тарифицируются как выходные токены, даже если текст размышлений вам не возвращается, и они учитываются в max_tokens наряду с текстом ответа. На этой странице описано, как размышления ведут себя во всём API: как их включить, как читать их вывод и как управлять их взаимодействием с инструментами, потоковой передачей, кэшированием и контекстным окном.
Как работают размышления
Будет ли Claude размышлять над конкретным запросом и насколько глубоко, зависит от вашей конфигурации размышлений и сложности запроса.
Вот как выглядят предварительные размышления в ответе: один или несколько блоков содержимого thinking поступают перед блоками text. Блок размышлений — это тоже сгенерированное содержимое, как и следующий за ним блок text, но он отделён от канонического ответа. Каждый блок размышлений также содержит поле signature — зашифрованную копию полных рассуждений, которую вы передаёте обратно без изменений в многоходовых диалогах и диалогах с использованием инструментов (см. Шифрование размышлений):
{
"content": [
{
"type": "thinking",
"thinking": "Let me break this down. The question has two parts, so I'll start with the simpler one and use its result to constrain the second...",
"signature": "WaUjzkypQ2mUEVM36O2Txu...."
},
{
"type": "text",
"text": "Based on my analysis..."
}
]
}Вы не всегда видите этот текст, и то, что вы видите, никогда не является сырой цепочкой рассуждений: текст в блоке размышлений — это сводка рассуждений Claude. Поле display в конфигурации размышлений определяет, возвращается ли эта сводка вообще: "summarized" возвращает её, тогда как "omitted", значение по умолчанию на многих моделях, возвращает блоки размышлений с пустым полем thinking. В любом случае блок тарифицируется одинаково и одинаково передаётся обратно в многоходовых диалогах. Значения по умолчанию для каждой модели и подробности см. в разделе Управление отображением размышлений.
Если Claude использует инструменты, размышления также могут появляться между вызовами инструментов. См. Размышления при использовании инструментов. Полный формат ответа см. в справочнике по Messages APIДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape..
Настройка размышлений
На большинстве моделей размышления включены по умолчанию или требуют только одного параметра. В следующей таблице показано, что делает каждая модель с каждым значением thinking, которое может отправить запрос. Ошибка 400 означает, что API отклоняет запрос; в разделе Устранение неполадок с размышлениями описаны все ошибки и способы их исправления.
| Модель | Без поля thinking | "adaptive" | "enabled" с budget_tokens | "between_tools" | "disabled" |
|---|---|---|---|---|---|
| Claude Opus 5.5 | Адаптивные размышления | Адаптивные размышления | Ошибка 400 | Ошибка 400 | Ошибка 400 |
| Claude Sonnet 5.5 | Адаптивные размышления | Адаптивные размышления | Ошибка 400 | Предварительные размышления выключены при уровне усилий high или ниже | Ошибка 400 |
| Claude Haiku 5.5 | Адаптивные размышления | Адаптивные размышления | Ошибка 400 | Ошибка 400 | Размышления выключены при уровне усилий high или ниже |
| Claude Fable 5.2 | Адаптивные размышления | Адаптивные размышления | Ошибка 400 | Ошибка 400 | Ошибка 400 |
| Claude Mythos 5.2 | Адаптивные размышления | Адаптивные размышления | Ошибка 400 | Ошибка 400 | Ошибка 400 |
| Claude Fable 5.1 | Адаптивные размышления | Адаптивные размышления | Ошибка 400 | Ошибка 400 | Ошибка 400 |
| Claude Mythos 5.1 | Адаптивные размышления | Адаптивные размышления | Ошибка 400 | Ошибка 400 | Ошибка 400 |
| Claude Fable 5 | Адаптивные размышления | Адаптивные размышления | Ошибка 400 | Ошибка 400 | Ошибка 400 |
| Claude Mythos 5 | Адаптивные размышления | Адаптивные размышления | Ошибка 400 | Ошибка 400 | Ошибка 400 |
| Claude Opus 5 | Адаптивные размышления | Адаптивные размышления | Ошибка 400 | Ошибка 400 | Размышления выключены при уровне усилий high или ниже |
| Claude Sonnet 5 | Адаптивные размышления | Адаптивные размышления | Ошибка 400 | Ошибка 400 | Размышления выключены |
| Claude Opus 4.8 | Размышления выключены | Адаптивные размышления | Ошибка 400 | Ошибка 400 | Размышления выключены |
| Claude Opus 4.7 | Размышления выключены | Адаптивные размышления | Ошибка 400 | Ошибка 400 | Размышления выключены |
| Claude Mythos Preview | Адаптивные размышления | Адаптивные размышления | Расширенные размышления | Ошибка 400 | Ошибка 400 |
| Claude Opus 4.6 | Размышления выключены | Адаптивные размышления | Расширенные размышления (устарело) | Ошибка 400 | Размышления выключены |
| Claude Sonnet 4.6 | Размышления выключены | Адаптивные размышления | Расширенные размышления (устарело) | Ошибка 400 | Размышления выключены |
| Claude Opus 4.5 | Размышления выключены | Ошибка 400 | Расширенные размышления | Ошибка 400 | Размышления выключены |
| Claude Sonnet 4.5 | Размышления выключены | Ошибка 400 | Расширенные размышления | Ошибка 400 | Размышления выключены |
| Claude Haiku 4.5 | Размышления выключены | Ошибка 400 | Расширенные размышления | Ошибка 400 | Размышления выключены |
В таблице «при уровне усилий high или ниже» означает, что запрос работает при уровнях усилий low, medium и high и возвращает ошибку 400 при xhigh или max.
На Claude 5 и более поздних моделях и Claude Mythos Preview размышления уже включены и не требуют настройки. На этих моделях display по умолчанию имеет значение "omitted", поэтому текст размышлений скрыт, пока вы явно не включите его. Включите его с помощью thinking: {"type": "adaptive", "display": "summarized"}, как это сделано в следующих примерах.
На Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6 и Claude Sonnet 4.6 размышления выключены, пока вы не зададите thinking: {type: "adaptive"}, что позволяет Claude определять, когда и насколько глубоко размышлять, в зависимости от запроса. Тот же запрос с заменённой строкой модели включает их там. В следующих примерах задано display: "summarized", чтобы текст размышлений был виден, и используется большое значение max_tokens:
client = anthropic.Anthropic()
response = client.messages.create(
model="claude-opus-5-5",
max_tokens=16000,
thinking={"type": "adaptive", "display": "summarized"},
messages=[
{
"role": "user",
"content": "What is the greatest common divisor of 1071 and 462?",
}
],
)
for block in response.content:
match block.type:
case "thinking":
print(f"\nThinking: {block.thinking}")
case "text":
print(f"\nResponse: {block.text}")Ответ содержит сводку размышлений, а затем ответ:
Thinking: Use Euclidean algorithm.
1071 = 2*462 + 147
462 = 3*147 + 21
147 = 7*21 + 0
GCD = 21
Response: ## Finding GCD of 1071 and 462
I'll use the **Euclidean algorithm**, repeatedly dividing and taking remainders...Токены размышлений учитываются в max_tokens, поэтому задайте достаточно большое значение, чтобы хватило места и для размышлений, и для текста ответа. См. Контроль затрат на странице об управлении и Размышления и контекстное окно.
Отключение размышлений
На Claude Sonnet 5, где размышления включены по умолчанию, их можно отключить:
client = anthropic.Anthropic()
response = client.messages.create(
model="claude-sonnet-5",
max_tokens=4096,
thinking={"type": "disabled"},
messages=[{"role": "user", "content": "Summarize this article in one sentence."}],
)У Claude Opus 5 размышления также включены по умолчанию, и модель принимает thinking: {type: "disabled"} при уровне усилий high или ниже. При уровне усилий xhigh или max размышления отключить нельзя: запросы, сочетающие thinking: {type: "disabled"} с этими уровнями усилий, возвращают ошибку 400. Это ограничение проверяется для каждого запроса. С отключёнными размышлениями Claude Opus 5 может иногда выдавать вызовы инструментов в виде обычного текста или включать внутренние XML-теги в видимый вывод. Способы смягчения этого с помощью подсказок см. в разделе Работа с отключёнными размышлениями.
У Claude Sonnet 5.5 размышления также включены по умолчанию, и модель отклоняет thinking: {type: "disabled"} с ошибкой 400. Чтобы отключить предварительные размышления, отправьте вместо этого thinking: {type: "between_tools"}. Это самая низкая настройка размышлений на Claude Sonnet 5.5, и она принимается при уровне усилий high или ниже. Модель по-прежнему возвращает свои сообщения о ходе работы между вызовами инструментов. Без инструментов ответ содержит только текст, как при disabled на Claude Sonnet 5. Рекомендации по подсказкам см. в разделе Работа без предварительных размышлений.
У Claude Haiku 5.5 размышления также включены по умолчанию, и модель принимает thinking: {type: "disabled"} при уровне усилий high или ниже. При уровне усилий xhigh или max такое сочетание возвращает ошибку 400. Чтобы уменьшить объём размышлений, сначала понизьте уровень усилий. С выключенными размышлениями модель может пропустить необходимый вызов инструмента, если вы также запрашиваете вывод в формате JSON. output_config.effort для отдельного сообщения, отличающийся от действующего уровня, также возвращает ошибку 400, пока размышления выключены. См. Используйте уровень усилий для управления размышлениями и Используйте адаптивные размышления с выводом JSON и собственными инструментами.
Claude Fable 5.2, Claude Mythos 5.2, Claude Fable 5.1, Claude Mythos 5.1, Claude Fable 5, Claude Mythos 5, Claude Opus 5.5 и Claude Mythos Preview отклоняют thinking: {type: "disabled"}. На этих моделях размышления отключить нельзя.
Чтобы перед отправкой запроса проверить, принимает ли модель "disabled" или "between_tools", прочитайте её значение capabilities.thinking.types.disabled.supported или capabilities.thinking.types.between_tools.supported из Models API. Оба поля описаны в разделе Использование Models API.
Если ваша модель поддерживает только расширенные размышления (см. таблицу конфигурации по моделям), настройте их с помощью type: "enabled" и значения budget_tokens. Эта конфигурация описана на странице Расширенные размышления. А если какая-либо конфигурация размышлений возвращает ошибку 400, в разделе Устранение неполадок с размышлениями каждому сообщению об ошибке сопоставлен способ исправления.
Чтение вывода размышлений
Управление отображением размышлений
Поле display в конфигурации размышлений определяет, как содержимое размышлений возвращается в ответах API. display работает в обоих режимах: задавайте его вместе с type: "adaptive" или type: "enabled". Оно принимает следующие значения:
"summarized": блоки размышлений содержат текст сводки размышлений — читаемое краткое изложение рассуждений Claude. Это значение по умолчанию на Claude Opus 4.6, Claude Sonnet 4.6 и более ранних моделях."omitted": блоки размышлений возвращаются с пустым полемthinking. Полеsignatureпо-прежнему содержит зашифрованные полные размышления для непрерывности многоходового диалога (см. Шифрование размышлений). Это значение по умолчанию на Claude Fable 5.2, Claude Mythos 5.2, Claude Fable 5.1, Claude Mythos 5.1, Claude Fable 5, Claude Mythos 5, Claude Opus 5.5, Claude Opus 5, Claude Sonnet 5.5, Claude Sonnet 5, Claude Opus 4.8, Claude Opus 4.7, Claude Mythos Preview и Claude Haiku 5.5."updates"(бета): блоки рассуждений возвращаются с пустым полемthinking, как при"omitted", а короткие сообщения о ходе работы, которые некоторые модели пишут между вызовами инструментов, возвращаются в виде читаемого текста. Требуется бета-заголовокthinking-display-updates-2026-08-18.
Задайте display: "omitted", если ваше приложение не показывает содержимое размышлений пользователям. Основное преимущество — более быстрое «time-to-first-text-token» (время до первого текстового токена) при потоковой передаче: сервер полностью пропускает потоковую передачу токенов размышлений и доставляет только подпись, поэтому потоковая передача итогового текстового ответа начинается раньше.
С display: "omitted" ответ содержит блоки thinking с пустым полем thinking:
{
"content": [
{
"type": "thinking",
"thinking": "",
"signature": "EosnCkYICxIMMb3LzNrMu..."
},
{
"type": "text",
"text": "The answer is 12,231."
}
]
}При работе со скрытыми размышлениями учитывайте следующее:
- Вы по-прежнему оплачиваете полные токены размышлений. Скрытие сокращает задержку, а не затраты.
- Если вы передаёте блоки размышлений обратно в многоходовых диалогах, передавайте их без изменений. Сервер расшифровывает
signature, чтобы восстановить исходные размышления при построении подсказки (см. Сохранение блоков размышлений). Любой текст, помещённый вами в полеthinkingвозвращаемого скрытого блока, игнорируется. displayнедопустимо сthinking.type: "disabled"(отображать нечего) и сthinking.type: "between_tools"(только Claude Sonnet 5.5), который не принимает никаких других полей. Сbetween_toolsсообщения о ходе работы по-прежнему возвращаются с текстом сводки, как и приdisplay: "updates"(см. Сообщения о ходе работы).- Когда вы используете
thinking.type: "adaptive"и модель пропускает размышления для простого запроса, блок размышлений не создаётся независимо отdisplay. - При потоковой передаче с
display: "omitted"текст размышлений не передаётся. Каждый блок размышлений передаётthinking_deltaс пустой строкойthinking, а затем свойsignature_delta. Сdisplay: "updates"только блоки сообщений о ходе работы передают событияthinking_delta, содержащие текст. Последовательность событий см. в разделе Потоковая передача размышлений.
Сводка размышлений
Когда display имеет значение "summarized", получаемый вами текст размышлений — это сводка полного процесса размышлений Claude, а не сырая цепочка рассуждений. Сводка размышлений обеспечивает все интеллектуальные преимущества размышлений, одновременно предотвращая злоупотребления. Ни одна настройка display не возвращает сырую цепочку рассуждений.
При работе со сводкой размышлений учитывайте следующее:
- Вы оплачиваете полные токены размышлений, сгенерированные исходным запросом, а не токены сводки. Количество тарифицируемых выходных токенов не совпадает с количеством токенов, которые вы видите в ответе.
- На Claude Opus 4.6, Claude Sonnet 4.6 и более ранних моделях первые несколько строк вывода размышлений более подробны и содержат детальные рассуждения, что особенно полезно для целей инженерии подсказок. Claude Mythos Preview формирует сводку с первого токена, поэтому его блоки размышлений не содержат этой подробной преамбулы.
- Формирование сводки сохраняет ключевые идеи процесса размышлений Claude с минимальной дополнительной задержкой, поэтому сводки могут передаваться потоком по мере поступления.
- Сводка формируется моделью, отличной от той, к которой вы обращаетесь в запросах. Модель размышлений не получает вывод сводки.
Чтобы увидеть рассуждения модели, читайте блоки thinking, а не запрашивайте рассуждения в тексте ответа с помощью подсказки. На Claude Fable 5.2, Claude Fable 5.1, Claude Opus 5.5, Claude Opus 5, Claude Sonnet 5.5 и Claude Fable 5 запрос, пытающийся получить внутренние рассуждения модели в составе текста ответа, может быть отклонён с stop_details.category: "reasoning_extraction". Справку по полю см. в разделе Как выглядит отказ, а что запрашивать вместо этого — в разделе Храните рассуждения в блоках размышлений.
Потоковая передача размышлений
Размышления работают с потоковой передачей. Блоки размышлений передаются как события thinking_delta внутри событий content_block_delta, за которыми следует одно событие signature_delta непосредственно перед content_block_stop блока. Текстовые блоки передаются после этого как обычно.
Следующие примеры передают ответ потоком с адаптивными размышлениями, выводя дельты размышлений и текста по мере их поступления:
client = anthropic.Anthropic()
with client.messages.stream(
model="claude-opus-5-5",
max_tokens=16000,
thinking={"type": "adaptive", "display": "summarized"},
messages=[
{
"role": "user",
"content": "What is the greatest common divisor of 1071 and 462?",
}
],
) as stream:
for event in stream:
match event.type:
case "content_block_start":
print(f"\nStarting {event.content_block.type} block...")
case "content_block_delta":
delta = event.delta
match delta.type:
case "thinking_delta":
print(delta.thinking, end="", flush=True)
case "text_delta":
print(delta.text, end="", flush=True)Чтобы собрать полные блоки размышлений с их подписями после потоковой передачи, используйте вспомогательную функцию накопления сообщений вашего SDK, stream.get_final_message(), вместо того чтобы самостоятельно объединять дельты.
event: message_start
data: {"type": "message_start", "message": {"id": "msg_01...", "type": "message", "role": "assistant", "content": [], "model": "claude-opus-5-5", "stop_reason": null, "stop_sequence": null}}
event: content_block_start
data: {"type": "content_block_start", "index": 0, "content_block": {"type": "thinking", "thinking": "", "signature": ""}}
event: content_block_delta
data: {"type": "content_block_delta", "index": 0, "delta": {"type": "thinking_delta", "thinking": "I need to find the GCD of 1071 and 462 using the Euclidean algorithm.\n\n1071 = 2 × 462 + 147"}}
event: content_block_delta
data: {"type": "content_block_delta", "index": 0, "delta": {"type": "thinking_delta", "thinking": "\n462 = 3 × 147 + 21\n147 = 7 × 21 + 0\n\nSo GCD(1071, 462) = 21"}}
// Additional thinking deltas...
event: content_block_delta
data: {"type": "content_block_delta", "index": 0, "delta": {"type": "signature_delta", "signature": "EqQBCgIYAhIM1gbcDa9GJwZA2b..."}}
event: content_block_stop
data: {"type": "content_block_stop", "index": 0}
event: content_block_start
data: {"type": "content_block_start", "index": 1, "content_block": {"type": "text", "text": ""}}
event: content_block_delta
data: {"type": "content_block_delta", "index": 1, "delta": {"type": "text_delta", "text": "The greatest common divisor of 1071 and 462 is **21**."}}
// Additional text deltas...
event: content_block_stop
data: {"type": "content_block_stop", "index": 1}
event: message_delta
data: {"type": "message_delta", "delta": {"stop_reason": "end_turn", "stop_sequence": null}}
event: message_stop
data: {"type": "message_stop"}Когда задано display: "omitted", блок размышлений открывается, поступает thinking_delta с пустой строкой thinking, за ним следует одно signature_delta, и блок закрывается. Потоковая передача текста начинается сразу после этого:
event: content_block_start
data: {"type":"content_block_start","index":0,"content_block":{"type":"thinking","thinking":"","signature":""}}
event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"thinking_delta","thinking":""}}
event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"signature_delta","signature":"EosnCkYICxIMMb3LzNrMu..."}}
event: content_block_stop
data: {"type":"content_block_stop","index":0}
event: content_block_start
data: {"type":"content_block_start","index":1,"content_block":{"type":"text","text":""}}С display: "updates" (в бета-версии) блоки рассуждений передаются так же, как при "omitted". Каждый блок сообщения о ходе работы передаёт свой текст в виде событий thinking_delta перед блоком tool_use, который он предваряет. Пауза в несколько секунд перед открытием блока сообщения о ходе работы — это нормально:
event: content_block_start
data: {"type":"content_block_start","index":1,"content_block":{"type":"thinking","thinking":"","signature":""}}
event: content_block_delta
data: {"type":"content_block_delta","index":1,"delta":{"type":"thinking_delta","thinking":"Confirmed the retry path never refreshes the expired token. Editing auth.py to add the refresh call."}}
event: content_block_delta
data: {"type":"content_block_delta","index":1,"delta":{"type":"signature_delta","signature":"Es8CCkYICxIM..."}}
event: content_block_stop
data: {"type":"content_block_stop","index":1}
event: content_block_start
data: {"type":"content_block_start","index":2,"content_block":{"type":"tool_use","id":"toolu_01D7FLrfh4GYq7yT1ULFeyMV","name":"edit_file","input":{}}}При "updates" считайте блок сообщением о ходе работы, как только одно из его событий thinking_delta содержит непустой текст.
Общие механизмы потоковой передачи см. в разделе Потоковая передача сообщений.
Размышления и уровень усилий
Параметр thinking управляет тем, размышляет ли Claude в блоках размышлений перед ответом; параметр effort управляет тем, сколько усилий Claude вкладывает в весь ответ, что в адаптивном режиме включает то, как часто и насколько глубоко он размышляет. Не передавайте adaptive в качестве значения effort: adaptive — это режим размышлений, а не уровень усилий.
Чтобы узнать, как каждый уровень усилий влияет на поведение размышлений, см. таблицу поведения размышлений по уровням на странице Управление размышлениями. На странице Уровень усилий описан сам параметр, включая то, какие уровни поддерживает каждая модель. На Claude Opus 4.5, единственной модели только с расширенными размышлениями, поддерживающей уровень усилий, уровень усилий сочетается с budget_tokens. См. Правила бюджета и настройка.
Поскольку эти два механизма управления разделены таким образом, выберите тот, который соответствует вашей цели:
- Снизить затраты или задержку для рабочей нагрузки с включёнными размышлениями: сначала понизьте
effort. Он уменьшает весь ответ, включая размышления. - Claude размышляет слишком редко или слишком поверхностно: повысьте
effortили см. раздел Управление частотой размышлений Claude на странице об управлении. - Нужно полностью отключить размышления: используйте
thinking: {type: "disabled"}на моделях, которые это допускают (см. таблицу конфигурации по моделям). Claude Sonnet 5.5 отклоняет"disabled". Его самая низкая настройка —thinking: {type: "between_tools"}, которая отключает предварительные размышления. - Нужен жёсткий предел расходов: используйте
max_tokens. Уровень усилий — это мягкая рекомендация.max_tokens— строгое ограничение.
Размышления при использовании инструментов
Размышления работают вместе с использованием инструментов, позволяя Claude рассуждать при выборе инструментов и обработке их результатов. Действуют два ограничения:
- Ограничение выбора инструмента (ручной режим): использование инструментов с ручными расширенными размышлениями (
thinking: {type: "enabled"}) поддерживает толькоtool_choice: {"type": "auto"}(по умолчанию) илиtool_choice: {"type": "none"}. Использованиеtool_choice: {"type": "any"}илиtool_choice: {"type": "tool", "name": "..."}приводит к ошибке, поскольку эти варианты принудительно вызывают использование инструментов, что несовместимо с ручными расширенными размышлениями. Адаптивные размышления, в том числе на моделях, где размышления включены по умолчанию, поддерживают принудительное использование инструментов, кроме Claude Opus 5.5, Claude Sonnet 5.5, Claude Fable 5.2, Claude Mythos 5.2, Claude Fable 5.1 и Claude Mythos 5.1 (см. Предварительное заполнение ответа и принудительное использование инструментов). Там, где принудительное использование инструментов принимается, ответ начинается с вызова инструмента и не содержит блокаthinking. - Сохранение блоков размышлений: когда вы возвращаете результаты инструментов, вы должны передать блоки размышлений из сообщения ассистента обратно в API полностью и без изменений. См. Сохранение блоков размышлений.
Цикл использования инструментов — это один ход ассистента. С точки зрения модели ход ассистента заканчивается только тогда, когда Claude завершает свой полный ответ, который может включать несколько вызовов инструментов и их результатов. Вся эта последовательность — один ход ассистента:
User: "What's the weather in Paris?"
Assistant: [thinking] + [tool_use: get_weather]
User: [tool_result: "20°C, sunny"]
Assistant: [text: "The weather in Paris is 20°C and sunny"]Весь ход выполняется в одном режиме размышлений: нельзя переключать размышления в середине хода, в том числе во время цикла использования инструментов. В расширенном (ручном) режиме API дополнительно требует, чтобы последний ход ассистента в запросе с включёнными размышлениями начинался с блока размышлений. Адаптивный режим смягчает это требование: ни один ход ассистента не обязан начинаться с такого блока.
Конфликты в середине хода обрабатываются мягко. Если вы переключаете размышления в середине хода (например, между отправкой вызова инструмента и возвратом его результата), API не возвращает ошибку. Вместо этого он незаметно отключает размышления для этого запроса. Чтобы сохранить качество модели, API может удалять блоки размышлений, которые создали бы недопустимую структуру хода, или отключать размышления, когда история диалога несовместима с включёнными размышлениями. Чтобы убедиться, были ли размышления активны, проверьте наличие блоков thinking в ответе.
Переключайте между ходами, а не внутри них. Планируйте стратегию размышлений в начале каждого хода. Завершите ход ассистента, а затем измените конфигурацию размышлений для следующего:
User: "What's the weather?"
Assistant: [tool_use] (thinking disabled)
User: [tool_result]
Assistant: [text: "It's sunny"]
User: "What about tomorrow?"
Assistant: [thinking] + [text: "..."] (thinking enabled - new turn)Переключение режимов размышлений также делает недействительным кэширование подсказок. См. Размышления и кэширование подсказок.
Сохранение блоков размышлений
Когда Claude вызывает инструмент, он приостанавливает построение ответа в ожидании внешней информации. Когда вы возвращаете результат инструмента, Claude продолжает строить тот же ответ, поэтому его предыдущие рассуждения должны оставаться доступными. Передавайте каждый блок thinking обратно в API полностью и без изменений вместе с блоком tool_use, который он сопровождал. Это важно по двум причинам:
- Непрерывность рассуждений: блоки размышлений фиксируют пошаговые рассуждения, которые привели к запросам инструментов. Их включение позволяет Claude продолжить рассуждения с того места, где он остановился.
- Сохранение контекста: результаты инструментов представлены в структуре API как сообщения пользователя, но они являются частью одного непрерывного потока рассуждений. Сохранение блоков размышлений поддерживает этот поток между вызовами API.
Вкратце:
- Обязательно: в пределах хода с использованием инструментов передавайте блоки размышлений обратно.
- Рекомендуется: между ходами передавайте обратно всё.
- Допустимо: вне использования инструментов опускайте размышления предыдущих ходов, но не блок между двумя блоками, которые вы сохраняете.
Вам не нужно самостоятельно удалять старые размышления. Передавайте все блоки размышлений обратно в многоходовых диалогах, и API автоматически отфильтрует их, сохранит блоки, необходимые для сохранения рассуждений модели, и выставит счёт за входные токены только для блоков, фактически показанных Claude. То, какие блоки предыдущих ходов сохраняются, зависит от модели. См. Сохранение блоков размышлений в зависимости от модели. Чтобы переопределить поведение по умолчанию, используйте стратегию редактирования контекста clear_thinking_20251015.
В последнем сообщении ассистента последовательность идущих подряд блоков thinking должна совпадать с тем, что модель сгенерировала в исходном запросе: их нельзя переставлять, редактировать или частично удалять. Это относится и к блокам redacted_thinking.
Разобранный пример с кодом для каждого SDK см. в разделе Пошаговый разбор двухходового цикла использования инструментов. В нём определяется инструмент, принимается ответ с размышлениями и использованием инструмента, а ход ассистента возвращается обратно вместе с результатом инструмента.
Чередующиеся размышления
«Interleaved thinking» (чередующиеся размышления) позволяет Claude размышлять между вызовами инструментов, рассуждая о каждом результате инструмента перед тем, как действовать на его основе. С чередующимися размышлениями Claude может:
- Рассуждать о результатах вызова инструмента, прежде чем определить, что делать дальше
- Выстраивать цепочки из нескольких вызовов инструментов с шагами рассуждений между ними
- Принимать более взвешенные решения на основе промежуточных результатов
С адаптивными размышлениями чередующиеся размышления включаются автоматически на каждой модели, поддерживающей адаптивные размышления. На Claude Fable 5.2, Claude Mythos 5.2, Claude Fable 5.1, Claude Mythos 5.1, Claude Fable 5, Claude Mythos 5, Claude Mythos Preview, Claude Opus 5.5, Claude Opus 5, Claude Sonnet 5.5, Claude Opus 4.8 и Claude Opus 4.7 рассуждения между вызовами инструментов всегда появляются в блоках размышлений. Claude Haiku 4.5 не поддерживает чередующиеся размышления. На моделях, использующих ручные расширенные размышления, чередование требует бета-заголовка и меняет способ подсчёта бюджета размышлений. Правила для каждой модели и особенности заголовков на разных платформах описаны в разделе Чередующиеся размышления в ручном режиме.
При чередующихся размышлениях объём размышлений может охватывать весь ход ассистента, а не отдельный ответ. Чередующиеся размышления поддерживаются только для инструментов, используемых через Messages API.
Разобранное сравнение, показывающее, что меняют чередующиеся размышления в рабочем процессе с двумя инструментами, см. в разделе Как чередующиеся размышления меняют процесс.
Сообщения о ходе работы между вызовами инструментов
На Claude Fable 5.2, Claude Mythos 5.2, Claude Fable 5.1, Claude Mythos 5.1, Claude Opus 5.5, Claude Sonnet 5.5 и Claude Fable 5 модель может писать сообщение о ходе работы между вызовами инструментов. Сообщение о ходе работы — это заметка о том, что модель только что обнаружила и что она собирается сделать дальше, написанная для человека, наблюдающего за агентом, а не в качестве рассуждения. Каждое такое сообщение возвращается в виде отдельного блока thinking со своей signature, отдельно от любого блока рассуждений в той же точке. Оно располагается непосредственно перед блоком tool_use или server_tool_use, который оно предваряет. Каждому вызову инструмента предшествует не более одного сообщения о ходе работы, и модель может пропустить любое из них. Сообщения о ходе работы не являются чередующимися размышлениями: они появляются независимо от того, появляются ли блоки рассуждений между вызовами инструментов, и ответ может содержать и то, и другое.
Содержимое блока сообщения о ходе работы зависит от display:
display | Блоки рассуждений | Блоки сообщений о ходе работы |
|---|---|---|
"omitted" (значение по умолчанию на этих моделях) | Пустое поле thinking | Пустое поле thinking |
"updates" (бета) | Пустое поле thinking | Текст сводки |
"summarized" | Текст сводки | Текст сводки, неотличимый от блока рассуждений |
На Claude Sonnet 5.5 самая низкая настройка размышлений — thinking: {type: "between_tools"}. Она отключает предварительные размышления, и каждое сообщение о ходе работы возвращается с текстом сводки, как это было бы при display: "updates". between_tools принимается только при уровне усилий high или ниже. При xhigh или max запрос с этой настройкой возвращает ошибку 400. between_tools не принимает никаких других полей: display, budget_tokens или block_binding, отправленные вместе с ней, возвращают ошибку 400. Эта настройка работает на каждой платформе, предлагающей Claude Sonnet 5.5. Передавайте блоки обратно без изменений: блок сообщения о ходе работы, который вы отправляете обратно, передаёт модели полную написанную ею заметку, а не сводку.
Используйте display: "updates" для интерфейса агента, который скрывает рассуждения и показывает пользователю строку состояния на каждом шаге. При этом значении любой блок thinking с непустым текстом является сообщением о ходе работы, поэтому отображайте такие блоки и ничего больше. Это значение находится в бета-версии и требует бета-заголовка thinking-display-updates-2026-08-18 (как отправить его на Amazon Bedrock, Claude Models on Google Cloud (Google managed) или Microsoft Foundry, см. в разделе Бета-функции на других платформах). Без него значение отклоняется с той же ошибкой 400 invalid_request_error, что и неизвестное значение display.
{
"model": "claude-fable-5-1",
"max_tokens": 16000,
"thinking": { "type": "adaptive", "display": "updates" },
"tools": [
{
"name": "edit_file",
"description": "Replace the contents of a file in the repository.",
"input_schema": {
"type": "object",
"properties": {
"path": { "type": "string" },
"content": { "type": "string" }
},
"required": ["path", "content"]
}
}
],
"messages": [
{
"role": "user",
"content": "The login test fails after an hour of uptime. Find out why and fix it."
}
]
}При "updates" начало ответа, следующего за tool_result, выглядит так. Первый блок — это рассуждение, и он остаётся пустым, как было бы при "omitted". Второй содержит текст, поэтому он является сообщением о ходе работы. При "summarized" оба блока содержат текст, а при "omitted" оба пусты.
{
"content": [
{
"type": "thinking",
"thinking": "",
"signature": "EqMBCkYICxIM..."
},
{
"type": "thinking",
"thinking": "Confirmed the retry path never refreshes the expired token. Editing auth.py to add the refresh call.",
"signature": "Es8CCkYICxIM..."
},
{
"type": "tool_use",
"id": "toolu_01D7FLrfh4GYq7yT1ULFeyMV",
"name": "edit_file",
"input": { "path": "auth.py", "content": "..." }
}
]
}При работе с сообщениями о ходе работы учитывайте следующее:
- Передавайте блоки сообщений о ходе работы обратно без изменений вместе с остальной частью хода ассистента, как и любой другой блок
thinking. - Получаемый вами текст — это сводка сообщения о ходе работы, обычно одно-два предложения. Не полагайтесь на его длину. Сообщение о ходе работы учитывается в
usage.output_tokensв полном объёме, а не в объёме сводки. - Блок сообщения о ходе работы может вернуться с пустым полем
thinkingпри любом значенииdisplay. Для пустого блока ничего не отображайте. При"updates"он выглядит так же, как пустой блок рассуждений, и не требует отдельной обработки. - Когда ответ останавливается по
max_tokens,model_context_window_exceededилиstop_sequenceвскоре после вызова инструмента или результата инструмента, его последним блоком может быть блок сообщения о ходе работы, заменяющий работу, которую модель не успела завершить. При"updates"и"summarized"его текст в точности равенThis part of the response was interrupted before it finished., и его можно показать, как любое другое сообщение. При"omitted"он пуст. Чтобы продолжить, передайте ход ассистента обратно без изменений и добавьте новое сообщениеuser(сtool_resultдля каждого блокаtool_useв этом ходе). - При потоковой передаче ожидайте паузы в несколько секунд перед открытием блока сообщения о ходе работы. См. трассировку
"updates"в разделе Потоковая передача размышлений. - Эти модели пишут меньше сообщений о ходе работы при более высоком уровне усилий и в длинных цепочках инструментов. Если ваш интерфейс зависит от них, см. Запросите обновления о ходе работы для пользователя. Для Claude Opus 5.5 и Claude Sonnet 5.5 см. раздел «Обновления о ходе работы для пользователя» на странице Составление подсказок для Claude Opus 5.5 или Подсказки для Claude Sonnet 5.5. Для Claude Fable 5.2 см. Информируйте пользователей во время длинных ходов.
Сохранение блоков размышлений в зависимости от модели
Остаются ли блоки размышлений из предыдущих ходов ассистента в контексте по умолчанию, зависит от модели:
- Сохраняются все предыдущие ходы: Claude Opus 4.5 и более поздние модели Opus, Claude Sonnet 4.6 и более поздние модели Sonnet, Claude Haiku 5.5, Claude Fable 5.2, Claude Mythos 5.2, Claude Fable 5.1, Claude Mythos 5.1, Claude Fable 5, Claude Mythos 5 и Claude Mythos Preview.
- Сохраняется только текущий ход (модели, сохраняющие только последний ход): более ранние модели Opus и Sonnet, а также все модели Haiku вплоть до Claude Haiku 4.5. Когда вы передаёте обратно более старые блоки размышлений, API автоматически удаляет их. Вам не нужно удалять их самостоятельно.
Сохранение даёт два преимущества:
- Оптимизация кэша: сохранённые блоки размышлений обеспечивают попадания в кэш при использовании инструментов, поскольку они передаются обратно вместе с результатами инструментов и кэшируются инкрементально в рамках хода ассистента, что приводит к экономии токенов в многошаговых рабочих процессах.
- Отсутствие влияния на интеллект: сохранение блоков размышлений не оказывает негативного влияния на производительность модели.
Компромисс заключается в использовании контекста: длинные разговоры потребляют больше контекстного пространства на моделях, сохраняющих все ходы, поскольку сохранённые блоки размышлений учитываются как входные данные, как и любая другая история разговора (см. Размышления и контекстное окно). Поведение автоматическое в обоих режимах. Продолжайте передавать полные, неизменённые блоки размышлений обратно, как описано в разделе Сохранение блоков размышлений. Чтобы переопределить поведение по умолчанию в любую сторону, используйте очистку блоков размышлений.
Переключение моделей посреди разговора. Продолжайте передавать блоки размышлений обратно без изменений при переключении моделей, например после резервного переключения при отказе классификатора. Блок размышлений может прочитать только модель, которая его создала, и некоторые другие модели. API игнорирует или отбрасывает блоки, которые целевая модель не может прочитать (см. Переключение моделей туда и обратно). Для каждой модели из следующего списка указано, что она читает и какие модели читают её блоки:
- Claude Fable 5.2 и Claude Mythos 5.2: на Claude API и Claude Models on Google Cloud (Google managed) они читают блоки размышлений друг друга. Там они также читают блоки других моделей, включая Claude Opus 5.5, Claude Sonnet 5.5 и Claude Haiku 5.5. Никакая другая модель не читает блоки Claude Fable 5.2 или Claude Mythos 5.2. Поэтому переключение с любой из них на модель за пределами этой пары отбрасывает рассуждения более ранних ходов.
- Claude Fable 5.1 и Claude Mythos 5.1: они читают блоки размышлений друг друга и более ранних моделей, за исключением блоков Claude Mythos Preview. На Claude API и Claude Models on Google Cloud (Google managed) их блоки также читают Claude Fable 5.2 и Claude Mythos 5.2. Никакая другая модель их не читает. Переключение на Claude Fable 5.1 или Claude Mythos 5.1 с модели, чьи блоки они читают, сохраняет рассуждения разговора. Переключение с любой из них на модель, которая не может прочитать их блоки, отбрасывает их.
- Claude Opus 5.5: читает блоки размышлений Claude Opus 5 и более ранних моделей Claude Opus, Claude Sonnet и Claude Haiku. На Claude API и Claude Models on Google Cloud (Google managed) она также читает блоки Claude Sonnet 5.5 и Claude Haiku 5.5. Она не читает блоки моделей Claude Fable и Claude Mythos. На Claude API модели Claude Fable 5.1 и Claude Mythos 5.1 читают блоки Claude Opus 5.5. На Claude API и Claude Models on Google Cloud (Google managed) их также читают Claude Fable 5.2 и Claude Mythos 5.2. Переключение с Claude Opus 5.5 на Claude Fable 5.1 на Claude API сохраняет рассуждения более ранних ходов. Переключение с Claude Fable 5.1 на Claude Opus 5.5 отбрасывает их.
- Claude Sonnet 5.5: читает блоки размышлений Claude Sonnet 5, Claude Opus 4.8, Claude Haiku 4.5 и более ранних моделей Claude Opus, Claude Sonnet и Claude Haiku. На Claude API и Claude Models on Google Cloud (Google managed) она также читает блоки Claude Haiku 5.5. Она не читает блоки Claude Opus 5, Claude Opus 5.5 или любой модели Claude Fable или Claude Mythos. На этих двух платформах блоки Claude Sonnet 5.5 читают Claude Opus 5.5, Claude Fable 5.2 и Claude Mythos 5.2. Никакая другая модель их не читает. Переключение с Claude Sonnet 5.5 на одну из этих трёх моделей там сохраняет рассуждения более ранних ходов. Любое другое переключение с Claude Sonnet 5.5 отбрасывает их.
- Claude Haiku 5.5: читает блоки размышлений Claude Sonnet 5, Claude Opus 4.8, Claude Haiku 4.5 и более ранних моделей Claude Opus, Claude Sonnet и Claude Haiku. Она не читает блоки Claude Opus 5, Claude Opus 5.5, Claude Sonnet 5.5 или любой модели Claude Fable или Claude Mythos. Блоки Claude Haiku 5.5 читают четыре модели: Claude Opus 5.5, Claude Sonnet 5.5, Claude Fable 5.2 и Claude Mythos 5.2. Они делают это на Claude API и Claude Models on Google Cloud (Google managed). Никакая другая модель их не читает.
Не удаляйте блоки размышлений при переключении. API отбрасывает блоки, которые невозможно прочитать, не выставляя за них счёт, а модель, которая их читает, по-прежнему их получает. Удаление также лишает вас резервного кредита, который требует неизменённого тела запроса.
Сохранённые размышления
На моделях с сохранёнными размышлениями к каждому запросу, который отправляет блоки размышлений обратно, применяется проверка префикса. Если ваш код изменяет system, tools или более раннее сообщение, каждый блок размышлений, который уже следует за этим изменением, не проходит проверку префикса. Тогда запрос может получить ошибку 400.
Ещё два правила отбрасывают блоки без ошибки. Модель читает блоки размышлений только некоторых других моделей (см. Переключение моделей туда и обратно). А блоки некоторых моделей работают только в аккаунте, который их создал, или в аккаунте, связанном с ним (см. Аккаунты и облачные платформы).
Модели с функцией «preserved thinking» (Сохранённые размышления) — это Claude Fable 5.2, Claude Mythos 5.2, Claude Fable 5.1, Claude Mythos 5.1, Claude Opus 5.5, Claude Sonnet 5.5 и Claude Haiku 5.5.
О том, что считается изменением и что отправлять вместо этого, см. Проверка префикса для блоков размышлений. Если запрос завершился ошибкой «The block is bound to a different conversation», перейдите на страницу Исправление блока размышлений, привязанного к другому разговору.
Размышления и кэширование подсказок
Кэширование подсказок («prompt caching») взаимодействует с размышлениями несколькими особыми способами. Следующие правила применяются в обоих режимах размышлений.
Изменения конфигурации могут сделать кэш недействительным. Конфигурация размышлений и итоговый уровень effort встраиваются в саму подсказку, поэтому изменение любого из них изменяет подсказку.
Переключение между adaptive, enabled и disabled или изменение budget_tokens делает точки кэширования недействительными. Точки на уровне сообщений всегда дают промах, а точки на уровне инструментов и системной подсказки тоже могут давать промах — в зависимости от того, где модель отображает конфигурацию. Изменение значения усилия может сделать недействительными точки на уровне сообщений на любой модели. На Claude Opus 5, Claude Sonnet 5, Claude Fable 5, Claude Mythos 5 и более ранних моделях, поддерживающих усилие, изменение значения усилия может сделать недействительными также точки на уровне инструментов и системной подсказки. Считайте, что любое изменение размышлений или усилия верхнего уровня делает недействительным весь кэш.
На моделях, поддерживающих усилие на уровне сообщения, изменение усилия, переданное в сообщении role: "system" внутри messages, оставляет кэшированный префикс нетронутым. Последовательные запросы с одинаковой конфигурацией сохраняют кэш, а явная установка параметра в значение по умолчанию эквивалентна его пропуску.
Блок размышлений, который API отбрасывает при любом условии сохранённых размышлений, изменяет кэшированный префикс начиная с позиции этого блока. Блоки, переданные обратно без изменений, сохраняют кэш нетронутым.
Блоки размышлений кэшируются вместе с результатами инструментов. Во время цикла использования инструментов кэширование происходит, когда вы делаете последующий запрос, включающий результаты инструментов. В этот момент предыдущая история разговора, включая её блоки размышлений, может быть закэширована, и эти закэшированные блоки размышлений учитываются как входные токены в ваших метриках использования при чтении из кэша. Это происходит автоматически, даже без явных маркеров cache_control, и работает одинаково для обычных и чередующихся размышлений. Компромисс: блоки размышлений, которые вы больше никогда не увидите в ответах, всё равно учитываются во входных токенах при чтении из кэша.
Находятся ли предыдущие блоки в контексте вообще, зависит от модели. Это определяется поведением сохранения по умолчанию. На моделях, сохраняющих все ходы, блоки размышлений предыдущих ходов остаются в кэше и в контексте. На моделях, сохраняющих только последний ход, как только вы отправляете сообщение пользователя, не являющееся результатом инструмента, все предыдущие блоки размышлений удаляются из контекста. На таких моделях разговор вроде этого:
User: ["What's the weather in Paris?"],
Assistant: [thinking_block_1] + [tool_use block 1],
User: [tool_result_1, cache=True],
Assistant: [thinking_block_2] + [text block 2],
User: [Text response, cache=True]обрабатывается так, как будто блоков размышлений никогда не было:
User: ["What's the weather in Paris?"],
Assistant: [tool_use block 1],
User: [tool_result_1, cache=True],
Assistant: [text block 2],
User: [Text response, cache=True]На моделях, сохраняющих все ходы, тот же запрос сохраняет thinking_block_1 и thinking_block_2 в контексте и в кэше.
Деградация удаляет размышления из кэшируемой истории. Если размышления отключаются посреди хода, а вы передаёте содержимое размышлений в текущем ходе использования инструментов, это содержимое удаляется, и размышления остаются отключёнными для этого запроса (см. плавную деградацию). Чередующиеся размышления усиливают эффекты инвалидации кэша, поскольку блоки размышлений могут появляться между несколькими вызовами инструментов.
Размышления и контекстное окно
max_tokens, включающий все размышления, которые Claude генерирует в текущем ходе, применяется как строгий лимит. На моделях Claude 4.5 и новее, если входные токены плюс max_tokens превышают размер контекстного окна, API принимает запрос. Если затем генерация достигает лимита контекстного окна, она останавливается с stop_reason: "model_context_window_exceeded" вместо возврата ошибки. На более ранних моделях API вместо этого возвращает ошибку валидации. См. Причины остановки и резервные модели.
То, как размышления учитываются в окне, зависит от того, когда они были сгенерированы:
- Размышления текущего хода всегда учитываются в
max_tokens, оплачиваются как выходные токены и занимают пространство контекстного окна в том ходе, в котором были сгенерированы. - Размышления предыдущих ходов зависят от поведения сохранения по умолчанию. На моделях, сохраняющих все предыдущие ходы, предыдущие блоки размышлений остаются в контексте, учитываются в окне и оплачиваются как входные токены, как и остальная история разговора. На моделях, сохраняющих только последний ход, API автоматически удаляет более старые блоки размышлений, когда вы передаёте их обратно, поэтому они не занимают пространство окна и не расходуют входные токены.
На практике:
- На моделях, сохраняющих все ходы, планируйте контекстное окно так, как если бы размышления были обычной историей разговора, — ведь так оно и есть. Длинные агентные сессии накапливают размышления в контексте. Используйте очистку блоков размышлений, если вам нужно освободить место.
- На моделях, сохраняющих только последний ход, размышления — это затраты только в пределах хода: размышления каждого хода учитываются в
max_tokensэтого хода, а затем выпадают из окна.
Следующие диаграммы иллюстрируют режим сохранения только последнего хода (удаления). На первой показан многоходовой разговор: блок размышлений каждого хода генерируется в выводе, но не переносится во входные данные последующих ходов.
На второй показан тот же режим с использованием инструментов: размышления остаются в контексте вместе с результатом своего инструмента на протяжении хода ассистента, а затем выпадают при следующем ходе пользователя.
Используйте API подсчёта токенов, чтобы получить точные значения для вашего конкретного сценария, особенно для многоходовых разговоров, включающих размышления.
Шифрование размышлений
Полное содержимое размышлений зашифровывается и возвращается в поле signature каждого блока размышлений. API использует подпись, чтобы проверить, что блоки размышлений были сгенерированы Claude, когда вы передаёте их обратно.
При работе с подписями учитывайте следующее:
- Отправлять блоки размышлений обратно строго необходимо только при использовании инструментов с размышлениями. В остальных случаях вы можете опускать блоки размышлений из предыдущих ходов, но не блок между двумя блоками, которые вы сохраняете. Если вы всё же передаёте их обратно, то сохранит ли API их или удалит, зависит от модели (см. Сохранение блоков размышлений в зависимости от модели). Используйте редактирование контекста, чтобы настроить это.
- При отправке блоков размышлений обратно передавайте всё точно в том виде, в каком вы это получили, для согласованности и во избежание возможных проблем.
- При «streaming» (потоковой передаче) ответов подпись приходит как
signature_deltaвнутри событияcontent_block_deltaнепосредственно перед событиемcontent_block_stop. - Значения
signatureзначительно длиннее в моделях Claude 4 и более поздних, чем в предыдущих моделях. - Поле
signatureнепрозрачно: не интерпретируйте и не разбирайте его. - Значения
signatureсовместимы между платформами, включая Claude API, Amazon Bedrock (bedrock-mantle) и Claude Models on Google Cloud (Google managed). Значения, сгенерированные на одной платформе, работают на другой, за исключением того, что блоки размышлений Claude Sonnet 5.5, Claude Haiku 5.5, Claude Fable 5.2 и Claude Mythos 5.2 работают только в аккаунте, который их создал, или в аккаунте, связанном с ним. См. Аккаунты и облачные платформы.
Скрытые блоки размышлений
Помимо обычных блоков thinking, API может возвращать блоки redacted_thinking, когда части рассуждений Claude скрыты из соображений безопасности. Блок redacted_thinking содержит зашифрованное содержимое размышлений в поле data без читаемого текста:
{
"type": "redacted_thinking",
"data": "..."
}Поле data непрозрачно и зашифровано. Как и в случае с полем signature в обычных блоках размышлений, передавайте блоки redacted_thinking обратно в API без изменений при продолжении многоходового разговора с инструментами.
Если ваш код фильтрует блоки содержимого по типу (например, block.type == "thinking") при обратной передаче ответов с использованием инструментов, включайте также блоки redacted_thinking. Фильтрация только по block.type == "thinking" незаметно отбрасывает блоки redacted_thinking и нарушает многоходовой протокол, описанный в разделе Сохранение блоков размышлений.
Блоки redacted_thinking — это отдельный тип блока содержимого, возвращаемый, когда размышления скрыты из соображений безопасности. Это отличается от параметра display: "omitted", который возвращает обычные блоки thinking с пустым полем thinking.
Ограничения и совместимость функций
Параметры сэмплирования
На Claude Fable 5.2, Claude Mythos 5.2, Claude Fable 5.1, Claude Mythos 5.1, Claude Fable 5, Claude Mythos 5, Claude Mythos Preview, Claude Opus 5.5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5.5, Claude Sonnet 5 и Claude Haiku 5.5 значения temperature, top_p или top_k, отличные от значений по умолчанию, возвращают ошибку 400 в каждом запросе, независимо от того, используются ли размышления. На этих моделях значение top_p по умолчанию равно 0.99, поэтому top_p, равное 1, возвращает ошибку 400, как и запрос, включающий одновременно temperature и top_p, даже со значениями по умолчанию. См. Удалите параметры сэмплирования. Начиная с версии API 2026-10-21, запрос, включающий temperature, top_p или top_k с любым значением, возвращает ошибку 400 на любой модели. На более старых моделях в версиях API до 2026-10-21 ограничение действует только при включённых размышлениях: temperature и top_k несовместимы с размышлениями, а top_p допускается в диапазоне от 0,95 до 1.
Предварительное заполнение ответа и принудительное использование инструментов
Модели Claude 4.6 и более поздние, а также Claude Mythos Preview отклоняют предварительно заполненный последний ход ассистента с ошибкой 400 независимо от того, включены ли размышления (см. Предварительное заполнение не поддерживается). На более ранних моделях нельзя предварительно заполнять ответ ассистента при включённых размышлениях. Принудительное использование инструментов (tool_choice: {"type": "any"} или {"type": "tool", ...}) несовместимо с ручными «extended thinking» (расширенными размышлениями), но работает с адаптивными размышлениями. Исключение составляют Claude Opus 5.5, Claude Sonnet 5.5, Claude Fable 5.2, Claude Mythos 5.2, Claude Fable 5.1 и Claude Mythos 5.1, которые отклоняют принудительное использование инструментов в каждом запросе с ошибкой 400. На этих моделях используйте вместо этого tool_choice: {"type": "auto"} со строгим использованием инструментов или структурированными выводами. Там, где принудительное использование инструментов принимается, ответ начинается с вызова инструмента и не содержит блока thinking. Чтобы позволить модели подумать перед вызовом инструмента, используйте tool_choice: {"type": "auto"} и укажите в подсказке, когда использовать инструмент. См. Размышления при использовании инструментов.
Ограничения вывода
Каждая модель принимает max_tokens вплоть до указанного здесь предела. В Message Batches API бета-заголовок output-300k-2026-03-24 повышает этот предел для моделей, у которых указан предел для пакетов.
| Модель | Максимум выходных токенов | Предел Batches (бета) |
|---|---|---|
| Claude Fable 5.2 | 128 тыс. | — |
| Claude Mythos 5.2 | 128 тыс. | — |
| Claude Fable 5.1 | 128 тыс. | — |
| Claude Mythos 5.1 | 128 тыс. | — |
| Claude Fable 5 | 128 тыс. | — |
| Claude Mythos 5 | 128 тыс. | — |
| Claude Mythos Preview | 128 тыс. | Недоступно |
| Claude Opus 5.5 | 128 тыс. | 300 тыс. |
| Claude Opus 5 | 128 тыс. | 300 тыс. |
| Claude Opus 4.8 | 128 тыс. | 300 тыс. |
| Claude Opus 4.7 | 128 тыс. | 300 тыс. |
| Claude Opus 4.6 | 128 тыс. | 300 тыс. |
| Claude Opus 4.5 | 64 тыс. | Недоступно |
| Claude Sonnet 5.5 | 128 тыс. | 300 тыс. |
| Claude Sonnet 5 | 128 тыс. | 300 тыс. |
| Claude Sonnet 4.6 | 128 тыс. | 300 тыс. |
| Claude Sonnet 4.5 | 64 тыс. | Недоступно |
| Claude Haiku 5.5 | 128 тыс. | 300 тыс. |
| Claude Haiku 4.5 | 64 тыс. | Недоступно |
Чтобы программно получить сведения об ограничениях модели, см. раздел Использование Models API.
Длительные запросы
SDK требует потоковой передачи, когда max_tokens больше 21 333, чтобы избежать тайм-аутов HTTP при длительных запросах. Это проверка на стороне клиента, а не ограничение API. Если вам не нужно обрабатывать события инкрементально, используйте .stream() вместе с .get_final_message(), чтобы получить полный объект Message, не собирая его из отдельных событий самостоятельно. См. Получение финального сообщения без обработки событий. Ожидайте более длительного времени ответа при активных размышлениях, поскольку генерация блоков размышлений увеличивает время обработки. Для рабочих нагрузок, в которых размышления превышают примерно 32 тыс. токенов на запрос, используйте пакетную обработку, чтобы избежать сетевых проблем: такие запросы могут выполняться достаточно долго, чтобы упереться в системные тайм-ауты и лимиты открытых соединений.
Следующие шаги
Управляйте тем, как часто и насколько глубоко размышляет Claude, с помощью уровней усилия, указаний в системной подсказке и управления на уровне сообщений, а также разберитесь в стоимости и ценообразовании размышлений.
Пройдите полный двухходовой цикл использования инструментов с корректным сохранением блоков размышлений и посмотрите, как чередующиеся размышления меняют процесс.
Узнайте, редактирует ли ваша интеграция с Messages API историю разговора, и замените каждое редактирование функцией API, которая сохраняет более ранние блоки размышлений действительными.
Диагностируйте и исправляйте наиболее распространённые сбои размышлений: ошибки конфигурации 400, пустые или отсутствующие блоки размышлений, остановки по max_tokens и промахи кэша.
Управляйте тем, сколько токенов Claude использует при ответе, с помощью параметра effort, находя баланс между тщательностью ответа и эффективностью использования токенов.
Доступность
Claude API
- API
- Messages API
- Managed Agents
- Модели
- Все модели
Amazon Bedrock
- API
- Messages API
- Модели
- Все модели
Amazon Bedrock (bedrock-runtime)
- API
- Messages API
- Модели
- Все модели
Claude Platform on AWS
- API
- Messages API
- Managed Agents
- Модели
- Все модели
Claude Models on Google Cloud (Anthropic managed)
- API
- Messages API
- Managed Agents
- Модели
- Все модели
Claude Models on Google Cloud (Google managed)
- API
- Messages API
- Модели
- Все модели
Microsoft Foundry
- API
- Messages API
- Модели
- Все модели
Обработка данных
Обзор обработки данныхПрименимые конечные точки
/v1/messagesсthinking
Кроме Охватываемые модели
Эта страница была полезной?