API и разработка
Effort в Claude Code: medium, high, xhigh и max — что выбрать
Как уровень effort в Claude Code влияет на качество и расход токенов. Почему max часто хуже xhigh, что стоит по умолчанию у Sonnet 5.5 и Opus 5.5 и как настроить effort под API или подписку.
В Claude Code есть настройка, которая влияет на ваш счёт сильнее, чем выбор модели, — и большинство её ни разу не трогали. Это effort, уровень усилия рассуждений. Один и тот же Sonnet 5.5 на medium и на max — это, по сути, два разных инструмента с разным характером, скоростью и ценой. Давайте разберёмся, как они отличаются и почему «поставить на максимум» — почти всегда плохая идея.
Что вообще регулирует effort
Современные модели Claude думают адаптивно: перед ответом и между шагами они сами решают, нужно ли рассуждать и насколько долго. Effort задаёт этому рассуждению рамки. На низком уровне модель быстрее переходит к делу и чаще возвращает вам «черновик», который вы доводите сами. На высоком — дольше проверяет крайние случаи, перепроверяет свою работу и принимает больше решений самостоятельно.
Anthropic в документации Claude Code описывает это так: на высоком уровне Claude тестирует больше краевых случаев и проверяет больше своей работы, а на низком быстрее отдаёт отправную точку, что подходит для работы, где вы проверяете каждый результат и направляете следующий шаг.
Уровней пять: low, medium, high, xhigh и max. У Sonnet 5.5, Opus 5.5 и Fable 5.1 доступны все пять.
Сюрприз: у новых моделей по умолчанию стоит medium
Если вы пересели на Sonnet 5.5 или Opus 5.5 с предыдущих версий, вы могли не заметить важную деталь: по умолчанию у них medium, а не high, как у большинства прошлых моделей.
Это не экономия за ваш счёт. По данным Anthropic, Opus 5.5 на medium в тестах на программирование и офисные задачи не уступает, а местами превосходит Opus 5 на high. Новые модели просто думают больше за один ход, поэтому планку сдвинули вниз. Отсюда практический совет прямо из документации: при переходе на модели 5.5 начинайте с medium, а не переносите привычный уровень со старой модели.
Пять уровней на пальцах
| Уровень | Когда подходит |
|---|---|
low | Быстрые правки, переименования, наброски, мозговой штурм — всё, что вы тут же проверите глазами |
medium | Повседневная разработка с понятной постановкой: новая функция, типовая задача. По умолчанию у Sonnet 5.5 и Opus 5.5 |
high | Работа, где важна проверка и вероятны краевые случаи: баг в чужом коде, изменения в сложном модуле |
xhigh | Глубокие рассуждения для действительно трудных задач: архитектура, запутанный рефакторинг, неочевидный баг |
max | Длинные автономные задачи, где цена ошибки высока, например поиск уязвимостей. Anthropic прямо предупреждает о склонности к overthinking |
Почему max — ловушка
Интуиция подсказывает: платишь больше — получаешь лучше. С effort это работает до определённой точки, а потом начинает работать против вас.
В документации Anthropic про max сказано прямо: он может давать убывающую отдачу и склонен к overthinking, поэтому его стоит протестировать, прежде чем включать повсюду. И это не формальная оговорка. У Sonnet 5.5 в бенчмарке FrontierCode результат на max оказался ниже, чем на xhigh: 46,2% против 52,1%, по данным Anthropic и разбора Vellum. Модель начинала перепроверять лишнее, упиралась в таймауты и правила код за пределами задачи.
Ещё нагляднее — независимый эксперимент, описанный на DEV Community. Автор прогнал одну и ту же задачу — реализовать девять функций по докстрингам — на всех уровнях effort. Все уровни прошли все 57 тестов с первой попытки. Только low справился за 77 секунд и $0,59, а max — за одиннадцать с половиной минут и $4,72. Код тот же, счёт в восемь раз больше, токенов в двенадцать раз больше.
Его вывод, с которым мы полностью согласны: для хорошо поставленной задачи, где сессия может сама запустить тесты, хватает low или medium. Высокие уровни стоит оставлять для задач, где модель не может сама себя проверить: неоднозначная диагностика, гонки, большие незнакомые кодовые базы.
Effort стоит по-разному для API и для подписки
Вот где выбор уровня перестаёт быть абстрактным.
Если вы работаете через API, effort напрямую превращается в деньги. Рассуждения тарифицируются как выходные токены, самые дорогие. Разница между medium и max на одной задаче может составить разы, как в эксперименте выше. Поэтому для работы через API правильный effort — это главная статья экономии. В паре с кешированием промптов она даёт больше, чем переход на более дешёвую модель. Через API Клодыча вы платите в рублях ровно за то, что потратили, и видите расход по каждому ключу. Актуальные тарифы — на странице цен, другие способы экономии — в статье как снизить расходы на Claude API.
Получить API-ключ для Claude Code в Клодыче →
Если у вас подписка Claude Pro или Max, effort не меняет цену, но меняет лимиты. Чем выше уровень, тем быстрее вы выбираете отведённый объём и упираетесь в ограничение до конца окна. Тот, кто сидит на max по привычке, просто быстрее заканчивает рабочий день. Для подписки разумный подход тот же: medium на каждый день, повышать точечно. Подписку Claude Pro можно оформить в Клодыче на свой аккаунт за 2 099 ₽, а если лимитов Pro не хватает, есть Claude Max 5× за 12 990 ₽.
Оформить Claude Pro в Клодыче →
Как переключать effort
Всё управляется парой команд:
/effortбез аргументов открывает ползунок,/effort highсразу задаёт уровень,/effort autoвозвращает значение по умолчанию для модели. Менять уровень можно даже пока Claude работает.- В ползунке
Enterсохраняет уровень как постоянный для этой модели, аsприменяет его только к текущей сессии. - При запуске можно передать флаг:
claude --effort high. - Переменная окружения
CLAUDE_CODE_EFFORT_LEVELзадаёт уровень для всех сессий. - В
settings.jsonуровни хранятся отдельно для каждой модели в ключеmodelSettings.
Две тонкости. Первая: max нельзя сохранить в настройках — Claude Code включает его только на текущую сессию, если не задать его через переменную окружения. Это разумная защита от случайного «вечного максимума». Вторая: если нужно подумать глубже над одним конкретным вопросом, не трогайте уровень вовсе — добавьте в промпт слово ultrathink. Это усилит рассуждение только на один ход. Фразы вроде «подумай хорошенько» ключевыми словами не являются и передаются модели как обычный текст.
Если Claude Code у вас ещё не настроен, начните с инструкции по установке и подключению. А о том, как сейчас меняется сам Claude Code, мы пишем в changelog на русском.
Наша схема
Если упростить всё сказанное до одного правила: effort выбирается под задачу, а не под модель и не «на всякий случай».
Каждый день: medium. Этого достаточно для большинства задач на Sonnet 5.5 и Opus 5.5, и так и задумано. Сложный баг в незнакомом коде: high. Архитектура, запутанный рефакторинг, неочевидная ошибка: xhigh. Один трудный вопрос посреди обычной работы: ultrathink в промпте. А max — только для длинных автономных задач, где вы готовы заплатить за тщательность и заранее проверили, что она окупается.
Подробнее о том, как Sonnet 5.5 ведёт себя на разных уровнях, мы писали в разборе Sonnet 5.5 и Claude Code.
API Клодыча
Ссылка откроет бота в Telegram. Нажмите «Старт», затем выберите нужный раздел.
Получить API-ключ →