ИНСТРУКЦИЯ · 7 МИН. ЧТЕНИЯ
Режимы рассуждения: пять уровней
Уровней рассуждения пять, и по умолчанию включён второй сверху. Поэтому повышать уровень обычно почти некуда, а понижать можно — и это экономит лимиты.
Effort в документации называется поведенческим сигналом. Он не задаёт жёсткий потолок токенов: на низком уровне модель всё равно может рассуждать над сложной задачей, но меньше, чем на высоком.
Он влияет на весь ответ: объяснения, вызовы инструментов, аргументы и рассуждения. На низком уровне модель чаще объединяет операции и сразу действует; на высоком — делает больше вызовов, объясняет план и подробно описывает изменения.
Пять уровней
От низкого к высокому: low — меньше рассуждений, простое пропускает; medium — умеренно, простое пропускает; high — рассуждает почти всегда, ЭТО УРОВЕНЬ ПО УМОЛЧАНИЮ; xhigh — всегда глубоко; max — максимальная глубина.
У вашей модели может быть четыре уровня
Набор зависит от модели. Fable 5, Opus 5, Sonnet 5, Opus 4.8 и Opus 4.7 поддерживают все пять. Opus 4.6 и Sonnet 4.6 — четыре, без xhigh. В линейке Haiku effort отсутствует.
При выборе неподдерживаемого уровня Claude Code возвращается к ближайшему нижнему. Например, xhigh на Opus 4.6 выполняется как high. Ошибки нет, но поведение отличается от запрошенного.
По умолчанию — high, с одним исключением
У моделей с поддержкой effort значение по умолчанию — high. Исключение: Opus 4.7 в Claude Code запускается с xhigh. В API у той же модели остаётся high, а xhigh нужно указывать явно.
Явно выбрать high — то же, что оставить параметр без значения: документация описывает одинаковое поведение.
Как переключать уровень
/effort — открыть ползунок;
/effort xhigh — выбрать уровень;
/effort auto — вернуть значение модели по умолчанию;
claude --effort max — задать уровень на один запуск.
Другие способы: ползунок в /model, переменная окружения и поле файла настроек. В настройках допустимы low, medium, high и xhigh. Max там не сохраняется: он действует в рамках сессии.
Пример ~/.claude/settings.json:
{
"effortLevel": "xhigh"
}
Приоритет: переменная окружения, пользовательская настройка, значение модели по умолчанию. Effort в frontmatter навыка или субагента действует во время его активности и перекрывает уровень сессии, но не переменную окружения.
Отдельной горячей клавиши смены уровня нет. Option+T на Mac и Alt+T на других системах переключают сами рассуждения, а не уровень effort.
Max не сохраняется после перезапуска
Low, medium, high и xhigh, выбранные интерактивно, сохраняются между сессиями. Max без переменной окружения действует только в текущей. После закрытия возвращается значение по умолчанию.
Смена уровня посреди работы сбрасывает кэш
Уровень включается в промпт, поэтому его смена нарушает кэширование. В примере документации первый запрос создаёт кэш на 3546 токенов, второй использует его, а третий после перехода с high на medium создаёт кэш заново.
В длинной сессии выбирайте уровень в начале и затем не меняйте.
Когда повышать уровень
Позиция Anthropic: для большинства задач оставляйте значение модели по умолчанию. Повышайте при конкретном недостатке: пропущен файл, не запущены тесты, не выполнена проверка.
Если задача не требует более глубокого рассуждения, повышение effort решает не ту проблему. Причину стоит искать в контексте, CLAUDE.md или постановке задачи.
Для max документация отмечает убывающую отдачу и склонность к излишним действиям. Сначала проверяйте его на своих задачах. Для Opus 4.7 стартовый уровень программирования — xhigh, а max стоит выбирать, когда измерения показывают пользу.
Два разных регулятора
Модель и effort отвечают за разное. Модель — за знания, тонкие ошибки, незнакомые области и архитектуру. Effort — за продолжительность усилий. В повседневной задаче большая модель может лишь расходовать больше дорогих токенов без улучшения результата.
Ultrathink распознаётся, «think hard» — обычный текст
Популярная лестница think → think hard → think harder → ultrathink не соответствует текущему поведению. Claude Code распознаёт только ultrathink: слово добавляет инструкцию в контекст, но не меняет уровень API. Остальные фразы передаются как текст промпта.
Да, рассуждения расходуют лимиты
Anthropic прямо называет effort фактором расхода и советует снижать его для повседневных задач, не требующих глубокой проработки. Числовой коэффициент не опубликован, поэтому точное увеличение расхода неизвестно.
Реальный расход рассуждений можно измерить по полю API-ответа usage.output_tokens_details.thinking_tokens. При стриминге оно приходит в последнем событии.
Блок рассуждений может отсутствовать
Для каждого запроса модель решает, нужны ли рассуждения. В одном диалоге могут быть оба варианта. Код, работающий с API, не должен предполагать постоянное наличие блока рассуждений.
Чек-лист настройки effort
Проверьте уровень через /effort. Узнайте, сколько уровней поддерживает модель. Для повседневных задач оставьте значение по умолчанию. Каждое повышение должно объясняться конкретной проблемой.
До повышения проверьте, не решается ли проблема правкой CLAUDE.md или самой задачи. В длинной сессии выбирайте уровень заранее. Не пытайтесь постоянно сохранить max в настройках.


