Effort в Claude Code: какой уровень выбрать и когда нужен Ultracode
Кратко. В меню /effort вы увидите
low, medium, high,
xhigh, max и Ultracode. Первые пять — уровни
усилия рассуждения; Ultracode — отдельный переключатель для работы
нескольких агентов через dynamic workflows. Он стоит в том же меню,
поэтому в сравнении пропускать его нельзя. Для обычной разработки
начинайте с medium или high; повышайте effort,
когда задача требует тщательной проверки, а Ultracode включайте, когда
работу полезно разделить между агентами.
Вы просите Claude Code переименовать поле в одном обработчике. Потом приносите баг: при повторном запросе пользователь иногда видит чужой результат из кеша. Команда в обоих случаях одна — «исправь», но цена поверхностного ответа разная. В первом случае достаточно быстро найти место и поправить тест. Во втором нужно проследить ключи кеша, область действия пользовательских данных и соседние вызовы. Для этого и нужен переключатель effort.
Что меняет effort
Effort управляет адаптивным рассуждением: модель сама определяет, где стоит подумать дольше, а где можно сразу перейти к действию. Более высокий уровень даёт ей больше пространства для исследования, вариантов и самопроверки. Обычно это увеличивает расход токенов и время работы, но не устанавливает жёсткое число «секунд на размышление» и не гарантирует правильный ответ.
Значение уровня зависит от модели. Один и тот же high у
разных поколений Claude нельзя считать одинаковым объёмом мысли. При
смене модели проверьте текущую настройку, а не переносите прежнюю
привычку автоматически.
Пункт /effort |
Когда ставить | Пример задачи |
|---|---|---|
low |
Маленькая, чётко ограниченная правка, которую вы сразу просмотрите | Переименовать параметр в одном файле |
medium |
Повседневная работа с понятным объёмом | Добавить поле в форму и обновить связанный тест |
high |
Возможны пограничные случаи; важна проверка изменений | Найти причину сбоя в существующем коде |
xhigh |
Длинная задача с несколькими гипотезами и заметной ценой ошибки | Проследить поток данных через сервисы и устранить утечку из кеша |
max |
Самая трудная аналитическая задача, где оправдан повышенный расход | Разобрать сложную уязвимость и проверить, не повторяется ли она в соседних модулях |
| Ultracode (отдельный переключатель, не уровень глубины) | Когда содержательную задачу полезно разложить на работу нескольких агентов | Проверить авторизацию во всех независимых группах API-маршрутов и свести результаты |
Это ориентиры, а не правило «чем выше, тем качественнее». На короткой
задаче max может тратить время на варианты, которые вы и
так отвергнете при просмотре diff. В документации Anthropic прямо
предупреждают о снижающейся отдаче и склонности max к
избыточному анализу. Если баг не воспроизводится из-за отсутствующего
тестового стенда, повышенный effort стенд не создаст.
С чего начать на практике
Для понятной фичи на актуальных Opus и Sonnet я бы начала с
medium. Для отладки существующего сервиса, где легко задеть
соседние сценарии, — с high. На xhigh
переходите, когда после первого прохода остаются конкурирующие
объяснения бага или нужно самостоятельно исследовать большой кусок кода.
max оставьте для случая, когда особенно важна глубина
проверки и вы готовы платить за дополнительные попытки анализа.
Есть полезная проверка: запустите одну и ту же типовую задачу на
medium и high, сравните не красоту отчёта, а
изменённый код, запущенные тесты, пропущенные края и расход. Если
результат одинаковый, нет смысла всегда держать более высокий уровень.
Если модель на medium регулярно не замечает регрессии, это
аргумент перейти на high для такого класса задач.
На момент подготовки черновика в каталоге kosareva.cloud есть Claude Sonnet
5.5 и Claude Opus
5.5. В актуальной документации Claude Code их базовый effort —
medium; доступные уровни включают xhigh и
max. У Opus 4.6 и Sonnet 4.6 набор другой:
xhigh не поддерживается, при его выборе Claude Code
откатывается к high. Список моделей и настройки со временем
меняются, поэтому перед запуском проверьте выбранную модель и меню
/effort.
Как переключить уровень
В интерактивной сессии откройте ползунок командой
/effort или задайте уровень напрямую:
/effort medium
/effort high
/effort xhigh
/effort maxПосмотреть текущую настройку можно через /effort status.
Команда /effort auto убирает вручную сохранённый уровень
для активной модели и возвращает её настройку по умолчанию. Если задаёте
low, medium, high или
xhigh прямой командой в интерактивной сессии, Claude Code
сохраняет выбор для этой модели и следующих сессий; max
обычно действует только до конца текущей сессии. Для одноразового
запуска используйте флаг:
claude --effort highВ новых версиях интерфейса можно выбрать уровень ползунком и нажать
s, чтобы применить его только к текущей сессии, не меняя
сохранённую настройку модели. Если пункта нет или команда ведёт себя
иначе, проверьте версию Claude Code и доступные возможности выбранной
модели.
Ultracode: шестой пункт меню, но не шестая ступень глубины
Ultracode есть и в таблице, и в меню /effort:
пользователь действительно выбирает его там же, где остальные пункты. Но
после max не появляется ещё одна ступень «думать глубже».
xhigh и max меняют усилие рассуждения модели;
Ultracode позволяет Claude Code автоматически планировать
dynamic workflows для содержательных задач. Такой workflow
распределяет работу между субагентами и собирает их результаты. В
актуальных версиях его можно включить при текущем уровне effort, не
обязательно на max.
Когда это полезно? Если нужно проверить авторизацию в десятках независимых маршрутов, можно разделить маршруты на группы, затем свести находки и провести общий проход по тестам. Если вы чините один обработчик, несколько агентов обычно лишь увеличат расход и объём результатов для ревью. Ultracode не делает каждую задачу параллельной: Claude Code сам оценивает, нужен ли workflow.
Для одной задачи добавьте ключевое слово в запрос, не меняя сессию:
ultracode: проверь авторизацию в src/routes/ по каждому маршруту. Сгруппируй независимые проверки, затем сведи находки и укажи, какие тесты подтвердили исправления.Для всей текущей сессии в Claude Code версии 2.1.284 и новее:
/effort ultracode
/effort ultracode offПервая команда включает оркестрацию при уже выбранном
effort, вторая выключает. Если запустить
claude --effort ultracode, Claude Code одновременно
включает её и выбирает xhigh. В версиях до
2.1.284 команда /effort ultracode тоже переводила
сессию на xhigh, а отдельной команды off не
было. Поэтому совет «после Ultracode напишите /effort high»
подходит для старого поведения, но не для нового.
Ultracode способен задействовать много агентов. Каждый из них
расходует токены; в API это отражается на счёте, в подписке — на
лимитах. Перед аудитом целого монорепозитория разумнее попробовать одну
директорию. Если workflow не дал пользы по сравнению с обычной работой
на high, оставьте его для более широкой задачи.
Ограничения, о которых легко забыть
Высокий effort не заменяет критерии приёмки. Задача «исправь кеш» без
воспроизводимого сценария и проверки изоляции пользователей останется
расплывчатой и на max. Дайте агенту пример сбоя, ожидаемое
поведение и список тестов, которые должны пройти.
Наличие Claude Opus или Sonnet в каталоге API-шлюза ещё не
доказывает, что конкретная версия Claude Code и выбранная модель
поддержат все уровни effort или dynamic workflows через этот шлюз. Если
работаете через kosareva.cloud, сначала проверьте доступные пункты
/effort и выполните маленькую пробную задачу. Не выдаём
доступность модели за подтверждённую совместимость всех режимов.
Частые вопросы
max всегда лучше
high?
Нет. max даёт модели больше пространства для анализа, но
на простых задачах добавляет расход и может увести в избыточную
проверку. Сравнивайте уровни на своих типовых задачах, а не по
названию.
Почему после смены модели изменился привычный effort?
Claude Code хранит выбор отдельно для моделей, а их значения по
умолчанию и поддерживаемые уровни отличаются. Проверьте
/effort status после переключения.
Можно ли включить
Ultracode, оставив medium?
В Claude Code версии 2.1.284 и новее — да:
/effort ultracode включает оркестрацию без смены текущего
уровня. Флаг запуска --effort ultracode, напротив,
одновременно устанавливает xhigh.
Почему я не вижу
xhigh?
Этот уровень поддерживают не все модели. Например, в документации Claude Code он доступен для Opus 5.5 и Sonnet 5.5, но отсутствует у Opus 4.6 и Sonnet 4.6.
Стоит ли держать Ultracode включённым постоянно?
Обычно нет, если большинство ваших задач небольшие. Автоматические workflows могут добавить агентов и расход; на короткой правке их нечем занять. Включайте Ultracode на широкий аудит или миграцию и выключайте после неё.
Для меня практический ориентир такой: medium для
понятной работы, high для бага с последствиями,
xhigh для длинного расследования. max берите,
когда выигрыш от дополнительной проверки вероятнее её стоимости.
Ultracode пригодится тогда, когда задачу можно честно разделить между
агентами, а итог вы сможете проверить как единое изменение.
Источники
Заведите аккаунт за минуту
Один ключ ко всем моделям из статьи. Пополнение от 50 ₽ картой или по счёту, списание по факту, без абонентской платы.