Для Claude Opus 5.5 разумная отправная точка — medium: это уровень усилий (effort) по умолчанию. На повторяемых, хорошо описанных действиях попробуйте low; если модель решает лишь часть задачи и проверка это показывает, переходите на high. xhigh и max оставьте для работы, где дополнительная глубина действительно улучшает готовый результат настолько, что оправдывает время и расход токенов. Это не универсальный рейтинг качества: документация Anthropic прямо советует перебрать уровни на собственных задачах.
Здесь важно не перепутать две настройки. Effort направляет поведение модели, влияя на размышление, текст ответа и вызовы инструментов; он не выделяет ей фиксированное число токенов. max_tokens, напротив, задаёт жёсткий предел для размышления вместе с видимым ответом. Поэтому повышение effort при слишком тесном max_tokens может прервать работу до полезного результата. О цене самой модели, её доступе и несовместимостях при миграции отдельно рассказано в обзоре Opus 5.5.
Как выбрать один из пяти уровней
У Opus 5.5 доступны low, medium, high, xhigh и max. Следующая таблица — практическая отправная точка, а не обещание, что уровень гарантированно справится с указанной задачей. Описания уровней и значение по умолчанию опубликованы в руководстве Anthropic по effort.
| Уровень | С чего пробовать | Когда пересмотреть выбор |
|---|---|---|
low | Переименование по готовому образцу, короткое преобразование или другой механический шаг с простой проверкой | Если пропускает случаи или требует повторных попыток, вернитесь к medium |
medium | Повседневная разработка и агентная работа с понятным объёмом; уровень Opus 5.5 по умолчанию | Если проверка выявляет незавершённые зависимости, попробуйте high |
high | Сложная отладка, несколько связанных компонентов, трудные задачи программирования | Если выигрыш не окупает дополнительные токены и время, вернитесь к medium |
xhigh | Длинная многошаговая работа, где важна устойчивость на большом горизонте | Сопоставьте долю успешно завершённых задач с задержкой и расходами |
max | Задача, для которой вы сознательно готовы к максимальному расходу ради предельной глубины | Не оставляйте как общий уровень без проверки экономической пользы |
Не переносите без проверки прежний конфиг Opus 5. Запрос без effort у Opus 5 выполнялся на high, а у Opus 5.5 — на medium. Поэтому простая замена ID модели меняет сразу две переменные. Более того, руководство для Opus 5.5 предупреждает: одинаковое имя уровня у двух версий ещё не гарантирует одинаковый расход размышления. Для честного сравнения явно зафиксируйте модель и effort в каждой группе задач.
Настройка в Claude Code
В сеансе Claude Code введите /effort status, чтобы увидеть текущий уровень, затем, например, /effort high. Новый уровень применяется со следующего запроса. Для рутины можно тем же способом установить /effort low, а после неё вернуть medium. Команды и рекомендации для ежедневной работы описаны в материале Anthropic о стоимости задач.
Есть цена переключения посреди длинного диалога: изменение effort или thinking в Claude Code очищает кэш беседы. Следующий запрос заново записывает её в кэш. Поэтому сравнивать «один ход до» и «один ход после» как будто условия одинаковы нельзя. Если задача уже близка к завершению, учитывайте стоимость этой записи; если текущий уровень раз за разом не закрывает задачу, переключение может всё равно оказаться выгоднее нового цикла исправлений. Для подписки Claude Code расчёт по публичным ставкам API служит лишь ориентиром расхода ресурсов, а не суммой счёта пользователя.
Настройка в Messages API
В прямом Messages API задайте уровень в output_config.effort. Минимальный пример запроса с отдельным лимитом вывода:
bashcurl https://api.anthropic.com/v1/messages \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{ "model": "claude-opus-5-5", "max_tokens": 4096, "output_config": {"effort": "medium"}, "messages": [{"role": "user", "content": "Назовите два риска при миграции схемы данных."}] }'
Нужен действующий ANTHROPIC_API_KEY и доступ к модели в вашем аккаунте. Ответ с content и usage подтверждает, что запрос прошёл; само наличие параметра в коде ещё не подтверждает поддержку на стороннем маршруте. Пример следует официальному синтаксису output_config.effort; платный вызов для этой статьи не выполнялся.
На Opus 5.5 адаптивное мышление включено постоянно. Не пытайтесь совместить effort с thinking: {"type": "disabled"} или прежним thinking: {"type": "enabled", "budget_tokens": ...}: такие настройки дают HTTP 400. На высоких уровнях подберите max_tokens так, чтобы хватило и на размышление, и на итоговый ответ. Если перед вами ошибка 400 после перехода с Opus 5, сначала проверьте именно эти поля; остальные изменения при миграции разобраны в отдельном руководстве.
Менять уровень между ходами API можно двумя способами, но кэш ведёт себя по-разному. Если менять верхнеуровневый output_config.effort от запроса к запросу, ранее кэшированный префикс беседы перестаёт совпадать. Отдельная бета-возможность effort на уровне сообщения позволяет добавить пустое системное сообщение с новым output_config.effort и заголовком mid-conversation-output-config-2026-07-01: изменение действует со следующего хода пользователя и сохраняет предшествующий префикс кэша. Это описано в API-документации для поддерживаемых моделей, включая Opus 5.5. Не переносите это свойство на команду /effort в Claude Code.
Что говорят независимые цифры — и чего они не говорят
В Artificial Analysis Intelligence Index v4.3.2 уровни Opus 5.5 показали такую пару «сводный балл / взвешенная стоимость одной задачи индекса» при включённом fallback:
| Effort | Балл AA Index | Доллары за задачу AA Index |
|---|---|---|
low | 42 | $0,55 |
medium | 51 | $1,34 |
high | 54 | $1,82 |
xhigh | 56 | $3,46 |
max | 58 | $5,98 |
Это составной показатель десяти оценок и стоимость взвешенной тестовой задачи, а не цена обычного запроса, подписки или вашей конкретной работы. Например, переход с medium на high в этой серии дал +3 балла при +$0,48 за задачу индекса; с high на xhigh — ещё +2 балла при +$1,64. Разница вычислена из таблицы, а не измерена на реальном проекте. Она показывает, почему более высокий уровень нельзя выбирать по одному баллу без цены и типа задачи.
Сравнивайте стоимость завершённой работы
Для своей оценки возьмите набор реальных задач одного типа и заранее задайте проверку результата: тесты, просмотр затронутых файлов, критерий ответа или действия агента. Прогоните одинаковые условия на medium и одном соседнем уровне. Записывайте не только сумму токенов первого ответа, но и число повторов, вызовы инструментов, время до принятого результата и долю задач, которые вообще удалось закрыть. Если на low приходится чаще исправлять работу, экономия отдельного хода может исчезнуть. Если high предотвращает цикл исправлений, он может оказаться дешевле по готовой задаче, несмотря на больший вывод.
Для прямого Claude API на 23 сентября 2026 года тариф Opus 5.5 составляет $4 за миллион обычных входных токенов и $20 за миллион выходных; чтение из кэша — $0,20, запись на пять минут — $5, на час — $8 за миллион токенов. В расчёте одной завершённой задачи сложите соответствующие категории по всем её ходам и повторам. Меняя effort, отмечайте сбросы кэша отдельно: одинаковый размер промпта не означает одинаковый счёт. Эти прямые ставки не включают наценку посредника, налоги и условия подписки.
Итоговое правило простое: оставляйте medium, пока задача завершается с приемлемым качеством и временем. Понижайте effort только после проверки, что результат сохраняется; повышайте, когда проверка показывает конкретный недочёт, который дополнительная глубина помогает устранить. Перед длительной серией зафиксируйте выбранный уровень и способ учёта кэша — иначе сравнение затрат будет вводить в заблуждение.
