· 8 мин · Руководства для разработчиков

Как изменить модель по умолчанию в Claude Code и новые хуки переключения моделей в 2.1.251

Как изменить модель по умолчанию в Claude Code и новые хуки переключения моделей в 2.1.251

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

Задайте модель Claude Code по умолчанию с помощью /model

Главное различие — между сохранением предпочтения и временным переключением моделей. По состоянию на 29 августа 2026 года /model уже поддерживал оба сценария.

В версии 2.1.153 изменилось поведение /model так, что выбранная модель сохраняется как модель по умолчанию для новых сессий. Такое поведение появилось до 2.1.251: августовский выпуск добавил хуки переключения моделей, а не возможность запоминать интерактивный выбор модели.

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

Сохраните предпочтение для будущих сессий

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

/model

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

Это самый ясный ответ на вопрос «Как сохранить предпочитаемую модель?», подтверждённый историческими источниками. Он не требует представлять функцию из более раннего выпуска как новую возможность 2.1.251.

Переключите модель только для текущей сессии

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

Это различие важно, если вы следуете старым инструкциям или поддерживаете собственные сочетания клавиш. Прежнее действие в меню выбора d стало s, а связанное с ним пользовательское сочетание клавиш изменилось с modelPicker:setAsDefault на modelPicker:thisSessionOnly.

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

Файлы настроек, ANTHROPIC_MODEL и переопределения при запуске

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

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

В следующей таблице документированные варианты отделены от того, что подтверждают датированные источники.

Способ настройки Сведения в предоставленных исследовательских материалах Историческая подтверждённость для этой статьи
Интерактивный /model выбор Сохраняет модель по умолчанию для новых сессий Подтверждено в журнале изменений до даты публикации
Действие в меню выбора s Переключает модель только для текущей сессии Подтверждено в журнале изменений до даты публикации
В файле настроек model ключ Постоянный параметр конфигурации Точная документация до даты публикации не проверена
ANTHROPIC_MODEL Выбор модели через переменную окружения Точная документация до даты публикации не проверена
При запуске --model флаг Выбор модели при запуске Точный приоритет до даты публикации не проверен

Какая настройка имеет приоритет?

В предоставленных исследовательских материалах упоминается документация, согласно которой флаг запуска имеет приоритет над ANTHROPIC_MODEL, а переменная окружения — над значением из файла настроек model . При этом прямо указано, что такой порядок не проверен для даты публикации.

Поэтому в этой статье такая цепочка приоритетов не представлена как установленный факт на август 29 года. Изменение поведения /model в части сохранения выбора подтверждено датированной записью в журнале изменений; точная иерархия настроек — нет.

А как задать модель по умолчанию для отдельного проекта?

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

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

Что добавляют хуки переключения моделей в 2.1.251

Claude Code 2.1.251 вышел 28 августа 2026 года. В его официальных примечаниях к выпуску представлены два хука с точными именами:

  • PreModelSwitch
  • PostModelSwitch

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

Именно эту новую функцию следует отличать от сохранения модели по умолчанию. Сохранение предпочтения модели уже было доступно; новые события хуков добавляют способы участия в смене модели.

Может ли хук заблокировать переключение или запросить подтверждение?

Да, блокировка и подтверждение прямо названы среди возможностей в анонсе выпуска. Добавление аннотаций также указано.

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

То же ограничение относится к таким деталям, как поля полезной нагрузки, обозначающие старую и новую модели, или требуемая структура ответа с подтверждением. Эти детали отсутствуют в предоставленных источниках, опубликованных до установленной даты.

Что нужно перед реализацией хука?

Для рабочей реализации недостаточно имён событий: нужны применимый формат конфигурации и поддерживаемый контракт ответа. В примечаниях к выпуску этих сведений нет.

Используйте руководство по хукам Claude Code для получения общих сведений о хуках. Для этого выпуска точно придерживайтесь подтверждённых возможностей: PreModelSwitch и PostModelSwitch существуют, а в анонсе описаны возможности блокировки, подтверждения и добавления аннотаций.

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

Версия 2.1.251 также добавляет диагностику, помогающую понять поведение кеша промптов. Эти дополнения показывают активность кеша и оценочную стоимость его восстановления; в выпуске не объявлены новые цены на токены или числовые лимиты кеша.

Посмотрите новую строку о кеше в /cost

В существующей команде появилась строка о кеше промптов для каждой сессии:

/cost

В этой строке отображаются четыре показателя:

  • Доля попаданий
  • Промахи
  • Повторно кешированные токены
  • Прогретое или холодное состояние

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

Скрипты строки состояния также получают соответствующий prompt_cache объект. Благодаря этому диагностика кеша доступна как в интерфейсе строки состояния, так и через /cost.

