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

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

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

Псевдоним модели
Имя модели
- Anthropic API: полное имя модели
- Bedrock: ARN профиля вывода
- Foundry: имя развертывания
- Vertex: имя версии

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

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

Псевдоним модели	Поведение
`default`	Рекомендуемый параметр модели в зависимости от типа вашей учетной записи
`sonnet`	Использует последнюю модель Sonnet (в настоящее время Sonnet 4.6) для ежедневных задач кодирования
`opus`	Использует последнюю модель Opus (в настоящее время Opus 4.6) для сложных задач рассуждения
`haiku`	Использует быструю и эффективную модель Haiku для простых задач
`sonnet[1m]`	Использует Sonnet с контекстным окном в 1 миллион токенов для длительных сеансов
`opus[1m]`	Использует Opus с контекстным окном в 1 миллион токенов для длительных сеансов
`opusplan`	Специальный режим, который использует `opus` во время режима плана, а затем переключается на `sonnet` для выполнения

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

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

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

Во время сеанса - Используйте /model <alias|name> для переключения моделей во время сеанса
При запуске - Запустите с claude --model <alias|name>
Переменная окружения - Установите ANTHROPIC_MODEL=<alias|name>
Параметры - Настройте постоянно в файле параметров, используя поле model.

Пример использования:

# Запустить с Opus
claude --model opus

# Переключиться на Sonnet во время сеанса
/model sonnet

Пример файла параметров:

{
    "permissions": {
        ...
    },
    "model": "opus"
}

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

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

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

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

Опция Default в средстве выбора модели не затрагивается availableModels. Она всегда остается доступной и представляет системное значение по умолчанию во время выполнения на основе уровня подписки пользователя. Даже с availableModels: [] пользователи все еще могут использовать Claude Code с моделью Default для своего уровня.

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

Для полного управления опытом работы с моделью используйте availableModels вместе с параметром model:

availableModels: ограничивает, на что пользователи могут переключаться
model: устанавливает явное переопределение модели, имеющее приоритет над Default

Этот пример гарантирует, что все пользователи работают на Sonnet 4.6 и могут выбирать только между Sonnet и Haiku:

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

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

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

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

Параметр модели `default`

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

Max и Team Premium: по умолчанию Opus 4.6
Pro и Team Standard: по умолчанию Sonnet 4.6
Enterprise: Opus 4.6 доступен, но не по умолчанию

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

Параметр модели `opusplan`

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

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

Это дает вам лучшее из обоих миров: превосходное рассуждение Opus для планирования и эффективность Sonnet для выполнения.

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

Уровни усилий управляют адаптивным рассуждением, которое динамически распределяет мышление на основе сложности задачи. Более низкие усилия работают быстрее и дешевле для простых задач, а более высокие усилия обеспечивают более глубокое рассуждение для сложных проблем. Три уровня сохраняются между сеансами: low, medium и high. Четвертый уровень, max, обеспечивает самое глубокое рассуждение без ограничений на расходование токенов, поэтому ответы медленнее и дороже, чем на high. max доступен только на Opus 4.6 и не сохраняется между сеансами, кроме как через переменную окружения CLAUDE_CODE_EFFORT_LEVEL. Opus 4.6 и Sonnet 4.6 по умолчанию используют среднее усилие. Это применяется ко всем поставщикам, включая Bedrock, Vertex AI и прямой доступ к API. Среднее усилие является рекомендуемым уровнем для большинства задач кодирования: оно балансирует скорость и глубину рассуждения, а более высокие уровни могут привести к тому, что модель будет переосмысливать рутинную работу. Зарезервируйте high или max для задач, которые действительно выигрывают от более глубокого рассуждения, таких как сложные проблемы отладки или сложные архитектурные решения. Для одноразового глубокого рассуждения без изменения параметра сеанса включите “ultrathink” в вашу подсказку, чтобы запустить высокое усилие для этого хода. Установка усилий:

/effort: запустите /effort low, /effort medium, /effort high или /effort max для изменения уровня, или /effort auto для сброса на значение по умолчанию модели
В /model: используйте клавиши со стрелками влево/вправо для регулировки ползунка усилий при выборе модели
Флаг --effort: передайте low, medium, high или max для установки уровня на один сеанс при запуске Claude Code
Переменная окружения: установите CLAUDE_CODE_EFFORT_LEVEL на low, medium, high, max или auto
Параметры: установите effortLevel в файле параметров на "low", "medium" или "high"
Frontmatter skill и subagent: установите effort в файле markdown skill или subagent для переопределения уровня усилий при запуске этого skill или subagent

Переменная окружения имеет приоритет над всеми другими методами, затем ваш настроенный уровень, затем значение по умолчанию модели. Frontmatter усилие применяется, когда этот skill или subagent активен, переопределяя уровень сеанса, но не переменную окружения. Усилие поддерживается на Opus 4.6 и Sonnet 4.6. Ползунок усилий появляется в /model при выборе поддерживаемой модели. Текущий уровень усилий также отображается рядом с логотипом и спиннером, например “with low effort”, поэтому вы можете подтвердить, какой параметр активен, без открытия /model. Чтобы отключить адаптивное рассуждение на Opus 4.6 и Sonnet 4.6 и вернуться к предыдущему фиксированному бюджету мышления, установите CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1. При отключении эти модели используют фиксированный бюджет, контролируемый MAX_THINKING_TOKENS. См. переменные окружения.

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

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

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

