Конфигурация модели

Настройте, какую модель использует Claude Code, уровни усилий, расширенный контекст и окно auto-compact

Доступные модели

Для настройки model в Claude Code вы можете указать либо:

Псевдоним модели
Имя модели
- Anthropic API: полное имя модели
- Amazon Bedrock: ARN профиля вывода
- Microsoft Foundry: имя развёртывания
- Google Cloud's Agent Platform: имя версии

Рекомендации по выбору модели и уровня усилий для различных типов работ см. в статье Choosing a Claude model and effort level in Claude Code в блоге.

Псевдонимы моделей

Используйте псевдоним модели для выбора параметров модели без необходимости запоминать точные номера версий:

Псевдоним модели	Поведение
`default`	Специальное значение, которое очищает любое переопределение модели и возвращается к стандартной модели для вашей учётной записи. Сам по себе не является псевдонимом модели
`best`	Использует модель, на которую разрешается псевдоним `fable`, где Fable доступна вам, в противном случае ту же модель, что и `opus`
`fable`	Использует модель Fable для вашего поставщика для ваших самых сложных и долгоживущих задач
`sonnet`	Использует последнюю модель Sonnet для ежедневных задач кодирования
`opus`	Использует последнюю модель Opus для сложных задач рассуждения
`haiku`	Использует быструю и эффективную модель Haiku для простых задач
`sonnet[1m]`	Использует Sonnet с контекстным окном в 1 миллион токенов для длительных сессий. Не имеет эффекта, когда `sonnet` уже разрешается на Sonnet 5.5 или Sonnet 5 с их встроенным окном 1M
`opus[1m]`	Использует Opus с контекстным окном в 1 миллион токенов для длительных сессий. Не имеет эффекта, когда `opus` уже разрешается на Opus 4.7 или более позднюю версию со встроенным окном 1M
`opusplan`	Специальный режим, который использует `opus` в режиме планирования, затем переключается на `sonnet` для выполнения

Псевдонимы opus, sonnet и haiku разрешаются на новейшую версию в Anthropic API и на более раннюю версию у некоторых других поставщиков:

Поставщик	`opus`	`sonnet`	`haiku`
Anthropic API	Opus 5.5	Sonnet 5.5	Haiku 5.5
Claude Platform on AWS	Opus 5.5	Sonnet 4.6	Haiku 4.5
Amazon Bedrock, Google Cloud's Agent Platform	Opus 5.5	Sonnet 4.5	Haiku 4.5
Microsoft Foundry	Opus 4.6	Sonnet 4.5	Haiku 4.5

Если вы не установили ANTHROPIC_DEFAULT_FABLE_MODEL, псевдоним fable разрешается на Fable 5.1, за исключением сессий Claude apps gateway, где fable и best разрешаются на Fable 5.

Шлюз, который не настроен на обслуживание claude-fable-5-1, отклоняет запросы для этой модели. Чтобы использовать Fable 5.1 через шлюз, который его обслуживает, выберите его с помощью /model claude-fable-5-1.

Где opus или sonnet разрешается на более старую модель, более новые модели доступны путём явного выбора полного имени модели или установки ANTHROPIC_DEFAULT_OPUS_MODEL или ANTHROPIC_DEFAULT_SONNET_MODEL.

Более ранние версии разрешают эти псевдонимы на более старые модели. Для версии, в которой каждый псевдоним изменился, см. Version history.

Псевдонимы указывают на рекомендуемую версию для вашего поставщика и обновляются со временем. Чтобы закрепить определённую версию, используйте полное имя модели, например claude-opus-5-5, или установите соответствующую переменную окружения, например ANTHROPIC_DEFAULT_OPUS_MODEL.

Работа с Fable

Claude Fable 5.1 и Claude Fable 5 — это наиболее мощные модели в Claude Code, подходящие для задач, требующих более одной сессии. Они поддерживают длительные автономные сессии, исследуют перед действием и проверяют свою работу чаще, чем меньшие модели. Fable 5.1 — это более новый выпуск.

Ни одна из моделей Fable не является стандартной для типа учётной записи ни на одном плане или поставщике. Выберите одну явно:

Fable 5.1: запустите /model fable или запустите с помощью claude --model fable. В сессиях Claude apps gateway, где псевдоним разрешается на Fable 5, вместо этого запустите /model claude-fable-5-1.
Fable 5: выберите её по ID модели. В Anthropic API запустите /model claude-fable-5 или запустите с помощью claude --model claude-fable-5. На других поставщиках используйте ID модели Fable 5 вашего поставщика или закрепите её с помощью ANTHROPIC_DEFAULT_FABLE_MODEL.

Если вы подключаетесь непосредственно к Anthropic API и ваши пользовательские настройки содержат claude-fable-5 или claude-fable-5[1m] в качестве модели, например потому что вы выбрали Fable в средстве выбора /model до версии 2.1.257, Claude Code изменит это сохранённое значение на псевдоним fable или fable[1m] при первом запуске версии 2.1.257 или позже. Строка запуска модели показывает (auto-updated) один раз. Значение claude-fable-5 в настройках проекта, локальных или управляемых настройках остаётся как есть.

Запросы, которые классификаторы безопасности модели Fable помечают, чаще всего в областях кибербезопасности и биологии, запускают автоматическое переключение на резервную модель.

Чтобы получить максимум от Fable:

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

В Anthropic API модель Fable появляется в средстве выбора /model, если availableModels или ограничения модели организации её не исключают. Когда ваша организация вообще не может использовать Fable, например при нулевом сохранении данных, строка остаётся в средстве выбора неактивной с примечанием о причине.

Fable и кредиты использования

В зависимости от вашего плана и уровня места использование Fable может оплачиваться из кредитов использования вместо использования включённых лимитов вашего плана. Когда это происходит, средство выбора /model показывает "Requires usage credits" в строке Fable. Для управления кредитами использования см. Add usage credits to your subscription.

В интерактивных сессиях Claude Code показывает запрос согласия перед запросом Fable, который оплачивается из кредитов использования. Члены планов Enterprise с организационным биллингом не видят запрос. Вы можете продолжить работу на Fable, используя кредиты использования, или переключиться на вашу модель по умолчанию. Вы также можете отклонить запрос:

Когда вы выбираете модель Fable с помощью /model, вы сохраняете вашу текущую модель.
Во время сессии Claude Code продолжает ход на вашей модели по умолчанию.

После того как вы выберете продолжить работу на Fable, используя кредиты использования, Claude Code больше не показывает запрос.

В сессии с подключённым Remote Control, фоновой сессии или сессии участника команды агентов у терминала может никого не быть, поэтому Claude Code удерживает запрос согласия во время сессии до крайнего срока dialogExpiry, пять минут по умолчанию. Если никто не ответил к крайнему сроку, Claude Code завершает ход без отправки запроса и добавляет примечание в транскрипт, которое также показывает клиент Remote Control. Ваш выбор модели не изменяется, и Claude Code снова запрашивает согласие при следующем сообщении.

То, что вы можете делать во время ожидания запроса, зависит от сессии:

С подключённым Remote Control или в сессии участника команды нажмите любую клавишу у терминала, чтобы отменить крайний срок, и Claude Code будет ждать вашего ответа.
В фоновой сессии ответьте до крайнего срока.
Если вы отправите новое сообщение от удалённого клиента до того, как кто-нибудь напечатает у терминала, Claude Code завершит ход так же, и ваше новое сообщение начнёт следующий ход. После того как кто-нибудь напечатает у терминала, Claude Code продолжит ждать ответа и поставит ваше новое сообщение в очередь позади него.

В сессии, размещённой другим приложением через Agent SDK, появляется ли запрос, зависит от этого приложения. Если он появляется и никто не ответит до того же крайнего срока dialogExpiry, Claude Code завершает ход без отправки запроса.

В неинтерактивном режиме с флагом -p и в приложении Agent SDK, которое не показывает запрос, Claude Code никогда не запрашивает согласие. Когда запрос Fable там должен оплачиваться из кредитов использования, Claude Code оплачивает его без запроса.

Установка вашей модели

Вы можете настроить вашу модель несколькими способами, перечисленными в порядке приоритета:

Во время сессии: используйте /model <alias|name> для немедленного переключения или запустите /model без аргумента, чтобы открыть средство выбора. См. когда Claude Code просит вас подтвердить переключение
При запуске: запустите с помощью claude --model <alias|name>
Переменная окружения: установите ANTHROPIC_MODEL=<alias|name>
Настройки: настройте постоянно в файле настроек, используя поле model
Стандартная для новых сессий: установите ANTHROPIC_DEFAULT_MODEL=<alias|name>

/model сохраняет ваш выбор как стандартный для новых сессий, записывая поле model в ваши пользовательские настройки. В средстве выбора:

Enter: переключить модель и сохранить как вашу стандартную
s: переключить модель только для этой сессии и оставить вашу стандартную без изменений. Чтобы использовать другую клавишу, переназначьте modelPicker:thisSessionOnly

Ввод /model <name> напрямую ведёт себя как Enter. Чтобы переключиться только для этой сессии, откройте средство выбора с помощью /model и нажмите s в строке модели.

На плане Enterprise, когда вы вошли в систему с помощью своей учётной записи claude.ai и сохранили стандартную с помощью /model, Claude Code также записывает выбор на эту учётную запись. Это требует Claude Code версии 2.1.280 или позже.

Когда ваш администратор не установил стандартную модель организации, опция Default может разрешиться на записанную модель, и когда это происходит, строка Default в средстве выбора показывает имя этой модели.
Если ограничения модели исключают записанную модель или она недоступна для вашей учётной записи, и ваш администратор не установил стандартную модель организации, опция Default разрешается так, как если бы ничего не было записано.
Если вы выберете Default или opusplan в /model, записанный выбор не изменяется.

Если вы переключаете модели с помощью /model, переключение также достигает субагентов, которые наследуют модель основного диалога, потому что Claude Code разрешает их модель из той, которую использует ваша сессия, когда Claude их запускает. Переключитесь на Opus перед тем, как Claude делегирует исследование или тестовые запуски одному из них, и эта работа также будет выполняться на Opus. Чтобы оставить пользовательского субагента на меньшей модели, установите model в его определении.

Если вы установите модель с помощью /model в неинтерактивном режиме, с флагом -p, ваш выбор применяется только к текущей сессии и не сохраняется как ваша стандартная; /model в этом режиме требует Claude Code версии 2.1.205 или позже. Настройки проекта и управляемые настройки по-прежнему имеют приоритет и переприменяются при следующем запуске. Стандартная модель организации, которую ваш администратор настроил для переопределения выбора пользователя, также переприменяется при следующем запуске.

В версиях 2.1.144 по 2.1.152 /model применялся только к текущей сессии, а d в средстве выбора сохранял стандартную.

Флаг --model и переменная окружения ANTHROPIC_MODEL применяются только к сессии, которую вы запускаете с ними. Чтобы запустить разные модели в разных терминалах одновременно, запустите каждую с её собственным флагом --model вместо переключения с помощью /model.

Цены в средстве выбора /model появляются, когда Claude Code взаимодействует с Anthropic API, напрямую или через LLM-шлюз, который его проксирует, и цена в строке — это цена модели, которую выбирает эта строка. На поставщиках третьих сторон, таких как Amazon Bedrock, и на шлюзе Claude apps gateway ваш поставщик или шлюз определяет, что вы платите, поэтому строки средства выбора не показывают цену. Цена — это только метка отображения; она не влияет на то, какую модель выбирает строка, или что выставляет в счёт ваш поставщик. До версии 2.1.206 Claude Platform on AWS и сессии шлюза показывали цены списка Anthropic, и строка могла показывать цену другой модели, чем та, которую она выбирала.

Возобновлённые сессии, начатые с помощью claude --resume, --continue или средства выбора /resume, сохраняют модель, которую они использовали, когда транскрипт был сохранён. Если восстановленная модель была снята с производства или исключена availableModels, сессия переходит к обычному порядку приоритета. У поставщиков, которые используют специфичные для поставщика ID развёртывания вместо ID моделей Anthropic, таких как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, модель из транскрипта вообще не восстанавливается, и сессия разрешает свою модель через обычный порядок приоритета.

Если ваша настройка model — haiku, сессия, сохранённая на модели Haiku, возобновляется на модели, на которую haiku разрешается сейчас. Например, как только haiku начнёт разрешаться на Haiku 5.5, сессия, сохранённая на Haiku 4.5, возобновится на Haiku 5.5.

Модель, которую вы выбираете для нового запуска с помощью --model или ANTHROPIC_MODEL, по-прежнему имеет приоритет над восстановленной моделью. Начиная с версии 2.1.195, переменная семейства ANTHROPIC_DEFAULT_OPUS_MODEL также имеет приоритет. ANTHROPIC_DEFAULT_MODEL может тоже, при условиях, перечисленных в её разделе.

Когда активная модель при запуске поступает из настроек проекта или управляемых настроек, а не из вашего собственного выбора, заголовок запуска показывает, какой файл настроек её установил. Запустите /model для переопределения; настройка проекта или управляемая настройка переприменяется при следующем запуске. На платформах, которые встраивают Claude Code и устанавливают CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST, конфигурация модели хоста имеет приоритет над управляемыми настройками модели, в то время как управляемый список разрешённых моделей availableModels остаётся в силе, если только хост не предоставляет свой собственный; Exceptions to managed settings precedence говорит, какие ключи и переменные переопределяет хост.

Если вы или ваша организация настроите хуки PreModelSwitch, они запускаются перед применением запрошенного переключения и могут его заблокировать или попросить вас подтвердить.

Когда Claude Code не может определить, какие хуки PreModelSwitch доставляют управляемые плагины вашей организации, например потому что управляемый плагин не загрузился, он отказывает в переключении вместо его применения без проверки, и он проверяет снова при каждой новой попытке. См. Model switch was blocked by a PreModelSwitch hook для сообщения и восстановления.

Когда вы переключаете модели через метод Agent SDK setModel(), через приложение, такое как Desktop app, или с устройства, подключённого через Remote Control, Claude Code проверяет значение при переключении:

Agent SDK или приложение: с Claude Code версии 2.1.268 или позже, если Claude Code не принимает ID модели локально, как это происходит для вашего пользовательского варианта модели, он подтверждает ID у вашего поставщика при первом переключении сессии на него. Подтверждение выполняется на каждом поставщике, и ID, который ваш поставщик не предлагает, отклоняется при переключении вместо сбоя при следующем запросе.
Remote Control: в Anthropic API Claude Code проверяет значение локально и не отправляет запрос.

См. Model is not a recognized model id и Model not found для сообщений.

Если вы установите модель с флагом --model, переменной окружения ANTHROPIC_MODEL или настройкой model, Claude Code не проверяет её заранее, и неправильно введённое значение приводит к There's an issue with the selected model при первом запросе.

Когда запрошенная модель имеет запланированную дату снятия с производства или автоматически переназначается на более новую версию, Claude Code показывает предупреждение, которое называет запрошенную модель. Интерактивные сессии показывают его как уведомление при запуске. Начиная с версии 2.1.182, то же предупреждение записывается в stderr в неинтерактивном режиме при использовании формата вывода текста по умолчанию. Проверка также охватывает model, установленный во frontmatter субагента. Предупреждение stderr подавляется для --output-format json и stream-json; вместо этого прочитайте фактическую модель из поля modelUsage результирующего сообщения.

Например, запустите сессию на Opus:

claude --model opus

Затем переключайте модели из сессии:

/model sonnet

Пример файла настроек:

{
    "permissions": {
        "allow": ["Bash(npm run lint)"]
    },
    "model": "opus"
}

Установка стандартной модели для новых сессий

Установите ANTHROPIC_DEFAULT_MODEL=<alias|name> для выбора модели, на которой ваши сессии запускаются по умолчанию. Требует Claude Code версии 2.1.236 или позже.

Claude Code запускает новую сессию на модели переменной, только когда ни один из этих вариантов не выбирает модель:

Флаг --model
ANTHROPIC_MODEL
Значение model в любом файле настроек, включая выбор, который вы сохраняете с помощью /model
Стандартная модель организации

Выбор, который вы сохраняете с помощью /model, имеет приоритет над переменной и при последующих запусках. Если же установлена ANTHROPIC_MODEL, Claude Code возвращается к модели этой переменной при следующем запуске, независимо от того, что вы сохранили с помощью /model.

Claude Code также разрешает опцию Default на модель переменной, если не применяется стандартная модель организации. Когда опция Default разрешается на модель переменной, строка Default в средстве выбора /model показывает метку Set by ANTHROPIC_DEFAULT_MODEL.

Claude Code игнорирует переменную в этих случаях, и опция Default разрешается так, как если бы вы её не установили:

Вы установили её на default, inherit, opusplan или haiku
enforceAvailableModels включена
Ограничения модели вашей организации исключают модель
Модель недоступна для вашей учётной записи

Когда новая сессия запустилась бы на модели переменной, сессия, которую вы возобновляете с помощью claude --resume, --continue или средства выбора /resume, также запускается на ней. Claude Code не восстанавливает модель, сохранённую в транскрипте этой сессии. В противном случае Claude Code не использует переменную, когда вы возобновляете сессию.

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

Когда вы выбираете модель с помощью /model, а ваша следующая сессия запускается на чём-то другом, обычные причины таковы:

Вы выбрали её для одной сессии. Нажатие s в средстве выбора, запуск с помощью --model и запуск /model в неинтерактивном режиме применяются к текущей сессии и оставляют вашу сохранённую стандартную без изменений.
Что-то с более высоким приоритетом устанавливает модель. Значение model в настройках проекта или управляемых настройках, ANTHROPIC_MODEL в вашей оболочке или стандартная модель организации, которую ваш администратор установил для переопределения выбора пользователя, применяется снова при каждом запуске. Ваш выбор /model по-прежнему сохранён; просто у него более низкий приоритет. Когда настройки проекта или управляемые настройки устанавливают модель, заголовок запуска называет файл.
Claude Code не смог сохранить ваш выбор. /model записывает model в ~/.claude/settings.json. Если вы не можете писать в этот файл, например потому что другой инструмент его генерирует или связывает его с копией только для чтения, выбранная вами модель действует в течение сессии, а следующий запуск читает старое значение. Установите model в инструменте, который генерирует файл, или сделайте файл доступным для записи. См. A change you made in Claude Code is lost in new sessions.
Вы возобновили сессию. Сессия, которую вы возобновляете с помощью claude --resume или --continue, обычно сохраняет модель, которую она использовала, вместо вашей текущей стандартной.

Ограничение выбора модели

Администраторы могут использовать availableModels в управляемых или политических параметрах для ограничения того, какие модели могут выбирать пользователи. Записи соответствуют семейству моделей, такому как sonnet, префиксу версии, такому как claude-sonnet-4-5, или полному идентификатору модели, такому как claude-sonnet-4-5-20250929. Префикс версии также соответствует более поздним идентификаторам моделей, которые расширяют его еще одним сегментом, поэтому claude-fable-5 разрешает как Fable 5, так и Fable 5.1, а claude-fable-5-1 разрешает только Fable 5.1. Чтобы заблокировать модель, которую разрешает список, или чтобы каждая запись идентификатора модели разрешала только версию, которую она называет, см. Блокировка конкретных моделей или версий.

На платформах, которые встраивают Claude Code и устанавливают CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST, конфигурация модели хоста имеет приоритет над управляемыми параметрами модели, в то время как управляемый список разрешений availableModels остается в силе, если только хост не предоставляет свой собственный; Исключения из приоритета управляемых параметров указывает, какие ключи и переменные переопределяет хост.

Когда установлен availableModels, список разрешений применяется везде, где пользователь может указать модель:

Модель основной сессии: /model, флаг --model, переменная окружения ANTHROPIC_MODEL, параметр model, ANTHROPIC_DEFAULT_MODEL и модель, восстановленная при возобновлении сессии
Разрешение псевдонимов: переменные окружения ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL и ANTHROPIC_DEFAULT_FABLE_MODEL не могут перенаправить разрешенный псевдоним на модель вне списка
Fast mode: команда /fast отказывает переключаться, когда это неявно переключилось бы на модель Opus вне списка, с сообщением "is not in your organization's allowed models"
Модели подагента и товарища: поле model в подагенте frontmatter, параметр model инструмента Agent, модели товарищей команды агентов, CLAUDE_CODE_SUBAGENT_MODEL и, в v2.1.197 и более ранних версиях, средство выбора модели в мастере /agents
Модели skills и команд: frontmatter model в skills и командах
Модель советника: настроенный параметр advisorModel и флаг --advisor
Модель фонового агента: модель, выбранная в средстве выбора диспетчеризации

На Anthropic API и Claude Platform on AWS псевдоним семейства моделей, opus, sonnet, haiku или fable, разрешается в его обычную модель, когда список разрешений разрешает эту модель. Когда список разрешений блокирует эту модель, Claude Code подставляет самую новую версию семейства, которую разрешает список разрешений, и показывает уведомление с названием как запрошенной, так и подставленной моделей. С ["sonnet", "claude-opus-4-6"], например, как /model opus, так и --model opus выбирают Claude Opus 4.6, самую новую разрешенную версию Opus. До v2.1.205 псевдоним, самая новая выпущенная версия которого была вне списка, отклонялась или заменялась как любой другой заблокированный выбор, даже когда список разрешал более старую версию.

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

Claude Code обрабатывает любой другой заблокированный выбор в соответствии с тем, где была установлена модель:

/model: Claude Code отклоняет переключение с ошибкой
Флаг --model, ANTHROPIC_MODEL или параметр model: Claude Code заменяет значение при запуске с предупреждением, называющим как запрошенную, так и подставленную модели, и сессия начинается на модели по умолчанию
ANTHROPIC_DEFAULT_MODEL: Claude Code игнорирует переменную
Переопределение подагента или товарища: Claude Code запускает подагента или товарища на резервной модели, а не отказывает в запросе. См. Выбор модели для резервной копии подагента и Указание товарищей и моделей для резервной копии товарища.

В интерактивных сессиях Claude Code предупреждает вас, когда он подставляет модель подагента, либо этой резервной копией, либо подстановкой самой новой разрешенной версии выше, называя запрошенную и подставленную модели; он не сообщает о резервной копии товарища.

Где работает подстановка самой новой разрешенной версии выше, заблокированный псевдоним семейства следует ей вместо этого. До v2.1.222 псевдоним отступал как любое другое заблокированное значение на каждом поставщике
Переопределение skill или команды: Claude Code игнорирует переопределение, включая заблокированный псевдоним семейства, и skill или команда запускаются на модели сессии. Skill или команда, которая запускается в подагенте, следует поведению подагента выше вместо этого
Параметр advisorModel: советник отключен для сессии
Флаг --advisor: Claude Code выходит с ошибкой при запуске. В фоновой сессии он запускает сессию без советника вместо выхода

Claude Code скрывает исключённые модели из средства выбора /model. Получит ли указанный вами идентификатор модели собственную строку, зависит от провайдера:

Anthropic API, Claude Platform on AWS, Claude apps gateway или LLM-шлюз, заданный через ANTHROPIC_BASE_URL: указанный в списке идентификатор модели Anthropic, для которого нет встроенной строки в средстве выбора, отображается как отдельная подписанная строка. Claude Code добавляет такую строку для версий Opus, Sonnet и Haiku — например, для более старой версии, закреплённой в списке. Если вы задаёте replaceBuiltInOptions в наборе modelPicker, такая строка не отображается. До v2.1.199 такой идентификатор можно было выбрать, только введя /model <id>.
Amazon Bedrock, Agent Platform Google Cloud или Microsoft Foundry: если указанный вами идентификатор модели не начинается с anthropic., Claude Code не добавляет для него строку — ни для идентификатора модели Anthropic, ни для идентификатора, специфичного для провайдера. Идентификаторы моделей Mantle имеют этот префикс. Чтобы показать указанную версию, у которой нет встроенной строки, также добавьте её в набор modelPicker, который принимает идентификаторы в формате вашего провайдера.

Изменения модели, которые Claude Code делает от вашего имени, проверяются таким же образом:

Цепочки резервных моделей: записи вне списка разрешений удаляются
Обновления Plan Mode: на Anthropic API и Claude Platform on AWS обновление, такое как opusplan на исключенную модель, использует самую новую разрешенную версию семейства обновления. На поставщиках с идентификаторами моделей, специфичными для поставщика, и когда никакая версия не разрешена, обновление пропускается и планирование продолжается на модели сессии
Автоматический резервный вариант модели: резервный вариант, целевой объект которого исключен, не запускается, поэтому помеченный запрос заканчивается отказом вместо этого
Классификатор авторежима: используемая классификатором по умолчанию модель Claude Sonnet 5 применяется, только если список разрешённых моделей допускает Sonnet 5. Если она исключена, классификатор работает на модели сессии, которую уже контролирует список разрешённых моделей, или на модели Opus, если сессия работает на модели Fable. У провайдеров, отличных от Anthropic API, этот резервный вариант Opus работает на модели, заданной в ANTHROPIC_DEFAULT_OPUS_MODEL, а если она не задана — на Opus 5, без проверки списка разрешённых моделей. Требуется Claude Code v2.1.210 или новее
Fast mode: включение fast mode отказывается, когда модель, на которой сессия будет запускаться впоследствии, находится вне списка разрешений
Переключение из-за доступности в Amazon Bedrock и Agent Platform Google Cloud: если ваша учётная запись теряет доступ к модели посреди сессии, при переключении на другую модель исключённые модели пропускаются. Проверки модели при запуске в Amazon Bedrock и Agent Platform Google Cloud пропускают исключённые модели, только если управляемые настройки также задают enforceAvailableModels

{
  "availableModels": ["sonnet", "haiku"]
}

Охват поверхности

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

Механизм доставки	CLI и IDE	Локальные сессии Desktop	Веб-, мобильные и облачные сессии	Agent SDK и неинтерактивные	Cowork
Управляемые параметры сервера из консоли администратора	Применяется	Применяется	Применяется, кроме сессий Claude Tag	Применяется	Удаленные сессии Cowork: сервер проверяет модель. На машине пользователя: не доставляется.
MDM или файлы управляемых параметров	Применяется	Применяется	Не доставляется в средах, размещенных Anthropic; в самостоятельно размещенных средах применяется из образа runner согласно как Claude Code объединяет управляемые источники	Применяется	Применяется где развернуто

Облачные сессии, включая те, которые вы запускаете из приложения Desktop, по умолчанию запускаются на управляемых Anthropic виртуальных машинах: параметры, развернутые на вашем устройстве, не достигают их, поэтому доставляйте список разрешений через управляемые параметры сервера. Сессии, которые ваша организация маршрутизирует в самостоятельно размещенную среду, запускаются на вашем собственном вычислении и также читают файл управляемых параметров в образе runner. Как Claude Code объединяет управляемые источники указывает, когда этот файл применяется. Переключение модели в середине сессии в облачной сессии отклоняется, когда запрошенная модель исключена списком разрешений. Когда список availableModels в ваших управляемых параметрах сервера не пуст, сервер отклоняет запрос на запуск облачной сессии на модели, которую список исключает, на claude.ai/code или из приложения Desktop.
Сессии Claude Tag запускаются в облачных средах, но не получают управляемые параметры сервера; в самостоятельно размещенной среде они все еще читают файл управляемых параметров в образе runner. Чтобы установить модель для этих сессий, см. Выбор модели для области в руководстве администратора Claude Tag.
Cowork, вкладка агентской работы в приложении Claude Desktop, запускает свои сессии на Claude Code, но по замыслу не получает управляемые параметры сервера из консоли администратора claude.ai. Когда список availableModels в ваших управляемых параметрах сервера не пуст и пользователь выбирает модель вне него, сервер отклоняет эту модель для удаленной сессии Cowork. Файл управляемых параметров применяется к сессиям Cowork, когда он присутствует там, где запускается сессия; удаленные сессии Cowork запускаются на управляемых Anthropic виртуальных машинах, где развернутый на устройстве файл отсутствует.
Сессии на поставщиках третьих сторон, таких как Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry и Claude Platform on AWS, не получают управляемые параметры сервера, поэтому доставляйте список разрешений через MDM или файлы управляемых параметров там.
Доставка из консоли администратора также требует, чтобы сессия получала настройки с подходящим входом в вашу организацию или с OAuth-токеном, выданным для неё. Для парков устройств, которые аутентифицируются с помощью API-ключей — заданных напрямую или сгенерированных скриптом apiKeyHelper, — доставляйте список разрешённых моделей через MDM или файлы управляемых настроек.
Вкладка Desktop Code также размещает сессии SSH, которые читают файл управляемых параметров с удаленного хоста, на котором они запускаются. См. Управляемые параметры Desktop.
Средства выбора модели на claude.ai и в приложении Desktop скрывают или затемняют модели, исключенные списком разрешений вашей организации. Состояние средства выбора — это удобство для пользователей; оно не применяет список разрешений.

Поведение модели по умолчанию

С префиксным сопоставлением по умолчанию, availableModels сам по себе оставляет параметр Default на значении по умолчанию runtime системы для учетной записи, пока вы также не установите enforceAvailableModels. Если это значение по умолчанию — это модель, которую вы намереваетесь ограничить, установите enforceAvailableModels также или заблокируйте эту модель.

С availableModels: [], именованные выборы моделей блокируются и enforceAvailableModels не имеет никакого эффекта.

Применение списка разрешений к модели Default

Установите enforceAvailableModels: true рядом с непустым availableModels в управляемых параметрах, чтобы расширить список разрешений на параметр Default. Это требует Claude Code v2.1.175 или позже.

{
  "availableModels": ["sonnet", "haiku"],
  "enforceAvailableModels": true
}

Для члена без модели записанной на его учетной записи, параметр Default разрешается в значение по умолчанию типа учетной записи, или в модель по умолчанию организации, когда администратор установил одну. Когда эта модель не находится в списке разрешений, параметр Default вместо этого разрешается в первую запись availableModels, которая называет разрешенную, доступную модель, и строка Default средства выбора /model показывает эту модель. Это применяется везде, где достигается значение по умолчанию: запуск сессии, выбор Default в /model, ключевое слово "default" в цепочках резервных моделей и резервный вариант, используемый при удалении исключенного выбора. Модель, записанная на учетной записи члена, также проверяется против availableModels; Установка вашей модели описывает, как параметр Default ее обрабатывает.

enforceAvailableModels переназначает параметр Default только когда availableModels непуст. Когда availableModels непуст, но ни одна запись не разрешается в разрешенную и доступную модель, применение пропускается с предупреждением, видимым только под --debug. Сохраняйте по крайней мере одну гарантированно доступную запись в списке, чтобы избежать этого.

Развертывайте оба ключа вместе в источнике управляемых параметров с наивысшим рейтингом, который вы доставляете. По умолчанию Claude Code читает только этот источник, поэтому пара, размещенная в файле управляемых параметров, игнорируется, когда консоль администратора доставляет какие-либо параметры; при выборе слияния в как Claude Code объединяет управляемые источники, Claude Code все еще игнорирует карту modelOverrides из источника, ранжированного ниже того, который устанавливает availableModels.

Управление моделью, на которой работают пользователи

Параметр model — это начальный выбор, а не применение. Он устанавливает, какая модель активна при запуске сессии, но пользователи все еще могут открыть /model и выбрать Default, который разрешается в значение по умолчанию runtime системы независимо от того, что установлено в model, если только enforceAvailableModels или ключи, которые блокируют конкретные версии, не применяются к нему.

Чтобы полностью управлять опытом модели, объедините эти параметры:

availableModels: ограничивает, какие именованные модели пользователи могут переключать
enforceAvailableModels: расширяет список разрешений availableModels на параметр Default, поэтому Default не может разрешиться в модель вне списка
deniedModels и availableModelsMatch: блокируют конкретные версии, которые запись availableModels иначе разрешила бы
model: устанавливает начальный выбор модели при запуске сессии
ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_HAIKU_MODEL / ANTHROPIC_DEFAULT_FABLE_MODEL: управляют тем, на что разрешаются псевдонимы sonnet, opus, haiku и fable, и какую версию использует значение по умолчанию типа учетной записи

Этот пример запускает пользователей на Sonnet 4.5, ограничивает средство выбора Sonnet и Haiku и гарантирует, что Default разрешается в модель в списке разрешений, а не в значение по умолчанию уровня:

{
  "model": "claude-sonnet-4-5",
  "availableModels": ["claude-sonnet-4-5", "haiku"],
  "enforceAvailableModels": true,
  "env": {
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5"
  }
}

Без enforceAvailableModels или блока env пользователь, который выбирает Default в средстве выбора, получает значение по умолчанию runtime вместо версии, закрепленной в model. Два параметра охватывают разные области: enforceAvailableModels делает Default послушным списку разрешений, в то время как блок env закрепляет, на какую версию разрешается разрешенный псевдоним, такой как sonnet. Используйте enforceAvailableModels отдельно, когда ограничения семейств моделей достаточно; добавьте блок env, когда вам также нужно закрепить конкретную версию.

Поведение слияния

Когда управляемые параметры, которые применяет Claude Code, определяют availableModels, этот список один применяется, кроме платформы хоста, которая предоставляет свой собственный: записи в параметрах пользователя, проекта или локальных параметрах не могут расширить его, и Claude Code никогда не объединяет availableModels между управляемыми источниками либо; как Claude Code объединяет управляемые источники указывает, какой список источника применяется. В противном случае списки из параметров пользователя, проекта и локальных параметров объединяются и дедублицируются как другие параметры массива. До Claude Code v2.1.175 записи из областей с более низким приоритетом объединялись с управляемым списком, а не заменялись им.

В пределах эффективного списка запись, называющая конкретную модель в семействе, будь то префикс версии или полный идентификатор модели, отключает запись подстановочного знака семейства: ["sonnet", "claude-sonnet-4-5"] разрешает только версии Sonnet 4.5, а не каждую модель Sonnet.

Идентификаторы моделей Mantle

Записи в availableModels, начинающиеся с anthropic., добавляются в средство выбора /model как пользовательские варианты. Это исключение из сопоставления псевдонимов, описанного в разделе Закрепление моделей для сторонних развёртываний. Если включён эндпоинт Amazon Bedrock Mantle, Claude Code направляет записи, соответствующие формату Mantle, на этот эндпоинт. Настройка по-прежнему ограничивает средство выбора перечисленными записями, а идентификатор Mantle содержит название семейства, поэтому он считается конкретной записью и отключает подстановку для этого семейства: вместе с идентификаторами Mantle перечислите префиксы версий или полные идентификаторы, которые должны оставаться доступными для выбора. См. Поведение при объединении.

Блокировка конкретных моделей или версий

Запись availableModels, такая как claude-opus-5, также разрешает более поздние выпуски, которые расширяют ее, такие как Opus 5.5, как только Claude Code их поддерживает. Два управляемых параметра позволяют вам задержать выпуск, и оба требуют Claude Code v2.1.283 или позже:

