Effort в Claude Code: что это, уровни и почему снова medium

Effort (в русской документации Claude Code — «уровень усилий») определяет, сколько работы Claude вкладывает в каждый запрос: насколько глубоко думает, сколько файлов читает, сколько раз вызывает инструменты и как далеко продвигается, прежде чем вернуться к вам с вопросом. Модель он не меняет: Opus 5.5 на low остаётся Opus 5.5. Уровень по умолчанию зависит от модели. По состоянию на 2 ноября 2026 года Opus 5.5, Sonnet 5.5 и Haiku 5.5 стартуют на medium, Opus 4.7 — на xhigh, все остальные модели с поддержкой effort — на high, поэтому medium в нижней строке на моделях 5.5 — это штатное значение, а не поломка.

Чтобы узнать, на каком уровне идёт текущая сессия, введите /effort status. Чтобы поднять уровень надолго, введите /effort high: Claude Code запишет его для текущей модели в блок modelSettings файла ~/.claude/settings.json, и следующие сессии на этой модели начнутся с high. Если нужен уровень только до конца сессии, нажмите s в ползунке /effort. max всегда действует только на сессию, а переменная окружения CLAUDE_CODE_EFFORT_LEVEL, если она задана, перекрывает всё остальное.

Повышать effort стоит, когда Claude пропустил файл, не запустил тесты или бросил рефакторинг на полпути. Если же у него был весь нужный контекст и он всё равно ошибся, Anthropic советует менять модель, а не уровень.

Что такое effort в Claude Code и на что он влияет

Effort — это ручка объёма работы, а не переключатель интеллекта и не лимит токенов. В статье Anthropic «Choosing a Claude model and effort level in Claude Code» уровень описан как то, сколько Claude делает в целом: сколько файлов прочитает, сколько инструментов задействует и сколько шагов пройдёт, прежде чем отчитаться. Время размышлений — только часть этого. В тестах Anthropic на Opus 5.5 и Fable 5.1 на высоких уровнях Claude проверял больше граничных случаев, чаще перепроверял свою работу и чаще принимал решения сам, а на низких быстрее возвращал черновой результат, который удобно поправить и направить дальше.

У моделей Opus 5.5, Sonnet 5.5, Haiku 5.5 и Fable рассуждения отключить нельзя: alwaysThinkingEnabled: false или MAX_THINKING_TOKENS=0 на них ничего не меняют, и единственный способ сделать Claude «легче» или «тщательнее» — это effort. Шкала откалибрована под каждую модель отдельно, поэтому medium у Opus 5.5 и medium у Opus 5 — разные величины. По документации Claude Code о настройке модели Opus 5.5 на medium в тестах Anthropic не уступает Opus 5 на high в задачах программирования и работы со знаниями, а на одном и том же уровне думает за ход больше. При переходе с Opus 5 документация советует начинать с medium, а не переносить старый high по привычке.

Уровень effort по умолчанию: medium на моделях 5.5, high на остальных

Набор уровней и значение по умолчанию у каждой модели свои. Модели, которых нет в таблице, effort не поддерживают. Если выставить уровень, которого у модели нет, Claude Code молча возьмёт ближайший поддерживаемый уровень ниже: xhigh на Opus 4.6 превращается в high.

Последний столбец — результат локальной проверки. 2 ноября 2026 года Claude Code 2.1.316 на macOS запускался с чистой папкой настроек и с ANTHROPIC_BASE_URL, направленным на локальный тестовый сервер, который только записывает входящие запросы. Настоящая модель не вызывалась, поэтому проверка показывает, какое значение output_config.effort отправляет сам Claude Code, но не то, как модель отвечает на этом уровне и сколько токенов тратит. Каждая модель запускалась командой claude -p "Reply with OK" --model <id> без других настроек, и во всех запросах рядом с уровнем стоял thinking: {"type": "adaptive"}. Остальные результаты этой проверки приведены в разделах ниже.

Если организация задала уровень по умолчанию для своей модели по умолчанию, он заменяет значение из таблицы. При прямых вызовах Claude API значения по умолчанию другие: документация Claude API об effort указывает для Sonnet 5.5 high, тогда как Claude Code отправляет для него medium.

Какой уровень effort выбрать: low, medium, high, xhigh или max

Для большинства задач подходит уровень по умолчанию вашей модели. Anthropic советует настраивать effort как общую привычку под тип работы, а не переключать его перед каждым запросом. Ориентир по уровням взят из таблицы «Выбор уровня усилий» в документации Claude Code.