Чтобы полностью отключить контекст 1M, установите CLAUDE_CODE_DISABLE_1M_CONTEXT=1. Это удаляет варианты моделей 1M из средства выбора модели. См. переменные окружения. Контекстное окно 1M использует стандартное ценообразование модели без премии за токены сверх 200K. Для планов, где расширенный контекст включен в вашу подписку, использование остается покрытым вашей подпиской. Для планов, которые получают доступ к расширенному контексту через дополнительное использование, токены выставляются в счет дополнительного использования. Если ваша учетная запись поддерживает контекст 1M, опция появляется в средстве выбора модели (/model) в последних версиях Claude Code. Если вы его не видите, попробуйте перезагрузить сеанс. Вы также можете использовать суффикс [1m] с псевдонимами моделей или полными именами моделей:

# Используйте псевдоним opus[1m] или sonnet[1m]
/model opus[1m]
/model sonnet[1m]

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

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

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

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

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

Используйте ANTHROPIC_CUSTOM_MODEL_OPTION для добавления одной пользовательской записи в средство выбора /model без замены встроенных псевдонимов. Это полезно для развертываний шлюза LLM или тестирования идентификаторов моделей, которые Claude Code не указывает по умолчанию. Этот пример устанавливает все три переменные, чтобы сделать развертывание Opus с маршрутизацией через шлюз выбираемым:

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

Пользовательская запись появляется в нижней части средства выбора /model. ANTHROPIC_CUSTOM_MODEL_OPTION_NAME и ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION являются необязательными. Если они опущены, идентификатор модели используется как имя, а описание по умолчанию — Custom model (<model-id>). Claude Code пропускает валидацию для идентификатора модели, установленного в ANTHROPIC_CUSTOM_MODEL_OPTION, поэтому вы можете использовать любую строку, которую принимает ваша конечная точка API.

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

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

Переменная окружения	Описание
`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`	Модель для использования для subagents

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

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

При развертывании Claude Code через Bedrock, Vertex AI или Foundry закрепите версии моделей перед развертыванием для пользователей. Без закрепления Claude Code использует псевдонимы моделей (sonnet, opus, haiku), которые разрешаются в последнюю версию. Когда Anthropic выпускает новую модель, пользователи, чьи учетные записи не имеют включенной новой версии, будут молча сломаны.

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

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

Поставщик	Пример
Bedrock	`export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-6-v1'`
Vertex AI	`export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-6'`
Foundry	`export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-6'`

Применяйте тот же шаблон для ANTHROPIC_DEFAULT_SONNET_MODEL и ANTHROPIC_DEFAULT_HAIKU_MODEL. Для текущих и устаревших идентификаторов моделей во всех поставщиках см. Обзор моделей. Чтобы обновить пользователей до новой версии модели, обновите эти переменные окружения и переразверните. Чтобы включить расширенный контекст для закрепленной модели, добавьте [1m] к идентификатору модели в ANTHROPIC_DEFAULT_OPUS_MODEL или ANTHROPIC_DEFAULT_SONNET_MODEL:

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

Суффикс [1m] применяет контекстное окно 1M ко всему использованию этого псевдонима, включая opusplan. Claude Code удаляет суффикс перед отправкой идентификатора модели вашему поставщику. Добавляйте [1m] только когда базовая модель поддерживает контекст 1M, такая как Opus 4.6 или Sonnet 4.6.

Список разрешений settings.availableModels все еще применяется при использовании поставщиков третьих сторон. Фильтрация соответствует псевдониму модели (opus, sonnet, haiku), а не идентификатору модели, специфичному для поставщика.

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

Переменные окружения уровня семейства выше настраивают один идентификатор модели для каждого псевдонима семейства. Если вам нужно отобразить несколько версий в одном семействе на различные идентификаторы поставщика, используйте вместо этого параметр modelOverrides. modelOverrides отображает отдельные идентификаторы моделей Anthropic на строки, специфичные для поставщика, которые Claude Code отправляет API вашего поставщика. Когда пользователь выбирает отображаемую модель в средстве выбора /model, Claude Code использует ваше настроенное значение вместо встроенного значения по умолчанию. Это позволяет администраторам предприятия маршрутизировать каждую версию модели на конкретный ARN профиля вывода Bedrock, имя версии Vertex AI или имя развертывания Foundry для управления, распределения затрат или региональной маршрутизации. Установите modelOverrides в файле параметров:

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

Ключи должны быть идентификаторами моделей Anthropic, как указано в Обзоре моделей. Для датированных идентификаторов моделей включите суффикс даты точно так, как он там отображается. Неизвестные ключи игнорируются. Переопределения заменяют встроенные идентификаторы моделей, которые поддерживают каждую запись в средстве выбора /model. На Bedrock переопределения имеют приоритет над любыми профилями вывода, которые Claude Code автоматически обнаруживает при запуске. Значения, которые вы предоставляете непосредственно через ANTHROPIC_MODEL, --model или переменные окружения ANTHROPIC_DEFAULT_*_MODEL, передаются поставщику как есть и не преобразуются modelOverrides. modelOverrides работает вместе с availableModels. Список разрешений оценивается по идентификатору модели Anthropic, а не по значению переопределения, поэтому запись, такая как "opus" в availableModels, продолжает совпадать, даже когда версии Opus отображаются на ARN.

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

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 имеет приоритет над параметрами для каждой модели, позволяя вам быстро отключить все кэширование при необходимости. Параметры для каждой модели полезны для выборочного управления, например при отладке конкретных моделей или работе с облачными поставщиками, которые могут иметь различные реализации кэширования.

Конфигурация

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

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

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

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

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

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

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

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

​Параметр модели default

​Параметр модели opusplan

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

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

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

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

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

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

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

​Конфигурация кэширования подсказок

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

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

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

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

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

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

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

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

Параметр модели `default`

Параметр модели `opusplan`

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

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

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

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

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

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

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

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