Уровни усилия и ultracode

Почему это важно именно вам

Есть два разных вопроса: «кто делает работу» и «насколько тщательно он её делает». В первой части курса мы отвечали только на первый — выбирали модель. Второй рычаг — уровень усилия — не менее важен, а стоит ровно ничего: это одна команда.

Практический смысл простой. Одна и та же модель на низком усилии ответит за десять секунд и потратит минимум лимита. На максимальном — будет думать минуту, перепроверит себя и найдёт то, что на низком пропустила. Разница видна именно на задачах, где ответ неочевиден: разбор противоречий в данных, поиск причины сбоя, решение с несколькими вариантами.

Директорская аналогия: вы просите юриста «глянуть договор по диагонали перед встречей» или «разобрать построчно, мы подписываем на три года». Тот же человек, разная глубина, разный счёт за работу.

Что это такое

Уровень усилия управляет адаптивным рассуждением: модель сама решает, думать ли над шагом и сколько, а уровень задаёт верхнюю планку этой свободы.

Доступные уровни зависят от модели. У Fable 5, Opus 5, Sonnet 5, Opus 4.8 и 4.7:

Уровень	Что это значит на практике
`low`	быстро и дёшево; для механики и очевидных задач
`medium`	компромисс, когда важнее скорость
`high`	значение по умолчанию; подходит большинству задач
`xhigh`	глубже обычного; для сложных разборов
`max`	максимальная глубина; для самого трудного

По умолчанию стоит high на всех моделях, кроме Opus 4.7 — у неё по умолчанию xhigh. Если вы зададите уровень, которого модель не поддерживает, Claude Code возьмёт ближайший доступный сверху вниз — например, xhigh на старой модели выполнится как high.

Отдельная позиция в меню — ultracode. Это не уровень усилия, а режим Claude Code: он отправляет модели xhigh и вдобавок заставляет Claude оркестрировать динамические workflow — то есть раскладывать существенную задачу на десятки параллельных агентов. Про сами workflow будет блок 9; пока запомните, что ultracode — это «максимальное усилие плюс автоматическое привлечение команды».

Ultracode стоит дорого — и работает не всегда

Он не просто думает дольше: он запускает много агентов. На простой задаче это выброшенные деньги и время. Включать его стоит там, где цена ошибки выше цены прогона: аудит, поиск неочевидного бага, разбор запутанной ситуации.

Вторая оговорка: оркестрация работает, только если у вас включены динамические workflow. На тарифе Pro они по умолчанию выключены — включаются строкой «Dynamic workflows» в /config. Если workflow выключены, ultracode превращается просто в xhigh: думает глубже, но команду агентов не собирает.

Как работает на практике

Посмотреть и сменить уровень

/effort

Без аргумента открывает меню с уровнями и пунктом ultracode. С аргументом — переключает сразу:

/effort low
/effort xhigh
/effort ultracode

Уровни low, medium, high, xhigh, выбранные в интерактивной сессии, сохраняются между сессиями — причём отдельно для каждой модели: у Opus и Sonnet свои запомненные уровни. max — только на текущую сессию (если не задан переменной окружения). /effort status показывает текущий уровень, /effort auto сбрасывает сохранённый для активной модели.

Задать уровень при запуске

claude --effort xhigh
claude --effort ultracode

--effort ultracode требует версии 2.1.203 или новее: на более старых сессия молча стартует с уровнем по умолчанию.

Для скриптов и автоматических прогонов это единственный надёжный способ: в неинтерактивном режиме команда /effort применяется только к текущему запуску и не сохраняется.

Закрепить постоянно

export CLAUDE_CODE_EFFORT_LEVEL=high

Переменная окружения перебивает выбор в сессии. Тонкость: значение ultracode она не принимает — это настройка Claude Code, а не уровень модели. Если переменная выставлена в уровень, отличный от xhigh, ultracode со своей оркестрацией не включится, и Claude предупредит об этом.

Практическая схема на день

Утро, разбор почты и мелкие задачи:

/model sonnet
/effort medium

Разбор сложной ситуации — расхождение цифр, странное поведение системы:

/model opus
/effort xhigh

