Клодыч В Telegram ↗

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-ключ →
Получить API-ключ →