Разница между high, xhigh и max не в том, что модель становится умнее, а в том, сколько она готова сделать сама. high подходит для работы, где Claude должен проверить себя, но вы всё равно читаете результат. xhigh добавляет глубины ценой токенов и есть не у всех моделей: на Opus 4.6 и Sonnet 4.6 он работает как high. max документация прямо называет склонным к чрезмерному обдумыванию и советует сначала испытать его на своих задачах. Он не сохраняется между сессиями, поэтому совет «просто поставь max» на практике означает «поставь max на эту сессию и проверь, стало ли лучше».

Перед тем как поднимать уровень, решите, что именно не так. Пропущенный файл, незапущенные тесты и брошенный рефакторинг лечатся более высоким effort, а ошибка при полном контексте — более сильной моделью. Сравнение «Sonnet на high или Opus на medium» с ценой задачи разобрано в статье «Claude Sonnet 5.5 или Opus 5.5: разница, цена задачи и выбор», а что меняется для Sonnet с его medium по умолчанию — в «Claude Sonnet 5.5: цены по уровням effort и переход с Sonnet 5». Высокий effort означает больше работы на каждый запрос, и проверить, куда уходит лимит подписки, помогает разбор «Лимиты Claude Code: как проверить в /usage и где теряются токены». Стоимость задачи на Fable и Opus в API сравнивается в статье «Claude Fable 5.1 или Opus 5: цены API и стоимость задачи».

Как поменять effort: /effort, --effort, переменная и settings.json

Способ задать уровень определяет, как долго он проживёт. Claude Code собирает уровень из нескольких источников и берёт первый подходящий в таком порядке: переменная CLAUDE_CODE_EFFORT_LEVEL, затем уровень, выбранный в самой сессии через /effort или /model, затем флаг --effort при запуске, затем файлы настроек и, наконец, значение модели по умолчанию. Поэтому переменная, забытая в .zshrc, молча перебивает любой выбор в ползунке.

Если вы правите файл вручную, так выглядит запись, которая держит Opus 5.5 на high, не трогая остальные модели. Имя модели пишется в каноническом виде, а псевдонимы, суффиксы с датой и [1m] попадают в ту же запись.

{
  "modelSettings": {
    "claude-opus-5-5": {
      "effortLevel": "high"
    }
  }
}

В неинтерактивном запуске claude -p, в удалённой сессии и в Agent SDK команда /effort меняет уровень только для этой сессии, и уровень, выбранный с телефона или из браузера через Remote Control, тоже не сохраняется. Горячих клавиш две пары: стрелки влево и вправо двигают уровень в ползунке /effort (с v2.1.284) и в ползунке внутри /model; их можно переназначить как effortSlider:decreaseEffort / effortSlider:increaseEffort и modelPicker:decreaseEffort / modelPicker:increaseEffort.

Skill и subagent могут задать собственный уровень полем effort во frontmatter своего markdown-файла. Он действует, пока идёт ход этого skill или работает subagent, если вызов subagent не переопределяет его. Две вещи сильнее этого поля: CLAUDE_CODE_EFFORT_LEVEL, который по-прежнему побеждает, и ограничения maxEffortLevel или организации, которые срезают уровень сверху.

Как проверить, на каком уровне effort работает сессия

Нижняя строка показывает уровень, но не источник, из которого он взялся, поэтому проверяйте по порядку.

1. Посмотрите на нижнюю строку и заголовок сессии. В проверке 2 ноября 2026 года свежая сессия на Opus 5.5 показывала ◐ medium · /effort, после /effort high — ● high, после /effort max — ◈ max; заголовок сессии пишет уровень словами, например «with low effort».
2. Введите /effort status. Ответ Effort level: auto (currently medium) означает, что вы уровень не выбирали и Claude Code отправляет значение модели по умолчанию, здесь medium. Ответ Effort level: auto без скобок означает, что уровень не отправляется вовсе. До v2.1.304 команда ошибочно показывала auto (currently high) даже тогда, когда уровень не отправлялся.
3. Выполните в терминале echo $CLAUDE_CODE_EFFORT_LEVEL. Если там есть значение, оно перекрывает всё, что вы выбираете в сессии.
4. Откройте ~/.claude/settings.json и найдите в modelSettings запись своей модели, а также ключи effortLevel и maxEffortLevel верхнего уровня. Проверьте и настройки проекта: effortLevel там действует на все модели.
5. Если сессия переключилась на резервную модель, снова введите /effort status. После автоматического переключения Claude Code сохраняет уровень исходного запроса: Opus 5.5 на medium, откатившийся на Opus 4.8, останется на medium, хотя у Opus 4.8 по умолчанию high, пока вы не смените уровень, не выберете модель в /model или не возобновите сессию.

