Примечание автора: статья подготовлена по официальной документации Anthropic от 2026-11-08 (UTC+8) и по обновлённому 2026-11-09 в 10:40 руководству APIYI по параметрам thinking в Claude; формулировки сверены 2026-11-13. Материал поможет избежать ошибки 400 при работе с параметром thinking в claude-opus-5-5 и claude-sonnet-5-5.
Если в claude-opus-5-5 передать в thinking значение type: disabled, интерфейс сразу вернёт 400 — именно так сказано в официальной документации Anthropic от 2026-11-08 (UTC+8). APIYI (apiyi.com) 2026-11-09 в 10:40 обновил руководство по параметрам thinking в Claude и подробно разобрал, как правильно записывать оба ID моделей. В этой статье — короткий разбор того, что эти изменения означают для тех, кто вызывает Claude API.
Это не слухи: оба ключевых вывода подтверждены документацией — в claude-opus-5-5 нельзя отключить thinking, можно только снизить effort; в claude-sonnet-5-5, чтобы отключить предварительное рассуждение, нужно перейти на between_tools.
Главное: за 3 минуты вы узнаете, как правильно записывать оба ID моделей, каковы границы параметра between_tools и как искать причину ошибки 400.
Кратко о главном: параметр thinking у claude-opus-5-5 и claude-sonnet-5-5
Сначала таблица с выводами, потом разберём по пунктам:
| Пункт | Детали |
|---|---|
| Официальный источник | 2026-11-08 (UTC+8), официальная документация Anthropic |
| Обновление руководства APIYI | 2026-11-09 10:40, docs.apiyi.com уже синхронизирован |
| claude-opus-5-5 | Не передаёте thinking — адаптивное мышление; передаёте disabled — ответ 400 |
| claude-sonnet-5-5 | Без thinking — тоже адаптивное мышление; отключить предварительное обдумывание можно через between_tools |
Значение effort по умолчанию |
У Opus 5.5 — medium, у Sonnet 5.5 — high |
| Максимальный вывод | У обоих ID моделей 128000, токены размышления входят в этот лимит |
У claude-opus-5-5 формулировка довольно прямолинейная. Если в запросе нет поля thinking, модель переходит в режим адаптивного мышления и сама решает, думать ли в этот раз и насколько глубоко. А вот если задать type у thinking как disabled, интерфейс не проигнорирует это молча — он сразу вернёт 400. Иными словами, у этого ID модели нет выключателя размышлений: единственный способ регулировки, который даёт документация, — снизить effort, значение по умолчанию — medium.
У claude-sonnet-5-5 ситуация немного другая. Он тоже поддерживает адаптивное мышление, когда thinking не передан, но у него есть дополнительный официально признанный путь отключения: если задать type как between_tools, предварительное обдумывание выключается и остаются только обновления прогресса между вызовами инструментов. Границы этого пути тоже прописаны чётко, так что лучше сразу сверяться с таблицей ниже:
| Ограничение | Что говорит документация |
|---|---|
Значения effort |
Принимаются только low, medium, high |
| Верхняя граница | Не выше high |
| Совместимость | Нельзя одновременно с display или budget_tokens |
| Практический эффект | Предварительное обдумывание отключено, остаются только обновления прогресса между вызовами инструментов |
Есть ещё одна деталь, которую легко упустить: токены размышления учитываются в max_tokens. У обоих ID моделей максимум вывода — 128000. Если задать в запросе слишком низкий max_tokens, размышления могут съесть больше половины бюджета, и основной текст обрежется. Когда разбираетесь, почему «ответ непонятно с чего стал короче», первым делом стоит проверить, сколько бюджета заняли размышления.
Пояснение к схеме: на ней цепочка вызовов показана на примере шлюза APIYI apiyi.com в нативном формате Anthropic. При работе в формате Anthropic базовый адрес — https://api.apiyi.com; обратите внимание, что писать его с /v1 не нужно.
Анализ последствий: кого затрагивает ошибка 400 при использовании disabled
Это изменение правил затрагивает клиентов в трёх местах — обработке ошибок, комбинациях параметров и планировании бюджета. Если разобрать по пунктам, картина станет нагляднее.
Влияние на существующий код: миграция с disabled
| Сценарий | Старый вариант | Текущий результат | Как правильно |
|---|---|---|---|
| claude-opus-5-5 хочет отключить размышления | передать disabled в type |
возвращается 400 | отключить нельзя, можно только снизить effort |
| claude-sonnet-5-5 хочет отключить предварительные размышления | передать disabled в type |
возвращается 400 | переключиться на between_tools |
| нужно тонко управлять бюджетом размышлений | between_tools вместе с budget_tokens |
комбинация не принимается | их нельзя передавать вместе; используйте три уровня effort |
| есть опасение, что размышления съедят вывод | задать очень маленький max_tokens |
основной текст обрезается | размышления учитываются в max_tokens, оставьте запас |
Первое последствие — ограничений на комбинации параметров стало больше. between_tools нельзя использовать одновременно с budget_tokens или display. Это значит, что тонко управлять бюджетом размышлений этим путём больше не получится — остаётся только косвенная регулировка через три уровня: low, medium, high. С учётом правила «токены размышлений учитываются в max_tokens» клиенту приходится заново искать баланс между effort и max_tokens.
Второе последствие — нужно обновить логику ветвлений. Если скрипт по ID модели решает, передавать ли disabled, то для этих двух ID нужны отдельные ветки: первый принимает реальность «отключить нельзя» и понижает уровень через effort; второй переключается на between_tools. Если хранить такие ветки в одном месте конфигурации, то при следующем изменении правил правок будет меньше всего.
Кстати, на той же странице указано, что Fable 5.1 и Fable 5 при передаче disabled тоже получают 400 — их так же нельзя отключить. А Haiku 5.5 и Opus 5 всё ещё могут использовать disabled, если effort не выше high. Если код обслуживает несколько ID моделей, лучше вести матрицу переключателей по моделям, а не применять один и тот же подход глобально.
Влияние на структуру затрато в: thinking token и расход
В сводной таблице APIYI (apiyi.com) стоимость claude-sonnet-5-5 указана так: вход $2, выход $10, чтение кэша $0.1. Поскольку thinking token учитываются в max_tokens, то, отключите ли вы предварительное обдумывание и какой уровень effort выберете, напрямую отразится на расходе токенов. В сценариях с частыми вызовами эта разница будет только расти — при правке кода стоит заодно прикинуть расходы.
Пояснение к схеме: данные взяты из официальной документации от 2026-11-08, проверить оригинал можно в центре документации APIYI apiyi.com.
| ID модели | Доступность disabled |
Формулировка в документации |
|---|---|---|
| claude-opus-5-5 | Недоступно, возвращается 400 | Обдумывание не отключить, можно только снизить effort (по умолчанию medium) |
| claude-sonnet-5-5 | Недоступно, возвращается 400 | Переключитесь на between_tools (по умолчанию high) |
| Fable 5.1 / Fable 5 | Недоступно, возвращается 400 | Тоже не отключается |
| Haiku 5.5 / Opus 5 | Доступно, когда effort не выше high |
Старый синтаксис работает только для этих двух ID |
Как быстро проверить between_tools у claude-sonnet-5-5
Перед выкатыванием изменений в прод советуем сначала проверить различия в поведении на небольшом трафике. Зарегистрируйтесь в APIYI (apiyi.com) и получите API-ключ — новым пользователям доступен бесплатный тестовый лимит; запросы отправляются на https://api.apiyi.com. В теле запроса установите для thinking параметр type в значение between_tools, для effort выберите один из трёх уровней, прогоните один раунд, а затем сравните с адаптивным режимом без передачи thinking — и посмотрите, как изменились структура вывода и расход токенов.
🚀 Совет по быстрой проверке: получите бесплатный тестовый лимит через APIYI apiyi.com, прогоните одну и ту же группу промптов в двух режимах —
between_toolsи адаптивном — и только после подтверждения различий меняйте существующий код. Платформа поддерживает единый вызов популярных моделей Claude, OpenAI, Gemini и других, а OpenAI-совместимый интерфейс тарифицируется по объёму использования — это удобно для сравнения и переключения.
Частые вопросы (FAQ): disabled, between_tools и ошибка 400
Q1: можно ли вообще отключить рассуждения у claude-opus-5-5?
Нельзя. В официальной формулировке от 2026-11-08 прямо сказано: передача `disabled` вернёт 400, у этого ID модели нет переключателя для отключения рассуждений — глубину можно уменьшить только через `effort`, а уровень по умолчанию — `medium`. Если в сценарии рассуждения должны полностью отсутствовать, остаётся только сменить ID модели.
Q2: можно ли использовать between_tools у claude-sonnet-5-5 вместе с budget_tokens?
Нельзя. В документации прямо указано, что `between_tools` нельзя одновременно использовать с `display` или `budget_tokens`; соответствующий `effort` принимает только три уровня — `low`, `medium`, `high` — и не может быть выше `high`. Если нужен точный контроль бюджета рассуждений, придётся вернуться к адаптивному режиму или сменить ID модели.
Q3: почему мой запрос к Claude вдруг возвращает 400?
Сначала проверьте, не установлен ли в теле запроса `type` у `thinking` в значение `disabled` — для claude-opus-5-5 и claude-sonnet-5-5 это прямо указанное в документации условие срабатывания. Если подтвердилось, действуйте по таблице соответствий из этой статьи: для первой модели снизьте `effort`, для второй переключитесь на `between_tools`. Актуальные формулировки — по официальной документации от 2026-11-08 (UTC+8); страница APIYI синхронизирована 2026-11-09 в 10:40.
Q4: как быстро проверить эффект between_tools у claude-sonnet-5-5?
Зарегистрируйте аккаунт в APIYI (apiyi.com) и получите API-ключ — новым пользователям доступен бесплатный тестовый лимит. Запросы отправляются на `https://api.apiyi.com`; установите `type` у `thinking` в `between_tools`, выберите любой уровень `effort`, прогоните один раунд — и вы увидите разницу с адаптивным режимом.
Q5: съедают ли токены рассуждений бюджет вывода?
Да. Токены рассуждений учитываются в `max_tokens`, а максимальный вывод у обоих ID моделей — 128000. Если в запросе задать `max_tokens` слишком низким, рассуждения могут первыми израсходовать бюджет, и основной текст обрежется — поэтому лучше заранее оставить достаточно места для самого ответа.
claude-opus-5-5 и claude-sonnet-5-5: ключевые выводы
- У claude-opus-5-5 нельзя отключить размышления: передача
disabledсразу возвращает 400; понизить уровень можно только черезeffort, по умолчанию —medium. - claude-sonnet-5-5 перешёл на
between_tools: отключает предварительное размышление и оставляет только обновления прогресса между вызовами инструментов. - Три ограничения по параметрам:
effortподдерживает толькоlow,medium,high, вышеhighнельзя;displayиbudget_tokensзапрещены. - Правила бюджета: токены размышления входят в
max_tokens, верхний лимит для обоих ID — 128000. - Где проверить: APIYI apiyi.com, base в формате Anthropic —
https://api.apiyi.com, без/v1.
Итог: три действия, чтобы избежать 400
Всё сводится к трём фразам:
- claude-opus-5-5: передача
disabledдаёт 400, размышления не отключить — можно только понизитьeffort. - claude-sonnet-5-5: отключаем предварительное размышление через
between_tools, три уровняeffort;displayиbudget_tokensзапрещены. - Бюджет: токены размышления входят в
max_tokens, лимит — 128000, оставляйте запас для основного ответа.
Если вы застряли на этой ошибке 400, рекомендую сначала на APIYI apiyi.com с бесплатным тестовым лимитом прогнать сценарий с between_tools, убедиться в поведении, а потом менять существующий код. Один API-ключ на платформе позволяет вызывать OpenAI, Claude, Gemini и другие популярные модели; оплата по факту использования — удобно для быстрого сравнения и переключения.
📚 Справочные материалы
- Руководство APIYI по параметрам thinking Claude: как правильно применять effort и thinking
- Ссылка:
docs.apiyi.com/api-capabilities/claude-effort-thinking.md -
Описание: версия, обновлённая 2026-11-09 в 10:40 — основной источник фактов для этой статьи
-
Обновления справочника APIYI: официальное пояснение о синхронизации формулировок в этом раунде
- Ссылка:
docs.apiyi.com/live/2026-11/claude-thinking-guide-refresh.md -
Описание: описывает процесс сверки с официальной документацией от 2026-11-08
-
Официальная документация Anthropic: первоисточник формулировок по параметру thinking
- Ссылка:
docs.anthropic.com - Описание: рекомендуем читать параллельно, чтобы проверить актуальный синтаксис
Автор: техническая команда APIYI
Техническая связь: пишите нам через главную страницу сайта APIYI, больше материалов — в центре документации docs.apiyi.com