Аудит, который не жалко оставить на час без присмотра:

/model fable
/effort ultracode

Массовая механика:

/model haiku
/effort low

Два рычага, а не один

Модель отвечает за способность, усилие — за старательность. Сильная модель на низком усилии часто хуже, чем средняя на высоком, — просто потому, что не стала думать. Если ответ выглядит поверхностным, первым делом поднимите усилие, а не меняйте модель.

Частые ошибки

Держать max всегда. Это заметно медленнее и дороже, а выигрыш проявляется только на действительно трудных задачах. На простых вы просто ждёте дольше.

Ждать от ultracode магии на пустом месте. Он раскладывает задачу на агентов — если задача не раскладывается (короткий вопрос, правка одной строки), вы платите за оркестрацию, которая ничего не даёт.

Забывать про уровень в автоматических прогонах. Скрипт, запущенный по расписанию, унаследует уровень по умолчанию. Если ночная задача требует глубины — задайте --effort xhigh явно в самой команде.

Считать, что усилие лечит плохую постановку задачи. Не лечит. Максимальное усилие над расплывчатым запросом даёт очень тщательно продуманный ответ не на тот вопрос.

Не проверять, применился ли уровень. На тарифе Enterprise администратор может поставить потолок уровня — отдельно для каждой модели, так что при смене модели набор доступных уровней меняется. Тогда ваш max тихо выполнится как разрешённый максимум — в интерактивной сессии будет предупреждение, в фоновом агенте нет.

Когда нужно / когда нет

Поднимать усилие стоит:

когда ответ звучит правдоподобно, но вы не уверены, что он верен;
в задачах с неочевидной причиной: расхождения, сбои, противоречивые данные;
когда решение принимается один раз и надолго.

Снижать стоит:

в массовых однотипных операциях;
в интерактивной работе, где важнее темп диалога;
когда вы просто уточняете формат или просите переписать текст.

Ultracode включать:

на аудитах и поиске багов, где нужна полнота, а не скорость;
на задачах, которые вы всё равно оставите работать без присмотра.

Не включать:

на всём подряд «чтобы получше»;
когда у вас жёсткий лимит на месяц и до конца периода далеко.

Связь с другими уроками

День 61 — выбор модели. Модель и усилие крутятся вместе: сначала выбираете исполнителя, потом задаёте глубину.

День 74 — динамические workflow. Именно их запускает ultracode. Там вы научитесь делать это осознанно и вручную, а не одним общим переключателем.

День 65 — деньги. Усилие — второй по влиянию фактор расхода лимита после объёма контекста.

Задание на сегодня

Выполните /effort и посмотрите, какие уровни доступны на вашей модели.
Возьмите задачу, где вы недавно получили поверхностный ответ. Повторите её на /effort xhigh и сравните.
Возьмите механическую задачу и выполните её на /effort low — засеките, насколько быстрее.
Решите, какой уровень должен быть у вас по умолчанию, и закрепите его через CLAUDE_CODE_EFFORT_LEVEL.
Если у вас есть автоматический прогон (по расписанию или скриптом) — добавьте в него явный --effort.

Критерий «выполнено»: вы на одной и той же задаче увидели разницу между уровнями и можете объяснить, какой уровень ставите по умолчанию и почему.

Резюме

Уровень усилия — второй рычаг рядом с выбором модели: он задаёт глубину рассуждения, а не способности.
Уровни: low, medium, high (по умолчанию везде, кроме Opus 4.7 — там xhigh), xhigh, max. Набор зависит от модели, неподдерживаемый уровень понижается до ближайшего, а сохраняется он отдельно для каждой модели.
/effort переключает в сессии, --effort — при запуске, CLAUDE_CODE_EFFORT_LEVEL закрепляет постоянно.
Ultracode — не уровень, а режим: xhigh плюс автоматическая оркестрация workflow (требует включённых динамических workflow — на Pro их включают в /config). Дорого, оправдано на аудитах и сложных разборах.
В автоматических прогонах уровень задавайте явно флагом: настройка из интерактивной сессии туда не переносится.
Поверхностный ответ чаще лечится повышением усилия, чем сменой модели.