deniedModels: перечислите модели для блокировки. Перечисленная модель блокируется даже когда availableModels ее разрешает, и ключ также работает без списка разрешений вообще. Выпуск, который ни одна запись не блокирует, остается разрешенным
availableModelsMatch: установите его на "exact", чтобы каждый идентификатор модели в availableModels разрешал только версию, которую он называет. Более новая версия перечисленного идентификатора модели затем остается заблокированной, пока вы не добавите ее в список

Более ранние версии игнорируют оба ключа, поэтому также установите requiredMinimumVersion, чтобы предотвратить запуск этих версий.

Этот пример разрешает модели Opus и Sonnet и блокирует Opus 5.5 в каждом написании, включая датированные и специфичные для поставщика идентификаторы:

{
  "availableModels": ["opus", "sonnet"],
  "deniedModels": ["claude-opus-5-5"]
}

Заблокированная модель, будь то deniedModels называет ее или список "exact" ее опускает, рассматривается как заблокированный выбор везде, где применяется список разрешений. Она скрыта из средства выбора /model, и /model <name> отклоняет ее. Если вы назовете заблокированный идентификатор модели с помощью --model, ANTHROPIC_MODEL или параметра model, Claude Code удаляет его при запуске и разрешает параметр Default вместо этого. Если hook или фоновый запрос называет модель, которую deniedModels блокирует, такую как поле model hook агента, этот запрос запускается на модели сессии вместо этого.

Параметр Default следует обоим ключам также, независимо от того, установили ли вы enforceAvailableModels. Если вы установите его с непустым availableModels, заблокированный default считается моделью вне списка разрешений. В противном случае параметр Default, который разрешился бы в заблокированную модель, понижается в этом порядке:

Самая новая разрешенная версия того же семейства
Самая новая разрешенная модель каждого семейства с более низкой стоимостью по очереди: Sonnet, затем Haiku
Первая запись availableModels, которая называет разрешенную модель

Если ни один из них не разрешен, сессия, запускаемая на параметре Default, отказывает запуститься с ошибкой, которая называет ключ для исправления. Список "exact" влияет на параметр Default только когда управляемый список availableModels называет по крайней мере одну модель или семейство.

Claude Code читает оба ключа только из управляемых параметров. Если вы установите любой из них в параметрах пользователя, проекта или локальных параметрах или с --settings, Claude Code игнорирует его с предупреждением.

Ограничения модели организации

Администраторы организации на планах Claude Enterprise ограничивают, какие модели могут запускать члены, отключая отдельные модели в консоли администратора claude.ai. Это ограничение доставляется с правами учетной записи, когда Claude Code аутентифицируется, отдельно от любого списка availableModels в параметрах, и сервер независимо применяет то же ограничение при создании сессии. Требуется Claude Code v2.1.187 или позже.

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

Claude Console не имеет управления ограничением модели. Организации без плана Claude Enterprise, включая те, члены которых аутентифицируются через Anthropic API, ограничивают модели с помощью availableModels в управляемых параметрах вместо этого, добавляя enforceAvailableModels для охвата параметра Default. Охват поверхности указывает, как каждая поверхность получает и применяет эти параметры.

Ограниченная модель скрыта из средства выбора /model. Выбор ее по имени с помощью --model, переменной окружения ANTHROPIC_MODEL или параметра model показывает уведомление Model "<name>" is restricted by your organization's settings. Using <model> instead. и сессия запускается на разрешенной модели. Ввод /model <name> для ограниченной модели отклоняется с Model '<name>' is restricted by your organization's settings. Run /model to choose a different model. и сессия сохраняет свою текущую модель.

Псевдоним семейства моделей, такой как opus, разрешается в его обычную модель, когда организация его разрешает. Когда организация ограничивает эту модель, Claude Code подставляет самую новую версию семейства, которую организация разрешает, с тем же уведомлением подстановки. /model <alias> отклоняется только когда каждая версия его семейства ограничена; псевдоним, установленный с помощью --model, ANTHROPIC_MODEL или параметра model, все еще заменяется при запуске в этом случае. До v2.1.205 псевдоним семейства подставлялся или отклонялся на основе только его самой новой выпущенной версии, даже когда была разрешена более старая версия.

Ограничения применяются на уровне организации или по ролям:

Отключение модели на уровне организации удаляет ее для каждого члена.
Доступ на уровне ролей предоставляет разные модели разным пользовательским ролям, и член, который имеет несколько ролей, может использовать любую модель, которую разрешает одна из его ролей.
Модели Haiku всегда доступны и не могут быть отключены, поэтому каждый член сохраняет по крайней мере одну пригодную для использования модель.
Изменение доступа вступает в силу на новых запросах в течение примерно минуты; средство выбора /model отражает это при следующем запуске сессии.

Оба ограничения применяются вместе: модель выбираемая только когда она разрешена availableModels и не ограничена организацией. Ограничения организации достигают сессий на Anthropic API и развертываниях LLM gateway только; на любом другом поставщике используйте availableModels вместо этого.

Модель по умолчанию для организации

Администраторы организации на планах Claude Enterprise могут установить модель по умолчанию для членов Claude Code из консоли администратора claude.ai для всей организации или для каждой пользовательской роли. Когда модель установлена, опция Default разрешается в эту модель. Требуется Claude Code v2.1.196 или позже.

Строка Default в средстве выбора /model показывает имя организационного значения по умолчанию с меткой Org default. Метка читается как Org default независимо от того, установил ли администратор значение по умолчанию для всей организации или для вашей роли. Значение по умолчанию для роли охватывает членов этой пользовательской роли и имеет приоритет над организационным значением по умолчанию; когда несколько ваших ролей устанавливают разные значения по умолчанию, применяется наиболее мощная модель.

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

флаг --model и переменная окружения ANTHROPIC_MODEL
значение model в управляемых параметрах или предоставленное через --settings
значение model в ваших пользовательских, проектных или локальных параметрах, включая модель, которую вы сохраняете с помощью /model

Администраторы также могут настроить организационное значение по умолчанию для переопределения выбора пользователя. При включении переопределения оно имеет приоритет над значением model в пользовательских, проектных и локальных настройках, поэтому модель, которую вы сохраняете с помощью /model, применяется для текущей сессии, а организационное значение по умолчанию возвращается при следующем запуске. Когда ваш выбор отличается, /model показывает Your organization's default (<model>) applies on restart. Флаг --model, ANTHROPIC_MODEL, управляемые настройки и --settings по-прежнему имеют приоритет даже при включённом переопределении.

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

Claude Code читает организационное значение по умолчанию один раз при запуске, поэтому значение по умолчанию, которое администратор изменяет во время сеанса, вступает в силу при следующем запуске.

Когда организационное значение по умолчанию не переопределяет выбор пользователя, первый интерактивный запуск после изменения администратором очищает ключ model из ваших пользовательских параметров один раз, чтобы применилось новое значение по умолчанию. Это не изменяет ничего другого в файле, и модель, которую вы сохраняете с помощью /model после этого запуска, сохраняется.

Организационное значение по умолчанию проходит эти проверки ограничений перед его принятием:

С совпадением префикса по умолчанию availableModels сам по себе не применяется к организационному значению по умолчанию, поэтому организационное значение по умолчанию вне списка разрешений по-прежнему применяется. Когда также установлен enforceAvailableModels, организационное значение по умолчанию вне списка разрешений переназначается первой записи списка разрешений, как и любое другое Default
организационное значение по умолчанию, которое ограничения модели организации запрещают для вашего аккаунта, заменяется самой новой разрешенной моделью в его семействе или моделью с более низкой стоимостью, когда каждая версия ее ограничена
для организационного значения по умолчанию, которое deniedModels или список "exact" блокирует, см. Блокировка определенных моделей или версий
организационное значение по умолчанию, которое вообще недоступно для вашего аккаунта, пропускается, и опция Default разрешается так, как это было бы без организационного значения по умолчанию

Начиная с v2.1.199, когда организационное значение по умолчанию является другим семейством моделей от обычного значения по умолчанию типа вашего аккаунта, средство выбора /model сохраняет отдельную строку для этого обычного семейства, чтобы вы все еще могли переключиться на него для сеанса. В версиях v2.1.196 по v2.1.198 эта строка отсутствует в средстве выбора.

Организационное значение по умолчанию достигает только сеансов, аутентифицированных с помощью Anthropic API. Чтобы установить значение по умолчанию где-либо еще, включая развертывания LLM gateway, используйте вместо этого ключ model в управляемых параметрах.

Ограничения уровня усилий организации

Ваша организация может ограничить уровень усилий двумя способами. В плане Claude Enterprise администраторы организации устанавливают ограничения уровня усилий для каждой роли, описанные ниже. В любом плане и у любого поставщика, включая Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, управляемый параметр maxEffortLevel ограничивает усилия на стороне клиента. Когда оба ограничения применяются к модели, действует более низкий лимит.

Администраторы организации в планах Claude Enterprise могут установить максимальный уровень усилий для каждой модели для каждой пользовательской роли, наряду с ограничениями модели на уровне роли организации. Уровни выше лимита не предлагаются в средстве выбора /effort, а указание более высокого уровня с помощью --effort или /effort выполняется на уровне лимита вместо этого. В интерактивных сеансах и обычных текстовых запусках --print предупреждение указывает запрошенные и применённые уровни; при выводе json или stream-json или в фоновых агентах ограничение применяется без уведомления. Ограничения действуют для каждой модели, поэтому переключение моделей может изменить доступные уровни. Когда несколько ваших ролей предоставляют одну и ту же модель, применяется наименее ограничивающий лимит. Требуется Claude Code v2.1.195 или более поздняя версия.

Ограничения уровня усилий доставляются вместе с ограничениями модели организации и достигают одних и тех же сеансов.

Специальное поведение модели

Настройка модели `default`

Поведение default зависит от типа вашей учётной записи:

Pro, Max, Team, Enterprise и Anthropic API: по умолчанию Opus 5.5
Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform: по умолчанию Opus 5.5
Microsoft Foundry: по умолчанию Sonnet 4.5

До версии 2.1.280 default разрешался в Sonnet 5 на Pro и Team Standard, а в Opus 5 на Max, Team Premium, Enterprise, Anthropic API, Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform с версии 2.1.219. До версии 2.1.219 default разрешался в Opus 4.8 на Anthropic API, Max, Team Premium и Enterprise с оплатой по мере использования с версии 2.1.154, а также на Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform с версии 2.1.207. До версии 2.1.207 default разрешался в Opus 4.7 на Claude Platform on AWS и в Sonnet 4.5 на Amazon Bedrock и Google Cloud's Agent Platform.

Когда администратор установил модель по умолчанию организации, default разрешается в эту модель вместо стандартного значения для типа учётной записи выше. Требуется Claude Code версии 2.1.196 или позже. default также может разрешаться в модель, которую вы установили с помощью ANTHROPIC_DEFAULT_MODEL, при условиях, указанных в его разделе, или в модель, записанную в вашей учётной записи.

Когда в вашей учётной записи ничего не записано, управляемые настройки принудительно применяют список разрешённых моделей для модели Default, а стандартное значение для типа учётной записи отсутствует в availableModels, default разрешается в принудительный Default вместо стандартного значения для типа учётной записи выше. Когда применяются и модель по умолчанию организации, и принудительное применение, модель по умолчанию организации сначала заменяет стандартное значение для типа учётной записи, а затем к ней применяется принудительное ограничение: модель по умолчанию организации из списка разрешённых сохраняется, а модель вне списка разрешается в принудительный Default.

Модели Fable не являются стандартным значением для типа учётной записи ни на одном тарифе или у одного поставщика. Выбор одной из них с помощью /model сохраняет её как выбранную модель в пользовательских настройках, поэтому последующие сессии начинаются с неё. Об одноразовом изменении, которое Claude Code вносит в сохранённый выбор Fable 5 в версии 2.1.257, см. Работа с Fable.

Настройка модели `opusplan`

Псевдоним модели opusplan обеспечивает автоматизированный гибридный подход:

В режиме планирования: использует opus для сложных рассуждений и решений по архитектуре
В режиме выполнения: автоматически переключается на sonnet для генерации кода и реализации

Это сочетает рассуждения Opus для планирования с эффективностью Sonnet для выполнения.

Фаза Opus в режиме планирования использует то же контекстное окно, что и настройка модели opus, а фаза выполнения использует то же окно, что и sonnet. Когда opus и sonnet разрешаются в модели, которые по умолчанию работают с контекстным окном 1M, как текущие модели на Anthropic API, обе фазы работают с ним. Чтобы запросить контекст 1M для обеих фаз там, где это не так, установите модель opusplan[1m], например с помощью /model opusplan[1m]. Установка с помощью /model требует Claude Code версии 2.1.265 или позже; в более ранних версиях используйте вместо этого флаг --model или настройку model.

Когда availableModels исключает новейший Opus, но разрешает более старую версию, например ["sonnet", "claude-opus-4-6"], opusplan использует для планирования новейший разрешённый Opus и остаётся на Sonnet, только когда исключены все версии Opus. Сессия Haiku, которая обычно переключается на Sonnet в режиме планирования, аналогично использует новейший разрешённый Sonnet и остаётся на Haiku, только когда исключены все версии Sonnet. До версии 2.1.205 режим планирования оставался на модели сессии всякий раз, когда исключалась новейшая версия семейства для переключения, даже если список разрешённых моделей разрешал более старую версию.

Подстановка более старой разрешённой версии применяется на Anthropic API и Claude Platform on AWS. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Mantle, развёртывания которых используют специфичные для поставщика идентификаторы моделей, режим планирования остаётся на модели сессии всякий раз, когда модель для переключения исключена.

Для гибридного подхода, при котором Claude решает во время выполнения задачи, когда обратиться ко второй модели, а не переключаться на границе плана, см. инструмент advisor.

Цепочки резервных моделей

Когда основная модель перегружена, недоступна или возвращает другую ошибку сервера, не подлежащую повторной попытке, Claude Code может переключиться на резервную модель вместо того, чтобы завершить запрос ошибкой. Ошибки аутентификации, биллинга, ограничения частоты запросов, размера запроса и транспорта, а также отказ по результатам проверки политики вашей организации никогда не вызывают переключение; они обрабатываются обычным механизмом повторных попыток и обработки ошибок. Переключение происходит, когда Amazon Bedrock или Google Cloud's Agent Platform отказывает в модели, которую ваша учётная запись не может вызвать: Claude Code рассматривает это как недоступность модели, а не как ошибку аутентификации.

Настройте одну или несколько резервных моделей, и Claude Code будет пробовать их по порядку, показывая уведомление при переключении. Переключение действует только в течение текущего хода, поэтому ваше следующее сообщение снова сначала пробует основную модель. Claude Code ограничивает цепочки тремя моделями после удаления дубликатов и игнорирует лишние записи.

Задайте цепочку для одной сессии с помощью флага --fallback-model, который принимает список, разделённый запятыми:

claude --fallback-model sonnet,haiku

Чтобы сохранить цепочку между сессиями, задайте fallbackModel в настройках как массив:

{
  "fallbackModel": ["claude-sonnet-5", "claude-haiku-4-5"]
}

Флаг --fallback-model имеет приоритет над настройкой fallbackModel. Каждая запись принимает имя модели или псевдоним, а "default" раскрывается в модель по умолчанию.

Claude Code не подтверждает цепочку при запуске, и /status её не отображает. Уведомление, показываемое при переключении, — первый видимый признак того, что резервная модель настроена.

Когда запрос переключается на резервную модель, Claude Code пробует каждую запись по порядку, пока одна из них не примет запрос. Запись, которая тоже недоступна, например снятая с поддержки модель, закреплённая в настройках, точно так же переключается на следующую. Перед этим проходом Claude Code удаляет записи двух типов:

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

Claude Code также применяет цепочку к субагентам. Когда запрос субагента переключается на резервную модель, Claude Code пробует настроенные вами резервные модели по порядку, и субагент продолжает работу на модели, которая приняла запрос. Модель вашей сессии не изменяется. До версии 2.1.247 сбой, на который распространяется цепочка, вместо этого завершал работу субагента.

Автоматическое переключение на резервную модель

Этот раздел описывает переключение на резервную модель на основе содержимого для моделей Fable, Opus 5.5, Sonnet 5.5 и Opus 5. О переключении на основе доступности, когда модель перегружена или недоступна, см. Цепочки резервных моделей.

Модели Fable, Opus 5.5, Sonnet 5.5 и Opus 5 работают с классификаторами безопасности, которые чаще всего помечают содержимое, связанное с кибербезопасностью и биологией. Для этих двух категорий резервная модель зависит от того, какая модель отказала:

Fable 5.1, Fable 5 и Opus 5.5: запросы, помеченные как связанные с биологией, повторно выполняются на Opus 5, а запросы, помеченные как связанные с кибербезопасностью, — на Opus 4.8.
Sonnet 5.5: запросы, помеченные как связанные с кибербезопасностью, повторно выполняются на Sonnet 5. Запросы, помеченные как связанные с биологией, вместо этого завершаются отказом, потому что у Sonnet 5.5 нет резервной модели для биологии.
Opus 5: запросы, помеченные как связанные с кибербезопасностью, повторно выполняются на Opus 4.8. Запросы, помеченные как связанные с биологией, вместо этого завершаются отказом, потому что Opus 5 использует собственные классификаторы биологии без резервной модели.

На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry Claude Code вместо этого разрешает эти целевые модели через идентификаторы моделей вашего развёртывания. См. Включение резервного варианта на Bedrock, Agent Platform и Foundry.

Когда Claude Code переключает помеченный запрос на резервную модель для его категории, он повторно выполняет запрос на этой модели. В основном диалоге он показывает уведомление в транскрипте. Чтобы получать вопрос перед переключением, см. Запрос перед переключением.

После переключения на резервную модель сессия продолжается на ней. Чтобы вернуться к исходной модели, выполните /model.

Переключение на основе категории требует Claude Code версии 2.1.219 или позже. До версии 2.1.219 каждый помеченный запрос Fable 5 повторно выполнялся на модели Opus по умолчанию вашего поставщика, а Opus 5 не был источником переключения.

Резервная модель проверяется по availableModels. Если она заблокирована, переключение не происходит. Отказ показывается как обычная ошибка, и модель сессии не изменяется.

Уровень усилий после переключения на резервную модель

Когда Claude Code переключает вашу сессию на резервную модель, он сохраняет уровень усилий, с которым выполнялся помеченный запрос. Например, сессия на Opus 5.5 с уровнем по умолчанию medium, переключившаяся на Opus 4.8, остаётся на medium, хотя Opus 4.8 по умолчанию использует high.

Другой уровень применяется, например, в следующих случаях:

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

В сессии выполните /effort status, чтобы увидеть действующий уровень, или /effort, чтобы изменить его.

Проверка того, что вызвало переключение

Переключение на резервную модель может произойти уже на первом запросе сессии, прежде чем вы отправите что-либо необычное, потому что первый запрос содержит контекст рабочего пространства, например содержимое вашего CLAUDE.md и статус git. Репозиторий, содержащий материалы по безопасности или биологии, может сработать на классификаторе только из-за этого контекста.

Чтобы проверить, не являются ли причиной ваши настройки, запустите сессию с claude --safe-mode, что отключает такие настройки, как CLAUDE.md, скиллы, MCP-серверы и хуки. Статус Git и имена каталогов не являются настройками и по-прежнему включаются.

Запрос перед переключением

Чтобы самостоятельно решать, что происходит каждый раз, когда запрос помечен, выполните /config, выберите Switch models when a message is flagged и выберите Ask each time. Вы также можете установить switchModelsOnFlag в false в файле настроек. Тогда Claude Code приостанавливается на помеченном запросе, который привёл бы к переключению моделей, и предлагает два варианта: переключиться на резервную модель или отредактировать промпт и повторить попытку.

В первый раз, когда помеченный запрос в интерактивной сессии должен привести к переключению моделей, Claude Code может спросить, переключаться ли автоматически в дальнейшем. Он спрашивает, только если вы не установили switchModelsOnFlag, и сохраняет ваш выбор в этом ключе в пользовательских настройках.

Если вы решите остаться на текущей модели, сохраняется значение false, так же как для Ask each time. Если вы закроете вопрос, Claude Code ничего не сохраняет и спросит снова в следующий раз, когда помеченный запрос должен будет привести к переключению моделей.

Если вы выбрали Ask each time, некоторые случаи ведут себя иначе:

Когда у помеченной категории нет резервной модели, например при пометке биологии на Opus 5 или Sonnet 5.5, Claude Code не показывает запрос, и запрос к модели завершается отказом.
Если обе модели помечают один и тот же запрос, вы можете отредактировать промпт и повторить попытку или начать новую сессию.
В облачных сессиях в мобильном приложении редактирование и повторная попытка не поддерживаются. Переключите модели или продолжите сессию в браузере на компьютере или в настольном приложении.
В неинтерактивном режиме и интеграциях SDK, которые не могут показать запрос, помеченный запрос вместо этого завершает ход отказом.
В субагенте Claude Code не показывает запрос, и помеченный запрос, который привёл бы к переключению моделей, повторно выполняется на резервной модели.
Когда целевая резервная модель заблокирована availableModels, Claude Code не показывает запрос. Помеченный запрос завершается отказом, так же как при автоматическом переключении, когда целевая модель заблокирована.

Включение резервного варианта на Bedrock, Agent Platform и Foundry

На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry идентификаторы моделей специфичны для поставщика, поэтому автоматическое переключение на резервную модель работает, только когда Claude Code может идентифицировать каждую задействованную модель:

Claude Code должен распознавать текущую модель как источник переключения. Fable 5.1 и Fable 5 распознаются, когда идентификатор модели содержит claude-fable-5, совпадает со значением ANTHROPIC_DEFAULT_FABLE_MODEL или сопоставлен через modelOverrides. Opus 5.5, Sonnet 5.5 и Opus 5 распознаются по идентификатору модели поставщика или по сопоставлению в modelOverrides.
Целевая модель Opus должна разрешаться в вашем развёртывании, независимо от того, какая модель отказала: установите ANTHROPIC_DEFAULT_OPUS_MODEL или сохраните запись Opus 4.8 в списке моделей поставщика. Без этого переключение остаётся отключённым для всех исходных моделей, включая Sonnet 5.5, и помеченные запросы завершаются отказом.
Резервная модель для помеченной категории должна разрешаться в вашем развёртывании. Для модели Fable, Opus 5.5 или Opus 5, если вы установите ANTHROPIC_DEFAULT_OPUS_MODEL, помеченные запросы повторно выполняются на этой модели для каждой категории, у которой есть резервная модель; пометка биологии на Opus 5 по-прежнему завершается отказом. Если вы его не установите, запросы, помеченные как связанные с кибербезопасностью, повторно выполняются на записи Opus 4.8, а запросы, помеченные как связанные с биологией, от модели Fable или Opus 5.5 — на записи Opus 5. Для Sonnet 5.5 запросы, помеченные как связанные с кибербезопасностью, повторно выполняются на модели, которую вы задали в ANTHROPIC_DEFAULT_SONNET_MODEL, или, если вы её не задали, на записи Sonnet 5 в списке моделей поставщика.

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

Модели Fable: установите ANTHROPIC_DEFAULT_FABLE_MODEL в идентификатор вашей модели Fable, чтобы Claude Code распознавал её как источник переключения.
Любая исходная модель: установите ANTHROPIC_DEFAULT_OPUS_MODEL в идентификатор модели Opus, чтобы включить переключение и дать помеченным категориям целевую модель. Закрепление, указывающее модель вне семейства Opus или ту модель, которая отказала, оставляет отказ в силе.
Sonnet 5.5: помимо закрепления Opus установите ANTHROPIC_DEFAULT_SONNET_MODEL или сохраните запись Sonnet 5 в списке моделей поставщика, чтобы указать модель, на которой запрос будет выполнен повторно. Закрепление Sonnet, указывающее модель вне семейства Sonnet или саму Sonnet 5.5, оставляет отказ в силе.

Резервная модель также должна иметь контекстное окно не меньше, чем у сессии, иначе Claude Code не переключается, и помеченный запрос завершается тем же отказом. У этих поставщиков исходные модели по умолчанию работают с контекстным окном 1M. Закрепите модель, которая тоже работает с ним, например Opus 4.8 в ANTHROPIC_DEFAULT_OPUS_MODEL или Sonnet 5 в ANTHROPIC_DEFAULT_SONNET_MODEL, по идентификатору, который Claude Code может сопоставить с этой моделью.

Исследования безопасности и рабочие нагрузки в области биологии

Рабочие нагрузки в наступательной безопасности или биологии, включая тестирование на проникновение, упражнения Capture the Flag (CTF) и кодовые базы, связанные с биологией, часто вызывают переключение на резервную модель, нередко уже при первом запросе. При серьёзной работе по биологии на Fable 5.1, Fable 5 или Opus 5.5 первый помеченный запрос, приводящий к переключению моделей, переводит сессию на Opus 5, и последующие запросы, помеченные как связанные с биологией, завершаются там отказами, потому что у Opus 5 нет резервной модели для биологии. На Opus 5 и Sonnet 5.5 вы получаете эти отказы начиная с первого помеченного запроса.

Это ожидаемая маршрутизация для этих областей, а не пометка учётной записи. Если вашей организации для этой работы нужны возможности класса Fable, обратитесь к своей команде по работе с клиентами Anthropic по поводу программ доверенного доступа.

Регулировка уровня усилий

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

Доступные уровни усилий зависят от модели. Модели, не указанные здесь, не поддерживают effort:

Модель	Уровни
Fable 5.1 и Fable 5	`low`, `medium`, `high`, `xhigh`, `max`
Opus 5.5, Sonnet 5.5, Haiku 5.5, Opus 5, Sonnet 5, Opus 4.8 и Opus 4.7	`low`, `medium`, `high`, `xhigh`, `max`
Opus 4.6 и Sonnet 4.6	`low`, `medium`, `high`, `max`

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

Claude Code определяет уровень усилий сессии в следующем порядке, используя первый применимый:

Явный выбор: переменная окружения CLAUDE_CODE_EFFORT_LEVEL, запуск с --effort или /effort в сессии (неинтерактивный /effort действует уже)
Ваши настройки: уровень, сохранённый вами для модели, или ключ effortLevel; приоритет между ними и между файлами настроек описан в modelSettings
Уровень усилий модели по умолчанию: high на каждой модели, поддерживающей effort, за исключением того, что Opus 5.5, Sonnet 5.5 и Haiku 5.5 по умолчанию используют medium, Opus 4.7 по умолчанию использует xhigh, а когда ваша организация задаёт уровень усилий по умолчанию для своей модели по умолчанию организации, этот уровень используется по умолчанию при работе с этой моделью

Об уровне, который применяется после автоматического переключения на резервную модель, см. Уровень усилий после переключения на резервную модель.

Opus 5.5 начинает с medium, если ни один из перечисленных выше источников не задаёт для него уровень, а ключ effortLevel верхнего уровня в вашем файле пользовательских настроек для Opus 5.5 не учитывается. Этот ключ — старая форма, которую /effort записывал до того, как Claude Code стал сохранять уровни для каждой модели: он продолжает действовать там, где действовал раньше, — на Opus 5, Fable 5.1 и более ранних моделях, тогда как Opus 5.5 и модели, выпущенные после неё, начинают со своего собственного уровня по умолчанию, пока вы не выберете для них уровень с помощью /effort или средства выбора /model. Ключ effortLevel верхнего уровня в настройках проекта, локальных или управляемых настройках или переданный с --settings применяется ко всем моделям.

Когда вы устанавливаете low, medium, high или xhigh в интерактивной сессии на своём компьютере, срок действия уровня определяется тем, как вы его подтверждаете:

Enter в ползунке /effort или средстве выбора /model либо уровень, введённый после /effort: уровень сохраняется как ваш уровень по умолчанию и применяется в последующих сессиях
s в ползунке /effort или средстве выбора /model: уровень применяется только к этой сессии. Требуется Claude Code версии 2.1.257 или позже

Claude Code сохраняет уровень для каждой модели в ключе modelSettings в пользовательских настройках, поэтому у каждой модели свой сохранённый уровень.

max — самый глубокий уровень рассуждений. Если вы не задаёте его через переменную окружения CLAUDE_CODE_EFFORT_LEVEL, Claude Code применяет max только к текущей сессии.

Когда вы устанавливаете уровень с помощью /effort при запуске с -p, Claude Code применяет его только к этой сессии и не сохраняет как уровень по умолчанию.

В ползунке /effort также есть переключатель Ultracode. Ultracode — это настройка Claude Code, а не уровень усилий модели: когда она включена, Claude организует динамические рабочие процессы для существенных задач на любом уровне усилий, на котором работает сессия. О том, где её можно задать постоянно, см. настройку ultracode.

Включение или отключение ultracode с помощью /effort или настройки ultracode не меняет уровень усилий. Флаг --effort ultracode и значение Agent SDK effortLevel: "ultracode" включают его и также устанавливают уровень xhigh. Выбор уровня в ползунке /effort или средстве выбора /model оставляет ultracode в прежнем состоянии.

Включить ultracode можно любым из следующих способов:

/effort: выполните /effort ultracode, чтобы включить его для текущей сессии, или /effort ultracode off, чтобы отключить. В ползунке /effort нажмите Tab, чтобы переключить Ultracode, затем Enter, чтобы применить
Флаг --effort: запустите claude --effort ultracode, что начинает сессию с уровнем xhigh и включённым ultracode
Настройка ultracode: задайте "ultracode": true в файле настроек, с --settings или в управляющем запросе Agent SDK. Запрос applyFlagSettings() также принимает effortLevel: "ultracode", что включает его и устанавливает уровень усилий xhigh

Форма /effort ultracode off, переключатель в ползунке и сохранение ultracode включённым на уровнях усилий, отличных от xhigh, требуют Claude Code версии 2.1.284 или позже. До версии 2.1.284 включение ultracode устанавливало для сессии уровень xhigh, выбор другого уровня отключал его, а ограничение усилий ниже xhigh делало его недоступным.

Передача ultracode во флаг --effort или в значение Agent SDK effortLevel требует Claude Code версии 2.1.203 или позже. До версии 2.1.203 --effort ultracode выводил Unknown --effort value 'ultracode', и сессия начиналась с уровнем усилий по умолчанию.

Сохраняемая настройка effortLevel и переменная окружения CLAUDE_CODE_EFFORT_LEVEL не принимают ultracode. Если CLAUDE_CODE_EFFORT_LEVEL или ограничение усилий задаёт уровень сессии, ultracode остаётся включённым на этом уровне.

Ultracode недоступен, когда:

Рабочие процессы отключены
Модель не поддерживает уровень xhigh

В этих случаях --effort ultracode запускает сессию с отключённым ultracode на наивысшем уровне усилий, который допускают модель и любое ограничение, но не выше xhigh.

Выбор уровня усилий

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

Уровень	Когда его использовать
`low`	Быстрые обмены, где вы проверяете каждый результат, например мозговой штурм, первый набросок или небольшое изменение вроде переименования
`medium`	Уровень по умолчанию на Opus 5.5, Sonnet 5.5 и Haiku 5.5. На Opus 5.5 и Sonnet 5.5 подходит для повседневной инженерной работы с чётко определёнными рамками, например реализации новой функции. На моделях с более высоким уровнем по умолчанию снижает расход токенов для работы, чувствительной к затратам, где можно пожертвовать частью интеллекта
`high`	Работа, где важна проверка или вероятны граничные случаи, например исправление ошибки в существующей кодовой базе. Уровень по умолчанию на всех моделях, кроме Opus 5.5, Sonnet 5.5, Haiku 5.5 и Opus 4.7
`xhigh`	Более глубокие рассуждения при большем расходе токенов. Уровень по умолчанию на Opus 4.7
`max`	Сложные проблемы, которые вы хотите, чтобы Claude проработал без вас, например поиск уязвимостей безопасности. `max` может давать убывающую отдачу и склонен к чрезмерному обдумыванию, поэтому протестируйте его перед широким внедрением
`ultracode`	Настройка Claude Code, а не уровень: планирует динамический рабочий процесс для каждой существенной задачи на любом уровне усилий

В тестах на Opus 5.5 и Fable 5.1 Claude на более высоком уровне проверял больше граничных случаев и больше перепроверял свою работу перед ответом. Он также принимал больше решений самостоятельно. На более низком уровне Claude быстрее возвращал отправную точку, что подходит для работы, где вы проверяете каждый результат и направляете следующий шаг. Чтобы увидеть, как одни и те же задачи выполняются на каждом уровне, прочитайте Using Claude Code: Spending your effort в блоге.

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

Opus 5.5 по умолчанию использует medium — на один уровень ниже, чем high по умолчанию у Opus 5. В тестировании Anthropic Opus 5.5 на medium не уступает или превосходит Opus 5 на high в оценках по программированию и работе со знаниями. На одном и том же уровне Opus 5.5 обычно думает за ход больше, чем Opus 5. При переходе с Opus 5 на Opus 5.5 начните с medium, а не переносите уровень, который вы использовали на Opus 5. Чтобы протестировать уровни на своей работе, см. Calibrate effort в руководстве по составлению промптов для Opus 5.5.

Использование ultrathink для разовых глубоких рассуждений

Включите ultrathink в любое место промпта, чтобы запросить более глубокие рассуждения на этом ходе, не меняя настройку усилий сессии. Claude Code распознаёт ключевое слово и добавляет инструкцию в контекст. Уровень усилий, отправляемый в API, не меняется. Другие фразы, такие как "think", "think hard" и "think more", Claude Code передаёт как обычный текст промпта и не распознаёт как ключевые слова.

Установка уровня усилий

Изменить уровень усилий можно любым из следующих способов:

/effort: выполните /effort без аргументов, чтобы открыть интерактивный ползунок, /effort с именем уровня, чтобы задать его напрямую, или /effort auto, чтобы сбросить сохранённый уровень для активной модели. Команду можно выполнять, пока Claude работает, и после подтверждения предупреждения о кэше, если Claude Code его показывает, Claude Code применяет новый уровень к следующему запросу в ходе
В /model: при выборе модели используйте клавиши со стрелками влево/вправо, чтобы отрегулировать ползунок усилий
Флаг --effort: передайте имя уровня при запуске Claude Code, чтобы задать его для одной сессии
Переменная окружения: установите CLAUDE_CODE_EFFORT_LEVEL в имя уровня или auto
Настройки: задайте уровень для отдельной модели в modelSettings или установите effortLevel в low, medium, high или xhigh как уровень по умолчанию для моделей без собственного уровня. max не принимается как уровень ни в одном из этих ключей, а у ultracode есть собственный ключ ultracode
С подключённого устройства: в сессии Remote Control выберите уровень в элементе управления усилиями на телефоне или в браузере. Уровень применяется только к текущей сессии. Требуется Claude Code версии 2.1.234 или позже
Frontmatter скиллов и субагентов: задайте effort в markdown-файле скилла или субагента, чтобы переопределить уровень усилий при работе этого скилла или субагента