Новый уровень начинает действовать со следующего сообщения после подтверждения /effort. Чтобы применить его посреди длинного хода, отправьте в очередь короткое сообщение вроде keep going, пока Claude работает.

Почему effort не сохраняется и снова medium

Чаще всего уровень «сбрасывается» не из-за сбоя, а потому что был задан способом, который действует меньше, чем вы думали, или его перекрыл другой источник. Строки таблицы, отмеченные проверкой, воспроизведены в Claude Code 2.1.316 2 ноября 2026 года в изолированной папке пользовательских настроек; настройки проекта и управляемые настройки в этой проверке не участвовали.

Большинство расхождений из таблицы проходят молча: в проверке через -p без единого сообщения игнорировались верхнеуровневый effortLevel в пользовательских настройках на Opus 5.5 и max в файле настроек, а CLAUDE_CODE_EFFORT_LEVEL=xhigh так же тихо срезался потолком maxEffortLevel до high. Предупреждения в stderr появились только для флага: о превышении потолка (текст приведён в разделе про maxEffortLevel) и об опечатке. Команда с --effort banana вывела в stderr Warning: Unknown --effort value 'banana' — ignoring it and using the default effort. Valid values: low, medium, high, xhigh, max. и отправила medium. Там же подтвердился и обратный путь: --effort max и --effort low на Opus 5.5 отправили ровно max и low, а CLAUDE_CODE_EFFORT_LEVEL=max — max.

Интерактивная часть проверки прошла в той же версии на Opus 5.5 со свежей конфигурацией. /effort high ответил Set effort level to high (saved as your default for new sessions): Comprehensive implementation with extensive testing and documentation, и в settings.json появилась запись "modelSettings": {"claude-opus-5-5": {"effortLevel": "high"}}. /effort max ответил Set effort level to max (this session only): Maximum capability with deepest reasoning. May use excessive tokens resulting in long response times or overthinking. Use sparingly for the hardest tasks. — файл при этом не изменился, а следующее сообщение ушло с max. Ползунок без аргументов выглядел так: шкала Faster … Smarter, уровни low medium high xhigh max, справа Ultracode off · Tab to toggle, внизу подсказка ←/→ to adjust · Enter to confirm · s for this session only · Esc to cancel.

Ultracode, ultrathink и auto: что из этого уровень effort

Ни одно из трёх слов не является шестым уровнем. Ultracode — отдельная настройка поверх effort, ultrathink — разовая просьба думать глубже в одном ходе, а auto означает «уровень не выбран», причём в двух местах по-разному.

Ultracode и max: переключатель против уровня

Ultracode — это настройка Claude Code, при которой Claude для крупных задач строит динамические рабочие процессы и работает на том уровне effort, какой стоит в сессии. Включается он командой /effort ultracode (выключается /effort ultracode off) или клавишей Tab в ползунке с подтверждением Enter, а постоянно — ключом "ultracode": true; сам уровень при этом не меняется. Исключение — флаг --effort ultracode: он включает ultracode и одновременно ставит xhigh. В проверке 2 ноября 2026 года он отправил xhigh на Opus 5.5 и high на Opus 4.6, где xhigh нет. effortLevel и CLAUDE_CODE_EFFORT_LEVEL значение ultracode не принимают. До v2.1.284 включение ultracode переводило сессию на xhigh, а выбор другого уровня его выключал, поэтому старые описания расходятся с нынешним поведением. Вопрос «max или ultracode» поэтому некорректен: max углубляет работу в каждом запросе, ultracode меняет способ организации большой задачи, и их можно сочетать.

ultrathink и «think hard»

