Мышление и параметр effort

Мышление (thinking) — это механизм, позволяющий Claude тратить токены на внутреннее рассуждение перед финальным ответом. Актуальный способ его включения — адаптивное мышление: thinking: {"type": "adaptive"}. Модель сама решает, когда и сколько думать, и может вставлять рассуждение между вызовами инструментов. Старый способ с фиксированным бюджетом thinking: {"type": "enabled", "budget_tokens": 16000} устарел: на Opus 4.6 и Sonnet 4.6 он помечен как deprecated, а на Fable 5, Opus 4.7 и Opus 4.8 возвращает ошибку HTTP 400.

Глубина рассуждения и общий расход токенов управляются параметром effort: output_config: {"effort": "low" | "medium" | "high" | "xhigh" | "max"}. Значение по умолчанию — high; xhigh — лучший выбор для кодинга и агентных сценариев. Важно: если поле thinking в запросе не передано, адаптивное мышление НЕ включается — задавайте его явно.

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

При адаптивном мышлении модель оценивает сложность запроса и сама определяет, нужно ли рассуждать и как глубоко, — фиксированный токен-бюджет настраивать не нужно. Рассуждение по-прежнему возвращается в ответе блоками контента типа thinking. Нюанс: на Opus 4.7 и новее текст рассуждения по умолчанию опущен — блоки приходят пустыми; чтобы получить резюме рассуждения, явно укажите thinking: {"type": "adaptive", "display": "summarized"}. Параметр effort при этом влияет не только на глубину мышления, но и на общий стиль работы модели: при низких значениях — меньше и компактнее вызовы инструментов, короче преамбулы и подтверждения; при высоких — более тщательное исследование задачи.

Когда применять

Включайте адаптивное мышление с high или xhigh для задач, где качество критично: проектирование архитектуры, отладка сложных багов, математика, многошаговое планирование, длинные агентные циклы с инструментами. Для рутинных задач — классификации, извлечения, коротких ответов — снижайте effort до low/medium или не включайте мышление вовсе. Рассуждение увеличивает стоимость и задержку ответа, поэтому применяйте его выборочно, а не на каждом запросе. max оставьте для случаев, когда корректность важнее цены.

Типичные ошибки

Частые ошибки: отправка budget_tokens на Fable 5, Opus 4.7 или 4.8 — запрос упадёт с HTTP 400 (на Opus 4.6 и Sonnet 4.6 параметр пока работает, но deprecated — не используйте его в новом коде); ожидание, что мышление включено «из коробки» — пропущенное поле thinking означает выключено; недоумение по поводу пустых блоков thinking на Opus 4.7+ — без display: "summarized" текст рассуждения опускается намеренно; выставление max везде подряд (переосмысление простых задач и раздутые счета); показ рассуждений конечному пользователю без фильтрации — промежуточный ход мысли может содержать то, что показывать не стоит.

Связанные понятия

• Режим мышления
• Токены бюджета
• Потоковое мышление
• Когда использовать мышление