Уровень усилий из frontmatter применяется, когда этот скилл или субагент активен, и переопределяет уровень сессии, но не переменную окружения. maxEffortLevel или ограничение усилий организации по-прежнему ограничивают уровень, на котором работает скилл или субагент.

Если вы задаёте effortLevel в управляемых настройках, Claude Code применяет его на шаге настроек порядка разрешения усилий, и пользователи по-прежнему могут менять уровень с помощью /effort или --effort. Чтобы пользователи не превышали определённый уровень, задайте maxEffortLevel.

Ползунок усилий появляется в /model, когда выбрана поддерживаемая модель. Текущий уровень усилий также показывается в заголовке сессии рядом с именем модели, например "with low effort", поэтому вы можете проверить, какая настройка активна, не открывая /model. Нижняя строка также ненадолго показывает уровень усилий при запуске и при его изменении.

Адаптивные рассуждения и фиксированные бюджеты мышления

Адаптивные рассуждения делают мышление необязательным на каждом шаге, поэтому Claude может быстрее отвечать на рутинные промпты и приберегать более глубокое мышление для шагов, которым оно полезно. Если вы хотите, чтобы Claude думал чаще или реже, чем при текущем уровне, можно сказать об этом прямо в промпте или в CLAUDE.md; модель учитывает такие указания в рамках своей настройки усилий.

Модели Fable, Sonnet 5 и новее, Haiku 5.5, а также Opus 4.7 и новее всегда используют адаптивные рассуждения. Режим фиксированного бюджета мышления и CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING к ним не применяются.

На Opus 4.6 и Sonnet 4.6 можно установить CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1, чтобы вернуться к прежнему фиксированному бюджету мышления, управляемому MAX_THINKING_TOKENS. См. переменные окружения.

Расширенное мышление

Расширенное мышление — это размышления, которые Claude выдаёт перед ответом. На моделях, поддерживающих адаптивные рассуждения, основным регулятором объёма мышления является уровень усилий; настройки ниже включают или отключают мышление и управляют его отображением. Когда мышление отключено на Anthropic API, Claude Code отправляет уровень high вместо более высокого уровня моделям, которые, как ему известно, не принимают такую комбинацию, например Opus 5.

Способ управления	Как его задать
Переключение для текущей сессии	Нажмите `Option+T` на macOS или `Alt+T` на Windows и Linux
Установка глобального значения по умолчанию	Выполните `/config` и переключите режим мышления. Сохраняется как `alwaysThinkingEnabled` в `~/.claude/settings.json`
Отключение через переменную окружения	Задайте `MAX_THINKING_TOKENS=0`, что отключает мышление на Anthropic API, кроме Opus 5.5, Sonnet 5.5, Haiku 5.5 и моделей Fable. У сторонних поставщиков Claude Code вместо этого опускает параметр `thinking`, и модели с адаптивными рассуждениями всё равно могут размышлять

Мышление нельзя отключить на Opus 5.5, Sonnet 5.5, Haiku 5.5 и моделях Fable. Переключатель сессии и строка в /config для этих моделей показывают Thinking can't be turned off вместо переключателя, а сохранённые alwaysThinkingEnabled: false или MAX_THINKING_TOKENS=0 на них не действуют. На этих моделях модель сама решает на каждом шаге, сколько размышлять, исходя из уровня усилий. Сохранённая настройка снова начинает действовать, когда вы переключаетесь на модель, которая её поддерживает.

По умолчанию Claude Code сворачивает вывод размышлений. Нажмите Ctrl+O, чтобы переключить подробный режим и увидеть рассуждения серым курсивным текстом. Интерактивные сессии на Anthropic API по умолчанию получают скрытые блоки размышлений, поэтому установите showThinkingSummaries: true в настройках, если хотите, чтобы при развороте были доступны полные резюме. Оплачиваются все сгенерированные токены мышления, даже если они свёрнуты или скрыты.

Расширенный контекст

Fable 5.1, Fable 5, Sonnet 5 и новее, Haiku 5.5, Opus 4.6 и новее, а также Sonnet 4.6 поддерживают контекстное окно в 1 миллион токенов для длительных сессий с большими кодовыми базами.

Fable 5.1, Fable 5, Sonnet 5 и новее, Haiku 5.5, а также Opus 4.7 и новее по умолчанию работают с окном 1M, и суффикс [1m] не нужен. Это относится и к сессиям на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, а также к сессиям Claude apps gateway. Чтобы вместо этого запускать их с окном 200K, см. Отключение контекста 1M.

Opus 4.6 и Sonnet 4.6 получают 1M только через свой вариант [1m], и доступ к этому варианту зависит от вашего тарифа. На тарифах Max, Team и Enterprise, включая места как Team Standard, так и Team Premium, Opus 4.6 с контекстом 1M входит в вашу подписку. Sonnet 4.6 с контекстом 1M требует кредитов использования на любом тарифе подписки, включая Max.

Тариф	Opus 4.6 с контекстом 1M	Sonnet 4.6 с контекстом 1M
Max, Team и Enterprise	Входит в подписку	Требует кредитов использования
Pro	Требует кредитов использования	Требует кредитов использования
API и оплата по мере использования	Полный доступ	Полный доступ

Claude Code проверяет эти требования тарифа, только когда подключается к Anthropic API напрямую. Если вы направляете ANTHROPIC_BASE_URL на LLM-шлюз, а ваш сохранённый вход в claude.ai остаётся активными учётными данными, Claude Code не проверяет кредиты использования вашего тарифа. Варианты [1m] остаются доступными в /model, и шлюз решает, будет ли запрос успешным. До версии 2.1.229 Claude Code в такой конфигурации отклонял /model sonnet[1m], если не мог подтвердить наличие кредитов использования в учётной записи.

На Anthropic API контекстное окно 1M использует стандартные цены модели без надбавки за токены сверх 200K, за исключением Haiku 5.5, который стоит дороже на промптах длиннее 100K токенов. На тарифах, где расширенный контекст входит в подписку, использование по-прежнему покрывается подпиской. На тарифах, где доступ к расширенному контексту предоставляется через кредиты использования, токены оплачиваются из кредитов.

Выбор контекста 1M для Opus 4.6 или Sonnet 4.6

Чтобы выбрать вариант 1M по имени, добавьте суффикс [1m] к псевдониму модели или полному имени модели:

# Добавьте [1m] к полному имени модели
/model claude-opus-4-6[1m]
/model claude-sonnet-4-6[1m]

# Или к псевдониму: суффикс применяется к модели, в которую разрешается псевдоним
/model opus[1m]

Контекстное окно за LLM-шлюзом

Если вы установите ANTHROPIC_BASE_URL на LLM-шлюз или другой прокси, Claude Code даёт каждой распознанной модели то же контекстное окно, что и на Anthropic API. Fable 5.1, Fable 5, Sonnet 5 и новее, Haiku 5.5, а также Opus 4.7 и новее получают окно 1M без необходимости выбирать вариант [1m], а модель, которая получает 1M только через свой вариант [1m], например Opus 4.6, без него работает с 200K. Claude Code не может обнаружить более низкий предел, установленный шлюзом или сервером за ним. Если ваш шлюз отклоняет запросы свыше 200K токенов, установите CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000 в окружении, из которого запускается Claude Code, чтобы сессии на всех моделях сжимались на этой границе.

Отключение контекста 1M

Чтобы сессии оставались в окне 200K, установите CLAUDE_CODE_DISABLE_1M_CONTEXT=1 в оболочке или в файле настроек. Claude Code удаляет варианты моделей [1m] из средства выбора модели. На моделях, которые по умолчанию работают с окном 1M, таких как модели Fable, Sonnet 5 и новее, а также Opus 4.7 и новее, он также рассматривает модель как имеющую контекстное окно 200K:

При включённом автосжатии сессии сжимаются на границе 200K с помощью автосжатия. Установка окна автосжатия выше 200K не снимает это ограничение, потому что Claude Code ограничивает это окно контекстным окном модели.
При отключённом автосжатии сессии останавливаются на границе 200K с ошибкой превышения контекста вместо сжатия.

Контекстное окно и цены Haiku 5.5

На Anthropic API Haiku 5.5 работает с контекстным окном 1M на любом тарифе, и суффикс [1m] выбирать не нужно. Идентификатор модели — claude-haiku-5-5. Чтобы использовать её, выполните /model claude-haiku-5-5 в сессии или запустите Claude Code из оболочки командой claude --model claude-haiku-5-5.

Запрос к Haiku 5.5 стоит дороже за токен, если его промпт длиннее 100K токенов. Обе ставки см. в разделе цены Anthropic.

По умолчанию сессии автоматически сжимаются примерно на 967K токенов. Чтобы сжатие происходило раньше, задайте для модели меньшее окно автосжатия.

Контекстное окно и автосжатие

Окно автосжатия определяет, насколько может заполниться контекстное окно, прежде чем Claude Code выполнит сжатие контекста диалога. Информацию о том, что сохраняется и что удаляется при каждом механизме, см. в разделе Что сохраняется после сжатия контекста.

Установка окна автосжатия

Задать окно автосжатия можно в следующих местах:

Для текущей модели, в этой сессии и последующих: выполните /autocompact со значением, например /autocompact 500k. Claude Code сохраняет его в ваших пользовательских настройках для текущей модели в modelSettings и применяет к текущей сессии. Если область действия настроек с более высоким приоритетом, например управляемые настройки, задаёт собственное окно для этой модели или для всех моделей, команда сохраняет ваше значение, но сессия использует окно этой области действия, и команда сообщает об этом. Выполните /autocompact auto, чтобы вернуться к окну, оптимизированному для вашей модели. До версии v2.1.288 команда сохраняла одно окно для всех моделей в виде ключа верхнего уровня autoCompactWindow.
Для всех моделей: задайте autoCompactWindow в файле настроек, например "autoCompactWindow": 200000 в ~/.claude/settings.json. Окно, сохранённое для модели с помощью /autocompact, имеет приоритет над этим ключом в том же файле для этой модели.
Для одного запуска: передайте --autocompact при запуске Claude Code. Флаг переопределяет вашу сохранённую настройку для этого запуска, не изменяя её, а claude --autocompact auto запускает сессию с оптимизированным окном, даже если в вашей сохранённой настройке задано значение. В отличие от /autocompact, флаг не вытесняется областью действия настроек с более высоким приоритетом, например управляемыми настройками.
В скриптах и облачных окружениях: задайте CLAUDE_CODE_AUTO_COMPACT_WINDOW. Пока эта переменная задана, она имеет приоритет над командой, флагом и настройкой, а /autocompact сообщает о переопределении вместо изменения окна.

Команда и флаг принимают размер окна от 100K до 1M токенов в любой из следующих форм:

Простое количество токенов, например 200000
Суффикс k или M, например 500k или 1M
Простое число от 100 до 1000, означающее тысячи, поэтому 200 задаёт 200 000

Переменная окружения принимает только простое количество токенов. Claude Code ограничивает окно размером контекстного окна модели.

Пороги автосжатия по умолчанию

Если вы не задали окно автосжатия, Claude Code выполняет сжатие контекста, когда диалог достигает предела контекста модели, за исключением следующих сессий:

Облачные сессии выполняют сжатие контекста по мере приближения диалога к пределу модели
Sonnet 4.6 и Opus 4.6 без расширенного контекста выполняют сжатие контекста на границе 200K
Когда вы задаёте CLAUDE_CODE_DISABLE_1M_CONTEXT=1, модели с собственным окном 1M, такие как Sonnet 5 и модели Fable, выполняют сжатие контекста на границе 200K
Модели, работающие с собственным окном 1M, выполняют сжатие контекста до заполнения окна, по умолчанию примерно на 967K токенов. К ним относятся модели Fable, Sonnet 5 и более поздние версии, Haiku 5.5, а также Opus 4.7 и более поздние версии. При использовании пользовательского ANTHROPIC_BASE_URL см. раздел контекстное окно за шлюзом
Сессии с ID модели, который Claude Code не распознаёт, например псевдонимом LLM-шлюза, выполняют сжатие контекста при контекстном окне, которое Claude Code предполагает для этого ID; см. Исправление окна для шлюза или пользовательского ID модели

Исправление окна для шлюза или пользовательского ID модели

При использовании LLM-шлюза или другого пользовательского развёртывания Claude Code может предполагать для ID модели контекстное окно, которое отличается от реального окна модели, независимо от того, сопоставляет ли он ID с моделью Claude. Задайте в CLAUDE_CODE_MAX_CONTEXT_TOKENS окно, которое Claude Code должен предполагать вместо этого.

Применение переменной зависит от ID. Claude Code рассматривает ID как написание поставщика или пользовательское написание, если он не начинается с claude- (в любом регистре) или если он содержит суффикс, который Claude Code удаляет при чтении ID, например дату @YYYYMMDD, используемую в Google Cloud's Agent Platform. До версии v2.1.259 Claude Code не учитывал удалённый суффикс, поэтому нераспознанный ID claude- с суффиксом даты рассматривался как простое имя claude-.

Нераспознанное написание поставщика или пользовательское написание, то же написание с [1m] и все остальные ID — это три отдельных случая:

Если Claude Code не может сопоставить написание поставщика или пользовательское написание с распознаваемой моделью и ID не содержит [1m], переменная применяется напрямую, и упреждающее сжатие контекста продолжается при объявленном окне.
Если Claude Code не может сопоставить написание поставщика или пользовательское написание с распознаваемой моделью и ID содержит [1m] (в любом регистре), Claude Code предполагает для него окно 1M, и переменная сама по себе не применяется. Чтобы исправить окно, сохранив упреждающее сжатие контекста, также задайте CLAUDE_CODE_DISABLE_1M_CONTEXT=1. Когда эта переменная задана, Claude Code определяет размер для ID так же, как для того же написания без [1m], поэтому CLAUDE_CODE_MAX_CONTEXT_TOKENS применяется в тех случаях, когда она применялась бы к этому написанию без метки.

Если объявленное окно превышает 200K, Claude Code затем показывает предупреждение при запуске о том, что предел 200K не применяется. В этой конфигурации такое предупреждение ожидаемо.
Если ID сопоставляется с моделью, которую Claude Code распознаёт, или ID является простым именем claude- без суффикса, который Claude Code мог бы удалить (в любом регистре), переменная вступает в силу, только если вы также задаёте DISABLE_COMPACT, что отключает любое сжатие контекста.

Например, ID, содержащий известное Claude Code имя модели Claude, такой как anthropic/claude-opus-4-8, us.anthropic.claude-…-v1:0 или датированный claude-sonnet-4-5@20250929, сопоставляется с этой моделью. Это относится и к ID, которые также содержат [1m]: Claude Code сопоставляет claude-opus-4-8[1m] с Opus 4.8 даже при заданной CLAUDE_CODE_DISABLE_1M_CONTEXT.

Для ID модели, который Claude Code не распознаёт, задайте CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1, чтобы Claude Code выполнял сжатие контекста только после того, как API отклонит диалог с ошибкой превышения длины, которую распознаёт Claude Code. Claude Code не выполняет это восстановление, если шлюз переписывает текст ошибки в формулировку, которую Claude Code не распознаёт.

Проверка вашей текущей модели

Вы можете увидеть, какую модель вы используете в настоящее время, в двух местах:

В строке состояния, если у вас она настроена
В /status, который также отображает информацию вашей учетной записи

Добавление пользовательского варианта модели

Используйте ANTHROPIC_CUSTOM_MODEL_OPTION для добавления одной пользовательской записи в средство выбора /model без замены встроенных псевдонимов. Это полезно для тестирования идентификаторов моделей, которые Claude Code не указывает по умолчанию. Для развертываний шлюза LLM Claude Code может заполнять средство выбора из конечной точки /v1/models шлюза, когда установлено значение CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1, поэтому эта переменная требуется только в том случае, если обнаружение отключено или не возвращает нужную вам модель. См. обнаружение модели шлюза.

Чтобы вместо этого перечислить несколько моделей в собственном порядке и под выбранными вами метками, установите modelPicker. Его запись указывает, какие строки средство выбора сохраняет, когда эта комбинация заменяет встроенную.

Этот пример устанавливает все три переменные, чтобы сделать развертывание Opus с маршрутизацией через шлюз выбираемым. Claude Code читает переменные окружения при запуске, поэтому запустите экспорты перед запуском claude или перезагрузите существующий сеанс, чтобы их применить:

export ANTHROPIC_CUSTOM_MODEL_OPTION="my-gateway/claude-opus-5-5"
export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Opus via Gateway"
export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Custom deployment routed through the internal LLM gateway"

ANTHROPIC_CUSTOM_MODEL_OPTION_NAME и ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION являются необязательными:

Если вы опустите имя, запись показывает имя модели, когда Claude Code распознает идентификатор, и идентификатор модели в противном случае.
Если вы опустите описание, Claude Code использует Custom model (<model-id>).

Claude Code перечисляет пользовательскую запись после встроенных записей, и любые строки modelPicker, которые вы добавляете, появляются после неё.

Claude Code пропускает валидацию для идентификатора модели, установленного в ANTHROPIC_CUSTOM_MODEL_OPTION, поэтому вы можете использовать любую строку, которую принимает ваша конечная точка API.

Когда установлено значение availableModels, включите пользовательский идентификатор модели в список разрешений. В противном случае Claude Code фильтрует пользовательскую запись из средства выбора и отклоняет выбор --model для неё, как и для любой другой исключённой модели.

Пользовательский идентификатор, который встраивает имя семейства, такой как my-gateway/claude-opus-5-5, считается конкретной записью для этого семейства и отключает его подстановочный знак, поэтому также перечислите версии, которые вы намереваетесь оставить выбираемыми. См. Поведение слияния.

Переменные окружения

Используйте следующие переменные окружения для управления именами моделей, на которые отображаются псевдонимы. Каждое значение должно быть полным именем модели или эквивалентным идентификатором для вашего поставщика API. Чтобы выбрать модель, на которой начинаются ваши сессии, установите ANTHROPIC_DEFAULT_MODEL, которую эта таблица опускает.

Переменная окружения	Описание
`ANTHROPIC_DEFAULT_FABLE_MODEL`	Модель для использования с `fable` и идентификатор модели, который Claude Code распознаёт как модель Fable для автоматического переключения на резервную модель у сторонних поставщиков
`ANTHROPIC_DEFAULT_OPUS_MODEL`	Модель для использования с `opus` или для `opusplan`, когда активен Plan Mode.
`ANTHROPIC_DEFAULT_SONNET_MODEL`	Модель для использования с `sonnet` или для `opusplan`, когда Plan Mode неактивен.
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	Модель для использования с `haiku` или фоновая функциональность
`CLAUDE_CODE_SUBAGENT_MODEL`	Модель по умолчанию для субагентов, участников команды агентов и агентов workflow, которым не назначена модель другим способом. Принимает псевдоним, такой как `haiku`, или полное имя модели. Модель для каждого вызова или поле `model` определения, включая `inherit`, имеет приоритет. Чтобы изменить это, установите `CLAUDE_CODE_SUBAGENT_MODEL_FORCE`

У сторонних поставщиков Настройка отображения и возможностей закреплённой модели описывает, что показывает строка закреплённой модели в средстве выбора /model.

Примечание: ANTHROPIC_SMALL_FAST_MODEL устарела в пользу ANTHROPIC_DEFAULT_HAIKU_MODEL.

Закрепление моделей для развёртываний у сторонних поставщиков

При развёртывании Claude Code через Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform on AWS закрепите версии моделей перед развёртыванием для пользователей.

Без закрепления Claude Code использует псевдонимы моделей, такие как fable, opus, sonnet и haiku, которые разрешаются во встроенный идентификатор модели по умолчанию для каждого поставщика. Этот идентификатор по умолчанию может отставать от последнего выпуска Anthropic, и модель, на которую он указывает, может быть ещё не включена в учётной записи пользователя. Когда идентификатор по умолчанию недоступен, пользователи Amazon Bedrock и Google Cloud's Agent Platform видят уведомление, и сессия переключается на более раннюю версию модели по умолчанию или на модель Sonnet по умолчанию, когда идентификатор по умолчанию является моделью Opus и нет доступной версии Opus. Пользователи Microsoft Foundry вместо этого видят ошибки, потому что Microsoft Foundry не имеет эквивалентной проверки при запуске.

На Amazon Bedrock и Google Cloud's Agent Platform пользователь, который запускает сессию на конкретной версии Sonnet или Opus, например с помощью --model, ANTHROPIC_MODEL или настройки model, закрепляет эту версию как идентификатор по умолчанию сессии для соответствующего псевдонима: проверка при запуске пропускает встроенный идентификатор по умолчанию, который она заменяет, и не показывает уведомление о переключении. До версии 2.1.211 проверка выполнялась и могла показать уведомление, даже когда модель сессии была явно настроена.

Используйте следующие переменные окружения с идентификаторами моделей для конкретных версий вашего поставщика:

Поставщик	Пример
Amazon Bedrock	`export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'`
Google Cloud's Agent Platform	`export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'`
Microsoft Foundry	`export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'`

Применяйте тот же шаблон для ANTHROPIC_DEFAULT_FABLE_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL и ANTHROPIC_DEFAULT_HAIKU_MODEL. Для текущих и устаревших идентификаторов моделей у всех поставщиков см. Обзор моделей. Чтобы обновить пользователей до новой версии модели, обновите эти переменные окружения и переразверните.

Закреплённая модель с нативным окном 1M, такая как Opus 4.8 или Sonnet 5, работает с контекстным окном 1M без какого-либо суффикса, когда Claude Code может сопоставить закреплённый идентификатор с этой моделью. Идентификатор совпадает, когда он содержит идентификатор модели в Anthropic API, как us.anthropic.claude-opus-4-8 содержит claude-opus-4-8, или когда запись modelOverrides отображает модель на него. Для закреплённого идентификатора, который Claude Code не может сопоставить с моделью, сессии по умолчанию работают с окном 200K, если идентификатор не содержит суффикс [1m].

Для модели, которая достигает 1M через свой вариант [1m], такой как Opus 4.6 или Sonnet 4.6, включите расширенный контекст, добавив [1m] к идентификатору модели в ANTHROPIC_DEFAULT_OPUS_MODEL или ANTHROPIC_DEFAULT_SONNET_MODEL:

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-6[1m]'

С суффиксом [1m] контекстное окно 1M применяется ко всему использованию закреплённого псевдонима, включая фазу Opus в режиме планирования opusplan и субагентов, чьё frontmatter model называет псевдоним.

Claude Code удаляет суффикс перед отправкой идентификатора модели вашему поставщику.
Добавляйте [1m] только когда базовая модель поддерживает контекст 1M.
Суффикс читается для каждой переменной, а не для каждой модели. На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry идентификатор Opus 4.6 или Sonnet 4.6 без [1m] в одной переменной использует контекст 200K, даже если другая переменная устанавливает ту же модель с суффиксом.

Когда вы устанавливаете переменную ANTHROPIC_DEFAULT_*_MODEL, средство выбора /model показывает одну строку для этой модели вместо встроенных строк семейства, включая любые строки контекста 1M. Чтобы достичь окна 1M без добавления суффикса к этой переменной, ваши пользователи запускают /model opus[1m], и Claude Code применяет суффикс к модели, которую называет переменная. /model sonnet[1m] работает так же.

Note

Список разрешённых моделей availableModels, доставленный через MDM или файл управляемых настроек, по-прежнему применяется при использовании сторонних поставщиков; настройки, управляемые сервером, туда не доставляются.

Фильтрация соответствует псевдониму модели, такому как opus, префиксу версии, такому как claude-opus-4-8, или полному идентификатору модели в форме поставщика. Префиксы, специфичные для поставщика, такие как us.anthropic., не удаляются, поэтому чтобы разрешить конкретную модель, укажите её полный идентификатор в форме поставщика или отобразите её через modelOverrides. Для закреплённой модели этот идентификатор является значением, которое вы установили в её переменной ANTHROPIC_DEFAULT_*_MODEL. Любой суффикс [1m] удаляется из записи списка разрешённых моделей и запрошенной модели перед сопоставлением.

Настройка отображения и возможностей закреплённой модели

Когда вы закрепляете модель у стороннего поставщика, её строка в средстве выбора /model показывает имя модели по умолчанию, если Claude Code распознаёт закреплённый идентификатор, и необработанный идентификатор в противном случае:

Распознана: точный идентификатор модели, которую Claude Code знает, такой как её идентификатор Anthropic API или форма вашего поставщика или шлюза, с суффиксом [1m] или без него. Закрепите us.anthropic.claude-sonnet-4-5-20250929-v1:0, и строка будет читаться как Sonnet 4.5.
Не распознана: любой другой идентификатор, такой как ARN профиля вывода приложения или версия модели, которую Claude Code не знает, если только запись modelOverrides не отображает модель на эту точную строку. На Microsoft Foundry имена развёртываний определяются пользователем, поэтому Claude Code никогда не распознаёт закреплённый идентификатор там, отображённый или нет, и строка показывает имя развёртывания по умолчанию.

Когда строка показывает имя модели, её описание по умолчанию включает закреплённый идентификатор, чтобы вы всё ещё могли видеть, какой идентификатор закреплён.

Claude Code также может не распознать, какие функции поддерживает закреплённая модель. Вы можете установить имя отображения и описание самостоятельно и объявить возможности с помощью переменных окружения-спутников для каждой закреплённой модели.

Эти переменные вступают в силу у сторонних поставщиков, таких как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. Переменные _NAME и _DESCRIPTION также вступают в силу, когда ANTHROPIC_BASE_URL указывает на LLM-шлюз. Они не имеют эффекта при прямом подключении к api.anthropic.com.

Переменная окружения	Описание
`ANTHROPIC_DEFAULT_OPUS_MODEL_NAME`	Имя отображения для закреплённой модели Opus в средстве выбора `/model`. Когда не установлено, строка показывает имя модели, если Claude Code распознаёт закреплённый идентификатор, и закреплённый идентификатор в противном случае
`ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION`	Описание отображения для закреплённой модели Opus в средстве выбора `/model`. Когда не установлено, строка показывает описание по умолчанию, которое начинается с `Custom Opus model`
`ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES`	Список возможностей, разделённый запятыми, которые поддерживает закреплённая модель Opus

Те же суффиксы _NAME, _DESCRIPTION и _SUPPORTED_CAPABILITIES доступны для ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL, ANTHROPIC_DEFAULT_FABLE_MODEL и ANTHROPIC_CUSTOM_MODEL_OPTION.

Claude Code включает функции, такие как уровни усилий и расширенное мышление, путём сопоставления идентификатора модели с известными шаблонами. Идентификаторы, специфичные для поставщика, такие как ARN Amazon Bedrock или пользовательские имена развёртываний, часто не соответствуют этим шаблонам, оставляя поддерживаемые функции отключёнными. Установите _SUPPORTED_CAPABILITIES, чтобы сообщить Claude Code, какие функции фактически поддерживает модель:

Значение возможности	Включает
`effort`	Уровни усилий и команду `/effort`
`xhigh_effort`	Уровень усилий `xhigh`
`max_effort`	Уровень усилий `max`
`thinking`	Расширенное мышление
`adaptive_thinking`	Адаптивное рассуждение, которое динамически распределяет мышление на основе сложности задачи
`interleaved_thinking`	Мышление между вызовами инструментов

Когда _SUPPORTED_CAPABILITIES установлена, Claude Code включает перечисленные возможности и отключает неперечисленные для соответствующей закреплённой модели. Когда переменная не установлена, Claude Code использует как резервный вариант встроенное обнаружение на основе идентификатора модели.

Этот пример закрепляет Opus на пользовательский ARN модели Amazon Bedrock, устанавливает понятное имя и объявляет его возможности:

export ANTHROPIC_DEFAULT_OPUS_MODEL='arn:aws:bedrock:us-east-1:123456789012:custom-model/abc'
export ANTHROPIC_DEFAULT_OPUS_MODEL_NAME='Opus via Bedrock'
export ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION='Opus 4.7 routed through a Bedrock custom endpoint'
export ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES='effort,xhigh_effort,max_effort,thinking,adaptive_thinking,interleaved_thinking'

Переопределение идентификаторов моделей для каждой версии

На платформах, которые встраивают Claude Code и устанавливают CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST, конфигурация модели хоста имеет приоритет над управляемыми настройками модели, в то время как управляемый список разрешённых моделей availableModels остаётся в силе, если только хост не предоставляет свой собственный; Исключения из приоритета управляемых настроек указывает, какие ключи и переменные переопределяет хост.

Переменные окружения уровня семейства выше настраивают один идентификатор модели для каждого псевдонима семейства. Если вам нужно отобразить несколько версий в одном семействе на различные идентификаторы поставщика, используйте вместо этого настройку modelOverrides.

modelOverrides отображает отдельные идентификаторы моделей Anthropic на строки, специфичные для поставщика, которые Claude Code отправляет API вашего поставщика. Когда пользователь выбирает отображённую модель в средстве выбора /model, Claude Code использует ваше настроенное значение вместо встроенного значения по умолчанию.

Это позволяет администраторам предприятия маршрутизировать каждую версию модели на конкретный ARN профиля вывода приложения Amazon Bedrock, имя версии Google Cloud's Agent Platform или имя развёртывания Microsoft Foundry для управления, распределения затрат или региональной маршрутизации.

Установите modelOverrides в вашем файле настроек:

{
  "modelOverrides": {
    "claude-opus-4-7": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-prod",
    "claude-opus-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-46-prod",
    "claude-sonnet-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/sonnet-prod"
  }
}

Ключи должны быть идентификаторами моделей Anthropic, как указано в Обзоре моделей. Для датированных идентификаторов моделей включите суффикс даты точно так, как он там появляется. Неизвестные ключи игнорируются.

Чтобы остановить диагностическую строку [claude-code:unrecognized_model] для идентификатора, такого как псевдоним шлюза, добавьте запись с этим идентификатором в качестве её значения.

Переопределения заменяют встроенные идентификаторы моделей, которые стоят за каждой записью в средстве выбора /model. На Amazon Bedrock записи modelOverrides имеют приоритет над любыми профилями вывода, которые Claude Code автоматически обнаруживает при запуске. Claude Code передаёт значения, которые уже являются собственными для поставщика, такие как ARN профиля вывода Amazon Bedrock или имена развёртываний Microsoft Foundry, поставщику как есть.

Переопределения также применяются, когда вы передаёте идентификатор модели Anthropic непосредственно через --model, переменную окружения ANTHROPIC_MODEL или переменную окружения ANTHROPIC_DEFAULT_*_MODEL. На Amazon Bedrock, Google Cloud's Agent Platform и Mantle идентификатор модели Anthropic без записи modelOverrides разрешается в тот же идентификатор, специфичный для поставщика, что и строка средства выбора /model для этой версии, когда поставщик поддерживает эту версию. Mantle поддерживает подмножество версий. Для идентификатора модели Anthropic вне этого подмножества Claude Code отправляет необработанный идентификатор в Mantle без отображения, если только запись modelOverrides не охватывает его. До версии 2.1.200 --model и значения переменных окружения достигали поставщика как есть, без прохождения через карту переопределений.

modelOverrides работает вместе с availableModels. Список разрешённых моделей оценивается по идентификатору модели Anthropic, а не по значению переопределения, поэтому запись, такая как "opus" в availableModels, продолжает соответствовать, даже когда версии Opus отображаются на ARN. Когда enforceAvailableModels установлена в управляемых настройках, принудительный Default разрешается через modelOverrides только из управляемых настроек. Отображение администратора, такое как версия, закреплённая на ARN профиля вывода, соблюдается в принудительном Default. Переопределения из настроек пользователя или проекта не влияют на него.

Когда availableModels установлена в управляемых настройках, к идентификатору модели Anthropic, переданному непосредственно через --model или переменные окружения выше, применяются только modelOverrides из управляемых настроек. Claude Code игнорирует переопределения в настройках пользователя или проекта для этих идентификаторов и никогда не разрешает идентификатор, который управляемый список исключает, через modelOverrides из любого источника настроек. Это ограничение источника управляемых настроек требует Claude Code версии 2.1.200 или более поздней. См. Ограничение выбора модели, чтобы узнать, как обрабатываются заблокированные идентификаторы.

Конфигурация кэширования промптов

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

Переменная окружения	Описание
`DISABLE_PROMPT_CACHING`	Установите на `1`, чтобы отключить кэширование промптов для всех моделей. Имеет приоритет над настройками для каждой модели
`DISABLE_PROMPT_CACHING_HAIKU`	Установите на `1`, чтобы отключить кэширование промптов для модели Haiku по умолчанию
`DISABLE_PROMPT_CACHING_SONNET`	Установите на `1`, чтобы отключить кэширование промптов для модели Sonnet по умолчанию
`DISABLE_PROMPT_CACHING_OPUS`	Установите на `1`, чтобы отключить кэширование промптов для модели Opus по умолчанию
`DISABLE_PROMPT_CACHING_FABLE`	Установите на `1`, чтобы отключить кэширование промптов только для моделей Fable

Чтобы выбрать TTL кэша для основного диалога и для субагентов отдельно, см. выберите TTL самостоятельно. О том, что вызывает промах кэша, см. Как Claude Code использует кэширование промптов.

История версий

В этой таблице перечислены версии Claude Code, в которых каждый псевдоним модели изменил модель, на которую он разрешается, начиная с самых новых.

Версия	Изменение
v2.1.293	`haiku` разрешается на Haiku 5.5 в Anthropic API
v2.1.284	`sonnet` разрешается на Sonnet 5.5 в Anthropic API
v2.1.280	`opus` разрешается на Opus 5.5 в Anthropic API, Claude Platform на AWS, Amazon Bedrock и Agent Platform Google Cloud
v2.1.257	`fable` разрешается на Fable 5.1, кроме сеансов шлюза приложений Claude
v2.1.219	`opus` разрешается на Opus 5 в Anthropic API, Claude Platform на AWS, Amazon Bedrock и Agent Platform
v2.1.207	`opus` разрешается на Opus 4.8 в Claude Platform на AWS, Amazon Bedrock и Agent Platform
v2.1.197	`sonnet` разрешается на Sonnet 5 в Anthropic API
v2.1.154	`opus` разрешается на Opus 4.8 в Anthropic API
Более ранние	`opus` разрешается на Opus 4.7 в Claude Platform на AWS и на Opus 4.6 в Amazon Bedrock и Agent Platform. `fable` разрешается на Fable 5, а `haiku` разрешается на Haiku 4.5 у каждого поставщика

model-config.md +263 −253

10 Доступные модели10 Доступные модели

11</h2>11</h2>

12 12

~~13Для параметра `model` в Claude Code вы можете настроить либо:~~13Для настройки `model` в Claude Code вы можете указать либо:

14 14