Слово ultrathink в любом месте запроса просит более глубоких рассуждений в этом ходе, не меняя настройку сессии; фразы вроде «think», «think hard» или «think more» передаются как обычный текст. Поведение отличается в терминале и в -p. В проверке 2 ноября 2026 года в интерактивной сессии на medium ход ultrathink about this and reply with OK ушёл на xhigh, следующий обычный ход вернулся к medium, а нижняя строка всё время показывала medium. В claude -p "ultrathink: reply with OK" уровень остался medium, и Claude Code только добавил в системный контекст строку The user included the keyword "ultrathink", requesting deeper reasoning on this turn. Reason as thoroughly as the task warrants., а think hard не добавил ничего. Поднимать ход до xhigh умеет только терминальная версия с v2.1.311, и тогда слово подсвечивается радугой. Если подсветки нет, удалите переменную CLAUDE_CODE_EFFORT_LEVEL, когда она задаёт уровень ниже xhigh, поднимите maxEffortLevel или лимит организации до xhigh и выше либо перейдите на Opus 5.5, Sonnet 5.5, Haiku 5.5 или Fable 5.1. Там, где ход поднять нельзя, например в Amazon Bedrock, выставляйте сам уровень effort.

/effort auto и CLAUDE_CODE_EFFORT_LEVEL=auto

/effort auto стирает сохранённый уровень текущей модели и возвращает её к значению по умолчанию, оставляя записи других моделей и верхнеуровневый effortLevel на месте. В проверке после /effort auto (ответ Effort level set to auto) запись claude-opus-5-5 превратилась в {}, а следующее сообщение ушло с medium. Переменная CLAUDE_CODE_EFFORT_LEVEL=auto, заданная до запуска claude, делает другое: Claude Code вообще не отправляет поле effort, и в проверке в запросе его действительно не было. Тогда действует значение по умолчанию самого API, а /effort status показывает просто Effort level: auto.

Ограничение effort для команды и одной модели: maxEffortLevel

Чтобы никто в команде не запускал сессии выше определённого уровня, используйте maxEffortLevel, а не effortLevel. effortLevel в управляемых настройках задаёт только стартовое значение, которое пользователь может поменять, а maxEffortLevel срезает любой более высокий уровень до потолка: из /effort, /model, --effort, переменной окружения, frontmatter skill и subagent и даже значение модели по умолчанию. Claude Code применяет потолок сам перед каждым запросом, поэтому он действует у любого провайдера, включая Amazon Bedrock, Google Cloud Agent Platform и Microsoft Foundry. Ключ требует v2.1.267 или новее и работает в любом файле настроек; если потолки заданы в нескольких, действует самый низкий, а "max" означает «без потолка». Уровни выше потолка из ползунка /effort пропадают.

Пример из справочника настроек Claude Code ограничивает все модели уровнем medium и снимает ограничение для Sonnet 4.6:

{
  "maxEffortLevel": "medium",
  "modelSettings": {
    "claude-sonnet-4-6": {
      "maxEffortLevel": "max"
    }
  }
}

В проверке 2 ноября 2026 года с "maxEffortLevel": "high" запуск с --effort max отправил high и вывел в stderr Effort 'max' exceeds the cap for claude-opus-5-5 set by your settings or organization; using 'high'., а CLAUDE_CODE_EFFORT_LEVEL=xhigh при том же потолке тоже дал high, но без сообщения в выводе -p. В плане Claude Enterprise администраторы могут дополнительно задать предельный уровень для каждой роли и каждой модели (Claude Code v2.1.195 или новее); если действуют оба ограничения, применяется более низкое.

Ошибка «Effort 'xhigh' isn't available with thinking turned off»

Эта ошибка появляется, когда рассуждения выключены, а уровень выше high стоит на модели, которая такое сочетание не принимает, например на Opus 5. Полный текст: API Error: Effort 'xhigh' isn't available with thinking turned off on this model · run /effort high to continue, or turn thinking back on (unset MAX_THINKING_TOKENS=0). В версиях до v2.1.242 она выглядела как API Error: 400 output_config.effort 'xhigh' is not supported when thinking is disabled on this model. Use effort 'high' or below, or enable thinking. Исправить можно двумя путями: выполнить /effort high или включить рассуждения обратно, удалив MAX_THINKING_TOKENS=0 из окружения и alwaysThinkingEnabled: false из настроек. С v2.1.251 Claude Code сам отправляет high моделям, о которых знает, что они отклоняют такое сочетание, поэтому при повторении ошибки сначала обновите Claude Code. На Opus 5.5, Sonnet 5.5, Haiku 5.5 и моделях Fable рассуждения не выключаются вовсе, так что на них эта комбинация не возникает.