Примечание автора: claude-haiku-5-5 по умолчанию «думает», а попытка отключить это заканчивается ошибкой? Скорее всего, effort выше high. Ниже — правила, три шага исправления и границы параметров.
Заставить claude-haiku-5-5 думать меньше и отдавать больше выходных токенов под основной текст — типичное желание при пакетной обработке и структурированных задачах. Вы уже, наверное, выставили thinking в disabled, а интерфейс вернул ошибку: хотите отключить размышления — и на тебе, вас же и останавливают. В этой статье разберём правила совместного использования effort и disabled, чтобы вы быстро освоили корректный способ отключения размышлений у claude-haiku-5-5.
Это не мистика и не «глюк» модели. В документации всё написано чётко: если не передавать thinking, у claude-haiku-5-5 включается адаптивное мышление, то есть по умолчанию оно активно; отключается оно через type: disabled в thinking, но такая запись принимается только при effort не выше high. Параметры в статье приведены по официальной документации Anthropic на 2026-11-08 (UTC+8), сверка выполнена 2026-11-13.
Главное: дочитав статью, вы поймёте настоящую причину ошибки, освоите три шага исправления и увидите связь max_tokens с токенами размышлений — и после этого, в каком бы окружении вы ни вызывали модель, на эти грабли больше не наступите.
Ключевые моменты claude-haiku-5-5
Сначала — выводы. Если вы торопитесь, достаточно этого раздела:
| Пункт | Что сказано в документации | Как это влияет на вас |
|---|---|---|
| Мышление включено по умолчанию | Если не передавать thinking, включается адаптивное мышление — по умолчанию |
Хотите экономить лимит — отключайте явно |
| Как отключить | Установить thinking в type: disabled |
Единственный способ отключить |
Порог effort |
disabled принимается, только если effort не выше high |
С xhigh или max будет ошибка |
Значение effort по умолчанию |
По умолчанию medium, как у claude-opus-5-5 |
Если не повышать его вручную, проблем не будет |
| Границы лимита | Максимальный объём вывода — 128000, токены мышления учитываются в max_tokens |
Мышление сокращает место для основного ответа |
claude-haiku-5-5: ключевые детали
Первое: модель думает по умолчанию. claude-haiku-5-5 работает с включённым режимом размышления: если в запросе нет поля thinking, модель использует адаптивное размышление. В документации не раскрываются детали принятия решений в адаптивном режиме, но точно одно — по умолчанию размышление включено.
Если ваш сценарий — короткие вопросы-ответы, массовая разметка, преобразование форматов, то есть задачи, где глубокое рассуждение не нужно, — токены размышления становятся чистыми накладными расходами. В документации также указано, что токены размышления учитываются в max_tokens, а максимальный объём вывода — 128000: чем больше размышлений, тем меньше остаётся на основной текст. Отсюда и возникает желание «отключить размышление и оставить лимит на текст ответа».
Второе: у отключения есть условие. Единственный переключатель для отключения размышления — задать thinking в значение type: disabled. Но в документации прямо сказано, что такая запись принимается только при effort не выше high: при effort равном medium или high всё работает нормально, а стоит указать xhigh или max — и запрос вернёт ошибку. Официальное предписание по исправлению тоже предельно простое — снизить effort до high или ниже. Если вы вызываете claude-haiku-5-5 через APIYI apiyi.com, при разборе таких ошибок тоже начинайте с этой пары параметров.
Третье: значение по умолчанию как раз безопасное. У claude-haiku-5-5 effort по умолчанию равен medium — так же, как у claude-opus-5-5, тогда как у большинства остальных моделей по умолчанию high. Типичная ловушка выглядит так: вы переносите код с другой модели, по привычке явно ставите effort в xhigh или max ради качества и заодно добавляете disabled, чтобы сэкономить, — два намерения конфликтуют, и появляется ошибка.
С другой стороны, если не поднимать effort вручную, значение по умолчанию medium естественным образом удовлетворяет условию «не выше high», и disabled срабатывает нормально. Когда нужно сравнивать разные модели между собой, на APIYI apiyi.com удобно вызывать несколько моделей одним API-ключом — не придётся каждый раз переделывать конфигурацию подключения.
Схема выше — это и есть стандартный путь диагностики; чаще всего проблема упирается в средний блок проверки: effort вышел за границу. После исправления рекомендую сначала прогнать небольшой тестовый запрос на APIYI apiyi.com, убедиться, что ответ приходит нормально, и только потом пускать модель в продакшн-трафик.
claude-haiku-5-5: быстрый старт и починка за три шага
Не нужно шерстить длинную документацию — сделайте три шага ниже, и подобная ошибка в большинстве случаев уйдёт:
- Проверьте ID модели: в запросе
modelдолжен бытьclaude-haiku-5-5— сначала исключите путаницу из-за неверно указанной версии. - Снизьте
effort: установитеhighили ниже.medium— значение по умолчанию, можно вообще не передавать; главное — не передавайтеxhighилиmax. - Отключите thinking: задайте
thinkingкак{"type": "disabled"}. При этомeffortне вышеhigh, и запрос будет принят нормально.
Шпаргалка по параметрам запроса claude-haiku-5-5
| Параметр | Рекомендуемое значение | Описание |
|---|---|---|
model |
claude-haiku-5-5 |
Модель, о которой идёт речь; следите, чтобы не написать другую версию |
thinking |
{"type": "disabled"} |
Единственный переключатель отключения thinking |
effort |
medium (по умолчанию) или high |
Обязательно не выше high, иначе конфликт с disabled |
Запрещённые значения effort |
xhigh, max |
В сочетании с disabled дают ошибку |
max_tokens |
максимум 128000 | Токены thinking входят в это значение; после отключения thinking всё можно оставить основному тексту |
Информация о подключении тоже несложная — на примере APIYI:
- Адрес подключения:
https://api.apiyi.com/v1 - Аутентификация: достаточно одного API Key
- Стиль интерфейса: OpenAI-совместимый API
- Биллинг: оплата по факту, выгодные цены, новым пользователям — бесплатная квота на тесты
- Покрытие: OpenAI, Claude, Gemini и другие популярные модели
🚀 Быстрый старт: рекомендую пройти эту проверку на APIYI apiyi.com. После регистрации прогоните исправленный запрос на бесплатной тестовой квоте, убедитесь, что
disabledработает как надо и ошибка исчезла, — и только потом подключайте реальную задачу. Весь цикл занимает пару минут.
Совместимость effort у claude-haiku-5-5
Вот таблица, которую стоит запомнить из всей статьи — лучше сразу сохранить её в командные заметки:
значение effort |
в сочетании с disabled |
результат |
|---|---|---|
medium (по умолчанию) |
совместимо | размышления отключаются штатно |
high |
совместимо | размышления отключаются штатно |
xhigh |
конфликт | запрос возвращает ошибку |
max |
конфликт | запрос возвращает ошибку |
Сверяясь с этой таблицей и глядя на собственный запрос, сразу понимаешь, куда смотреть: если ошибка появляется именно в запросе, где одновременно передан disabled, первое, что нужно проверить, — не перешагнул ли effort черту high. В документации описан единственный способ исправления — снизить effort до high или ниже, никаких обходных вариантов там нет.
Значения effort по умолчанию у claude-haiku-5-5 и других моделей
| модель | effort по умолчанию |
связь с отключением размышлений |
|---|---|---|
| claude-haiku-5-5 | medium |
по умолчанию удовлетворяет условию «не выше high», disabled срабатывает сразу |
| claude-opus-5-5 | medium |
значение по умолчанию такое же, как у haiku; правила переключателя размышлений для неё в этой статье не рассматриваются |
| большинство остальных моделей | high |
значение по умолчанию тоже в пределах порога, за его границу можно выйти, только подняв значение вручную |
Эта таблица объясняет, «почему ошибка достаётся именно моему запросу»: у разных моделей effort по умолчанию разный, и при переносе кода легко по старой привычке явно задать effort равным xhigh или max. Сверить значения по умолчанию перед миграцией — самая дешёвая профилактика.
Устранение ошибок и чек-лист самопроверки для claude-haiku-5-5
| Симптом | Наиболее вероятная причина | Что делать |
|---|---|---|
Передали disabled, но ошибка остаётся |
effort равен xhigh или max |
Понизьте effort до high или ниже |
Не уверены, какое значение у effort |
Если не передавать, по умолчанию medium |
Значение по умолчанию проходит порог, дополнительных действий не требуется |
| Текст ответа стал короче или обрезается | Токены рассуждения засчитываются в max_tokens |
Отключите рассуждение или увеличьте max_tokens в пределах лимита 128000 |
| Хотите более глубокое качество рассуждений | После отключения рассуждения процесса рассуждения нет | Уберите disabled, вернувшись к адаптивному рассуждению по умолчанию |
После исправления пробегитесь по этому чек-листу перед отправкой запроса:
modelточно указан какclaude-haiku-5-5effortотсутствует или явно равенmedium,highthinkingравен{"type": "disabled"}max_tokensне превышает 128000
Если все четыре условия выполнены, ошибки этого типа больше не побеспокоят. Закрепите итоговую комбинацию параметров в шаблоне запроса — это поможет избежать случайных правок в будущем.
claude-haiku-5-5: часто задаваемые вопросы (FAQ)
Q1: Думает ли claude-haiku-5-5 по умолчанию?
Да. По документации, если не передавать `thinking`, claude-haiku-5-5 работает в режиме адаптивного мышления — он включён по умолчанию. Чтобы весь лимит вывода ушёл на основной текст, нужно явно передать `disabled`, чтобы отключить его.
Q2: Почему я передал disabled, а ошибка всё равно есть?
Самая частая причина — `effort` выше `high`. В документации указано, что `disabled` принимается только при `effort` не выше `high`; в сочетании с `xhigh` или `max` будет ошибка. Решение — снизить `effort` до `high` или ниже.
Q3: Что будет, если не передавать effort?
По умолчанию используется `medium`. У claude-haiku-5-5 и claude-opus-5-5 значение по умолчанию одинаковое — `medium`, у большинства остальных моделей по умолчанию `high`. Само это значение уже удовлетворяет условию «не выше high», поэтому его можно сразу сочетать с `disabled`.
Q4: Как меняется длина вывода после отключения мышления?
В документации указано, что токены мышления учитываются в `max_tokens`, а максимальный вывод — 128000. После отключения мышления тот же бюджет `max_tokens` целиком уходит на основной текст, и риск обрезки снижается.
Q5: Что делать, если временно нужна более глубокая推理?
Просто уберите `disabled`, и claude-haiku-5-5 вернётся к адаптивному мышлению по умолчанию. Если одновременно повышаете `effort`, следите, чтобы не остаться в комбинации «`xhigh` или `max` плюс `disabled`».
Q6: Как быстро проверить, что исправление сработало?
Зарегистрируйтесь на APIYI apiyi.com и получите бесплатный тестовый лимит, в качестве адреса подключения используйте `https://api.apiyi.com/v1`, и прогоните исправленные параметры один раз: если запрос больше не выдаёт ошибку и основной текст возвращается нормально, значит `disabled` уже сработал. Платформа тарифицирует по объёму, так что проверка на небольшом лимите стоит дёшево.
Q7: Ошибка обязательно связана с effort?
Не обязательно, но это один из классов ошибок, явно описанных в документации. Сначала проверьте, точно ли `model` записан как `claude-haiku-5-5`, затем — не выходит ли комбинация `thinking` и `effort` за допустимые рамки, а уже потом ищите другие причины. Если ошибка возникает при вызове через APIYI, начинайте с этой же пары параметров.
Q8: По какой версии сверять эти параметры?
В этой статье всё сверено с официальной документацией Anthropic по состоянию на 2026-11-08 (UTC+8); дата проверки — 2026-11-13. Если официальные правила для `effort` и `disabled` позже изменятся, ориентируйтесь на актуальную документацию.
Итоги
Если говорить о том, как отключить «размышления» у claude-haiku-5-5, суть сводится к четырём пунктам:
- По умолчанию модель «думает»: если не передавать
thinking, включается адаптивное мышление — оно включено по умолчанию, и чтобы экономить лимит, его нужно отключать явно. - У отключения есть условие: когда
thinkingустановлен вdisabled, значениеeffortдолжно быть не вышеhigh; в сочетании сxhighилиmaxбудет ошибка. - Значение по умолчанию безопасно:
effortпо умолчанию равенmedium, как и у claude-opus-5-5, поэтому без ручного повышения конфликт не возникнет. - Границы лимита: максимальный вывод — 128000, токены «размышлений» учитываются в
max_tokens, а после отключения весь лимит остаётся на основной текст.
Если в следующий раз снова наткнётесь на ошибку «хочу отключить размышления, а оно ругается», сначала проверьте, не перешёл ли effort границу high, приведите комбинацию параметров в порядок — и проблема, как правило, решается. Рекомендую через APIYI apiyi.com быстро проверить результат на бесплатном тестовом лимите: один API-ключ даёт доступ к claude-haiku-5-5 и ещё целому ряду популярных моделей, а OpenAI-совместимый интерфейс заметно упрощает переключение между моделями.
📚 Справочные материалы
- Документация APIYI: описание параметров effort и thinking у Claude
- Ссылка:
docs.apiyi.com/api-capabilities/claude-effort-thinking.md -
Описание: допустимые значения effort, условия принятия disabled и формат ошибок
-
Документация APIYI: обновление руководства по размышлениям Claude (2026-11)
- Ссылка:
docs.apiyi.com/live/2026-11/claude-thinking-guide-refresh.md -
Описание: история обновлений и контекст руководства по размышлениям
-
Официальная документация Anthropic
- Ссылка:
docs.anthropic.com - Описание: параметры в этой статье приводятся по официальной версии от 2026-11-08 (UTC+8)
Автор: техническая команда APIYI
Техническое общение: свяжитесь с нами через главную страницу сайта APIYI, больше материалов — в центре документации