15* **Псевдоним модели**15* **Псевдоним модели**

16* **Имя модели**16* **Имя модели**

22Рекомендации по выбору модели и уровня усилий для различных типов работ см. в статье [Choosing a Claude model and effort level in Claude Code](https://claude.com/blog/claude-model-and-effort-level-in-claude-code) в блоге.22Рекомендации по выбору модели и уровня усилий для различных типов работ см. в статье [Choosing a Claude model and effort level in Claude Code](https://claude.com/blog/claude-model-and-effort-level-in-claude-code) в блоге.

23 23

24<Note>24<Note>

25 `ANTHROPIC_BASE_URL` изменяет, куда отправляются запросы, а не какая модель на них отвечает. Чтобы маршрутизировать Claude через шлюз LLM, см. [LLM gateways](/docs/ru/llm-gateway).25 `ANTHROPIC_BASE_URL` изменяет, куда отправляются запросы, а не какая модель на них отвечает. Чтобы маршрутизировать Claude через LLM-шлюз, см. [LLM gateways](/docs/ru/llm-gateway).

26</Note>26</Note>

27 27

28<h3 id="model-aliases">28<h3 id="model-aliases">

39| **`sonnet`** | Использует последнюю модель Sonnet для ежедневных задач кодирования |39| **`sonnet`** | Использует последнюю модель Sonnet для ежедневных задач кодирования |

40| **`opus`** | Использует последнюю модель Opus для сложных задач рассуждения |40| **`opus`** | Использует последнюю модель Opus для сложных задач рассуждения |

41| **`haiku`** | Использует быструю и эффективную модель Haiku для простых задач |41| **`haiku`** | Использует быструю и эффективную модель Haiku для простых задач |

42| **`sonnet[1m]`** | Использует Sonnet с [контекстным окном в 1 миллион токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сеансов. Не имеет эффекта, когда `sonnet` уже разрешается на Sonnet 5.5 или Sonnet 5 с их встроенным окном 1M |42| **`sonnet[1m]`** | Использует Sonnet с [контекстным окном в 1 миллион токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сессий. Не имеет эффекта, когда `sonnet` уже разрешается на Sonnet 5.5 или Sonnet 5 с их встроенным окном 1M |

43| **`opus[1m]`** | Использует Opus с [контекстным окном в 1 миллион токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сеансов |43| **`opus[1m]`** | Использует Opus с [контекстным окном в 1 миллион токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сессий. Не имеет эффекта, когда `opus` уже разрешается на Opus 4.7 или более позднюю версию со встроенным окном 1M |

44| **`opusplan`** | Специальный режим, который использует `opus` во время режима плана, затем переключается на `sonnet` для выполнения |44| **`opusplan`** | Специальный режим, который использует `opus` в режиме планирования, затем переключается на `sonnet` для выполнения |

45 45

46Псевдонимы `opus`, `sonnet` и `haiku` разрешаются на новейшую версию в Anthropic API и на более раннюю версию у некоторых других поставщиков:46Псевдонимы `opus`, `sonnet` и `haiku` разрешаются на новейшую версию в Anthropic API и на более раннюю версию у некоторых других поставщиков:

47 47

54 54

55<span id="fable-alias-resolution" />55<span id="fable-alias-resolution" />

56 56

57Если вы не установили `ANTHROPIC_DEFAULT_FABLE_MODEL`, псевдоним `fable` разрешается на Fable 5.1, за исключением сеансов [Claude apps gateway](/docs/ru/claude-apps-gateway), где `fable` и `best` разрешаются на Fable 5.57Если вы не установили `ANTHROPIC_DEFAULT_FABLE_MODEL`, псевдоним `fable` разрешается на Fable 5.1, за исключением сессий [Claude apps gateway](/docs/ru/claude-apps-gateway), где `fable` и `best` разрешаются на Fable 5.

58 58

59Шлюз, который не настроен на обслуживание `claude-fable-5-1`, отклоняет запросы для этой модели. Чтобы использовать Fable 5.1 через шлюз, который его обслуживает, выберите его с помощью `/model claude-fable-5-1`.59Шлюз, который не настроен на обслуживание `claude-fable-5-1`, отклоняет запросы для этой модели. Чтобы использовать Fable 5.1 через шлюз, который его обслуживает, выберите его с помощью `/model claude-fable-5-1`.

60 60

72 Работа с Fable72 Работа с Fable

73</h3>73</h3>

74 74

75[Claude Fable 5.1](https://platform.claude.com/docs/en/about-claude/models/overview) и Claude Fable 5 — это наиболее мощные модели в Claude Code, подходящие для задач, требующих более одного сеанса. Они поддерживают длительные автономные сеансы, исследуют перед действием и проверяют свою работу чаще, чем меньшие модели. Fable 5.1 — это более новый выпуск.75[Claude Fable 5.1](https://platform.claude.com/docs/en/about-claude/models/overview) и Claude Fable 5 — это наиболее мощные модели в Claude Code, подходящие для задач, требующих более одной сессии. Они поддерживают длительные автономные сессии, исследуют перед действием и проверяют свою работу чаще, чем меньшие модели. Fable 5.1 — это более новый выпуск.

76 76

77Ни одна из моделей Fable не является стандартной для типа учётной записи ни на одном плане или поставщике. Выберите одну явно:77Ни одна из моделей Fable не является стандартной для типа учётной записи ни на одном плане или поставщике. Выберите одну явно:

78 78

79* **Fable 5.1**: запустите `/model fable` или запустите с помощью `claude --model fable`. В сеансах [Claude apps gateway](/docs/ru/claude-apps-gateway), где псевдоним разрешается на Fable 5, вместо этого запустите `/model claude-fable-5-1`.79* **Fable 5.1**: запустите `/model fable` или запустите с помощью `claude --model fable`. В сессиях [Claude apps gateway](/docs/ru/claude-apps-gateway), где псевдоним разрешается на Fable 5, вместо этого запустите `/model claude-fable-5-1`.

80* **Fable 5**: выберите её по ID модели. В Anthropic API запустите `/model claude-fable-5` или запустите с помощью `claude --model claude-fable-5`. На других поставщиках используйте ID модели Fable 5 вашего поставщика или [закрепите её](#pin-models-for-third-party-deployments) с помощью `ANTHROPIC_DEFAULT_FABLE_MODEL`.80* **Fable 5**: выберите её по ID модели. В Anthropic API запустите `/model claude-fable-5` или запустите с помощью `claude --model claude-fable-5`. На других поставщиках используйте ID модели Fable 5 вашего поставщика или [закрепите её](#pin-models-for-third-party-deployments) с помощью `ANTHROPIC_DEFAULT_FABLE_MODEL`.

81 81

82Если вы подключаетесь непосредственно к Anthropic API и ваши пользовательские параметры содержат `claude-fable-5` или `claude-fable-5[1m]` в качестве модели, например потому что вы выбрали Fable в средстве выбора `/model` до версии 2.1.257, Claude Code изменит это сохранённое значение на псевдоним `fable` или `fable[1m]` при первом запуске версии 2.1.257 или позже. Строка запуска модели показывает `(auto-updated)` один раз. Значение `claude-fable-5` в параметрах проекта, локальных или управляемых параметрах остаётся как есть.82Если вы подключаетесь непосредственно к Anthropic API и ваши пользовательские настройки содержат `claude-fable-5` или `claude-fable-5[1m]` в качестве модели, например потому что вы выбрали Fable в средстве выбора `/model` до версии 2.1.257, Claude Code изменит это сохранённое значение на псевдоним `fable` или `fable[1m]` при первом запуске версии 2.1.257 или позже. Строка запуска модели показывает `(auto-updated)` один раз. Значение `claude-fable-5` в настройках проекта, локальных или управляемых настройках остаётся как есть.

83 83

84Запросы, которые классификаторы безопасности модели Fable помечают, чаще всего в областях кибербезопасности и биологии, запускают [автоматический откат модели](#automatic-model-fallback).84Запросы, которые классификаторы безопасности модели Fable помечают, чаще всего в областях кибербезопасности и биологии, запускают [автоматическое переключение на резервную модель](#automatic-model-fallback).

85 85

86Чтобы получить максимум от Fable:86Чтобы получить максимум от Fable:

87 87

88* **Описывайте результат, а не шаги**: дайте ей результат, который вы хотите, и позвольте ей спланировать путь. Чтобы она продолжала работать над этим результатом, [установите цель](/docs/ru/goal).88* **Описывайте результат, а не шаги**: дайте ей результат, который вы хотите, и позвольте ей спланировать путь. Чтобы она продолжала работать над этим результатом, [установите цель](/docs/ru/goal).

89* **Дайте ей неоднозначные проблемы**: исследования коренных причин, отладка сбоев и решения по архитектуре — это то, где дополнительное исследование и проверка окупаются.89* **Дайте ей неоднозначные проблемы**: исследования коренных причин, отладка сбоев и решения по архитектуре — это то, где дополнительное исследование и проверка окупаются.

90* **Пропустите напоминания о проверке**: она проверяет свою работу с меньшим количеством подсказок, поэтому напоминания о тестировании или проверке обычно не требуются.90* **Пропустите напоминания о проверке**: она проверяет свою работу с меньшим количеством напоминаний, поэтому напоминания о тестировании или проверке обычно не требуются.

91* **Масштабируйте более крупные задачи**: дайте ей работу, которую вы обычно разбиваете на части. Она выдерживает длительные сеансы без потери нити.91* **Масштабируйте более крупные задачи**: дайте ей работу, которую вы обычно разбиваете на части. Она выдерживает длительные сессии без потери нити.

92 92

93<Note>93<Note>

94 Fable 5.1 требует Claude Code версии 2.1.257 или позже. Если запрос для неё из более старой версии не удаётся, см. [Claude Code does not support this model](/docs/ru/errors#claude-code-does-not-support-this-model). Запустите `claude update` для обновления. Для доступности при нулевом сохранении данных см. [Model availability under ZDR](/docs/ru/zero-data-retention#model-availability-under-zdr).94 Fable 5.1 требует Claude Code версии 2.1.257 или позже. Если запрос для неё из более старой версии не удаётся, см. [Claude Code does not support this model](/docs/ru/errors#claude-code-does-not-support-this-model). Запустите `claude update` для обновления. Для доступности при нулевом сохранении данных см. [Model availability under ZDR](/docs/ru/zero-data-retention#model-availability-under-zdr).

100 Fable и кредиты использования100 Fable и кредиты использования

101</h4>101</h4>

102 102

103В зависимости от вашего плана и уровня места, использование Fable может выставляться в счёт [кредитам использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) вместо использования включённых лимитов вашего плана. Когда это происходит, средство выбора `/model` показывает "Requires usage credits" в строке Fable. Для управления кредитами использования см. [Add usage credits to your subscription](/docs/ru/costs#add-usage-credits-to-your-subscription).103В зависимости от вашего плана и уровня места использование Fable может оплачиваться из [кредитов использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) вместо использования включённых лимитов вашего плана. Когда это происходит, средство выбора `/model` показывает "Requires usage credits" в строке Fable. Для управления кредитами использования см. [Add usage credits to your subscription](/docs/ru/costs#add-usage-credits-to-your-subscription).

104 104

105В интерактивных сеансах Claude Code показывает запрос согласия перед запросом Fable, который выставляет кредиты использования. Члены планов Enterprise с организационным выставлением счётов не видят запрос. Вы можете продолжить работу на Fable, используя кредиты использования, или переключиться на вашу модель по умолчанию. Вы также можете отклонить запрос:105В интерактивных сессиях Claude Code показывает запрос согласия перед запросом Fable, который оплачивается из кредитов использования. Члены планов Enterprise с организационным биллингом не видят запрос. Вы можете продолжить работу на Fable, используя кредиты использования, или переключиться на вашу модель по умолчанию. Вы также можете отклонить запрос:

106 106

107* Когда вы выбираете модель Fable с помощью `/model`, вы сохраняете вашу текущую модель.107* Когда вы выбираете модель Fable с помощью `/model`, вы сохраняете вашу текущую модель.

108* Во время сеанса Claude Code продолжает ход на вашей модели по умолчанию.108* Во время сессии Claude Code продолжает ход на вашей модели по умолчанию.

109 109

110После того как вы выберете продолжить работу на Fable, используя кредиты использования, Claude Code больше не показывает запрос.110После того как вы выберете продолжить работу на Fable, используя кредиты использования, Claude Code больше не показывает запрос.

111 111

112В сеансе с подключённым [Remote Control](/docs/ru/remote-control), [фоновом сеансе](/docs/ru/agent-view) или сеансе товарища по [команде агентов](/docs/ru/agent-teams), никто не может быть у терминала, поэтому Claude Code удерживает запрос согласия во время сеанса до крайнего срока [`dialogExpiry`](/docs/ru/settings-reference#dialogexpiry), пять минут по умолчанию. Если никто не ответил к крайнему сроку, Claude Code завершает ход без отправки запроса и добавляет примечание в стенограмму, которое также показывает клиент Remote Control. Ваш выбор модели не изменяется, и Claude Code снова запрашивает согласие при следующем сообщении.112В сессии с подключённым [Remote Control](/docs/ru/remote-control), [фоновой сессии](/docs/ru/agent-view) или сессии участника [команды агентов](/docs/ru/agent-teams) у терминала может никого не быть, поэтому Claude Code удерживает запрос согласия во время сессии до крайнего срока [`dialogExpiry`](/docs/ru/settings-reference#dialogexpiry), пять минут по умолчанию. Если никто не ответил к крайнему сроку, Claude Code завершает ход без отправки запроса и добавляет примечание в транскрипт, которое также показывает клиент Remote Control. Ваш выбор модели не изменяется, и Claude Code снова запрашивает согласие при следующем сообщении.

113 113

114То, что вы можете делать во время ожидания запроса, зависит от сеанса:114То, что вы можете делать во время ожидания запроса, зависит от сессии:

115 115

116* С подключённым Remote Control или в сеансе товарища нажмите любую клавишу у терминала, чтобы отменить крайний срок, и Claude Code будет ждать вашего ответа.116* С подключённым Remote Control или в сессии участника команды нажмите любую клавишу у терминала, чтобы отменить крайний срок, и Claude Code будет ждать вашего ответа.

117* В фоновом сеансе ответьте до крайнего срока.117* В фоновой сессии ответьте до крайнего срока.

118* Если вы отправите новое сообщение от удалённого клиента до того, как кто-нибудь напечатает у терминала, Claude Code завершит ход так же, и ваше новое сообщение начнёт следующий ход. После того как кто-нибудь напечатает у терминала, Claude Code продолжит ждать ответа и поставит ваше новое сообщение в очередь позади него.118* Если вы отправите новое сообщение от удалённого клиента до того, как кто-нибудь напечатает у терминала, Claude Code завершит ход так же, и ваше новое сообщение начнёт следующий ход. После того как кто-нибудь напечатает у терминала, Claude Code продолжит ждать ответа и поставит ваше новое сообщение в очередь позади него.

119 119

120В сеансе, размещённом другим приложением через [Agent SDK](/docs/ru/agent-sdk/overview), появляется ли запрос, зависит от этого приложения. Если он появляется и никто не ответит до того же крайнего срока [`dialogExpiry`](/docs/ru/settings-reference#dialogexpiry), Claude Code завершает ход без отправки запроса.120В сессии, размещённой другим приложением через [Agent SDK](/docs/ru/agent-sdk/overview), появляется ли запрос, зависит от этого приложения. Если он появляется и никто не ответит до того же крайнего срока [`dialogExpiry`](/docs/ru/settings-reference#dialogexpiry), Claude Code завершает ход без отправки запроса.

121 121

122В [неинтерактивном режиме](/docs/ru/headless) с флагом `-p` и в приложении Agent SDK, которое не показывает запрос, Claude Code никогда не запрашивает согласие. Когда запрос Fable там выставляет кредиты использования, Claude Code выставляет его без запроса.122В [неинтерактивном режиме](/docs/ru/headless) с флагом `-p` и в приложении Agent SDK, которое не показывает запрос, Claude Code никогда не запрашивает согласие. Когда запрос Fable там должен оплачиваться из кредитов использования, Claude Code оплачивает его без запроса.

123 123

124<h3 id="setting-your-model">124<h3 id="setting-your-model">

125 Установка вашей модели125 Установка вашей модели

127 127

128Вы можете настроить вашу модель несколькими способами, перечисленными в порядке приоритета:128Вы можете настроить вашу модель несколькими способами, перечисленными в порядке приоритета:

129 129

1301. **Во время сеанса**: используйте `/model <alias|name>` для немедленного переключения или запустите `/model` без аргумента, чтобы открыть средство выбора. См. [когда Claude Code просит вас подтвердить переключение](/docs/ru/prompt-caching#switching-models)1301. **Во время сессии**: используйте `/model <alias|name>` для немедленного переключения или запустите `/model` без аргумента, чтобы открыть средство выбора. См. [когда Claude Code просит вас подтвердить переключение](/docs/ru/prompt-caching#switching-models)

1312. **При запуске**: запустите с помощью `claude --model <alias|name>`1312. **При запуске**: запустите с помощью `claude --model <alias|name>`

1323. **Переменная окружения**: установите `ANTHROPIC_MODEL=<alias|name>`1323. **Переменная окружения**: установите `ANTHROPIC_MODEL=<alias|name>`

1334. **Параметры**: настройте постоянно в файле параметров, используя поле `model`1334. **Настройки**: настройте постоянно в файле настроек, используя поле `model`

1345. **[Стандартная для новых сеансов](#set-a-default-model-for-new-sessions)**: установите `ANTHROPIC_DEFAULT_MODEL=<alias|name>`1345. **[Стандартная для новых сессий](#set-a-default-model-for-new-sessions)**: установите `ANTHROPIC_DEFAULT_MODEL=<alias|name>`

135 135

136`/model` сохраняет ваш выбор как стандартный для новых сеансов, записывая поле `model` в ваши пользовательские параметры. В средстве выбора:136`/model` сохраняет ваш выбор как стандартный для новых сессий, записывая поле `model` в ваши пользовательские настройки. В средстве выбора:

137 137

138* `Enter`: переключить модель и сохранить как вашу стандартную138* `Enter`: переключить модель и сохранить как вашу стандартную

139* `s`: переключить модель только для этого сеанса и оставить вашу стандартную без изменений. Чтобы использовать другую клавишу, переназначьте [`modelPicker:thisSessionOnly`](/docs/ru/keybindings#model-picker-actions)139* `s`: переключить модель только для этой сессии и оставить вашу стандартную без изменений. Чтобы использовать другую клавишу, переназначьте [`modelPicker:thisSessionOnly`](/docs/ru/keybindings#model-picker-actions)

140 140

141Ввод `/model <name>` напрямую ведёт себя как `Enter`. Чтобы переключиться только для этого сеанса, откройте средство выбора с помощью `/model` и нажмите `s` в строке модели.141Ввод `/model <name>` напрямую ведёт себя как `Enter`. Чтобы переключиться только для этой сессии, откройте средство выбора с помощью `/model` и нажмите `s` в строке модели.

142 142

143На плане Enterprise, когда вы вошли в систему с помощью своей учётной записи claude.ai и сохранили стандартную с помощью `/model`, Claude Code также записывает выбор на эту учётную запись. Это требует Claude Code версии 2.1.280 или позже.143На плане Enterprise, когда вы вошли в систему с помощью своей учётной записи claude.ai и сохранили стандартную с помощью `/model`, Claude Code также записывает выбор на эту учётную запись. Это требует Claude Code версии 2.1.280 или позже.

144 144

146* Если [ограничения модели](#restrict-model-selection) исключают записанную модель или она недоступна для вашей учётной записи, и ваш администратор не установил стандартную модель организации, опция Default разрешается так, как если бы ничего не было записано.146* Если [ограничения модели](#restrict-model-selection) исключают записанную модель или она недоступна для вашей учётной записи, и ваш администратор не установил стандартную модель организации, опция Default разрешается так, как если бы ничего не было записано.

147* Если вы выберете Default или `opusplan` в `/model`, записанный выбор не изменяется.147* Если вы выберете Default или `opusplan` в `/model`, записанный выбор не изменяется.

148 148

149Если вы переключаете модели с помощью `/model`, переключение также достигает [подагентов, которые наследуют модель основного разговора](/docs/ru/sub-agents#choose-a-model), потому что Claude Code разрешает их модель из той, которую использует ваш сеанс, когда Claude их запускает. Переключитесь на Opus перед тем, как Claude делегирует исследование или тестовые запуски одному из них, и эта работа также будет выполняться на Opus. Чтобы сохранить пользовательского подагента на меньшей модели, установите `model` в его определении.149Если вы переключаете модели с помощью `/model`, переключение также достигает [субагентов, которые наследуют модель основного диалога](/docs/ru/sub-agents#choose-a-model), потому что Claude Code разрешает их модель из той, которую использует ваша сессия, когда Claude их запускает. Переключитесь на Opus перед тем, как Claude делегирует исследование или тестовые запуски одному из них, и эта работа также будет выполняться на Opus. Чтобы оставить пользовательского субагента на меньшей модели, установите `model` в его определении.

150 150

151Если вы установите модель с помощью `/model` в [неинтерактивном режиме](/docs/ru/headless), с флагом `-p`, ваш выбор применяется только к текущему сеансу и не сохраняется как ваша стандартная; `/model` в этом режиме требует Claude Code версии 2.1.205 или позже. Параметры проекта и управляемые параметры по-прежнему имеют приоритет и переприменяются при следующем запуске. [Стандартная модель организации](#organization-default-model), которую ваш администратор настроил для переопределения выбора пользователя, также переприменяется при следующем запуске.151Если вы установите модель с помощью `/model` в [неинтерактивном режиме](/docs/ru/headless), с флагом `-p`, ваш выбор применяется только к текущей сессии и не сохраняется как ваша стандартная; `/model` в этом режиме требует Claude Code версии 2.1.205 или позже. Настройки проекта и управляемые настройки по-прежнему имеют приоритет и переприменяются при следующем запуске. [Стандартная модель организации](#organization-default-model), которую ваш администратор настроил для переопределения выбора пользователя, также переприменяется при следующем запуске.

152 152

153В версиях 2.1.144 по 2.1.152 `/model` применялся только к текущему сеансу, а `d` в средстве выбора сохранял стандартную.153В версиях 2.1.144 по 2.1.152 `/model` применялся только к текущей сессии, а `d` в средстве выбора сохранял стандартную.

154 154

155Флаг `--model` и переменная окружения `ANTHROPIC_MODEL` применяются только к сеансу, который вы запускаете с ними. Чтобы запустить разные модели в разных терминалах одновременно, запустите каждый с его собственным флагом `--model` вместо переключения с помощью `/model`.155Флаг `--model` и переменная окружения `ANTHROPIC_MODEL` применяются только к сессии, которую вы запускаете с ними. Чтобы запустить разные модели в разных терминалах одновременно, запустите каждую с её собственным флагом `--model` вместо переключения с помощью `/model`.

156 156

157Цены в средстве выбора `/model` появляются, когда Claude Code разговаривает с Anthropic API, напрямую или через [шлюз LLM](/docs/ru/llm-gateway), который его проксирует, и цена в строке — это цена модели, которую выбирает эта строка. На [поставщиках третьих сторон](/docs/ru/third-party-integrations), таких как Amazon Bedrock, и на [шлюзе Claude apps gateway](/docs/ru/claude-apps-gateway), ваш поставщик или шлюз определяет, что вы платите, поэтому строки средства выбора не показывают цену. Цена — это только метка отображения; она не влияет на то, какую модель выбирает строка, или что выставляет в счёт ваш поставщик. До версии 2.1.206 [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) и сеансы шлюза показывали цены списка Anthropic, и строка могла показывать цену другой модели, чем та, которую она выбирала.157Цены в средстве выбора `/model` появляются, когда Claude Code взаимодействует с Anthropic API, напрямую или через [LLM-шлюз](/docs/ru/llm-gateway), который его проксирует, и цена в строке — это цена модели, которую выбирает эта строка. На [поставщиках третьих сторон](/docs/ru/third-party-integrations), таких как Amazon Bedrock, и на [шлюзе Claude apps gateway](/docs/ru/claude-apps-gateway) ваш поставщик или шлюз определяет, что вы платите, поэтому строки средства выбора не показывают цену. Цена — это только метка отображения; она не влияет на то, какую модель выбирает строка, или что выставляет в счёт ваш поставщик. До версии 2.1.206 [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) и сессии шлюза показывали цены списка Anthropic, и строка могла показывать цену другой модели, чем та, которую она выбирала.

158 158

159Возобновлённые сессии, начатые с помощью `claude --resume`, `--continue` или средства выбора `/resume`, сохраняют модель, которую они использовали, когда транскрипт был сохранён. Если восстановленная модель была снята с производства или исключена [`availableModels`](#restrict-model-selection), сессия переходит к обычному порядку приоритета. У поставщиков, которые используют специфичные для поставщика ID развёртывания вместо ID моделей Anthropic, таких как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, модель из транскрипта вообще не восстанавливается, и сессия разрешает свою модель через обычный порядок приоритета.159Возобновлённые сессии, начатые с помощью `claude --resume`, `--continue` или средства выбора `/resume`, сохраняют модель, которую они использовали, когда транскрипт был сохранён. Если восстановленная модель была снята с производства или исключена [`availableModels`](#restrict-model-selection), сессия переходит к обычному порядку приоритета. У поставщиков, которые используют специфичные для поставщика ID развёртывания вместо ID моделей Anthropic, таких как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, модель из транскрипта вообще не восстанавливается, и сессия разрешает свою модель через обычный порядок приоритета.

160 160

162 162

163Модель, которую вы выбираете для нового запуска с помощью `--model` или `ANTHROPIC_MODEL`, по-прежнему имеет приоритет над восстановленной моделью. Начиная с версии 2.1.195, переменная семейства [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables) также имеет приоритет. [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions) может тоже, при условиях, перечисленных в её разделе.163Модель, которую вы выбираете для нового запуска с помощью `--model` или `ANTHROPIC_MODEL`, по-прежнему имеет приоритет над восстановленной моделью. Начиная с версии 2.1.195, переменная семейства [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables) также имеет приоритет. [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions) может тоже, при условиях, перечисленных в её разделе.

164 164

165Когда активная модель при запуске поступает из параметров проекта или управляемых параметров, а не из вашего собственного выбора, заголовок запуска показывает, какой файл параметров её установил. Запустите `/model` для переопределения; параметр проекта или управляемый параметр переприменяется при следующем запуске. На платформах, которые встраивают Claude Code и устанавливают [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ru/env-vars), конфигурация модели хоста имеет приоритет над управляемыми параметрами модели, в то время как управляемый список разрешений `availableModels` остаётся в силе, если только хост не предоставляет свой собственный; [Exceptions to managed settings precedence](/docs/ru/settings#exceptions-to-managed-settings-precedence) говорит, какие ключи и переменные переопределяет хост.165Когда активная модель при запуске поступает из настроек проекта или управляемых настроек, а не из вашего собственного выбора, заголовок запуска показывает, какой файл настроек её установил. Запустите `/model` для переопределения; настройка проекта или управляемая настройка переприменяется при следующем запуске. На платформах, которые встраивают Claude Code и устанавливают [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ru/env-vars), конфигурация модели хоста имеет приоритет над управляемыми настройками модели, в то время как управляемый список разрешённых моделей `availableModels` остаётся в силе, если только хост не предоставляет свой собственный; [Exceptions to managed settings precedence](/docs/ru/settings#exceptions-to-managed-settings-precedence) говорит, какие ключи и переменные переопределяет хост.

166 166

167Если вы или ваша организация настроите [PreModelSwitch hooks](/docs/ru/hooks#premodelswitch), они запускаются перед применением запрошенного переключения и могут его заблокировать или попросить вас подтвердить.167Если вы или ваша организация настроите [хуки PreModelSwitch](/docs/ru/hooks#premodelswitch), они запускаются перед применением запрошенного переключения и могут его заблокировать или попросить вас подтвердить.

168 168

169Когда Claude Code не может определить, какие PreModelSwitch hooks доставляют [управляемые плагины](/docs/ru/settings-reference#enabledplugins) вашей организации, например потому что управляемый плагин не загрузился, он отказывает в переключении вместо его применения, и он проверяет снова при каждой новой попытке. См. [Model switch was blocked by a PreModelSwitch hook](/docs/ru/errors#model-switch-was-blocked-by-a-premodelswitch-hook) для сообщения и восстановления.169Когда Claude Code не может определить, какие хуки PreModelSwitch доставляют [управляемые плагины](/docs/ru/settings-reference#enabledplugins) вашей организации, например потому что управляемый плагин не загрузился, он отказывает в переключении вместо его применения без проверки, и он проверяет снова при каждой новой попытке. См. [Model switch was blocked by a PreModelSwitch hook](/docs/ru/errors#model-switch-was-blocked-by-a-premodelswitch-hook) для сообщения и восстановления.

170 170

171Когда вы переключаете модели через метод [Agent SDK](/docs/ru/agent-sdk/overview) `setModel()`, через приложение, такое как [Desktop app](/docs/ru/desktop), или с устройства, подключённого через [Remote Control](/docs/ru/remote-control), Claude Code проверяет значение при переключении:171Когда вы переключаете модели через метод [Agent SDK](/docs/ru/agent-sdk/overview) `setModel()`, через приложение, такое как [Desktop app](/docs/ru/desktop), или с устройства, подключённого через [Remote Control](/docs/ru/remote-control), Claude Code проверяет значение при переключении:

172 172

173* **Agent SDK или приложение**: с Claude Code версии 2.1.268 или позже, если Claude Code не принимает ID модели локально, как это происходит для вашего [пользовательского варианта модели](#add-a-custom-model-option), он подтверждает ID у вашего поставщика при первом переключении сеанса на него. Подтверждение выполняется на каждом поставщике, и ID, который ваш поставщик не предлагает, отклоняется при переключении вместо сбоя при следующем запросе.173* **Agent SDK или приложение**: с Claude Code версии 2.1.268 или позже, если Claude Code не принимает ID модели локально, как это происходит для вашего [пользовательского варианта модели](#add-a-custom-model-option), он подтверждает ID у вашего поставщика при первом переключении сессии на него. Подтверждение выполняется на каждом поставщике, и ID, который ваш поставщик не предлагает, отклоняется при переключении вместо сбоя при следующем запросе.

174* **Remote Control**: в Anthropic API Claude Code проверяет значение локально и не отправляет запрос.174* **Remote Control**: в Anthropic API Claude Code проверяет значение локально и не отправляет запрос.

175 175

176См. [Model is not a recognized model id](/docs/ru/errors#model-is-not-a-recognized-model-id) и [Model not found](/docs/ru/errors#model-not-found) для сообщений.176См. [Model is not a recognized model id](/docs/ru/errors#model-is-not-a-recognized-model-id) и [Model not found](/docs/ru/errors#model-not-found) для сообщений.

177 177

178Если вы установите модель с флагом `--model`, переменной окружения `ANTHROPIC_MODEL` или параметром `model`, Claude Code не проверяет её заранее, и неправильно введённое значение производит [There's an issue with the selected model](/docs/ru/errors#theres-an-issue-with-the-selected-model) при первом запросе.178Если вы установите модель с флагом `--model`, переменной окружения `ANTHROPIC_MODEL` или настройкой `model`, Claude Code не проверяет её заранее, и неправильно введённое значение приводит к [There's an issue with the selected model](/docs/ru/errors#theres-an-issue-with-the-selected-model) при первом запросе.

179 179

180Когда запрошенная модель имеет запланированную дату снятия с производства или автоматически переназначается на более новую версию, Claude Code показывает предупреждение, которое называет запрошенную модель. Интерактивные сеансы показывают его как уведомление при запуске. Начиная с версии 2.1.182, то же предупреждение записывается в stderr в [неинтерактивном режиме](/docs/ru/headless) при использовании формата вывода текста по умолчанию. Проверка также охватывает `model`, установленный в [фронтматтере подагента](/docs/ru/sub-agents). Предупреждение stderr подавляется для `--output-format json` и `stream-json`; прочитайте фактическую модель из поля `modelUsage` [результирующего сообщения](/docs/ru/headless#get-structured-output) вместо этого.180Когда запрошенная модель имеет запланированную дату снятия с производства или автоматически переназначается на более новую версию, Claude Code показывает предупреждение, которое называет запрошенную модель. Интерактивные сессии показывают его как уведомление при запуске. Начиная с версии 2.1.182, то же предупреждение записывается в stderr в [неинтерактивном режиме](/docs/ru/headless) при использовании формата вывода текста по умолчанию. Проверка также охватывает `model`, установленный во [frontmatter субагента](/docs/ru/sub-agents). Предупреждение stderr подавляется для `--output-format json` и `stream-json`; вместо этого прочитайте фактическую модель из поля `modelUsage` [результирующего сообщения](/docs/ru/headless#get-structured-output).

181 181

182Например, запустите сеанс на Opus:182Например, запустите сессию на Opus:

183 183

184```bash theme={null}184```bash theme={null}

185claude --model opus185claude --model opus

186```186```

187 187

188Затем переключайте модели из сеанса:188Затем переключайте модели из сессии:

189 189

190```text theme={null}190```text theme={null}

191/model sonnet191/model sonnet

192```192```

193 193

194Пример файла параметров:194Пример файла настроек:

195 195

196```json theme={null}196```json theme={null}

197{197{

203```203```

204 204

205<h4 id="set-a-default-model-for-new-sessions">205<h4 id="set-a-default-model-for-new-sessions">

206 Установка стандартной модели для новых сеансов206 Установка стандартной модели для новых сессий

207</h4>207</h4>

208 208

209Установите `ANTHROPIC_DEFAULT_MODEL=<alias|name>` для выбора модели, на которой ваши сеансы запускаются по умолчанию. Требует Claude Code версии 2.1.236 или позже.209Установите `ANTHROPIC_DEFAULT_MODEL=<alias|name>` для выбора модели, на которой ваши сессии запускаются по умолчанию. Требует Claude Code версии 2.1.236 или позже.

210 210

211Claude Code запускает новый сеанс на модели переменной только когда ни один из этих не выбирает модель:211Claude Code запускает новую сессию на модели переменной, только когда ни один из этих вариантов не выбирает модель:

212 212

213* Флаг `--model`213* Флаг `--model`

214* `ANTHROPIC_MODEL`214* `ANTHROPIC_MODEL`

215* Значение `model` в любом файле параметров, включая выбор, который вы сохраняете с помощью `/model`215* Значение `model` в любом файле настроек, включая выбор, который вы сохраняете с помощью `/model`

216* [Стандартная модель организации](#organization-default-model)216* [Стандартная модель организации](#organization-default-model)

217 217

218Выбор, который вы сохраняете с помощью `/model`, имеет приоритет над переменной при последующих запусках. С установленным `ANTHROPIC_MODEL` вместо этого Claude Code возвращается к модели этой переменной при следующем запуске, независимо от того, что вы сохранили с помощью `/model`.218Выбор, который вы сохраняете с помощью `/model`, имеет приоритет над переменной и при последующих запусках. Если же установлена `ANTHROPIC_MODEL`, Claude Code возвращается к модели этой переменной при следующем запуске, независимо от того, что вы сохранили с помощью `/model`.

219 219

220Claude Code также разрешает опцию Default на модель переменной, если не применяется стандартная модель организации. Когда опция Default разрешается на модель переменной, строка Default в средстве выбора `/model` показывает метку Set by ANTHROPIC\_DEFAULT\_MODEL.220Claude Code также разрешает опцию Default на модель переменной, если не применяется стандартная модель организации. Когда опция Default разрешается на модель переменной, строка Default в средстве выбора `/model` показывает метку Set by ANTHROPIC\_DEFAULT\_MODEL.

221 221

226* [Ограничения модели](#restrict-model-selection) вашей организации исключают модель226* [Ограничения модели](#restrict-model-selection) вашей организации исключают модель

227* Модель недоступна для вашей учётной записи227* Модель недоступна для вашей учётной записи

228 228

229Когда новый сеанс запустится на модели переменной, сеанс, который вы возобновляете с помощью `claude --resume`, `--continue` или средства выбора `/resume`, также запустится на ней. Claude Code не восстанавливает модель, сохранённую в стенограмме этого сеанса. В противном случае Claude Code не использует переменную, когда вы [возобновляете сеанс](#setting-your-model).229Когда новая сессия запустилась бы на модели переменной, сессия, которую вы возобновляете с помощью `claude --resume`, `--continue` или средства выбора `/resume`, также запускается на ней. Claude Code не восстанавливает модель, сохранённую в транскрипте этой сессии. В противном случае Claude Code не использует переменную, когда вы [возобновляете сессию](#setting-your-model).

230 230

231<h4 id="a-new-session-starts-on-a-different-model-than-you-picked">231<h4 id="a-new-session-starts-on-a-different-model-than-you-picked">

232 Новый сеанс запускается на другой модели, чем вы выбрали232 Новая сессия запускается на другой модели, чем вы выбрали

233</h4>233</h4>

234 234

235Когда вы выбираете модель с помощью `/model` и ваш следующий сеанс запускается на чём-то другом, это обычные причины:235Когда вы выбираете модель с помощью `/model`, а ваша следующая сессия запускается на чём-то другом, обычные причины таковы:

236 236

237* **Вы выбрали её для одного сеанса.** Нажатие `s` в средстве выбора, запуск с помощью `--model` и запуск `/model` в неинтерактивном режиме применяются только к текущему сеансу и оставляют вашу сохранённую стандартную без изменений.237* **Вы выбрали её для одной сессии.** Нажатие `s` в средстве выбора, запуск с помощью `--model` и запуск `/model` в неинтерактивном режиме применяются к текущей сессии и оставляют вашу сохранённую стандартную без изменений.

238* **Что-то с более высоким приоритетом устанавливает модель.** Значение `model` в параметрах проекта или управляемых параметрах, `ANTHROPIC_MODEL` в вашей оболочке или [стандартная модель организации](#organization-default-model), которую ваш администратор установил для переопределения выбора пользователя, применяется снова при каждом запуске. Ваш выбор `/model` по-прежнему сохранён; он превосходит. Когда параметры проекта или управляемые параметры устанавливают модель, заголовок запуска называет файл.238* **Что-то с более высоким приоритетом устанавливает модель.** Значение `model` в настройках проекта или управляемых настройках, `ANTHROPIC_MODEL` в вашей оболочке или [стандартная модель организации](#organization-default-model), которую ваш администратор установил для переопределения выбора пользователя, применяется снова при каждом запуске. Ваш выбор `/model` по-прежнему сохранён; просто у него более низкий приоритет. Когда настройки проекта или управляемые настройки устанавливают модель, заголовок запуска называет файл.

239* **Claude Code не смог сохранить ваш выбор.** `/model` записывает `model` в `~/.claude/settings.json`. Если вы не можете писать в этот файл, например потому что другой инструмент его генерирует или связывает его с копией только для чтения, модель, которую вы выбрали, длится для сеанса, и следующий запуск читает старое значение. Установите `model` в инструменте, который генерирует файл, или сделайте файл доступным для записи. См. [A change you made in Claude Code is lost in new sessions](/docs/ru/settings#a-change-you-made-in-claude-code-is-lost-in-new-sessions).239* **Claude Code не смог сохранить ваш выбор.** `/model` записывает `model` в `~/.claude/settings.json`. Если вы не можете писать в этот файл, например потому что другой инструмент его генерирует или связывает его с копией только для чтения, выбранная вами модель действует в течение сессии, а следующий запуск читает старое значение. Установите `model` в инструменте, который генерирует файл, или сделайте файл доступным для записи. См. [A change you made in Claude Code is lost in new sessions](/docs/ru/settings#a-change-you-made-in-claude-code-is-lost-in-new-sessions).

240* **Вы возобновили сеанс.** Сеанс, который вы возобновляете с помощью `claude --resume` или `--continue`, обычно [сохраняет модель, которую он использовал](#setting-your-model), вместо вашей текущей стандартной.240* **Вы возобновили сессию.** Сессия, которую вы возобновляете с помощью `claude --resume` или `--continue`, обычно [сохраняет модель, которую она использовала](#setting-your-model), вместо вашей текущей стандартной.

241 241

242<h2 id="restrict-model-selection">242<h2 id="restrict-model-selection">

243 Ограничение выбора модели243 Ограничение выбора модели

310* Сессии [Claude Tag](https://claude.com/docs/claude-tag/overview) запускаются в облачных средах, но не получают управляемые параметры сервера; в [самостоятельно размещенной среде](/docs/ru/self-hosted-environments) они все еще читают файл управляемых параметров в образе runner. Чтобы установить модель для этих сессий, см. [Выбор модели для области](https://claude.com/docs/claude-tag/admins/customize#choose-the-model-for-a-scope) в руководстве администратора Claude Tag.310* Сессии [Claude Tag](https://claude.com/docs/claude-tag/overview) запускаются в облачных средах, но не получают управляемые параметры сервера; в [самостоятельно размещенной среде](/docs/ru/self-hosted-environments) они все еще читают файл управляемых параметров в образе runner. Чтобы установить модель для этих сессий, см. [Выбор модели для области](https://claude.com/docs/claude-tag/admins/customize#choose-the-model-for-a-scope) в руководстве администратора Claude Tag.

311* Cowork, вкладка агентской работы в приложении Claude Desktop, запускает свои сессии на Claude Code, но по замыслу не получает управляемые параметры сервера из консоли администратора claude.ai. Когда список `availableModels` в ваших управляемых параметрах сервера не пуст и пользователь выбирает модель вне него, сервер отклоняет эту модель для удаленной сессии Cowork. Файл управляемых параметров применяется к сессиям Cowork, когда он присутствует там, где запускается сессия; удаленные сессии Cowork запускаются на управляемых Anthropic виртуальных машинах, где развернутый на устройстве файл отсутствует.311* Cowork, вкладка агентской работы в приложении Claude Desktop, запускает свои сессии на Claude Code, но по замыслу не получает управляемые параметры сервера из консоли администратора claude.ai. Когда список `availableModels` в ваших управляемых параметрах сервера не пуст и пользователь выбирает модель вне него, сервер отклоняет эту модель для удаленной сессии Cowork. Файл управляемых параметров применяется к сессиям Cowork, когда он присутствует там, где запускается сессия; удаленные сессии Cowork запускаются на управляемых Anthropic виртуальных машинах, где развернутый на устройстве файл отсутствует.

312* Сессии на [поставщиках третьих сторон](/docs/ru/server-managed-settings#platform-availability), таких как Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), не получают управляемые параметры сервера, поэтому доставляйте список разрешений через MDM или файлы управляемых параметров там.312* Сессии на [поставщиках третьих сторон](/docs/ru/server-managed-settings#platform-availability), таких как Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws), не получают управляемые параметры сервера, поэтому доставляйте список разрешений через MDM или файлы управляемых параметров там.

313* Доставка, управляемая сервером, также требует, чтобы сессия аутентифицировалась с помощью [подходящего входа или ключа](/docs/ru/server-managed-settings#platform-availability). Флоты, которые генерируют ключи только через скрипт [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper), должны доставлять список разрешений через MDM или файлы управляемых параметров.313* Доставка из консоли администратора также требует, чтобы сессия получала настройки с [подходящим входом](/docs/ru/server-managed-settings#platform-availability) в вашу организацию или с OAuth-токеном, выданным для неё. Для парков устройств, которые аутентифицируются с помощью API-ключей — заданных напрямую или сгенерированных скриптом [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper), — доставляйте список разрешённых моделей через MDM или файлы управляемых настроек.

314* Вкладка Desktop Code также размещает [сессии SSH](/docs/ru/desktop#ssh-sessions), которые читают файл управляемых параметров с удаленного хоста, на котором они запускаются. См. [Управляемые параметры Desktop](/docs/ru/desktop#managed-settings).314* Вкладка Desktop Code также размещает [сессии SSH](/docs/ru/desktop#ssh-sessions), которые читают файл управляемых параметров с удаленного хоста, на котором они запускаются. См. [Управляемые параметры Desktop](/docs/ru/desktop#managed-settings).

315* Средства выбора модели на claude.ai и в приложении Desktop скрывают или затемняют модели, исключенные списком разрешений вашей организации. Состояние средства выбора — это удобство для пользователей; оно не применяет список разрешений.315* Средства выбора модели на claude.ai и в приложении Desktop скрывают или затемняют модели, исключенные списком разрешений вашей организации. Состояние средства выбора — это удобство для пользователей; оно не применяет список разрешений.

316 316

487</h2>487</h2>

488 488

489<h3 id="default-model-setting">489<h3 id="default-model-setting">

490 Параметр модели `default`490 Настройка модели `default`

491</h3>491</h3>

492 492

493Поведение `default` зависит от типа вашей учетной записи:493Поведение `default` зависит от типа вашей учётной записи:

494 494

495* **Pro, Max, Team, Enterprise и Anthropic API**: по умолчанию Opus 5.5495* **Pro, Max, Team, Enterprise и Anthropic API**: по умолчанию Opus 5.5

496* **Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform**: по умолчанию Opus 5.5496* **Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform**: по умолчанию Opus 5.5

498 498

499До версии 2.1.280 `default` разрешался в Sonnet 5 на Pro и Team Standard, а в Opus 5 на Max, Team Premium, Enterprise, Anthropic API, Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform с версии 2.1.219. До версии 2.1.219 `default` разрешался в Opus 4.8 на Anthropic API, Max, Team Premium и Enterprise с оплатой по мере использования с версии 2.1.154, а также на Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform с версии 2.1.207. До версии 2.1.207 `default` разрешался в Opus 4.7 на Claude Platform on AWS и в Sonnet 4.5 на Amazon Bedrock и Google Cloud's Agent Platform.499До версии 2.1.280 `default` разрешался в Sonnet 5 на Pro и Team Standard, а в Opus 5 на Max, Team Premium, Enterprise, Anthropic API, Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform с версии 2.1.219. До версии 2.1.219 `default` разрешался в Opus 4.8 на Anthropic API, Max, Team Premium и Enterprise с оплатой по мере использования с версии 2.1.154, а также на Claude Platform on AWS, Amazon Bedrock и Google Cloud's Agent Platform с версии 2.1.207. До версии 2.1.207 `default` разрешался в Opus 4.7 на Claude Platform on AWS и в Sonnet 4.5 на Amazon Bedrock и Google Cloud's Agent Platform.

500 500

501Когда администратор установил [модель по умолчанию организации](#organization-default-model), `default` разрешается в эту модель вместо стандартного значения для типа учетной записи выше. Требуется Claude Code версии 2.1.196 или позже. `default` также может разрешаться в модель, которую вы установили с помощью [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), при условиях, указанных в его разделе, или в модель, [записанную в вашей учетной записи](#setting-your-model).501Когда администратор установил [модель по умолчанию организации](#organization-default-model), `default` разрешается в эту модель вместо стандартного значения для типа учётной записи выше. Требуется Claude Code версии 2.1.196 или позже. `default` также может разрешаться в модель, которую вы установили с помощью [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), при условиях, указанных в его разделе, или в модель, [записанную в вашей учётной записи](#setting-your-model).

502 502

503Когда ничего не записано в вашей учетной записи, управляемые параметры [применяют список разрешений для модели Default](#enforce-the-allowlist-for-the-default-model), и стандартное значение для типа учетной записи отсутствует в `availableModels`, `default` разрешается в принудительный Default вместо стандартного значения для типа учетной записи выше. Когда применяются оба условия, модель по умолчанию организации сначала заменяет стандартное значение для типа учетной записи, а затем применяется принудительное значение: модель по умолчанию организации в списке разрешений сохраняется, а модель вне списка разрешается в принудительный Default.503Когда в вашей учётной записи ничего не записано, управляемые настройки [принудительно применяют список разрешённых моделей для модели Default](#enforce-the-allowlist-for-the-default-model), а стандартное значение для типа учётной записи отсутствует в `availableModels`, `default` разрешается в принудительный Default вместо стандартного значения для типа учётной записи выше. Когда применяются и модель по умолчанию организации, и принудительное применение, модель по умолчанию организации сначала заменяет стандартное значение для типа учётной записи, а затем к ней применяется принудительное ограничение: модель по умолчанию организации из списка разрешённых сохраняется, а модель вне списка разрешается в принудительный Default.

504 504

505Модели Fable не являются стандартным значением для типа учетной записи ни на одном плане или поставщике. Выбор одной с помощью `/model` сохраняет ее как выбранную модель в параметрах пользователя, поэтому более поздние сеансы начинаются с нее. Для одноразового изменения, которое Claude Code вносит в сохраненный выбор Fable 5 в версии 2.1.257, см. [Работа с Fable](#work-with-fable).505Модели Fable не являются стандартным значением для типа учётной записи ни на одном тарифе или у одного поставщика. Выбор одной из них с помощью `/model` сохраняет её как выбранную модель в пользовательских настройках, поэтому последующие сессии начинаются с неё. Об одноразовом изменении, которое Claude Code вносит в сохранённый выбор Fable 5 в версии 2.1.257, см. [Работа с Fable](#work-with-fable).

506 506

507<h3 id="opusplan-model-setting">507<h3 id="opusplan-model-setting">

508 Параметр модели `opusplan`508 Настройка модели `opusplan`

509</h3>509</h3>

510 510

511Псевдоним модели `opusplan` обеспечивает автоматизированный гибридный подход:511Псевдоним модели `opusplan` обеспечивает автоматизированный гибридный подход:

512 512

513* **В Plan Mode**: использует `opus` для сложного рассуждения и решений по архитектуре513* **В режиме планирования**: использует `opus` для сложных рассуждений и решений по архитектуре

514* **В режиме выполнения**: автоматически переключается на `sonnet` для генерации кода и реализации514* **В режиме выполнения**: автоматически переключается на `sonnet` для генерации кода и реализации

515 515

516Это сочетает рассуждение Opus для планирования с эффективностью Sonnet для выполнения.516Это сочетает рассуждения Opus для планирования с эффективностью Sonnet для выполнения.

517 517

518Фаза Opus в Plan Mode использует то же окно контекста, что и параметр модели `opus`, а фаза выполнения использует то же окно, что и `sonnet`. Когда `opus` и `sonnet` разрешаются в модели, которые работают с [окном контекста 1M](#extended-context) по умолчанию, как это делают текущие модели на Anthropic API, обе фазы работают с ним. Чтобы запросить контекст 1M для обеих фаз, где они этого не делают, [установите модель](#setting-your-model) на `opusplan[1m]`, например с помощью `/model opusplan[1m]`. Установка с помощью `/model` требует Claude Code версии 2.1.265 или позже; в более ранних версиях используйте флаг `--model` или параметр `model` вместо этого.518Фаза Opus в режиме планирования использует то же контекстное окно, что и настройка модели `opus`, а фаза выполнения использует то же окно, что и `sonnet`. Когда `opus` и `sonnet` разрешаются в модели, которые по умолчанию работают с [контекстным окном 1M](#extended-context), как текущие модели на Anthropic API, обе фазы работают с ним. Чтобы запросить контекст 1M для обеих фаз там, где это не так, [установите модель](#setting-your-model) `opusplan[1m]`, например с помощью `/model opusplan[1m]`. Установка с помощью `/model` требует Claude Code версии 2.1.265 или позже; в более ранних версиях используйте вместо этого флаг `--model` или настройку `model`.

519 519

520Когда [`availableModels`](#restrict-model-selection) исключает новейший Opus, но разрешает более старую версию, например `["sonnet", "claude-opus-4-6"]`, `opusplan` использует новейший разрешенный Opus для планирования и остается только на Sonnet, когда исключены все версии Opus. Сеанс Haiku, который обычно обновляется до Sonnet в Plan Mode, аналогично использует новейший разрешенный Sonnet и остается на Haiku только когда исключены все версии Sonnet. До версии 2.1.205 Plan Mode оставался на модели сеанса всякий раз, когда исключалась новейшая версия семейства обновлений, даже когда список разрешений разрешал более старую версию.520Когда [`availableModels`](#restrict-model-selection) исключает новейший Opus, но разрешает более старую версию, например `["sonnet", "claude-opus-4-6"]`, `opusplan` использует для планирования новейший разрешённый Opus и остаётся на Sonnet, только когда исключены все версии Opus. Сессия Haiku, которая обычно переключается на Sonnet в режиме планирования, аналогично использует новейший разрешённый Sonnet и остаётся на Haiku, только когда исключены все версии Sonnet. До версии 2.1.205 режим планирования оставался на модели сессии всякий раз, когда исключалась новейшая версия семейства для переключения, даже если список разрешённых моделей разрешал более старую версию.

521 521

522Подстановка более старой разрешенной версии применяется на Anthropic API и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Mantle, развертывания которых используют специфичные для поставщика идентификаторы моделей, Plan Mode остается на модели сеанса всякий раз, когда модель обновления исключена.522Подстановка более старой разрешённой версии применяется на Anthropic API и [Claude Platform on AWS](/docs/ru/claude-platform-on-aws). На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и Mantle, развёртывания которых используют специфичные для поставщика идентификаторы моделей, режим планирования остаётся на модели сессии всякий раз, когда модель для переключения исключена.

523 523

524Для гибридного подхода, при котором Claude решает во время выполнения задачи, когда обратиться ко второй модели, а не переключаться на границе плана, см. [инструмент advisor](/docs/ru/advisor).524Для гибридного подхода, при котором Claude решает во время выполнения задачи, когда обратиться ко второй модели, а не переключаться на границе плана, см. [инструмент advisor](/docs/ru/advisor).

525 525

527 Цепочки резервных моделей527 Цепочки резервных моделей

528</h3>528</h3>

529 529

530Когда основная модель перегружена, недоступна или возвращает другую неповторяемую ошибку сервера, Claude Code может переключиться на резервную модель вместо отказа в запросе. Ошибки аутентификации, выставления счетов, ограничения скорости, размера запроса и транспорта, а также [отказ в соответствии с проверкой политики вашей организации](/docs/ru/errors#automatic-retries), никогда не вызывают переключение; они следуют обычной обработке повторных попыток и ошибок. Он переключается, когда [Amazon Bedrock](/docs/ru/amazon-bedrock#when-a-model-is-disabled-mid-session) или [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai#when-a-model-is-disabled-mid-session) отказывает в модели, которую ваша учетная запись не может вызвать, что Claude Code рассматривает как недоступность модели, а не как ошибку аутентификации.530Когда основная модель перегружена, недоступна или возвращает другую ошибку сервера, не подлежащую повторной попытке, Claude Code может переключиться на резервную модель вместо того, чтобы завершить запрос ошибкой. Ошибки аутентификации, биллинга, ограничения частоты запросов, размера запроса и транспорта, а также [отказ по результатам проверки политики вашей организации](/docs/ru/errors#automatic-retries) никогда не вызывают переключение; они обрабатываются обычным механизмом повторных попыток и обработки ошибок. Переключение происходит, когда [Amazon Bedrock](/docs/ru/amazon-bedrock#when-a-model-is-disabled-mid-session) или [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai#when-a-model-is-disabled-mid-session) отказывает в модели, которую ваша учётная запись не может вызвать: Claude Code рассматривает это как недоступность модели, а не как ошибку аутентификации.

531 531

532Настройте одну или несколько резервных моделей, и Claude Code попробует их по порядку, показывая уведомление при переключении. Переключение длится только для текущего хода, поэтому ваше следующее сообщение сначала попробует основную модель снова. Claude Code ограничивает цепочки тремя моделями после удаления дубликатов и игнорирует дополнительные записи.532Настройте одну или несколько резервных моделей, и Claude Code будет пробовать их по порядку, показывая уведомление при переключении. Переключение действует только в течение текущего хода, поэтому ваше следующее сообщение снова сначала пробует основную модель. Claude Code ограничивает цепочки тремя моделями после удаления дубликатов и игнорирует лишние записи.

533 533

534Установите цепочку для одного сеанса с флагом `--fallback-model`, который принимает список, разделенный запятыми:534Задайте цепочку для одной сессии с помощью флага `--fallback-model`, который принимает список, разделённый запятыми:

535 535

536```bash theme={null}536```bash theme={null}

537claude --fallback-model sonnet,haiku537claude --fallback-model sonnet,haiku

538```538```

539 539

540Чтобы сохранить цепочку между сеансами, установите `fallbackModel` в [параметрах](/docs/ru/settings) как массив:540Чтобы сохранить цепочку между сессиями, задайте `fallbackModel` в [настройках](/docs/ru/settings) как массив:

541 541

542```json theme={null}542```json theme={null}

543{543{

545}545}

546```546```

547 547

548Флаг `--fallback-model` имеет приоритет над параметром `fallbackModel`. Каждая запись принимает имя модели или псевдоним, и `"default"` расширяется до модели по умолчанию.548Флаг `--fallback-model` имеет приоритет над настройкой `fallbackModel`. Каждая запись принимает имя модели или псевдоним, а `"default"` раскрывается в модель по умолчанию.

549 549

550Claude Code не подтверждает цепочку при запуске, и `/status` не отображает ее. Уведомление, показываемое при переключении, является первым видимым признаком того, что резервная модель настроена.550Claude Code не подтверждает цепочку при запуске, и `/status` её не отображает. Уведомление, показываемое при переключении, — первый видимый признак того, что резервная модель настроена.

551 551

552Когда запрос переходит в режим отказа, Claude Code пробует каждую запись по порядку, пока одна не примет ее. Запись, которая также не может быть достигнута, например снятая с производства модель, закрепленная в параметрах, переходит в режим отказа к следующей таким же образом. Claude Code удаляет два типа записей перед этим проходом:552Когда запрос переключается на резервную модель, Claude Code пробует каждую запись по порядку, пока одна из них не примет запрос. Запись, которая тоже недоступна, например снятая с поддержки модель, закреплённая в настройках, точно так же переключается на следующую. Перед этим проходом Claude Code удаляет записи двух типов:

553 553

554* **Вне списка разрешений**: Claude Code удаляет любую запись, не разрешенную [`availableModels`](#restrict-model-selection), когда читает цепочку.554* **Вне списка разрешённых моделей**: Claude Code отбрасывает любую запись, не разрешённую [`availableModels`](#restrict-model-selection), при чтении цепочки.

555* **Меньшее окно контекста во время компактирования**: цепочка также охватывает [компактирование](/docs/ru/context-window#what-survives-compaction), но Claude Code не будет переходить в режим отказа на модель с меньшим окном контекста, чем у основной, так как суммирование там сначала отрежет часть разговора. Если все резервные модели меньше, компактирование показывает исходную ошибку и вы можете повторить попытку.555* **Меньшее контекстное окно при сжатии контекста**: цепочка также охватывает [сжатие контекста](/docs/ru/context-window#what-survives-compaction), но Claude Code не переключится на модель с меньшим контекстным окном, чем у основной, поскольку суммирование на ней сначала отрезало бы часть диалога. Если все резервные модели меньше, сжатие показывает исходную ошибку, и вы можете повторить попытку.

556 556

557Claude Code также применяет цепочку к [subagents](/docs/ru/sub-agents). Когда запрос subagent переходит в режим отказа, Claude Code пробует ваши настроенные резервные модели по порядку, и subagent продолжает работу на модели, которая принимает запрос. Модель вашего сеанса не изменяется. До версии 2.1.247 отказ, который охватывает цепочка, завершал subagent.557Claude Code также применяет цепочку к [субагентам](/docs/ru/sub-agents). Когда запрос субагента переключается на резервную модель, Claude Code пробует настроенные вами резервные модели по порядку, и субагент продолжает работу на модели, которая приняла запрос. Модель вашей сессии не изменяется. До версии 2.1.247 сбой, на который распространяется цепочка, вместо этого завершал работу субагента.

558 558

559<h3 id="automatic-model-fallback">559<h3 id="automatic-model-fallback">

560 Автоматический резервный вариант модели560 Автоматическое переключение на резервную модель

561</h3>561</h3>

562 562

563Этот раздел охватывает резервный вариант на основе содержимого из моделей Fable, Opus 5.5, Sonnet 5.5 и Opus 5. Для резервного варианта на основе доступности, когда модель перегружена или недоступна, см. [Цепочки резервных моделей](#fallback-model-chains).563Этот раздел описывает переключение на резервную модель на основе содержимого для моделей Fable, Opus 5.5, Sonnet 5.5 и Opus 5. О переключении на основе доступности, когда модель перегружена или недоступна, см. [Цепочки резервных моделей](#fallback-model-chains).

564 564

565Модели Fable, Opus 5.5, Sonnet 5.5 и Opus 5 работают с классификаторами безопасности, которые чаще всего отмечают содержимое кибербезопасности и биологии. Когда классификатор отмечает запрос и отмеченная категория имеет резервную модель, Claude Code повторно запускает запрос на этой модели и показывает уведомление в стенограмме. Для этих двух категорий резервная модель зависит от того, какая модель отказала:565Модели Fable, Opus 5.5, Sonnet 5.5 и Opus 5 работают с классификаторами безопасности, которые чаще всего помечают содержимое, связанное с кибербезопасностью и биологией. Для этих двух категорий резервная модель зависит от того, какая модель отказала:

566 566

567* **Fable 5.1, Fable 5 и Opus 5.5**: запросы, отмеченные биологией, повторно запускаются на Opus 5, а запросы, отмеченные кибербезопасностью, повторно запускаются на Opus 4.8.567* **Fable 5.1, Fable 5 и Opus 5.5**: запросы, помеченные как связанные с биологией, повторно выполняются на Opus 5, а запросы, помеченные как связанные с кибербезопасностью, — на Opus 4.8.

568* **Sonnet 5.5**: запросы, отмеченные кибербезопасностью, повторно запускаются на Sonnet 5. Запросы, отмеченные биологией, заканчиваются отказом, потому что Sonnet 5.5 не имеет резервной модели биологии.568* **Sonnet 5.5**: запросы, помеченные как связанные с кибербезопасностью, повторно выполняются на Sonnet 5. Запросы, помеченные как связанные с биологией, вместо этого завершаются отказом, потому что у Sonnet 5.5 нет резервной модели для биологии.

569* **Opus 5**: запросы, отмеченные кибербезопасностью, повторно запускаются на Opus 4.8. Запросы, отмеченные биологией, заканчиваются отказом, потому что Opus 5 запускает свои собственные классификаторы биологии без резервной модели.569* **Opus 5**: запросы, помеченные как связанные с кибербезопасностью, повторно выполняются на Opus 4.8. Запросы, помеченные как связанные с биологией, вместо этого завершаются отказом, потому что Opus 5 использует собственные классификаторы биологии без резервной модели.

570 570

571На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry Claude Code разрешает эти цели через идентификаторы моделей вашего развертывания. См. [Включение резервного варианта на Bedrock, Agent Platform и Foundry](#enable-fallback-on-bedrock-agent-platform-and-foundry).571На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry Claude Code вместо этого разрешает эти целевые модели через идентификаторы моделей вашего развёртывания. См. [Включение резервного варианта на Bedrock, Agent Platform и Foundry](#enable-fallback-on-bedrock-agent-platform-and-foundry).

572 572

573После резервного варианта сеанс продолжается на резервной модели. Чтобы вернуться к исходной модели, запустите [`/model`](#setting-your-model).573Когда Claude Code переключает помеченный запрос на резервную модель для его категории, он повторно выполняет запрос на этой модели. В основном диалоге он показывает уведомление в транскрипте. Чтобы получать вопрос перед переключением, см. [Запрос перед переключением](#ask-before-switching).

574 574

575Резервный вариант на основе категории требует Claude Code версии 2.1.219 или позже. До версии 2.1.219 каждый отмеченный запрос Fable 5 повторно запускался на модели Opus по умолчанию вашего поставщика, и Opus 5 не был источником резервного варианта.575После переключения на резервную модель сессия продолжается на ней. Чтобы вернуться к исходной модели, выполните [`/model`](#setting-your-model).

576 576

577Резервная модель проверяется против [`availableModels`](#restrict-model-selection). Когда она заблокирована, резервный вариант не происходит. Отказ показывается как обычная ошибка, и модель сеанса не изменяется.577Переключение на основе категории требует Claude Code версии 2.1.219 или позже. До версии 2.1.219 каждый помеченный запрос Fable 5 повторно выполнялся на модели Opus по умолчанию вашего поставщика, а Opus 5 не был источником переключения.

578

579Резервная модель проверяется по [`availableModels`](#restrict-model-selection). Если она заблокирована, переключение не происходит. Отказ показывается как обычная ошибка, и модель сессии не изменяется.

578 580

579<h4 id="effort-level-after-a-fallback">581<h4 id="effort-level-after-a-fallback">

580 Уровень усилий после переключения на резервную модель582 Уровень усилий после переключения на резервную модель

581</h4>583</h4>

582 584

583Когда Claude Code переключает вашу сессию на резервную модель, он сохраняет уровень усилий, с которым выполнялся помеченный запрос, вместо уровня усилий по умолчанию для этой модели. Например, сессия на Opus 5.5 с уровнем по умолчанию `medium`, переключившаяся на Opus 4.8, остаётся на `medium`, хотя Opus 4.8 по умолчанию использует `high`.585Когда Claude Code переключает вашу сессию на резервную модель, он сохраняет уровень усилий, с которым выполнялся помеченный запрос. Например, сессия на Opus 5.5 с уровнем по умолчанию `medium`, переключившаяся на Opus 4.8, остаётся на `medium`, хотя Opus 4.8 по умолчанию использует `high`.

584 586

585Другой уровень применяется, например, в следующих случаях:587Другой уровень применяется, например, в следующих случаях:

586 588

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

588* **Ваше собственное изменение**: как только вы выбираете уровень усилий, выбираете модель в `/model` или позже возобновляете сессию, уровень помеченного запроса больше не переносится.589* **Ваше собственное изменение**: как только вы выбираете уровень усилий, выбираете модель в `/model` или позже возобновляете сессию, уровень помеченного запроса больше не переносится.

589* **Уровень усилий скилла**: уровень, который frontmatter `effort` скилла задал для помеченного запроса, применяется к этому ходу, а последующие ходы выполняются на уровне, который [порядок разрешения усилий](#adjust-effort-level) даёт резервной модели.590* **Уровень усилий скилла**: уровень, который frontmatter `effort` скилла задал для помеченного запроса, применяется к этому ходу, а последующие ходы выполняются на уровне, который [порядок разрешения усилий](#adjust-effort-level) даёт резервной модели.

590 591

591Заголовок сессии показывает действующий уровень рядом с именем модели. Чтобы изменить его, запустите `/effort` в сессии.592В сессии выполните `/effort status`, чтобы увидеть действующий уровень, или `/effort`, чтобы изменить его.

592 593

593<h4 id="check-what-triggered-fallback">594<h4 id="check-what-triggered-fallback">

594 Проверка того, что вызвало резервный вариант595 Проверка того, что вызвало переключение

595</h4>596</h4>

596 597

597Резервный вариант может быть вызван при первом запросе сеанса, прежде чем вы отправите что-либо необычное, потому что первый запрос содержит контекст рабочей области, такой как содержимое вашего CLAUDE.md и статус git. Репозиторий, содержащий материал по безопасности или биологии, может активировать классификатор только на этом контексте.598Переключение на резервную модель может произойти уже на первом запросе сессии, прежде чем вы отправите что-либо необычное, потому что первый запрос содержит контекст рабочего пространства, например содержимое вашего CLAUDE.md и статус git. Репозиторий, содержащий материалы по безопасности или биологии, может сработать на классификаторе только из-за этого контекста.

598 599

599Чтобы проверить, являются ли настройки триггером, запустите сеанс с `claude --safe-mode`, который отключает настройки, такие как CLAUDE.md, skills, MCP серверы и hooks. Статус Git и имена каталогов не являются настройками и по-прежнему включены.600Чтобы проверить, не являются ли причиной ваши настройки, запустите сессию с `claude --safe-mode`, что отключает такие настройки, как CLAUDE.md, скиллы, MCP-серверы и хуки. Статус Git и имена каталогов не являются настройками и по-прежнему включаются.

600 601

601<h4 id="ask-before-switching">602<h4 id="ask-before-switching">

602 Запрос перед переключением603 Запрос перед переключением

603</h4>604</h4>

604 605

605Чтобы решить, что происходит каждый раз, когда запрос отмечается, вместо автоматического переключения, запустите `/config` и отключите **Switch models when a message is flagged**, или установите [`switchModelsOnFlag`](/docs/ru/settings-reference#switchmodelsonflag) на `false` в файле параметров. Отмеченный запрос затем приостанавливает сеанс с двумя вариантами: переключиться на резервную модель или отредактировать подсказку и повторить попытку на текущей модели.606Чтобы самостоятельно решать, что происходит каждый раз, когда запрос помечен, выполните `/config`, выберите **Switch models when a message is flagged** и выберите **Ask each time**. Вы также можете установить [`switchModelsOnFlag`](/docs/ru/settings-reference#switchmodelsonflag) в `false` в файле настроек. Тогда Claude Code приостанавливается на помеченном запросе, который привёл бы к переключению моделей, и предлагает два варианта: переключиться на резервную модель или отредактировать промпт и повторить попытку.

607

608В первый раз, когда помеченный запрос в интерактивной сессии должен привести к переключению моделей, Claude Code может спросить, переключаться ли автоматически в дальнейшем. Он спрашивает, только если вы не установили `switchModelsOnFlag`, и сохраняет ваш выбор в этом ключе в пользовательских настройках.

609

610Если вы решите остаться на текущей модели, сохраняется значение `false`, так же как для **Ask each time**. Если вы закроете вопрос, Claude Code ничего не сохраняет и спросит снова в следующий раз, когда помеченный запрос должен будет привести к переключению моделей.

606 611

607Некоторые случаи ведут себя иначе:612Если вы выбрали **Ask each time**, некоторые случаи ведут себя иначе:

608 613

609* Когда отмеченная категория не имеет резервной модели, такой как флаг биологии на Opus 5 или Sonnet 5.5, Claude Code не показывает подсказку и запрос заканчивается отказом.614* Когда у помеченной категории нет резервной модели, например при пометке биологии на Opus 5 или Sonnet 5.5, Claude Code не показывает запрос, и запрос к модели завершается отказом.

610* Если обе модели отмечают один и тот же запрос, вы можете отредактировать подсказку и повторить попытку, или начать новый сеанс.615* Если обе модели помечают один и тот же запрос, вы можете отредактировать промпт и повторить попытку или начать новую сессию.

611* На мобильных сеансах [Claude Code в веб-браузере](/docs/ru/claude-code-on-the-web) редактирование и повторная попытка не поддерживаются. Переключите модели или продолжите сеанс из браузера рабочего стола или приложения рабочего стола.616* В [облачных сессиях](/docs/ru/claude-code-on-the-web) в мобильном приложении редактирование и повторная попытка не поддерживаются. Переключите модели или продолжите сессию в браузере на компьютере или в настольном приложении.

612* В [неинтерактивном режиме](/docs/ru/cli-reference#cli-flags) и интеграциях SDK, которые не могут показать подсказку, отмеченный запрос завершает ход с отказом.617* В [неинтерактивном режиме](/docs/ru/cli-reference#cli-flags) и интеграциях SDK, которые не могут показать запрос, помеченный запрос вместо этого завершает ход отказом.

613* Когда цель резервного варианта заблокирована [`availableModels`](#restrict-model-selection), Claude Code не показывает подсказку. Отмеченный запрос заканчивается отказом, так же как автоматический резервный вариант, когда цель заблокирована.618* В [субагенте](/docs/ru/sub-agents) Claude Code не показывает запрос, и помеченный запрос, который привёл бы к переключению моделей, повторно выполняется на резервной модели.

619* Когда целевая резервная модель заблокирована [`availableModels`](#restrict-model-selection), Claude Code не показывает запрос. Помеченный запрос завершается отказом, так же как при автоматическом переключении, когда целевая модель заблокирована.

614 620

615<h4 id="enable-fallback-on-bedrock-agent-platform-and-foundry">621<h4 id="enable-fallback-on-bedrock-agent-platform-and-foundry">

616 Включение резервного варианта на Bedrock, Agent Platform и Foundry622 Включение резервного варианта на Bedrock, Agent Platform и Foundry

617</h4>623</h4>

618 624

619На [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) и [Microsoft Foundry](/docs/ru/microsoft-foundry) идентификаторы моделей специфичны для поставщика, поэтому автоматический резервный вариант работает только когда Claude Code может идентифицировать каждую задействованную модель:625На [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) и [Microsoft Foundry](/docs/ru/microsoft-foundry) идентификаторы моделей специфичны для поставщика, поэтому автоматическое переключение на резервную модель работает, только когда Claude Code может идентифицировать каждую задействованную модель:

620 626

621* Claude Code должен распознавать текущую модель как источник резервного варианта. Fable 5.1 и Fable 5 распознаются, когда идентификатор модели содержит `claude-fable-5`, соответствует значению `ANTHROPIC_DEFAULT_FABLE_MODEL` или сопоставляется с [`modelOverrides`](#override-model-ids-per-version). Opus 5.5, Sonnet 5.5 и Opus 5 распознаются по их идентификатору модели поставщика или сопоставлению [`modelOverrides`](#override-model-ids-per-version).627* Claude Code должен распознавать текущую модель как источник переключения. Fable 5.1 и Fable 5 распознаются, когда идентификатор модели содержит `claude-fable-5`, совпадает со значением `ANTHROPIC_DEFAULT_FABLE_MODEL` или сопоставлен через [`modelOverrides`](#override-model-ids-per-version). Opus 5.5, Sonnet 5.5 и Opus 5 распознаются по идентификатору модели поставщика или по сопоставлению в [`modelOverrides`](#override-model-ids-per-version).

622* Цель Opus должна разрешаться в вашем развертывании, независимо от того, какая модель отказала: установите `ANTHROPIC_DEFAULT_OPUS_MODEL` или сохраните запись Opus 4.8 в списке моделей поставщика. Без одной резервный вариант остается отключенным для каждой исходной модели, включая Sonnet 5.5, и отмеченные запросы заканчиваются отказом.628* Целевая модель Opus должна разрешаться в вашем развёртывании, независимо от того, какая модель отказала: установите `ANTHROPIC_DEFAULT_OPUS_MODEL` или сохраните запись Opus 4.8 в списке моделей поставщика. Без этого переключение остаётся отключённым для всех исходных моделей, включая Sonnet 5.5, и помеченные запросы завершаются отказом.

623* Резервная модель отмеченной категории должна разрешаться в вашем развертывании. Из модели Fable, Opus 5.5 или Opus 5, если вы установите `ANTHROPIC_DEFAULT_OPUS_MODEL`, отмеченные запросы повторно запускаются на этой модели для каждой категории, которая имеет резервный вариант; флаг биологии на Opus 5 по-прежнему заканчивается отказом. Если вы не установите его, запросы, отмеченные кибербезопасностью, повторно запускаются на записи Opus 4.8, а запросы, отмеченные биологией, из модели Fable или Opus 5.5 на записи Opus 5. Из Sonnet 5.5 запросы, отмеченные кибербезопасностью, повторно запускаются на модели, которую вы установили в `ANTHROPIC_DEFAULT_SONNET_MODEL`, или на записи Sonnet 5 в списке моделей поставщика, если вы не установите его.629* Резервная модель для помеченной категории должна разрешаться в вашем развёртывании. Для модели Fable, Opus 5.5 или Opus 5, если вы установите `ANTHROPIC_DEFAULT_OPUS_MODEL`, помеченные запросы повторно выполняются на этой модели для каждой категории, у которой есть резервная модель; пометка биологии на Opus 5 по-прежнему завершается отказом. Если вы его не установите, запросы, помеченные как связанные с кибербезопасностью, повторно выполняются на записи Opus 4.8, а запросы, помеченные как связанные с биологией, от модели Fable или Opus 5.5 — на записи Opus 5. Для Sonnet 5.5 запросы, помеченные как связанные с кибербезопасностью, повторно выполняются на модели, которую вы задали в `ANTHROPIC_DEFAULT_SONNET_MODEL`, или, если вы её не задали, на записи Sonnet 5 в списке моделей поставщика.

624 630

625Если какая-либо модель не может быть идентифицирована, Claude Code не переключается. Отмеченный запрос заканчивается сообщением об отказе, и вы можете переключить модели с помощью [`/model`](#setting-your-model) и повторить попытку. Чтобы сделать обе модели идентифицируемыми, установите закрепления для вашей исходной модели:631Если какую-либо из моделей не удаётся идентифицировать, Claude Code не переключается. Помеченный запрос завершается сообщением об отказе, и вы можете переключить модель с помощью [`/model`](#setting-your-model) и повторить попытку. Чтобы обе модели можно было идентифицировать, задайте закрепления для вашей исходной модели:

626 632

627* **Модели Fable**: установите `ANTHROPIC_DEFAULT_FABLE_MODEL` на идентификатор вашей модели Fable, чтобы Claude Code распознал ее как источник резервного варианта.633* **Модели Fable**: установите `ANTHROPIC_DEFAULT_FABLE_MODEL` в идентификатор вашей модели Fable, чтобы Claude Code распознавал её как источник переключения.

628* **Каждая исходная модель**: установите `ANTHROPIC_DEFAULT_OPUS_MODEL` на идентификатор модели Opus, чтобы включить резервный вариант и дать отмеченным категориям цель. Закрепление, которое называет модель вне семейства Opus или модель, которая отказала, оставляет отказ в силе.634* **Любая исходная модель**: установите `ANTHROPIC_DEFAULT_OPUS_MODEL` в идентификатор модели Opus, чтобы включить переключение и дать помеченным категориям целевую модель. Закрепление, указывающее модель вне семейства Opus или ту модель, которая отказала, оставляет отказ в силе.

629* **Sonnet 5.5**: в дополнение к закреплению Opus установите `ANTHROPIC_DEFAULT_SONNET_MODEL` или сохраните запись Sonnet 5 в списке моделей поставщика, чтобы предоставить модель, на которой запрос повторно запускается. Закрепление Sonnet, которое называет модель вне семейства Sonnet или Sonnet 5.5 само по себе, оставляет отказ в силе.635* **Sonnet 5.5**: помимо закрепления Opus установите `ANTHROPIC_DEFAULT_SONNET_MODEL` или сохраните запись Sonnet 5 в списке моделей поставщика, чтобы указать модель, на которой запрос будет выполнен повторно. Закрепление Sonnet, указывающее модель вне семейства Sonnet или саму Sonnet 5.5, оставляет отказ в силе.

636

637Резервная модель также должна иметь контекстное окно не меньше, чем у сессии, иначе Claude Code не переключается, и помеченный запрос завершается тем же отказом. У этих поставщиков исходные модели по умолчанию работают с [контекстным окном 1M](#extended-context). Закрепите модель, которая тоже работает с ним, например Opus 4.8 в `ANTHROPIC_DEFAULT_OPUS_MODEL` или Sonnet 5 в `ANTHROPIC_DEFAULT_SONNET_MODEL`, по идентификатору, который Claude Code [может сопоставить с этой моделью](#pin-models-for-third-party-deployments).

630 638

631<h4 id="security-research-and-biology-workloads">639<h4 id="security-research-and-biology-workloads">

632 Исследование безопасности и рабочие нагрузки биологии640 Исследования безопасности и рабочие нагрузки в области биологии

633</h4>641</h4>

634 642

635Рабочие нагрузки в наступательной безопасности или биологии, включая тестирование на проникновение, упражнения Capture the Flag (CTF) и кодовые базы, смежные с биологией, часто вызывают резервный вариант, часто при первом запросе. Для существенной работы по биологии на Fable 5.1, Fable 5 или Opus 5.5 Claude Code перемещает сеанс на Opus 5 при первом отмеченном запросе, и более поздние запросы, отмеченные биологией, заканчиваются отказами там, потому что Opus 5 не имеет резервного варианта биологии. На Opus 5 и Sonnet 5.5 вы получаете эти отказы с первого отмеченного запроса.643Рабочие нагрузки в наступательной безопасности или биологии, включая тестирование на проникновение, упражнения Capture the Flag (CTF) и кодовые базы, связанные с биологией, часто вызывают переключение на резервную модель, нередко уже при первом запросе. При серьёзной работе по биологии на Fable 5.1, Fable 5 или Opus 5.5 первый помеченный запрос, приводящий к переключению моделей, переводит сессию на Opus 5, и последующие запросы, помеченные как связанные с биологией, завершаются там отказами, потому что у Opus 5 нет резервной модели для биологии. На Opus 5 и Sonnet 5.5 вы получаете эти отказы начиная с первого помеченного запроса.

636 644

637Это ожидаемая маршрутизация для этих областей, а не флаг учетной записи. Если вашей организации требуется возможность класса Fable для этой работы, обратитесь к команде учетной записи Anthropic о программах доверенного доступа.645Это ожидаемая маршрутизация для этих областей, а не пометка учётной записи. Если вашей организации для этой работы нужны возможности класса Fable, обратитесь к своей команде по работе с клиентами Anthropic по поводу программ доверенного доступа.

638 646

639<h3 id="adjust-effort-level">647<h3 id="adjust-effort-level">

640 Регулировка уровня усилий648 Регулировка уровня усилий

641</h3>649</h3>

642 650

643[Уровни усилий](https://platform.claude.com/docs/en/build-with-claude/effort) управляют адаптивным рассуждением, которое позволяет модели решать, нужно ли и сколько думать на каждом шаге в зависимости от сложности задачи. Более низкие усилия быстрее и дешевле для простых задач, в то время как более высокие усилия обеспечивают более глубокое рассуждение для сложных проблем.651[Уровни усилий](https://platform.claude.com/docs/en/build-with-claude/effort) управляют адаптивными рассуждениями, которые позволяют модели решать, нужно ли и сколько думать на каждом шаге в зависимости от сложности задачи. Более низкий уровень быстрее и дешевле для простых задач, а более высокий обеспечивает более глубокие рассуждения для сложных проблем.

644 652

645Доступные уровни усилий зависят от модели. Модели, не указанные здесь, не поддерживают усилия:653Доступные уровни усилий зависят от модели. Модели, не указанные здесь, не поддерживают effort:

646 654

647| Модель | Уровни |655| Модель | Уровни |

648| :- | :- |656| :- | :- |

652 660

653Если вы установите уровень, который активная модель не поддерживает, Claude Code переходит на наивысший поддерживаемый уровень на или ниже установленного. Например, `xhigh` работает как `high` на Opus 4.6. Ваша организация или ваши собственные параметры также могут ограничивать уровни, которые предлагает модель; см. [Ограничения усилий организации](#organization-effort-limits).661Если вы установите уровень, который активная модель не поддерживает, Claude Code использует наивысший поддерживаемый уровень, не превышающий установленный. Например, `xhigh` работает как `high` на Opus 4.6. Ваша организация или ваши собственные настройки также могут ограничивать уровни, которые предлагает модель; см. [Ограничения усилий организации](#organization-effort-limits).

662

663Claude Code определяет уровень усилий сессии в следующем порядке, используя первый применимый:

654 664

655Claude Code разрешает уровень усилий сеанса в этом порядке, принимая первый применимый:6651. Явный выбор: переменная окружения [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ru/env-vars#variables), запуск с `--effort` или `/effort` в сессии ([неинтерактивный `/effort` действует уже](#non-interactive-effort))

6662. Ваши настройки: уровень, сохранённый вами для модели, или ключ [`effortLevel`](/docs/ru/settings-reference#effortlevel); приоритет между ними и между файлами настроек описан в [`modelSettings`](/docs/ru/settings-reference#modelsettings)

6673. Уровень усилий модели по умолчанию: `high` на каждой модели, поддерживающей effort, за исключением того, что Opus 5.5, Sonnet 5.5 и Haiku 5.5 по умолчанию используют `medium`, Opus 4.7 по умолчанию использует `xhigh`, а когда ваша организация задаёт уровень усилий по умолчанию для своей [модели по умолчанию организации](#organization-default-model), этот уровень используется по умолчанию при работе с этой моделью

656 668

6571. Явный выбор: переменная окружения [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/ru/env-vars#variables), запуск с `--effort` или `/effort` в сеансе ([неинтерактивный `/effort` имеет более узкий эффект](#non-interactive-effort))669Об уровне, который применяется после автоматического переключения на резервную модель, см. [Уровень усилий после переключения на резервную модель](#effort-level-after-a-fallback).

6582. Ваши параметры: уровень, который вы сохранили для модели или ключ [`effortLevel`](/docs/ru/settings-reference#effortlevel), с приоритетом между ними и между файлами параметров, указанным в [`modelSettings`](/docs/ru/settings-reference#modelsettings)

6593. Уровень усилий модели по умолчанию: `high` на каждой модели, поддерживающей effort, за исключением того, что Opus 5.5, Sonnet 5.5 и Haiku 5.5 по умолчанию используют `medium`, Opus 4.7 по умолчанию использует `xhigh`, а когда ваша организация задаёт уровень усилий по умолчанию для своей [модели по умолчанию организации](#organization-default-model), этот уровень используется по умолчанию при работе с этой моделью. Об уровне, который применяется после автоматического переключения на резервную модель, см. [Уровень усилий после переключения на резервную модель](#effort-level-after-a-fallback).

660 670

661Opus 5.5 начинает с `medium`, если один из источников выше не устанавливает уровень для него, и верхний уровень `effortLevel` в файле параметров пользователя не считается для Opus 5.5. Этот ключ — это более старая форма, которую `/effort` писал перед тем, как Claude Code сохранял уровни для каждой модели: он продолжает применяться там, где применялся раньше, на Opus 5, Fable 5.1 и более ранних моделях, в то время как Opus 5.5 и модели, выпущенные после него, начинают со своего собственного стандарта, пока вы не выберете уровень для них с помощью `/effort` или средства выбора `/model`. Верхний уровень `effortLevel` в параметрах проекта, локальных или управляемых параметрах, или переданный с `--settings`, применяется к каждой модели.671Opus 5.5 начинает с `medium`, если ни один из перечисленных выше источников не задаёт для него уровень, а ключ `effortLevel` верхнего уровня в вашем файле пользовательских настроек для Opus 5.5 не учитывается. Этот ключ — старая форма, которую `/effort` записывал до того, как Claude Code стал сохранять уровни для каждой модели: он продолжает действовать там, где действовал раньше, — на Opus 5, Fable 5.1 и более ранних моделях, тогда как Opus 5.5 и модели, выпущенные после неё, начинают со своего собственного уровня по умолчанию, пока вы не выберете для них уровень с помощью `/effort` или средства выбора `/model`. Ключ `effortLevel` верхнего уровня в настройках проекта, локальных или управляемых настройках или переданный с `--settings` применяется ко всем моделям.

662 672

663Когда вы устанавливаете `low`, `medium`, `high` или `xhigh` в интерактивном сеансе на вашей машине, вы выбираете, как долго это длится, подтверждая это:673Когда вы устанавливаете `low`, `medium`, `high` или `xhigh` в интерактивной сессии на своём компьютере, срок действия уровня определяется тем, как вы его подтверждаете:

664 674

665* `Enter` в ползунке `/effort` или средстве выбора `/model`, или уровень, введенный после `/effort`: сохраните уровень как стандартный и примените его в более поздних сеансах675* `Enter` в ползунке `/effort` или средстве выбора `/model` либо уровень, введённый после `/effort`: уровень сохраняется как ваш уровень по умолчанию и применяется в последующих сессиях

666* `s` в ползунке `/effort` или средстве выбора `/model`: примените уровень только к этому сеансу. Требуется Claude Code версии 2.1.257 или позже676* `s` в ползунке `/effort` или средстве выбора `/model`: уровень применяется только к этой сессии. Требуется Claude Code версии 2.1.257 или позже

667 677

668Claude Code сохраняет уровень для каждой модели под ключом [`modelSettings`](/docs/ru/settings-reference#modelsettings) в параметрах пользователя, поэтому каждая модель сохраняет свой собственный уровень.678Claude Code сохраняет уровень для каждой модели в ключе [`modelSettings`](/docs/ru/settings-reference#modelsettings) в пользовательских настройках, поэтому у каждой модели свой сохранённый уровень.

669 679

670`max` — это самый глубокий уровень рассуждения. Если вы не установите его через переменную окружения `CLAUDE_CODE_EFFORT_LEVEL`, Claude Code применяет `max` только к текущему сеансу.680`max` — самый глубокий уровень рассуждений. Если вы не задаёте его через переменную окружения `CLAUDE_CODE_EFFORT_LEVEL`, Claude Code применяет `max` только к текущей сессии.

671 681

672<Note>682<Note>

673 Уровень, который вы выбираете из управления усилиями на телефоне или в браузере, подключенном через [Remote Control](/docs/ru/remote-control#what-connected-devices-see), применяется только к этому сеансу.683 Уровень, который вы выбираете в элементе управления усилиями на телефоне или в браузере, подключённом через [Remote Control](/docs/ru/remote-control#what-connected-devices-see), применяется только к этой сессии.

674</Note>684</Note>

675 685

676<span id="non-interactive-effort" />686<span id="non-interactive-effort" />

677 687

678Когда вы устанавливаете уровень с `/effort` в запуске [`-p`](/docs/ru/headless), Claude Code применяет его только к этому сеансу и не сохраняет его как стандартный.688Когда вы устанавливаете уровень с помощью `/effort` при [запуске с `-p`](/docs/ru/headless), Claude Code применяет его только к этой сессии и не сохраняет как уровень по умолчанию.

679 689

680Ползунок `/effort` также имеет переключатель **Ultracode**. Ultracode — это параметр Claude Code, а не уровень усилий модели: с его включением Claude организует [динамические рабочие процессы](/docs/ru/workflows) для существенных задач, на любом уровне усилий, на котором работает сеанс. Для того, где это можно установить постоянно, см. параметр [`ultracode`](/docs/ru/settings-reference#ultracode).690В ползунке `/effort` также есть переключатель **Ultracode**. Ultracode — это настройка Claude Code, а не уровень усилий модели: когда она включена, Claude организует [динамические рабочие процессы](/docs/ru/workflows) для существенных задач на любом уровне усилий, на котором работает сессия. О том, где её можно задать постоянно, см. настройку [`ultracode`](/docs/ru/settings-reference#ultracode).

681 691

682Включение или отключение ultracode с помощью `/effort` или параметра `ultracode` оставляет уровень усилий неизменным. Флаг `--effort ultracode` и значение Agent SDK `effortLevel: "ultracode"` включают его и также устанавливают уровень на `xhigh`. Выбор уровня в ползунке `/effort` или средстве выбора `/model` оставляет ultracode таким, как он был.692Включение или отключение ultracode с помощью `/effort` или настройки `ultracode` не меняет уровень усилий. Флаг `--effort ultracode` и значение Agent SDK `effortLevel: "ultracode"` включают его и также устанавливают уровень `xhigh`. Выбор уровня в ползунке `/effort` или средстве выбора `/model` оставляет ultracode в прежнем состоянии.

683 693

684Вы можете включить ultracode через любое из следующего:694Включить ultracode можно любым из следующих способов:

685 695

686* **`/effort`**: запустите `/effort ultracode`, чтобы включить его для текущего сеанса, или `/effort ultracode off`, чтобы отключить его. В ползунке `/effort` нажмите `Tab`, чтобы переключить переключатель **Ultracode**, затем `Enter`, чтобы применить его696* **`/effort`**: выполните `/effort ultracode`, чтобы включить его для текущей сессии, или `/effort ultracode off`, чтобы отключить. В ползунке `/effort` нажмите `Tab`, чтобы переключить **Ultracode**, затем `Enter`, чтобы применить

687* **Флаг `--effort`**: запустите с `claude --effort ultracode`, который запускает сеанс с усилиями `xhigh` и включенным ultracode697* **Флаг `--effort`**: запустите `claude --effort ultracode`, что начинает сессию с уровнем `xhigh` и включённым ultracode

688* **Параметр `ultracode`**: установите [`"ultracode": true`](/docs/ru/settings-reference#ultracode) в файле параметров, с `--settings` или в запросе управления Agent SDK. Запрос [`applyFlagSettings()`](/docs/ru/agent-sdk/typescript#applyflagsettings) также принимает `effortLevel: "ultracode"`, который включает его и устанавливает уровень усилий на `xhigh`698* **Настройка `ultracode`**: задайте [`"ultracode": true`](/docs/ru/settings-reference#ultracode) в файле настроек, с `--settings` или в управляющем запросе Agent SDK. Запрос [`applyFlagSettings()`](/docs/ru/agent-sdk/typescript#applyflagsettings) также принимает `effortLevel: "ultracode"`, что включает его и устанавливает уровень усилий `xhigh`

689 699

690Форма `/effort ultracode off`, переключатель ползунка и сохранение ultracode включенным на уровнях усилий, отличных от `xhigh`, требуют Claude Code версии 2.1.284 или позже. До версии 2.1.284 включение ultracode устанавливало сеанс на усилия `xhigh`, выбор другого уровня отключал его, и ограничение усилий ниже `xhigh` делало его недоступным.700Форма `/effort ultracode off`, переключатель в ползунке и сохранение ultracode включённым на уровнях усилий, отличных от `xhigh`, требуют Claude Code версии 2.1.284 или позже. До версии 2.1.284 включение ultracode устанавливало для сессии уровень `xhigh`, выбор другого уровня отключал его, а ограничение усилий ниже `xhigh` делало его недоступным.

691 701

692Передача `ultracode` флагу `--effort` или значению Agent SDK `effortLevel` требует Claude Code версии 2.1.203 или позже. До версии 2.1.203 `--effort ultracode` печатал `Unknown --effort value 'ultracode'` и сеанс начинался с усилиями по умолчанию.702Передача `ultracode` во флаг `--effort` или в значение Agent SDK `effortLevel` требует Claude Code версии 2.1.203 или позже. До версии 2.1.203 `--effort ultracode` выводил `Unknown --effort value 'ultracode'`, и сессия начиналась с уровнем усилий по умолчанию.

693 703

694Сохраненный параметр `effortLevel` и переменная окружения `CLAUDE_CODE_EFFORT_LEVEL` не принимают `ultracode`. Если `CLAUDE_CODE_EFFORT_LEVEL` или [ограничение усилий](#organization-effort-limits) устанавливает уровень сеанса, ultracode остается включенным на этом уровне.704Сохраняемая настройка `effortLevel` и переменная окружения `CLAUDE_CODE_EFFORT_LEVEL` не принимают `ultracode`. Если `CLAUDE_CODE_EFFORT_LEVEL` или [ограничение усилий](#organization-effort-limits) задаёт уровень сессии, ultracode остаётся включённым на этом уровне.

695 705

696<span id="when-ultracode-is-available" />706<span id="when-ultracode-is-available" />

697 707

698Ultracode недоступен, когда:708Ultracode недоступен, когда:

699 709

700* [Рабочие процессы отключены](/docs/ru/workflows#turn-workflows-off)710* [Рабочие процессы отключены](/docs/ru/workflows#turn-workflows-off)

701* Модель не поддерживает усилия `xhigh`711* Модель не поддерживает уровень `xhigh`

702 712

703В этих случаях `--effort ultracode` запускает сеанс с отключенным ultracode, на наивысшем уровне усилий, который модель и любое ограничение позволяют, вплоть до `xhigh`.713В этих случаях `--effort ultracode` запускает сессию с отключённым ultracode на наивысшем уровне усилий, который допускают модель и любое ограничение, но не выше `xhigh`.

704 714

705<h4 id="choose-an-effort-level">715<h4 id="choose-an-effort-level">

706 Выбор уровня усилий716 Выбор уровня усилий

707</h4>717</h4>

708 718

709Каждый уровень торгует расходом токенов против возможности. Стандартный уровень подходит для большинства задач кодирования; регулируйте, когда вы хотите другой баланс.719Каждый уровень — это компромисс между расходом токенов и возможностями. Уровень по умолчанию подходит для большинства задач программирования; меняйте его, когда вам нужен другой баланс.

710 720

711| Уровень | Когда его использовать |721| Уровень | Когда его использовать |

712| :- | :- |722| :- | :- |

713| `low` | Быстрые обмены, где вы проверяете каждый результат, такие как мозговой штурм, первый набросок или небольшое изменение, такое как переименование |723| `low` | Быстрые обмены, где вы проверяете каждый результат, например мозговой штурм, первый набросок или небольшое изменение вроде переименования |

714| `medium` | Уровень по умолчанию на Opus 5.5, Sonnet 5.5 и Haiku 5.5. На Opus 5.5 и Sonnet 5.5 подходит для повседневной инженерной работы с чётко определёнными рамками, например реализации новой функции. На моделях с более высоким уровнем по умолчанию снижает расход токенов для работы, чувствительной к затратам, где можно пожертвовать частью интеллекта |724| `medium` | Уровень по умолчанию на Opus 5.5, Sonnet 5.5 и Haiku 5.5. На Opus 5.5 и Sonnet 5.5 подходит для повседневной инженерной работы с чётко определёнными рамками, например реализации новой функции. На моделях с более высоким уровнем по умолчанию снижает расход токенов для работы, чувствительной к затратам, где можно пожертвовать частью интеллекта |

715| `high` | Работа, где важна проверка или вероятны граничные случаи, например исправление ошибки в существующей кодовой базе. Уровень по умолчанию на всех моделях, кроме Opus 5.5, Sonnet 5.5, Haiku 5.5 и Opus 4.7 |725| `high` | Работа, где важна проверка или вероятны граничные случаи, например исправление ошибки в существующей кодовой базе. Уровень по умолчанию на всех моделях, кроме Opus 5.5, Sonnet 5.5, Haiku 5.5 и Opus 4.7 |

717| `max` | Сложные проблемы, которые вы хотите, чтобы Claude решил без вас, такие как поиск уязвимостей безопасности. `max` может показать убывающую отдачу и склонен к чрезмерному размышлению, поэтому протестируйте перед широким внедрением |727| `max` | Сложные проблемы, которые вы хотите, чтобы Claude проработал без вас, например поиск уязвимостей безопасности. `max` может давать убывающую отдачу и склонен к чрезмерному обдумыванию, поэтому протестируйте его перед широким внедрением |

718| `ultracode` | Параметр Claude Code, а не уровень: планирует [динамический рабочий процесс](/docs/ru/workflows) для каждой существенной задачи на любом уровне усилий |728| `ultracode` | Настройка Claude Code, а не уровень: планирует [динамический рабочий процесс](/docs/ru/workflows) для каждой существенной задачи на любом уровне усилий |

719 729

720В тестах на Opus 5.5 и Fable 5.1 Claude на более высоком уровне протестировал больше граничных случаев и проверил больше своей работы перед ответом. Он также сделал больше выборов самостоятельно. На более низком уровне Claude вернул начальную точку быстрее, что подходит для работы, где вы проверяете каждый результат и направляете следующий шаг. Чтобы увидеть одни и те же задачи, выполняемые на каждом уровне, прочитайте [Using Claude Code: Spending your effort](https://claude.dev/blog/spending-your-effort/) в блоге.730В тестах на Opus 5.5 и Fable 5.1 Claude на более высоком уровне проверял больше граничных случаев и больше перепроверял свою работу перед ответом. Он также принимал больше решений самостоятельно. На более низком уровне Claude быстрее возвращал отправную точку, что подходит для работы, где вы проверяете каждый результат и направляете следующий шаг. Чтобы увидеть, как одни и те же задачи выполняются на каждом уровне, прочитайте [Using Claude Code: Spending your effort](https://claude.dev/blog/spending-your-effort/) в блоге.

721 731

722Шкала усилий откалибрована для каждой модели, поэтому одно и то же имя уровня не представляет одно и то же базовое значение между моделями.732Шкала усилий откалибрована для каждой модели отдельно, поэтому одно и то же имя уровня не соответствует одному и тому же базовому значению у разных моделей.

723 733

724Opus 5.5 [по умолчанию имеет `medium`](#adjust-effort-level), на один уровень ниже стандарта Opus 5 в `high`. В тестировании Anthropic Opus 5.5 на `medium` соответствует или превосходит Opus 5 на `high` при оценке кодирования и работы со знаниями. На заданном уровне Opus 5.5 имеет тенденцию думать больше за ход, чем Opus 5. Когда вы переходите с Opus 5 на Opus 5.5, начните с `medium` вместо того, чтобы переносить уровень, который вы использовали на Opus 5. Чтобы протестировать уровни на вашей собственной работе, см. [Calibrate effort](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#calibrate-effort) в руководстве по подсказкам Opus 5.5.734Opus 5.5 [по умолчанию использует `medium`](#adjust-effort-level) — на один уровень ниже, чем `high` по умолчанию у Opus 5. В тестировании Anthropic Opus 5.5 на `medium` не уступает или превосходит Opus 5 на `high` в оценках по программированию и работе со знаниями. На одном и том же уровне Opus 5.5 обычно думает за ход больше, чем Opus 5. При переходе с Opus 5 на Opus 5.5 начните с `medium`, а не переносите уровень, который вы использовали на Opus 5. Чтобы протестировать уровни на своей работе, см. [Calibrate effort](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#calibrate-effort) в руководстве по составлению промптов для Opus 5.5.

725 735

726<h4 id="use-ultrathink-for-one-off-deep-reasoning">736<h4 id="use-ultrathink-for-one-off-deep-reasoning">

727 Использование ultrathink для одноразового глубокого рассуждения737 Использование ultrathink для разовых глубоких рассуждений

728</h4>738</h4>

729 739

730Включите `ultrathink` в любое место вашей подсказки, чтобы запросить более глубокое рассуждение на этом ходе без изменения параметра усилий сеанса. Claude Code распознает ключевое слово и добавляет встроенную инструкцию. Уровень усилий, отправленный в API, не изменяется. Claude Code передает другие фразы, такие как "think", "think hard" и "think more", как обычный текст подсказки и не распознает их как ключевые слова.740Включите `ultrathink` в любое место промпта, чтобы запросить более глубокие рассуждения на этом ходе, не меняя настройку усилий сессии. Claude Code распознаёт ключевое слово и добавляет инструкцию в контекст. Уровень усилий, отправляемый в API, не меняется. Другие фразы, такие как "think", "think hard" и "think more", Claude Code передаёт как обычный текст промпта и не распознаёт как ключевые слова.

731 741

732<h4 id="set-the-effort-level">742<h4 id="set-the-effort-level">

733 Установка уровня усилий743 Установка уровня усилий

734</h4>744</h4>

735 745

736Вы можете изменить усилия через любое из следующего:746Изменить уровень усилий можно любым из следующих способов:

737 747

738* **`/effort`**: запустите `/effort` без аргументов, чтобы открыть интерактивный ползунок, `/effort`, за которым следует имя уровня, чтобы установить его напрямую, или `/effort auto`, чтобы очистить сохраненный уровень для активной модели. Вы можете запустить его, пока Claude работает, и после подтверждения [предупреждения о кэше](/docs/ru/prompt-caching#changing-effort-level), если Claude Code показывает его, Claude Code применяет новый уровень к следующему запросу в ходе748* **`/effort`**: выполните `/effort` без аргументов, чтобы открыть интерактивный ползунок, `/effort` с именем уровня, чтобы задать его напрямую, или `/effort auto`, чтобы сбросить сохранённый уровень для активной модели. Команду можно выполнять, пока Claude работает, и после подтверждения [предупреждения о кэше](/docs/ru/prompt-caching#changing-effort-level), если Claude Code его показывает, Claude Code применяет новый уровень к следующему запросу в ходе

739* **В `/model`**: используйте клавиши со стрелками влево/вправо, чтобы отрегулировать ползунок усилий при выборе модели749* **В `/model`**: при выборе модели используйте клавиши со стрелками влево/вправо, чтобы отрегулировать ползунок усилий

740* **Флаг `--effort`**: передайте имя уровня, чтобы установить его для одного сеанса при запуске Claude Code750* **Флаг `--effort`**: передайте имя уровня при запуске Claude Code, чтобы задать его для одной сессии

741* **Переменная окружения**: установите `CLAUDE_CODE_EFFORT_LEVEL` на имя уровня или `auto`751* **Переменная окружения**: установите `CLAUDE_CODE_EFFORT_LEVEL` в имя уровня или `auto`

742* **Параметры**: установите уровень для каждой модели в [`modelSettings`](/docs/ru/settings-reference#modelsettings) или установите [`effortLevel`](/docs/ru/settings-reference#effortlevel) на `low`, `medium`, `high` или `xhigh` как стандартный для моделей без одного. `max` не принимается как уровень ни в одном ключе, и `ultracode` имеет свой собственный ключ [`ultracode`](/docs/ru/settings-reference#ultracode)752* **Настройки**: задайте уровень для отдельной модели в [`modelSettings`](/docs/ru/settings-reference#modelsettings) или установите [`effortLevel`](/docs/ru/settings-reference#effortlevel) в `low`, `medium`, `high` или `xhigh` как уровень по умолчанию для моделей без собственного уровня. `max` не принимается как уровень ни в одном из этих ключей, а у `ultracode` есть собственный ключ [`ultracode`](/docs/ru/settings-reference#ultracode)

743* **С подключенного устройства**: в сеансе [Remote Control](/docs/ru/remote-control#what-connected-devices-see) выберите уровень из управления усилиями на вашем телефоне или в браузере. Уровень применяется только к текущему сеансу. Требуется Claude Code версии 2.1.234 или позже753* **С подключённого устройства**: в сессии [Remote Control](/docs/ru/remote-control#what-connected-devices-see) выберите уровень в элементе управления усилиями на телефоне или в браузере. Уровень применяется только к текущей сессии. Требуется Claude Code версии 2.1.234 или позже

744* **Frontmatter skill и subagent**: установите `effort` в файле markdown [skill](/docs/ru/skills#frontmatter-reference) или [subagent](/docs/ru/sub-agents#supported-frontmatter-fields), чтобы переопределить уровень усилий при запуске этого skill или subagent754* **Frontmatter скиллов и субагентов**: задайте `effort` в markdown-файле [скилла](/docs/ru/skills#frontmatter-reference) или [субагента](/docs/ru/sub-agents#supported-frontmatter-fields), чтобы переопределить уровень усилий при работе этого скилла или субагента

745 755

746Frontmatter усилия применяются, когда этот skill или subagent активен, переопределяя уровень сеанса, но не переменную окружения. [`maxEffortLevel`](/docs/ru/settings-reference#maxeffortlevel) или [ограничение усилий организации](#organization-effort-limits) по-прежнему ограничивает уровень, на котором работает skill или subagent.756Уровень усилий из frontmatter применяется, когда этот скилл или субагент активен, и переопределяет уровень сессии, но не переменную окружения. [`maxEffortLevel`](/docs/ru/settings-reference#maxeffortlevel) или [ограничение усилий организации](#organization-effort-limits) по-прежнему ограничивают уровень, на котором работает скилл или субагент.

747 757

748Если вы установите `effortLevel` в [управляемых параметрах](/docs/ru/managed-settings), Claude Code применяет его на этапе параметров [порядка разрешения усилий](#adjust-effort-level), и пользователи все еще могут изменять уровень с помощью `/effort` или `--effort`. Чтобы держать пользователей на или ниже уровня, установите [`maxEffortLevel`](/docs/ru/settings-reference#maxeffortlevel).758Если вы задаёте `effortLevel` в [управляемых настройках](/docs/ru/managed-settings), Claude Code применяет его на шаге настроек [порядка разрешения усилий](#adjust-effort-level), и пользователи по-прежнему могут менять уровень с помощью `/effort` или `--effort`. Чтобы пользователи не превышали определённый уровень, задайте [`maxEffortLevel`](/docs/ru/settings-reference#maxeffortlevel).

749 759

750Ползунок усилий появляется в `/model`, когда выбрана поддерживаемая модель. Текущий уровень усилий также показывается в заголовке сеанса рядом с именем модели, например "with low effort", поэтому вы можете подтвердить, какой параметр активен, без открытия `/model`. Нижний колонтитул также кратко показывает уровень усилий при запуске и при его изменении.760Ползунок усилий появляется в `/model`, когда выбрана поддерживаемая модель. Текущий уровень усилий также показывается в заголовке сессии рядом с именем модели, например "with low effort", поэтому вы можете проверить, какая настройка активна, не открывая `/model`. Нижняя строка также ненадолго показывает уровень усилий при запуске и при его изменении.

751 761

752<h4 id="adaptive-reasoning-and-fixed-thinking-budgets">762<h4 id="adaptive-reasoning-and-fixed-thinking-budgets">

753 Адаптивное рассуждение и фиксированные бюджеты размышления763 Адаптивные рассуждения и фиксированные бюджеты мышления

754</h4>764</h4>

755 765

756Адаптивное рассуждение делает размышление необязательным на каждом шаге, поэтому Claude может быстрее реагировать на обычные подсказки и зарезервировать более глубокое размышление для шагов, которые от него выигрывают. Если вы хотите, чтобы Claude думал чаще или реже, чем производит текущий уровень, вы можете сказать об этом прямо в своей подсказке или в `CLAUDE.md`; модель реагирует на это руководство в рамках своего параметра усилий.766Адаптивные рассуждения делают мышление необязательным на каждом шаге, поэтому Claude может быстрее отвечать на рутинные промпты и приберегать более глубокое мышление для шагов, которым оно полезно. Если вы хотите, чтобы Claude думал чаще или реже, чем при текущем уровне, можно сказать об этом прямо в промпте или в `CLAUDE.md`; модель учитывает такие указания в рамках своей настройки усилий.

757 767

758Модели Fable, Sonnet 5 и новее, Haiku 5.5, а также Opus 4.7 и новее всегда используют адаптивные рассуждения. Режим фиксированного бюджета мышления и `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` к ним не применяются.768Модели Fable, Sonnet 5 и новее, Haiku 5.5, а также Opus 4.7 и новее всегда используют адаптивные рассуждения. Режим фиксированного бюджета мышления и `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` к ним не применяются.

759 769

760На Opus 4.6 и Sonnet 4.6 вы можете установить `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1`, чтобы вернуться к предыдущему фиксированному бюджету размышления, контролируемому `MAX_THINKING_TOKENS`. См. [переменные окружения](/docs/ru/env-vars).770На Opus 4.6 и Sonnet 4.6 можно установить `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1`, чтобы вернуться к прежнему фиксированному бюджету мышления, управляемому `MAX_THINKING_TOKENS`. См. [переменные окружения](/docs/ru/env-vars).

761 771

762<h3 id="extended-thinking">772<h3 id="extended-thinking">

763 Extended thinking773 Расширенное мышление

764</h3>774</h3>

765 775

766Extended thinking — это рассуждение, которое Claude выдает перед ответом. На моделях, которые поддерживают [адаптивное рассуждение](#adjust-effort-level), уровень усилий является основным управлением тем, сколько размышления происходит; параметры ниже включают или отключают размышление и управляют тем, как оно отображается. С отключенным размышлением на Anthropic API Claude Code отправляет усилия `high` вместо более высокого уровня моделям, которые он знает [не принимают эту комбинацию](/docs/ru/errors#effort-isnt-available-with-thinking-turned-off), такие как Opus 5.776Расширенное мышление — это размышления, которые Claude выдаёт перед ответом. На моделях, поддерживающих [адаптивные рассуждения](#adjust-effort-level), основным регулятором объёма мышления является уровень усилий; настройки ниже включают или отключают мышление и управляют его отображением. Когда мышление отключено на Anthropic API, Claude Code отправляет уровень `high` вместо более высокого уровня моделям, которые, как ему известно, [не принимают такую комбинацию](/docs/ru/errors#effort-isnt-available-with-thinking-turned-off), например Opus 5.

767 777

768| Управление | Как его установить |778| Способ управления | Как его задать |

769| :- | :- |779| :- | :- |

771| Установка глобального стандартного | Запустите `/config` и переключите Thinking Mode. Сохранено как `alwaysThinkingEnabled` в `~/.claude/settings.json` |781| Установка глобального значения по умолчанию | Выполните `/config` и переключите режим мышления. Сохраняется как `alwaysThinkingEnabled` в `~/.claude/settings.json` |

772| Отключение через переменную окружения | Задайте [`MAX_THINKING_TOKENS=0`](/docs/ru/env-vars), что отключает мышление на Anthropic API, кроме Opus 5.5, Sonnet 5.5, Haiku 5.5 и моделей Fable. У [сторонних поставщиков](/docs/ru/third-party-integrations) Claude Code вместо этого опускает параметр `thinking`, и модели с адаптивными рассуждениями всё равно могут размышлять |782| Отключение через переменную окружения | Задайте [`MAX_THINKING_TOKENS=0`](/docs/ru/env-vars), что отключает мышление на Anthropic API, кроме Opus 5.5, Sonnet 5.5, Haiku 5.5 и моделей Fable. У [сторонних поставщиков](/docs/ru/third-party-integrations) Claude Code вместо этого опускает параметр `thinking`, и модели с адаптивными рассуждениями всё равно могут размышлять |

773 783

774Мышление нельзя отключить на Opus 5.5, Sonnet 5.5, Haiku 5.5 и моделях Fable. Переключатель сессии и строка в `/config` для этих моделей показывают `Thinking can't be turned off` вместо переключателя, а сохранённые `alwaysThinkingEnabled: false` или `MAX_THINKING_TOKENS=0` на них не действуют. На этих моделях модель сама решает на каждом шаге, сколько размышлять, исходя из уровня усилий. Сохранённая настройка снова начинает действовать, когда вы переключаетесь на модель, которая её поддерживает.784Мышление нельзя отключить на Opus 5.5, Sonnet 5.5, Haiku 5.5 и моделях Fable. Переключатель сессии и строка в `/config` для этих моделей показывают `Thinking can't be turned off` вместо переключателя, а сохранённые `alwaysThinkingEnabled: false` или `MAX_THINKING_TOKENS=0` на них не действуют. На этих моделях модель сама решает на каждом шаге, сколько размышлять, исходя из уровня усилий. Сохранённая настройка снова начинает действовать, когда вы переключаетесь на модель, которая её поддерживает.

775 785

776Claude Code сворачивает вывод размышления по умолчанию. Нажмите `Ctrl+O`, чтобы переключить подробный режим и увидеть рассуждение как серый курсивный текст. Интерактивные сеансы на Anthropic API получают отредактированные блоки размышления по умолчанию, поэтому установите `showThinkingSummaries: true` в [параметрах](/docs/ru/settings), если вы хотите, чтобы полные резюме были доступны при расширении. Вам выставляется счет за все сгенерированные токены размышления, даже когда они свернуты или отредактированы.786По умолчанию Claude Code сворачивает вывод размышлений. Нажмите `Ctrl+O`, чтобы переключить подробный режим и увидеть рассуждения серым курсивным текстом. Интерактивные сессии на Anthropic API по умолчанию получают скрытые блоки размышлений, поэтому установите `showThinkingSummaries: true` в [настройках](/docs/ru/settings), если хотите, чтобы при развороте были доступны полные резюме. Оплачиваются все сгенерированные токены мышления, даже если они свёрнуты или скрыты.

777 787

778<a id="extended-context-with-1m" />788<a id="extended-context-with-1m" />

779 789

790<span id="sonnet-5-5-and-sonnet-5-context-window" />

791

780<h3 id="extended-context">792<h3 id="extended-context">

781 Extended context793 Расширенный контекст

782</h3>794</h3>

783 795

784Fable 5.1, Fable 5, Sonnet 5 и новее, Haiku 5.5, Opus 4.6 и новее, а также Sonnet 4.6 поддерживают [контекстное окно в 1 миллион токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сессий с большими кодовыми базами.796Fable 5.1, Fable 5, Sonnet 5 и новее, Haiku 5.5, Opus 4.6 и новее, а также Sonnet 4.6 поддерживают [контекстное окно в 1 миллион токенов](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) для длительных сессий с большими кодовыми базами.

785 797

786На Anthropic API Fable 5.1, Fable 5, Sonnet 5 и новее, Haiku 5.5, а также Opus 4.7 и новее работают с окном 1M на любом тарифе, включая Pro. Для окна 1M на этих моделях не нужно выбирать вариант `[1m]` или включать кредиты использования. Само использование Fable на некоторых тарифах может оплачиваться из кредитов использования; см. [Fable и кредиты использования](#fable-and-usage-credits).798Fable 5.1, Fable 5, Sonnet 5 и новее, Haiku 5.5, а также Opus 4.7 и новее по умолчанию работают с окном 1M, и суффикс `[1m]` не нужен. Это относится и к сессиям на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, а также к сессиям [Claude apps gateway](/docs/ru/claude-apps-gateway). Чтобы вместо этого запускать их с окном 200K, см. [Отключение контекста 1M](#turn-off-1m-context).

787 799

788Opus 4.6 и Sonnet 4.6 достигают 1M только через их вариант `[1m]`, и доступ к этому варианту зависит от вашего плана. На планах Max, Team и Enterprise, включая как места Team Standard, так и Team Premium, Opus 4.6 с контекстом 1M включен в вашу подписку. Sonnet 4.6 с контекстом 1M требует [кредитов использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) на каждом плане подписки, включая Max.800Opus 4.6 и Sonnet 4.6 получают 1M только через свой вариант `[1m]`, и доступ к этому варианту зависит от вашего тарифа. На тарифах Max, Team и Enterprise, включая места как Team Standard, так и Team Premium, Opus 4.6 с контекстом 1M входит в вашу подписку. Sonnet 4.6 с контекстом 1M требует [кредитов использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) на любом тарифе подписки, включая Max.

789 801

791| - | - | - |803| - | - | - |

793| Pro | Требует [кредитов использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) | Требует [кредитов использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |805| Pro | Требует [кредитов использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) | Требует [кредитов использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

795 807

796Claude Code проверяет эти требования плана только при прямом подключении к Anthropic API. Если вы указываете `ANTHROPIC_BASE_URL` на [LLM gateway](/docs/ru/llm-gateway#subscriptions-and-gateways) и ваш сохраненный вход claude.ai остается активным учетным данным, Claude Code не проверяет кредиты использования вашего плана. Параметры `[1m]` остаются доступными в `/model`, и шлюз решает, успешен ли запрос. До версии 2.1.229 Claude Code отклонял `/model sonnet[1m]` в этой конфигурации, когда не мог подтвердить кредиты использования на учетной записи.808Claude Code проверяет эти требования тарифа, только когда подключается к Anthropic API напрямую. Если вы направляете `ANTHROPIC_BASE_URL` на [LLM-шлюз](/docs/ru/llm-gateway#subscriptions-and-gateways), а ваш сохранённый вход в claude.ai остаётся активными учётными данными, Claude Code не проверяет кредиты использования вашего тарифа. Варианты `[1m]` остаются доступными в `/model`, и шлюз решает, будет ли запрос успешным. До версии 2.1.229 Claude Code в такой конфигурации отклонял `/model sonnet[1m]`, если не мог подтвердить наличие кредитов использования в учётной записи.

~~797~~

798<span id="context-window-behind-a-gateway" />

~~799~~

800Если вы установите `ANTHROPIC_BASE_URL` на [LLM-шлюз](/docs/ru/llm-gateway) или другой прокси, Claude Code даёт каждой распознанной модели то же контекстное окно, что и на Anthropic API. Fable 5.1, Fable 5, Sonnet 5 и новее, Haiku 5.5, а также Opus 4.7 и новее получают окно 1M без необходимости выбирать вариант `[1m]`, а модель, которая получает 1M только через свой вариант `[1m]`, например Opus 4.6, без него работает с 200K. Claude Code не может обнаружить более низкий предел, установленный шлюзом или сервером за ним. Если ваш шлюз отклоняет запросы свыше 200K токенов, установите [`CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000`](/docs/ru/env-vars) в окружении, из которого запускается Claude Code, чтобы сессии на всех моделях [сжимались на этой границе](#set-the-auto-compact-window).

~~801~~

802Чтобы отключить контекст 1M, установите `CLAUDE_CODE_DISABLE_1M_CONTEXT=1`. Claude Code удаляет варианты модели 1M из средства выбора модели. На моделях с собственным окном 1M, таких как Sonnet 5 и модели Fable, он также рассматривает модель как имеющую окно контекста 200K:

803 809

804* С включенным auto-compaction сеансы компактируются на границе 200K через [auto-compaction](#set-the-auto-compact-window). Установка окна auto-compact выше 200K не снимает удержание, потому что Claude Code ограничивает это окно окном контекста модели.810На Anthropic API контекстное окно 1M использует стандартные цены модели без надбавки за токены сверх 200K, за исключением Haiku 5.5, который [стоит дороже на промптах длиннее 100K токенов](#haiku-5-5-context-window-and-pricing). На тарифах, где расширенный контекст входит в подписку, использование по-прежнему покрывается подпиской. На тарифах, где доступ к расширенному контексту предоставляется через кредиты использования, токены оплачиваются из кредитов.

805* С отключенным auto-compaction сеансы останавливаются на границе 200K с [ошибкой ограничения контекста](/docs/ru/errors#prompt-is-too-long) вместо компактирования.

806 811

807До версии 2.1.223 Claude Code удерживал только сеансы Sonnet 5, Opus 4.8 и Opus 5 на 200K. См. [переменные окружения](/docs/ru/env-vars).812<h4 id="select-1m-context-for-opus-4-6-or-sonnet-4-6">

~~808~~ 813 Выбор контекста 1M для Opus 4.6 или Sonnet 4.6

809Контекстное окно 1M использует стандартные цены модели без надбавки за токены сверх 200K, за исключением Haiku 5.5, который [стоит дороже на промптах длиннее 100K токенов](#haiku-5-5-context-window-and-pricing). На тарифах, где расширенный контекст входит в подписку, использование по-прежнему покрывается подпиской. На тарифах, где доступ к расширенному контексту предоставляется через кредиты использования, токены оплачиваются из кредитов.814</h4>

~~810~~

811Если ваша учетная запись поддерживает контекст 1M, параметр появляется в средстве выбора `/model` в последних версиях Claude Code. Если вы его не видите, перезагрузите сеанс, и на сторонних поставщиках проверьте, [закрепила ли ваша развертывание модель](#pin-models-for-third-party-deployments) с переменной `ANTHROPIC_DEFAULT_*_MODEL`.

812 815

813Вы также можете использовать суффикс `[1m]` с псевдонимами моделей или полными именами моделей:816Чтобы выбрать вариант 1M по имени, добавьте суффикс `[1m]` к псевдониму модели или полному имени модели:

814 817

815```text theme={null}818```text theme={null}

816# Используйте псевдоним opus[1m] или sonnet[1m]819# Добавьте [1m] к полному имени модели

817/model opus[1m]820/model claude-opus-4-6[1m]

818/model sonnet[1m]821/model claude-sonnet-4-6[1m]

819 822

820# Или добавьте [1m] к полному имени модели823# Или к псевдониму: суффикс применяется к модели, в которую разрешается псевдоним

821/model claude-opus-4-8[1m]824/model opus[1m]

822```825```

823 826

824<h4 id="sonnet-5-5-and-sonnet-5-context-window">827<span id="context-window-behind-a-gateway" />

825 Окно контекста Sonnet 5.5 и Sonnet 5828

829<h4 id="context-window-behind-an-llm-gateway">

830 Контекстное окно за LLM-шлюзом

826</h4>831</h4>

827 832

828На Anthropic API Sonnet 5.5 и Sonnet 5 всегда работают с окном контекста 1M. Нет варианта 200K, нет суффикса `[1m]` для выбора и нет требуемых кредитов использования ни на одном плане. Сеансы автоматически компактируются перед заполнением окна, примерно на 967K токенов по умолчанию; установите [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/ru/env-vars), чтобы выбрать другой порог.833Если вы установите `ANTHROPIC_BASE_URL` на [LLM-шлюз](/docs/ru/llm-gateway) или другой прокси, Claude Code даёт каждой распознанной модели то же контекстное окно, что и на Anthropic API. Fable 5.1, Fable 5, Sonnet 5 и новее, Haiku 5.5, а также Opus 4.7 и новее получают окно 1M без необходимости выбирать вариант `[1m]`, а модель, которая получает 1M только через свой вариант `[1m]`, например Opus 4.6, без него работает с 200K. Claude Code не может обнаружить более низкий предел, установленный шлюзом или сервером за ним. Если ваш шлюз отклоняет запросы свыше 200K токенов, установите [`CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000`](/docs/ru/env-vars) в окружении, из которого запускается Claude Code, чтобы сессии на всех моделях [сжимались на этой границе](#set-the-auto-compact-window).

829 834

830Claude Code дает Sonnet 5.5 и Sonnet 5 то же окно 1M позади [LLM gateway](/docs/ru/llm-gateway) или другого пользовательского `ANTHROPIC_BASE_URL`. Если ваш шлюз применяет более низкий предел, см. [окно контекста позади шлюза](#context-window-behind-a-gateway).835<h4 id="turn-off-1m-context">

836 Отключение контекста 1M

837</h4>

831 838

832Этот параметр бюджетирует окно на 200K вместо этого:839Чтобы сессии оставались в окне 200K, установите `CLAUDE_CODE_DISABLE_1M_CONTEXT=1` в оболочке или в [файле настроек](/docs/ru/env-vars#set-environment-variables). Claude Code удаляет варианты моделей `[1m]` из средства выбора модели. На моделях, которые по умолчанию работают с окном 1M, таких как модели Fable, Sonnet 5 и новее, а также Opus 4.7 и новее, он также рассматривает модель как имеющую контекстное окно 200K:

833 840

834* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**: удерживает сеансы на каждой модели с собственным окном 1M на окне 200K; см. [Extended context](#extended-context) для того, как удержание применяется. Полезно для развертываний, которым нужно ограничить контекст.841* При включённом автосжатии сессии сжимаются на границе 200K с помощью [автосжатия](#set-the-auto-compact-window). Установка окна автосжатия выше 200K не снимает это ограничение, потому что Claude Code ограничивает это окно контекстным окном модели.

842* При отключённом автосжатии сессии останавливаются на границе 200K с [ошибкой превышения контекста](/docs/ru/errors#prompt-is-too-long) вместо сжатия.

835 843

836<h4 id="haiku-5-5-context-window-and-pricing">844<h4 id="haiku-5-5-context-window-and-pricing">

837 Контекстное окно и цены Haiku 5.5845 Контекстное окно и цены Haiku 5.5

844По умолчанию сессии автоматически сжимаются примерно на 967K токенов. Чтобы сжатие происходило раньше, [задайте для модели меньшее окно автосжатия](#set-the-auto-compact-window).852По умолчанию сессии автоматически сжимаются примерно на 967K токенов. Чтобы сжатие происходило раньше, [задайте для модели меньшее окно автосжатия](#set-the-auto-compact-window).

845 853

846<h2 id="context-window-and-auto-compaction">854<h2 id="context-window-and-auto-compaction">

847 Контекстное окно и auto-compact855 Контекстное окно и автосжатие

848</h2>856</h2>

849 857

850Окно auto-compact определяет, насколько полным может быть контекстное окно перед тем, как Claude Code выполнит компактирование разговора. Информацию о том, что сохраняется и удаляется при каждом механизме компактирования, см. в разделе [What survives compaction](/docs/ru/context-window#what-survives-compaction).858Окно автосжатия определяет, насколько может заполниться контекстное окно, прежде чем Claude Code выполнит сжатие контекста диалога. Информацию о том, что сохраняется и что удаляется при каждом механизме, см. в разделе [Что сохраняется после сжатия контекста](/docs/ru/context-window#what-survives-compaction).

851 859

852<h3 id="set-the-auto-compact-window">860<h3 id="set-the-auto-compact-window">

853 Установка окна auto-compact861 Установка окна автосжатия

854</h3>862</h3>

855 863

856Задать окно автосжатия можно в следующих местах:864Задать окно автосжатия можно в следующих местах:

857 865

858* **Для текущей модели, в этой сессии и последующих**: выполните `/autocompact` со значением, например `/autocompact 500k`. Claude Code сохраняет его в ваших пользовательских настройках для текущей модели в [`modelSettings`](/docs/ru/settings-reference#modelsettings) и применяет к текущей сессии. Если [область действия настроек](/docs/ru/settings#settings-precedence) с более высоким приоритетом, например управляемые настройки, задаёт собственное окно для этой модели или для всех моделей, команда сохраняет ваше значение, но сессия использует окно этой области действия, и команда сообщает об этом. Выполните `/autocompact auto`, чтобы вернуться к окну, оптимизированному для вашей модели. До версии v2.1.288 команда сохраняла одно окно для всех моделей в виде ключа верхнего уровня `autoCompactWindow`.866* **Для текущей модели, в этой сессии и последующих**: выполните `/autocompact` со значением, например `/autocompact 500k`. Claude Code сохраняет его в ваших пользовательских настройках для текущей модели в [`modelSettings`](/docs/ru/settings-reference#modelsettings) и применяет к текущей сессии. Если [область действия настроек](/docs/ru/settings#settings-precedence) с более высоким приоритетом, например управляемые настройки, задаёт собственное окно для этой модели или для всех моделей, команда сохраняет ваше значение, но сессия использует окно этой области действия, и команда сообщает об этом. Выполните `/autocompact auto`, чтобы вернуться к окну, оптимизированному для вашей модели. До версии v2.1.288 команда сохраняла одно окно для всех моделей в виде ключа верхнего уровня `autoCompactWindow`.

859* **Для всех моделей**: задайте [`autoCompactWindow`](/docs/ru/settings-reference#autocompactwindow) в файле настроек, например `"autoCompactWindow": 200000` в `~/.claude/settings.json`. Окно, сохранённое для модели с помощью `/autocompact`, имеет приоритет над этим ключом в том же файле для этой модели.867* **Для всех моделей**: задайте [`autoCompactWindow`](/docs/ru/settings-reference#autocompactwindow) в файле настроек, например `"autoCompactWindow": 200000` в `~/.claude/settings.json`. Окно, сохранённое для модели с помощью `/autocompact`, имеет приоритет над этим ключом в том же файле для этой модели.

860* **Для одного запуска**: передайте [`--autocompact`](/docs/ru/cli-reference#cli-flags) при запуске Claude Code. Флаг переопределяет ваш сохранённый параметр для этого запуска без его изменения, и `claude --autocompact auto` запускает сеанс с оптимизированным окном, даже если ваш сохранённый параметр имеет значение. В отличие от `/autocompact`, флаг не переопределяется областью параметров с более высоким приоритетом, такой как управляемые параметры.868* **Для одного запуска**: передайте [`--autocompact`](/docs/ru/cli-reference#cli-flags) при запуске Claude Code. Флаг переопределяет вашу сохранённую настройку для этого запуска, не изменяя её, а `claude --autocompact auto` запускает сессию с оптимизированным окном, даже если в вашей сохранённой настройке задано значение. В отличие от `/autocompact`, флаг не вытесняется областью действия настроек с более высоким приоритетом, например управляемыми настройками.

861* **В скриптах и облачных окружениях**: установите [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/ru/env-vars). Пока она установлена, она имеет приоритет над командой, флагом и параметром, и `/autocompact` сообщает об переопределении вместо изменения окна.869* **В скриптах и облачных окружениях**: задайте [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/ru/env-vars). Пока эта переменная задана, она имеет приоритет над командой, флагом и настройкой, а `/autocompact` сообщает о переопределении вместо изменения окна.

862 870

863Команда и флаг принимают размер окна от 100K до 1M токенов в любой из этих форм:871Команда и флаг принимают размер окна от 100K до 1M токенов в любой из следующих форм:

864 872

865* Простой подсчёт токенов, например `200000`873* Простое количество токенов, например `200000`

866* Суффикс `k` или `M`, например `500k` или `1M`874* Суффикс `k` или `M`, например `500k` или `1M`

867* Простое число от 100 до 1000, означающее тысячи, поэтому `200` устанавливает 200 000875* Простое число от 100 до 1000, означающее тысячи, поэтому `200` задаёт 200 000

868 876

869Переменная окружения принимает только простой подсчёт токенов. Claude Code ограничивает окно контекстным окном модели.877Переменная окружения принимает только простое количество токенов. Claude Code ограничивает окно размером контекстного окна модели.

870 878

871<h3 id="default-auto-compact-thresholds">879<h3 id="default-auto-compact-thresholds">

872 Пороги auto-compact по умолчанию880 Пороги автосжатия по умолчанию

873</h3>881</h3>

874 882

875Если вы не установите окно auto-compact, Claude Code выполняет компактирование, когда разговор достигает предела контекста модели, за исключением этих сеансов:883Если вы не задали окно автосжатия, Claude Code выполняет сжатие контекста, когда диалог достигает предела контекста модели, за исключением следующих сессий:

876 884

877* [Cloud sessions](/docs/ru/claude-code-on-the-web) выполняют компактирование по мере приближения разговора к пределу модели885* [Облачные сессии](/docs/ru/claude-code-on-the-web) выполняют сжатие контекста по мере приближения диалога к пределу модели

878* Sonnet 4.6 и Opus 4.6 без [extended context](#extended-context) выполняют компактирование на границе 200K, как и Opus 4.8 и более поздние версии при работе с контекстным окном 200K, например на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry886* Sonnet 4.6 и Opus 4.6 без [расширенного контекста](#extended-context) выполняют сжатие контекста на границе 200K

879* Когда вы установите [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/env-vars), модели с собственным окном 1M, такие как Sonnet 5 и модели Fable, выполняют компактирование на границе 200K887* Когда вы задаёте [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/env-vars), модели с собственным окном 1M, такие как Sonnet 5 и модели Fable, выполняют сжатие контекста на границе 200K

880* Модели, работающие с собственным окном 1M, выполняют сжатие до заполнения окна, по умолчанию примерно на 967K токенов. В Anthropic API к ним относятся Sonnet 5, Haiku 5.5, модели Fable, а также Opus 4.7 и более поздние версии. Для Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry см. раздел [Закрепление моделей для сторонних развёртываний](#pin-models-for-third-party-deployments), чтобы узнать, какие модели работают с этим окном. При использовании пользовательского `ANTHROPIC_BASE_URL` см. раздел [контекстное окно за шлюзом](#context-window-behind-a-gateway)888* Модели, работающие с собственным окном 1M, выполняют сжатие контекста до заполнения окна, по умолчанию примерно на 967K токенов. К ним относятся модели Fable, Sonnet 5 и более поздние версии, Haiku 5.5, а также Opus 4.7 и более поздние версии. При использовании пользовательского `ANTHROPIC_BASE_URL` см. раздел [контекстное окно за шлюзом](#context-window-behind-a-gateway)

881* Сеансы на ID модели, которую Claude Code не распознаёт, такие как псевдоним [LLM gateway](/docs/ru/llm-gateway), выполняют компактирование при контекстном окне, которое Claude Code предполагает для ID; см. [Correct the window for a gateway or custom model ID](#correct-the-window-for-a-gateway-or-custom-model-id)889* Сессии с ID модели, который Claude Code не распознаёт, например псевдонимом [LLM-шлюза](/docs/ru/llm-gateway), выполняют сжатие контекста при контекстном окне, которое Claude Code предполагает для этого ID; см. [Исправление окна для шлюза или пользовательского ID модели](#correct-the-window-for-a-gateway-or-custom-model-id)

882 890

883<h3 id="correct-the-window-for-a-gateway-or-custom-model-id">891<h3 id="correct-the-window-for-a-gateway-or-custom-model-id">

884 Исправление окна для шлюза или пользовательского ID модели892 Исправление окна для шлюза или пользовательского ID модели

885</h3>893</h3>

886 894

887На [LLM gateway](/docs/ru/llm-gateway) или другом пользовательском развёртывании Claude Code может предполагать контекстное окно для ID модели, которое отличается от реального окна модели, независимо от того, разрешает ли оно ID в модель Claude. Установите [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](/docs/ru/env-vars) на окно, которое Claude Code должен предполагать вместо этого.895При использовании [LLM-шлюза](/docs/ru/llm-gateway) или другого пользовательского развёртывания Claude Code может предполагать для ID модели контекстное окно, которое отличается от реального окна модели, независимо от того, сопоставляет ли он ID с моделью Claude. Задайте в [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](/docs/ru/env-vars) окно, которое Claude Code должен предполагать вместо этого.

888 896

889Применение переменной зависит от ID. Claude Code рассматривает ID как поставщика или пользовательское написание, когда оно не начинается с `claude-`, в любом регистре, или когда оно содержит суффикс, который Claude Code удаляет при чтении ID, например дату `@YYYYMMDD`, используемую на Google Cloud's Agent Platform. До версии 2.1.259 Claude Code не учитывал удалённый суффикс, поэтому нераспознанный ID `claude-` с суффиксом даты рассматривался как простое имя `claude-`.897Применение переменной зависит от ID. Claude Code рассматривает ID как написание поставщика или пользовательское написание, если он не начинается с `claude-` (в любом регистре) или если он содержит суффикс, который Claude Code удаляет при чтении ID, например дату `@YYYYMMDD`, используемую в Google Cloud's Agent Platform. До версии v2.1.259 Claude Code не учитывал удалённый суффикс, поэтому нераспознанный ID `claude-` с суффиксом даты рассматривался как простое имя `claude-`.

890 898

891Нераспознанный поставщик или пользовательское написание, то же написание с `[1m]` и все остальные ID — это три отдельных случая:899Нераспознанное написание поставщика или пользовательское написание, то же написание с `[1m]` и все остальные ID — это три отдельных случая:

892 900

893* Если Claude Code не может разрешить поставщика или пользовательское написание в модель, которую он распознаёт, и ID не содержит `[1m]`, переменная применяется напрямую и упреждающее компактирование продолжается при объявленном окне.901* Если Claude Code не может сопоставить написание поставщика или пользовательское написание с распознаваемой моделью и ID не содержит `[1m]`, переменная применяется напрямую, и упреждающее сжатие контекста продолжается при объявленном окне.

894* Если Claude Code не может разрешить поставщика или пользовательское написание в модель, которую он распознаёт, и ID содержит `[1m]`, в любом регистре, Claude Code предполагает окно 1M для него и переменная не применяется самостоятельно. Чтобы исправить окно, сохраняя упреждающее компактирование, также установите [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/env-vars). С установленной переменной Claude Code размещает ID как то же написание без `[1m]`, поэтому `CLAUDE_CODE_MAX_CONTEXT_TOKENS` применяется, когда он применялся бы к этому неразмеченному написанию.902* Если Claude Code не может сопоставить написание поставщика или пользовательское написание с распознаваемой моделью и ID содержит `[1m]` (в любом регистре), Claude Code предполагает для него окно 1M, и переменная сама по себе не применяется. Чтобы исправить окно, сохранив упреждающее сжатие контекста, также задайте [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/env-vars). Когда эта переменная задана, Claude Code определяет размер для ID так же, как для того же написания без `[1m]`, поэтому `CLAUDE_CODE_MAX_CONTEXT_TOKENS` применяется в тех случаях, когда она применялась бы к этому написанию без метки.

895 903

896 С объявленным окном выше 200K Claude Code затем показывает [startup warning](/docs/ru/errors#the-200k-limit-isnt-enforced), что предел 200K не применяется. Предупреждение ожидается в этой конфигурации.904 Если объявленное окно превышает 200K, Claude Code затем показывает [предупреждение при запуске](/docs/ru/errors#the-200k-limit-isnt-enforced) о том, что предел 200K не применяется. В этой конфигурации такое предупреждение ожидаемо.

897* Если ID разрешается в модель, которую Claude Code распознаёт, или ID является простым именем `claude-` без суффикса для Claude Code, чтобы удалить его, в любом регистре, переменная вступает в силу только когда вы также установите [`DISABLE_COMPACT`](/docs/ru/env-vars), что отключает все компактирование.905* Если ID сопоставляется с моделью, которую Claude Code распознаёт, или ID является простым именем `claude-` без суффикса, который Claude Code мог бы удалить (в любом регистре), переменная вступает в силу, только если вы также задаёте [`DISABLE_COMPACT`](/docs/ru/env-vars), что отключает любое сжатие контекста.

898 906

899 Например, ID, который содержит имя модели Claude, которое Claude Code знает, такое как `anthropic/claude-opus-4-8`, `us.anthropic.claude-…-v1:0` или датированный `claude-sonnet-4-5@20250929`, разрешается в эту модель. Это включает ID, которые также содержат `[1m]`: Claude Code разрешает `claude-opus-4-8[1m]` в Opus 4.8 даже с установленным `CLAUDE_CODE_DISABLE_1M_CONTEXT`.907 Например, ID, содержащий известное Claude Code имя модели Claude, такой как `anthropic/claude-opus-4-8`, `us.anthropic.claude-…-v1:0` или датированный `claude-sonnet-4-5@20250929`, сопоставляется с этой моделью. Это относится и к ID, которые также содержат `[1m]`: Claude Code сопоставляет `claude-opus-4-8[1m]` с Opus 4.8 даже при заданной `CLAUDE_CODE_DISABLE_1M_CONTEXT`.

900 908

901Для ID модели, которую Claude Code не распознаёт, установите [`CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1`](/docs/ru/env-vars), чтобы Claude Code выполнял компактирование только после того, как API отклонит разговор с [too-long error Claude Code recognizes](/docs/ru/errors#prompt-is-too-long). Claude Code не запускает это восстановление, когда шлюз [rewrites the error](/docs/ru/llm-gateway-connect#troubleshoot-gateway-errors) на формулировку, которую Claude Code не распознаёт.909Для ID модели, который Claude Code не распознаёт, задайте [`CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1`](/docs/ru/env-vars), чтобы Claude Code выполнял сжатие контекста только после того, как API отклонит диалог с [ошибкой превышения длины, которую распознаёт Claude Code](/docs/ru/errors#prompt-is-too-long). Claude Code не выполняет это восстановление, если шлюз [переписывает текст ошибки](/docs/ru/llm-gateway-connect#troubleshoot-gateway-errors) в формулировку, которую Claude Code не распознаёт.

902 910

903<h2 id="checking-your-current-model">911<h2 id="checking-your-current-model">

904 Проверка вашей текущей модели912 Проверка вашей текущей модели

942 Переменные окружения950 Переменные окружения

943</h2>951</h2>

944 952

945Используйте следующие переменные окружения для управления именами моделей, на которые отображаются псевдонимы. Каждое значение должно быть полным именем модели или эквивалентным идентификатором для вашего поставщика API. Чтобы выбрать модель, на которой начинаются ваши сеансы, установите [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), которую эта таблица опускает.953Используйте следующие переменные окружения для управления именами моделей, на которые отображаются псевдонимы. Каждое значение должно быть полным именем модели или эквивалентным идентификатором для вашего поставщика API. Чтобы выбрать модель, на которой начинаются ваши сессии, установите [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), которую эта таблица опускает.

946 954

947| Переменная окружения | Описание |955| Переменная окружения | Описание |

948| - | - |956| - | - |

949| `ANTHROPIC_DEFAULT_FABLE_MODEL` | Модель для использования с `fable` и идентификатор модели, который Claude Code распознает как модель Fable для [автоматического переключения модели](#automatic-model-fallback) у сторонних поставщиков |957| `ANTHROPIC_DEFAULT_FABLE_MODEL` | Модель для использования с `fable` и идентификатор модели, который Claude Code распознаёт как модель Fable для [автоматического переключения на резервную модель](#automatic-model-fallback) у сторонних поставщиков |

952| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Модель для использования с `haiku` или [фоновая функциональность](/docs/ru/costs#background-token-usage) |960| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Модель для использования с `haiku` или [фоновая функциональность](/docs/ru/costs#background-token-usage) |

953| `CLAUDE_CODE_SUBAGENT_MODEL` | Модель по умолчанию для [подагентов](/docs/ru/sub-agents#choose-a-model), товарищей по [команде агентов](/docs/ru/agent-teams#specify-teammates-and-models) и агентов [workflow](/docs/ru/workflows), которым не назначена модель другим способом. Принимает псевдоним, такой как `haiku`, или полное имя модели. Модель для каждого вызова или поле `model` определения, включая `inherit`, имеет приоритет. Чтобы изменить это, установите [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/ru/sub-agents#run-every-subagent-on-one-model) |961| `CLAUDE_CODE_SUBAGENT_MODEL` | Модель по умолчанию для [субагентов](/docs/ru/sub-agents#choose-a-model), участников [команды агентов](/docs/ru/agent-teams#specify-teammates-and-models) и агентов [workflow](/docs/ru/workflows), которым не назначена модель другим способом. Принимает псевдоним, такой как `haiku`, или полное имя модели. Модель для каждого вызова или поле `model` определения, включая `inherit`, имеет приоритет. Чтобы изменить это, установите [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/ru/sub-agents#run-every-subagent-on-one-model) |

954 962

955У сторонних поставщиков [Настройка отображения и возможностей закреплённой модели](#customize-pinned-model-display-and-capabilities) описывает, что показывает строка закреплённой модели в средстве выбора `/model`.963У сторонних поставщиков [Настройка отображения и возможностей закреплённой модели](#customize-pinned-model-display-and-capabilities) описывает, что показывает строка закреплённой модели в средстве выбора `/model`.

956 964

963 971

964При развёртывании Claude Code через [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai), [Microsoft Foundry](/docs/ru/microsoft-foundry) или [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) закрепите версии моделей перед развёртыванием для пользователей.972При развёртывании Claude Code через [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai), [Microsoft Foundry](/docs/ru/microsoft-foundry) или [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) закрепите версии моделей перед развёртыванием для пользователей.

965 973

966Без закрепления Claude Code использует псевдонимы моделей, такие как `fable`, `opus`, `sonnet` и `haiku`, которые разрешаются в встроенный идентификатор модели по умолчанию для каждого поставщика. Этот идентификатор по умолчанию может отставать от последнего выпуска Anthropic, и модель, на которую он указывает, может быть ещё не включена в учётной записи пользователя. Когда идентификатор по умолчанию недоступен, пользователи Amazon Bedrock и Google Cloud's Agent Platform видят уведомление, и сеанс переключается на более раннюю версию модели по умолчанию или на модель Sonnet по умолчанию, когда идентификатор по умолчанию является моделью Opus и нет доступной версии Opus. Пользователи Microsoft Foundry видят ошибки вместо этого, потому что Microsoft Foundry не имеет эквивалентной проверки при запуске.974Без закрепления Claude Code использует псевдонимы моделей, такие как `fable`, `opus`, `sonnet` и `haiku`, которые разрешаются во встроенный идентификатор модели по умолчанию для каждого поставщика. Этот идентификатор по умолчанию может отставать от последнего выпуска Anthropic, и модель, на которую он указывает, может быть ещё не включена в учётной записи пользователя. Когда идентификатор по умолчанию недоступен, пользователи Amazon Bedrock и Google Cloud's Agent Platform видят уведомление, и сессия переключается на более раннюю версию модели по умолчанию или на модель Sonnet по умолчанию, когда идентификатор по умолчанию является моделью Opus и нет доступной версии Opus. Пользователи Microsoft Foundry вместо этого видят ошибки, потому что Microsoft Foundry не имеет эквивалентной проверки при запуске.

967 975

968На Amazon Bedrock и Google Cloud's Agent Platform пользователь, который запускает сеанс на конкретной версии Sonnet или Opus, например с помощью `--model`, `ANTHROPIC_MODEL` или параметра `model`, закрепляет эту версию как идентификатор по умолчанию сеанса для соответствующего псевдонима: проверка при запуске пропускает встроенный идентификатор по умолчанию, который она заменяет, и не показывает уведомление о переключении. До версии 2.1.211 проверка выполнялась и могла показать уведомление даже когда модель сеанса была явно настроена.976На Amazon Bedrock и Google Cloud's Agent Platform пользователь, который запускает сессию на конкретной версии Sonnet или Opus, например с помощью `--model`, `ANTHROPIC_MODEL` или настройки `model`, закрепляет эту версию как идентификатор по умолчанию сессии для соответствующего псевдонима: проверка при запуске пропускает встроенный идентификатор по умолчанию, который она заменяет, и не показывает уведомление о переключении. До версии 2.1.211 проверка выполнялась и могла показать уведомление, даже когда модель сессии была явно настроена.

969 977

970<Warning>978<Warning>

971 Установите переменные окружения модели на конкретные идентификаторы версий как часть вашей начальной настройки. Закрепление позволяет вам контролировать, когда ваши пользователи переходят на новую модель.979 Установите переменные окружения модели на конкретные идентификаторы версий как часть вашей начальной настройки. Закрепление позволяет вам контролировать, когда ваши пользователи переходят на новую модель.

981 989

982Применяйте тот же шаблон для `ANTHROPIC_DEFAULT_FABLE_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` и `ANTHROPIC_DEFAULT_HAIKU_MODEL`. Для текущих и устаревших идентификаторов моделей у всех поставщиков см. [Обзор моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Чтобы обновить пользователей до новой версии модели, обновите эти переменные окружения и переразверните.990Применяйте тот же шаблон для `ANTHROPIC_DEFAULT_FABLE_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` и `ANTHROPIC_DEFAULT_HAIKU_MODEL`. Для текущих и устаревших идентификаторов моделей у всех поставщиков см. [Обзор моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Чтобы обновить пользователей до новой версии модели, обновите эти переменные окружения и переразверните.

983 991

984Чтобы включить [расширенный контекст](#extended-context) для закреплённой модели, добавьте `[1m]` к идентификатору модели в `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` или `ANTHROPIC_DEFAULT_FABLE_MODEL`:992Закреплённая модель с нативным окном 1M, такая как Opus 4.8 или Sonnet 5, работает с [контекстным окном 1M](#extended-context) без какого-либо суффикса, когда Claude Code может сопоставить закреплённый идентификатор с этой моделью. Идентификатор совпадает, когда он содержит идентификатор модели в Anthropic API, как `us.anthropic.claude-opus-4-8` содержит `claude-opus-4-8`, или когда запись [`modelOverrides`](#override-model-ids-per-version) отображает модель на него. Для закреплённого идентификатора, который Claude Code не может сопоставить с моделью, сессии по умолчанию работают с окном 200K, если идентификатор не содержит суффикс `[1m]`.

993

994Для модели, которая достигает 1M через свой вариант `[1m]`, такой как Opus 4.6 или Sonnet 4.6, включите расширенный контекст, добавив `[1m]` к идентификатору модели в `ANTHROPIC_DEFAULT_OPUS_MODEL` или `ANTHROPIC_DEFAULT_SONNET_MODEL`:

985 995

986```bash theme={null}996```bash theme={null}

987export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8[1m]'997export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-6[1m]'

988```998```

989 999

990С суффиксом `[1m]` окно контекста 1M применяется ко всему использованию закреплённого псевдонима, включая фазу Opus в режиме плана [`opusplan`](#opusplan-model-setting) и [подагентов](/docs/ru/sub-agents#choose-a-model), чьё frontmatter `model` называет псевдоним.1000С суффиксом `[1m]` контекстное окно 1M применяется ко всему использованию закреплённого псевдонима, включая фазу Opus в режиме планирования [`opusplan`](#opusplan-model-setting) и [субагентов](/docs/ru/sub-agents#choose-a-model), чьё frontmatter `model` называет псевдоним.

991 1001

992* Claude Code удаляет суффикс перед отправкой идентификатора модели вашему поставщику.1002* Claude Code удаляет суффикс перед отправкой идентификатора модели вашему поставщику.

993* Добавляйте `[1m]` только когда базовая модель [поддерживает контекст 1M](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model).1003* Добавляйте `[1m]` только когда базовая модель [поддерживает контекст 1M](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model).

994* Суффикс читается для каждой переменной, а не для каждой модели. На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry идентификатор модели без `[1m]` в одной переменной использует контекст 200K даже если другая переменная устанавливает ту же модель с суффиксом. Sonnet 5 всегда работает с окном 1M на этих поставщиках и никогда не требует суффикса.1004* Суффикс читается для каждой переменной, а не для каждой модели. На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry идентификатор Opus 4.6 или Sonnet 4.6 без `[1m]` в одной переменной использует контекст 200K, даже если другая переменная устанавливает ту же модель с суффиксом.

995 1005

996Когда вы устанавливаете переменную `ANTHROPIC_DEFAULT_*_MODEL`, средство выбора `/model` показывает одну строку для этой модели вместо встроенных строк семейства, включая любые строки контекста 1M. Чтобы достичь окна 1M без добавления суффикса к этой переменной, ваши пользователи запускают `/model opus[1m]`, и Claude Code применяет суффикс к модели, которую называет переменная. `/model sonnet[1m]` работает так же.1006Когда вы устанавливаете переменную `ANTHROPIC_DEFAULT_*_MODEL`, средство выбора `/model` показывает одну строку для этой модели вместо встроенных строк семейства, включая любые строки контекста 1M. Чтобы достичь окна 1M без добавления суффикса к этой переменной, ваши пользователи запускают `/model opus[1m]`, и Claude Code применяет суффикс к модели, которую называет переменная. `/model sonnet[1m]` работает так же.

997 1007

998<Note>1008<Note>

999 Список разрешений `availableModels`, доставленный через [MDM или управляемый файл параметров](/docs/ru/managed-settings#delivery-mechanisms), по-прежнему применяется при использовании сторонних поставщиков; [параметры, управляемые сервером, не доставляются туда](/docs/ru/server-managed-settings#platform-availability).1009 Список разрешённых моделей `availableModels`, доставленный через [MDM или файл управляемых настроек](/docs/ru/managed-settings#delivery-mechanisms), по-прежнему применяется при использовании сторонних поставщиков; [настройки, управляемые сервером, туда не доставляются](/docs/ru/server-managed-settings#platform-availability).

1000 1010

1001 Фильтрация соответствует псевдониму модели, такому как `opus`, префиксу версии, такому как `claude-opus-4-8`, или полному идентификатору модели в форме поставщика. Префиксы, специфичные для поставщика, такие как `us.anthropic.`, не удаляются, поэтому чтобы разрешить конкретную модель, укажите её полный идентификатор в форме поставщика или отобразите её через [`modelOverrides`](#override-model-ids-per-version). Для закреплённой модели этот идентификатор является значением, которое вы установили в её переменной `ANTHROPIC_DEFAULT_*_MODEL`. Любой суффикс `[1m]` удаляется из записи списка разрешений и запрошенной модели перед сопоставлением.1011 Фильтрация соответствует псевдониму модели, такому как `opus`, префиксу версии, такому как `claude-opus-4-8`, или полному идентификатору модели в форме поставщика. Префиксы, специфичные для поставщика, такие как `us.anthropic.`, не удаляются, поэтому чтобы разрешить конкретную модель, укажите её полный идентификатор в форме поставщика или отобразите её через [`modelOverrides`](#override-model-ids-per-version). Для закреплённой модели этот идентификатор является значением, которое вы установили в её переменной `ANTHROPIC_DEFAULT_*_MODEL`. Любой суффикс `[1m]` удаляется из записи списка разрешённых моделей и запрошенной модели перед сопоставлением.

1002</Note>1012</Note>

1003 1013

1004<h3 id="customize-pinned-model-display-and-capabilities">1014<h3 id="customize-pinned-model-display-and-capabilities">

1007 1017

1008Когда вы закрепляете модель у стороннего поставщика, её строка в средстве выбора `/model` показывает имя модели по умолчанию, если Claude Code распознаёт закреплённый идентификатор, и необработанный идентификатор в противном случае:1018Когда вы закрепляете модель у стороннего поставщика, её строка в средстве выбора `/model` показывает имя модели по умолчанию, если Claude Code распознаёт закреплённый идентификатор, и необработанный идентификатор в противном случае:

1009 1019

1010* **Распознана**: точный идентификатор модели, которую Claude Code знает, такой как её идентификатор Anthropic API или форма вашего поставщика или шлюза, с суффиксом `[1m]` или без него. Закрепите `us.anthropic.claude-sonnet-4-5-20250929-v1:0` и строка будет читаться как `Sonnet 4.5`.1020* **Распознана**: точный идентификатор модели, которую Claude Code знает, такой как её идентификатор Anthropic API или форма вашего поставщика или шлюза, с суффиксом `[1m]` или без него. Закрепите `us.anthropic.claude-sonnet-4-5-20250929-v1:0`, и строка будет читаться как `Sonnet 4.5`.

1011* **Не распознана**: любой другой идентификатор, такой как ARN профиля вывода приложения или версия модели, которую Claude Code не знает, если только запись [`modelOverrides`](#override-model-ids-per-version) не отображает модель на эту точную строку. На Microsoft Foundry имена развёртываний определяются пользователем, поэтому Claude Code никогда не распознаёт закреплённый идентификатор там, отображённый или нет, и строка показывает имя развёртывания по умолчанию.1021* **Не распознана**: любой другой идентификатор, такой как ARN профиля вывода приложения или версия модели, которую Claude Code не знает, если только запись [`modelOverrides`](#override-model-ids-per-version) не отображает модель на эту точную строку. На Microsoft Foundry имена развёртываний определяются пользователем, поэтому Claude Code никогда не распознаёт закреплённый идентификатор там, отображённый или нет, и строка показывает имя развёртывания по умолчанию.

1012 1022

1013Когда строка показывает имя модели, её описание по умолчанию включает закреплённый идентификатор, чтобы вы всё ещё могли видеть, какой идентификатор закреплён.1023Когда строка показывает имя модели, её описание по умолчанию включает закреплённый идентификатор, чтобы вы всё ещё могли видеть, какой идентификатор закреплён.

1014 1024

1015Claude Code также может не распознать, какие функции поддерживает закреплённая модель. Вы можете установить имя отображения и описание самостоятельно и объявить возможности с помощью переменных окружения-спутников для каждой закреплённой модели.1025Claude Code также может не распознать, какие функции поддерживает закреплённая модель. Вы можете установить имя отображения и описание самостоятельно и объявить возможности с помощью переменных окружения-спутников для каждой закреплённой модели.

1016 1026

1017Эти переменные вступают в силу у сторонних поставщиков, таких как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. Переменные `_NAME` и `_DESCRIPTION` также вступают в силу, когда `ANTHROPIC_BASE_URL` указывает на [LLM gateway](/docs/ru/llm-gateway). Они не имеют эффекта при прямом подключении к `api.anthropic.com`.1027Эти переменные вступают в силу у сторонних поставщиков, таких как Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. Переменные `_NAME` и `_DESCRIPTION` также вступают в силу, когда `ANTHROPIC_BASE_URL` указывает на [LLM-шлюз](/docs/ru/llm-gateway). Они не имеют эффекта при прямом подключении к `api.anthropic.com`.

1018 1028

1019| Переменная окружения | Описание |1029| Переменная окружения | Описание |

1020| - | - |1030| - | - |

1037 1047

1038Когда `_SUPPORTED_CAPABILITIES` установлена, Claude Code включает перечисленные возможности и отключает неперечисленные для соответствующей закреплённой модели. Когда переменная не установлена, Claude Code возвращается к встроенному обнаружению на основе идентификатора модели.1048Когда `_SUPPORTED_CAPABILITIES` установлена, Claude Code включает перечисленные возможности и отключает неперечисленные для соответствующей закреплённой модели. Когда переменная не установлена, Claude Code использует как резервный вариант встроенное обнаружение на основе идентификатора модели.

1039 1049

1040Этот пример закрепляет Opus на пользовательский ARN модели Amazon Bedrock, устанавливает понятное имя и объявляет его возможности:1050Этот пример закрепляет Opus на пользовательский ARN модели Amazon Bedrock, устанавливает понятное имя и объявляет его возможности:

1041 1051

1050 Переопределение идентификаторов моделей для каждой версии1060 Переопределение идентификаторов моделей для каждой версии

1051</h3>1061</h3>

1052 1062

1053На платформах, которые встраивают Claude Code и устанавливают [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ru/env-vars), конфигурация модели хоста имеет приоритет над управляемыми параметрами модели, в то время как управляемый список разрешений `availableModels` остаётся в силе, если только хост не предоставляет свой собственный; [Исключения из приоритета управляемых параметров](/docs/ru/settings#exceptions-to-managed-settings-precedence) говорит, какие ключи и переменные переопределяет хост.1063На платформах, которые встраивают Claude Code и устанавливают [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ru/env-vars), конфигурация модели хоста имеет приоритет над управляемыми настройками модели, в то время как управляемый список разрешённых моделей `availableModels` остаётся в силе, если только хост не предоставляет свой собственный; [Исключения из приоритета управляемых настроек](/docs/ru/settings#exceptions-to-managed-settings-precedence) указывает, какие ключи и переменные переопределяет хост.

1054 1064

1055Переменные окружения уровня семейства выше настраивают один идентификатор модели для каждого псевдонима семейства. Если вам нужно отобразить несколько версий в одном семействе на различные идентификаторы поставщика, используйте вместо этого параметр `modelOverrides`.1065Переменные окружения уровня семейства выше настраивают один идентификатор модели для каждого псевдонима семейства. Если вам нужно отобразить несколько версий в одном семействе на различные идентификаторы поставщика, используйте вместо этого настройку `modelOverrides`.

1056 1066

1057`modelOverrides` отображает отдельные идентификаторы моделей Anthropic на строки, специфичные для поставщика, которые Claude Code отправляет API вашего поставщика. Когда пользователь выбирает отображённую модель в средстве выбора `/model`, Claude Code использует ваше настроенное значение вместо встроенного значения по умолчанию.1067`modelOverrides` отображает отдельные идентификаторы моделей Anthropic на строки, специфичные для поставщика, которые Claude Code отправляет API вашего поставщика. Когда пользователь выбирает отображённую модель в средстве выбора `/model`, Claude Code использует ваше настроенное значение вместо встроенного значения по умолчанию.

1058 1068

1059Это позволяет администраторам предприятия маршрутизировать каждую версию модели на конкретный ARN профиля вывода приложения Amazon Bedrock, имя версии Google Cloud's Agent Platform или имя развёртывания Microsoft Foundry для управления, распределения затрат или региональной маршрутизации.1069Это позволяет администраторам предприятия маршрутизировать каждую версию модели на конкретный ARN профиля вывода приложения Amazon Bedrock, имя версии Google Cloud's Agent Platform или имя развёртывания Microsoft Foundry для управления, распределения затрат или региональной маршрутизации.

1060 1070

1061Установите `modelOverrides` в вашем [файле параметров](/docs/ru/settings#where-settings-live):1071Установите `modelOverrides` в вашем [файле настроек](/docs/ru/settings#where-settings-live):

1062 1072

1063```json theme={null}1073```json theme={null}

1064{1074{

1072 1082

1073Ключи должны быть идентификаторами моделей Anthropic, как указано в [Обзоре моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Для датированных идентификаторов моделей включите суффикс даты точно так, как он там появляется. Неизвестные ключи игнорируются.1083Ключи должны быть идентификаторами моделей Anthropic, как указано в [Обзоре моделей](https://platform.claude.com/docs/en/about-claude/models/overview). Для датированных идентификаторов моделей включите суффикс даты точно так, как он там появляется. Неизвестные ключи игнорируются.

1074 1084

1075Чтобы остановить [диагностическую строку](/docs/ru/errors#unrecognized-model-id-on-a-request) `[claude-code:unrecognized_model]` для идентификатора, такого как псевдоним шлюза, добавьте запись с этим идентификатором в качестве его значения.1085Чтобы остановить [диагностическую строку](/docs/ru/errors#unrecognized-model-id-on-a-request) `[claude-code:unrecognized_model]` для идентификатора, такого как псевдоним шлюза, добавьте запись с этим идентификатором в качестве её значения.

1076 1086

1077Переопределения заменяют встроенные идентификаторы моделей, которые поддерживают каждую запись в средстве выбора `/model`. На Amazon Bedrock записи `modelOverrides` имеют приоритет над любыми профилями вывода, которые Claude Code автоматически обнаруживает при запуске. Claude Code передаёт значения, которые уже являются собственными для поставщика, такие как ARN профиля вывода приложения Amazon Bedrock или имена развёртываний Microsoft Foundry, поставщику как есть.1087Переопределения заменяют встроенные идентификаторы моделей, которые стоят за каждой записью в средстве выбора `/model`. На Amazon Bedrock записи `modelOverrides` имеют приоритет над любыми профилями вывода, которые Claude Code автоматически обнаруживает при запуске. Claude Code передаёт значения, которые уже являются собственными для поставщика, такие как ARN профиля вывода Amazon Bedrock или имена развёртываний Microsoft Foundry, поставщику как есть.

1078 1088

1079Переопределения также применяются, когда вы передаёте идентификатор модели Anthropic непосредственно через `--model`, переменную окружения `ANTHROPIC_MODEL` или переменную окружения `ANTHROPIC_DEFAULT_*_MODEL`. На Amazon Bedrock, Google Cloud's Agent Platform и [Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint), идентификатор модели Anthropic без записи `modelOverrides` разрешается на тот же идентификатор, специфичный для поставщика, что и строка средства выбора `/model` для этой версии, когда поставщик поддерживает эту версию. Mantle поддерживает подмножество версий. Для идентификатора модели Anthropic вне этого подмножества Claude Code отправляет необработанный идентификатор Mantle без отображения, если только запись `modelOverrides` не охватывает его. До версии 2.1.200 `--model` и значения переменных окружения достигали поставщика как есть без прохождения через карту переопределений.1089Переопределения также применяются, когда вы передаёте идентификатор модели Anthropic непосредственно через `--model`, переменную окружения `ANTHROPIC_MODEL` или переменную окружения `ANTHROPIC_DEFAULT_*_MODEL`. На Amazon Bedrock, Google Cloud's Agent Platform и [Mantle](/docs/ru/amazon-bedrock#use-the-mantle-endpoint) идентификатор модели Anthropic без записи `modelOverrides` разрешается в тот же идентификатор, специфичный для поставщика, что и строка средства выбора `/model` для этой версии, когда поставщик поддерживает эту версию. Mantle поддерживает подмножество версий. Для идентификатора модели Anthropic вне этого подмножества Claude Code отправляет необработанный идентификатор в Mantle без отображения, если только запись `modelOverrides` не охватывает его. До версии 2.1.200 `--model` и значения переменных окружения достигали поставщика как есть, без прохождения через карту переопределений.

1080 1090

1081`modelOverrides` работает вместе с `availableModels`. Список разрешений оценивается по идентификатору модели Anthropic, а не по значению переопределения, поэтому запись, такая как `"opus"` в `availableModels`, продолжает соответствовать даже когда версии Opus отображаются на ARN. Когда `enforceAvailableModels` установлена в управляемых параметрах, принудительный Default разрешается через `modelOverrides` из [управляемых параметров](/docs/ru/managed-settings#how-claude-code-combines-managed-sources) только. Отображение администратора, такое как версия, закреплённая на ARN профиля вывода, соблюдается в принудительном Default. Переопределения из параметров пользователя или проекта не влияют на него.1091`modelOverrides` работает вместе с `availableModels`. Список разрешённых моделей оценивается по идентификатору модели Anthropic, а не по значению переопределения, поэтому запись, такая как `"opus"` в `availableModels`, продолжает соответствовать, даже когда версии Opus отображаются на ARN. Когда `enforceAvailableModels` установлена в управляемых настройках, принудительный Default разрешается через `modelOverrides` только из [управляемых настроек](/docs/ru/managed-settings#how-claude-code-combines-managed-sources). Отображение администратора, такое как версия, закреплённая на ARN профиля вывода, соблюдается в принудительном Default. Переопределения из настроек пользователя или проекта не влияют на него.

1082 1092

1083Когда `availableModels` установлена в [управляемых параметрах](/docs/ru/managed-settings), только `modelOverrides` из управляемых параметров применяются к идентификатору модели Anthropic, переданному непосредственно через `--model` или переменные окружения выше. Claude Code игнорирует переопределения в параметрах пользователя или проекта для этих идентификаторов и никогда не разрешает идентификатор, который управляемый список исключает, через `modelOverrides` из любого источника параметров. Это ограничение источника управляемых параметров требует Claude Code версии 2.1.200 или позже. См. [Ограничение выбора модели](#restrict-model-selection) для того, как обрабатываются заблокированные идентификаторы.1093Когда `availableModels` установлена в [управляемых настройках](/docs/ru/managed-settings), к идентификатору модели Anthropic, переданному непосредственно через `--model` или переменные окружения выше, применяются только `modelOverrides` из управляемых настроек. Claude Code игнорирует переопределения в настройках пользователя или проекта для этих идентификаторов и никогда не разрешает идентификатор, который управляемый список исключает, через `modelOverrides` из любого источника настроек. Это ограничение источника управляемых настроек требует Claude Code версии 2.1.200 или более поздней. См. [Ограничение выбора модели](#restrict-model-selection), чтобы узнать, как обрабатываются заблокированные идентификаторы.

1084 1094

1085<h3 id="prompt-caching-configuration">1095<h3 id="prompt-caching-configuration">

1086 Конфигурация кэширования подсказок1096 Конфигурация кэширования промптов

1087</h3>1097</h3>

1088 1098

1089Claude Code автоматически использует [кэширование подсказок](/docs/ru/prompt-caching) для оптимизации производительности и снижения затрат. Вы можете отключить кэширование подсказок глобально или для конкретных уровней моделей:1099Claude Code автоматически использует [кэширование промптов](/docs/ru/prompt-caching) для оптимизации производительности и снижения затрат. Вы можете отключить кэширование промптов глобально или для конкретных уровней моделей:

1090 1100

1091| Переменная окружения | Описание |1101| Переменная окружения | Описание |

1092| - | - |1102| - | - |

1093| `DISABLE_PROMPT_CACHING` | Установите на `1`, чтобы отключить кэширование подсказок для всех моделей. Имеет приоритет над параметрами для каждой модели |1103| `DISABLE_PROMPT_CACHING` | Установите на `1`, чтобы отключить кэширование промптов для всех моделей. Имеет приоритет над настройками для каждой модели |

1094| `DISABLE_PROMPT_CACHING_HAIKU` | Установите на `1`, чтобы отключить кэширование подсказок для [модели Haiku по умолчанию](/docs/ru/prompt-caching#disable-prompt-caching) |1104| `DISABLE_PROMPT_CACHING_HAIKU` | Установите на `1`, чтобы отключить кэширование промптов для [модели Haiku по умолчанию](/docs/ru/prompt-caching#disable-prompt-caching) |

1095| `DISABLE_PROMPT_CACHING_SONNET` | Установите на `1`, чтобы отключить кэширование подсказок для [модели Sonnet по умолчанию](/docs/ru/prompt-caching#disable-prompt-caching) |1105| `DISABLE_PROMPT_CACHING_SONNET` | Установите на `1`, чтобы отключить кэширование промптов для [модели Sonnet по умолчанию](/docs/ru/prompt-caching#disable-prompt-caching) |

1096| `DISABLE_PROMPT_CACHING_OPUS` | Установите на `1`, чтобы отключить кэширование подсказок для [модели Opus по умолчанию](/docs/ru/prompt-caching#disable-prompt-caching) |1106| `DISABLE_PROMPT_CACHING_OPUS` | Установите на `1`, чтобы отключить кэширование промптов для [модели Opus по умолчанию](/docs/ru/prompt-caching#disable-prompt-caching) |

1098 1108

1099Чтобы выбрать TTL кэша для основного разговора и для подагентов отдельно, см. [выберите TTL самостоятельно](/docs/ru/prompt-caching#choose-the-ttl-yourself). Для того, что вызывает промах кэша, см. [Как Claude Code использует кэширование подсказок](/docs/ru/prompt-caching).1109Чтобы выбрать TTL кэша для основного диалога и для субагентов отдельно, см. [выберите TTL самостоятельно](/docs/ru/prompt-caching#choose-the-ttl-yourself). О том, что вызывает промах кэша, см. [Как Claude Code использует кэширование промптов](/docs/ru/prompt-caching).

1100 1110

1101<h2 id="version-history">1111<h2 id="version-history">

1102 История версий1112 История версий

model-config.md 2026-10-07 23:59 UTC to 2026-10-08 21:58 UTC

Конфигурация модели

Доступные модели

Псевдонимы моделей

Работа с Fable

Fable и кредиты использования

Установка вашей модели

Установка стандартной модели для новых сессий

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

Ограничение выбора модели

Охват поверхности

Поведение модели по умолчанию

Применение списка разрешений к модели Default

Управление моделью, на которой работают пользователи

Поведение слияния

Идентификаторы моделей Mantle

Блокировка конкретных моделей или версий

Ограничения модели организации

Модель по умолчанию для организации

Ограничения уровня усилий организации

Специальное поведение модели

Настройка модели `default`

Настройка модели `opusplan`

Цепочки резервных моделей

Автоматическое переключение на резервную модель

Уровень усилий после переключения на резервную модель

Проверка того, что вызвало переключение

Запрос перед переключением

Включение резервного варианта на Bedrock, Agent Platform и Foundry

Исследования безопасности и рабочие нагрузки в области биологии

Регулировка уровня усилий

Выбор уровня усилий

Использование ultrathink для разовых глубоких рассуждений

Установка уровня усилий

Адаптивные рассуждения и фиксированные бюджеты мышления

Расширенное мышление

Расширенный контекст

Выбор контекста 1M для Opus 4.6 или Sonnet 4.6

Контекстное окно за LLM-шлюзом

Отключение контекста 1M

Контекстное окно и цены Haiku 5.5

Контекстное окно и автосжатие

Установка окна автосжатия

Пороги автосжатия по умолчанию

Исправление окна для шлюза или пользовательского ID модели

Проверка вашей текущей модели

Добавление пользовательского варианта модели

Переменные окружения

Закрепление моделей для развёртываний у сторонних поставщиков

Настройка отображения и возможностей закреплённой модели

Переопределение идентификаторов моделей для каждой версии

Конфигурация кэширования промптов

История версий