Анонс не содержит полной схемы этого объекта. Считайте prompt_cache подтверждённым именем объекта, не предполагая наличия дополнительных полей помимо диагностических данных, описанных в выпуске.

Проверка информации о возобновлении через SessionStart

При возобновлении SessionStart хуки теперь получают сведения о давности сессии и предполагаемой стоимости восстановления кеша промпта.

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

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

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

При толковании понятия «модель по умолчанию» важно учитывать несколько сопутствующих изменений в 2.1.251. Они касаются субагентов, настроек аккаунта по умолчанию, предпочтений уровня усилий и видимости расходов на шлюзе.

Приоритет выбора модели субагента

CLAUDE_CODE_SUBAGENT_MODEL теперь задаёт значение по умолчанию. Значение в определении агента для model: и модель, явно выбранная при запуске агента, имеют приоритет над этой переменной.

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

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

Настройки аккаунта по умолчанию и предпочтения уровня усилий

В подписках Enterprise с оплатой за рабочие места теперь по умолчанию используется Opus 5, как и в других премиальных тарифах.

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

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

Видимость расходов на шлюзе

В /usage команда получает Лимит расходов — индикатор для разработчиков, использующих шлюз приложений Claude с лимитами расходов:

/usage

В скриптах строки состояния появляется соответствующее rate_limits.spend_limit поле. Это дополнение к диагностике для указанного сценария использования шлюза.

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

Основные выводы

  • /model уже сохраняла значение по умолчанию для новых сессий до 2.1.251; это поведение появилось в 2.1.153.
  • Нажмите s в списке выбора модели, чтобы переключить модель только для текущей сессии. В пользовательских сочетаниях клавиш используется modelPicker:thisSessionOnly.
  • В Claude Code 2.1.251 добавлены PreModelSwitch и PostModelSwitch; в описании выпуска указаны возможности блокировки, подтверждения и аннотирования.
  • /cost, данные кеша в строке состояния и сведения от SessionStart при возобновлении позволяют отслеживать работу кеша промпта и предполагаемые затраты на его восстановление.
  • CLAUDE_CODE_SUBAGENT_MODEL задаёт значение по умолчанию, которое можно переопределить явным выбором модели агента. Точный исторический порядок приоритетов настроек основной модели остаётся неподтверждённым в предоставленных исследовательских материалах.

Частые вопросы

Сохраняет ли /model модель по умолчанию в Claude Code?

Да. В версии 2.1.153 изменили /model так, что выбранная модель сохраняется как модель по умолчанию для новых сессий, и это поведение уже существовало до 2.1.251. Нажмите s в списке выбора модели, если хотите переключить её только для текущей сессии.

Что имеет приоритет: settings.json, ANTHROPIC_MODEL или --model?

В предоставленных исследовательских материалах упоминается документация, согласно которой флаг запуска имеет приоритет над ANTHROPIC_MODEL, а эта переменная — над значением модели в файле настроек. Однако точный порядок не был независимо проверен по снимку 2026, сделанному до августа 29, поэтому эта статья не подтверждает такое поведение на указанную предельную дату.

Может ли хук переключения модели Claude Code заблокировать изменение?

В описании выпуска 2.1.251 указано, что PreModelSwitch и PostModelSwitch поддерживают блокировку, подтверждение и аннотирование переключений модели. Полные схемы или JSON для принятия решений не приведены, поэтому одного объявления недостаточно для создания работающего хука.

Где можно увидеть промахи кеша и предполагаемые затраты на восстановление?

В 2.1.251 /cost показывает для каждой сессии долю попаданий в кеш, промахи, повторно кешированные токены и прогретое или холодное состояние; в скриптах строки состояния появляется соответствующий prompt_cache объект. Отдельно SessionStart хуки при возобновлении получают сведения о давности сессии и предполагаемой стоимости восстановления кеша промпта, хотя в примечаниях к выпуску имена этих ключей полезной нагрузки не указаны.

A

Этот блог публикует AI Prime Tech. Статьи готовятся с помощью ИИ; прежде чем полагаться на сведения, зависящие от версии, такие как идентификаторы моделей, цены и лимиты, сверяйте их с официальной документацией.

Получите более дешёвый доступ к API Claude

Один ключ API для Claude Opus 5.5, Sonnet 5, Haiku 4.5 и Fable 5.1, а также GPT-6 моделей. Оплата по мере использования, без подписки.

Получить ключ API →
AI Prime Tech — независимый сторонний API-шлюз. Claude™ и Anthropic® — товарные знаки Anthropic, PBC. Связь с этой компанией или одобрение с её стороны не подразумеваются.