Как включить Sonnet 5.5 в Claude Code: модель, effort и права доступа

Чтобы явно выбрать Sonnet 5.5 в Claude Code, запустите новую сессию командой claude --model claude-sonnet-5-5 или введите /model claude-sonnet-5-5 внутри сессии. Это применимо к провайдеру, который принимает такой ID. Сначала проверьте версию клиента и права аккаунта. Текущая документация Anthropic требует Claude Code v2.1.284 или новее.

Здесь разделены три разных условия: клиент распознаёт модель, провайдер её обслуживает, а аккаунту разрешено её использовать. Инструкции сверены с документацией настройки моделей Claude Code 29 сентября 2026 года. Они не подтверждают доступ для любой подписки или стороннего endpoint.

Проверьте версию и выберите модель

В терминале:

claude --version
claude update
claude --model claude-sonnet-5-5 --effort medium

claude update изменяет установленный клиент. Если установкой управляет организация, соблюдайте её порядок обновления ПО. В уже открытой интерактивной сессии используйте:

/model claude-sonnet-5-5
/status

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

Короткий алиас sonnet удобен, но его значение зависит от провайдера и версии клиента. Сейчас документация сопоставляет его с Sonnet 5.5 для Anthropic API, тогда как некоторые облачные алиасы ещё указывают на более старые Sonnet. Полное имя выражает намерение явно, но идентификатор и путь доступа всё равно должны поддерживаться выбранным провайдером.

Почему недостаточно поменять значение по умолчанию

Модель Claude Code по умолчанию — не обязательно последняя Sonnet. Текущая документация указывает Opus 5.5 для нескольких категорий аккаунтов и провайдеров. Sonnet нужно выбрать осознанно. При ограничениях организации список доступных моделей может отличаться от публичного руководства.

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

Для воспроизводимого теста используйте явный выбор, затем решайте, нужен ли постоянный default. Разовая проверка не требует изменений во всех репозиториях и определениях агентов.

Подберите effort под задачу

У Sonnet 5.5 в нативном API значение по умолчанию — high. Документация Claude Code описывает medium для этой модели в клиенте. Речь о разных точках входа, поэтому эти значения нельзя считать взаимозаменяемыми.

Для чётко заданного изменения кода medium — разумная отправная точка по документации. Повышайте уровень, когда это оправдано задачей и результатами. В интерактивном клиенте используйте /effort, при запуске — --effort, с учётом ограничений аккаунта. Управляемые настройки могут ограничить фактический уровень даже при запросе более высокого; фиксируйте применённую конфигурацию, если она доступна.

Руководство по effort объясняет, почему более высокий уровень не гарантирует лучший результат. Начните с отдельной ветки, явных критериев приёмки и diff, который можно проверить. Модели по-прежнему нужны разрешения инструментов, а изменения необходимо просмотреть перед слиянием.

Подписка и API — разные способы доступа и оплаты

Вход по подписке Claude и ключ API не являются одним маршрутом. Сообщение о запрете организацией подписочного доступа к Claude Code — блокировка политикой аккаунта, а не доказательство отказа Sonnet. Уточните у администратора разрешённый способ доступа; не обходите управляемое ограничение.

При подготовке статьи локальная попытка через Claude Code v2.1.281 вернула именно сообщение о доступе организации и не выполнила задачу Sonnet. Версия также была ниже документированного минимума. Поэтому мы не заявляем успешный тест модели, измерение скорости или стоимости по этой попытке. Команды выше проверены по документации.

Если доступен одобренный маршрут API, запросы оплачиваются как API: наличие подписки не делает их бесплатными. До теста проверьте точный endpoint, модель, аккаунт и действующие тарифы. В руководстве по цене Sonnet API разобран расчёт по ставкам разработчика.

Диагностируйте конкретную ошибку

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

Для изменений нативного запроса используйте план миграции API. Чтобы решить, нужен ли переход со старой модели вообще, прочитайте Sonnet 5 против 5.5.