Как включить 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 разобран расчёт по ставкам разработчика.

Зафиксируйте исходное состояние до изменения кода

Используйте небольшой контролируемый репозиторий без рабочих секретов и посторонних незакоммиченных изменений. До открытия Claude Code запишите текущий commit и выполните существующие тесты. Иначе старую ошибку можно принять за регрессию Sonnet, а чужие изменения — за результат модели. Следующие команды проверяют локальное состояние. Для тестов используйте реальную команду проекта, не устанавливая произвольный новый фреймворк.

git status --short
git rev-parse HEAD
claude --version
claude auth status

Вывод аутентификации проверяйте локально; в отчёте достаточно нужного типа учётной записи и разрешённого способа доступа. Не копируйте секреты или полный дамп окружения в статью, issue либо промпт. Если установкой и входом управляет организация, сначала пройдите утверждённую процедуру администратора. Обновление клиента не отменяет запрет на подписочный доступ.

После разрешённого обновления снова выполните claude --version. Отправленная команда update ещё не доказывает, что shell использует новый исполняемый файл. При нескольких установках старый бинарный файл может остаться раньше в пути поиска. Если версия не изменилась, проверьте command -v claude. Запишите и путь, и версию, особенно если терминал и IDE ведут себя по-разному.

Выберите модель без случайного изменения настроек по умолчанию

Текущая документация задаёт следующий приоритет: выбор внутри сессии, флаг запуска, ANTHROPIC_MODEL, поле model в settings, затем настройка модели по умолчанию. Управляемые ограничения сохраняются. Поэтому редактирование одного файла настроек может ничего не менять, когда действует более приоритетный выбор.

Для отдельной пробы запустите поддерживаемый полный ID с явным effort:

claude --model claude-sonnet-5-5 --effort medium

В сессии проверьте /status и выбор модели. Согласно текущей документации, прямой ввод /model <name> сохраняет выбор в пользовательских настройках для следующих сессий. Для изменения только текущей сессии откройте /model и используйте соответствующее действие списка; стандартная клавиша в документации — s. Не называйте прямую команду временной, не проверив её поведение при сохранении.

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

Первой задаче нужны границы и проверяемый результат

Для первого кодового задания подходит небольшой арифметический дефект с падающим тестом, а не просьба «улучшить проект». Далее — редакционный учебный fixture с синтетическими данными. Это не патч, полученный от Sonnet при подготовке статьи.

# expenses.py: intentionally incorrect practice function
def total(rows):
    return sum(row["unit_price"] for row in rows)

Для трёх блокнотов по $4.50 и двух ручек по $1.25 ошибочная функция возвращает $5.75. Правильный итог — $16.00: сначала умножают количество на цену каждой строки, затем складывают. Сохраните рядом следующий тест.

# test_expenses.py
from decimal import Decimal
from expenses import total

def test_total():
    rows = [
        {"quantity": 3, "unit_price": Decimal("4.50")},
        {"quantity": 2, "unit_price": Decimal("1.25")},
    ]
    assert total(rows) == Decimal("16.00")

def test_empty():
    assert total([]) == 0

if __name__ == "__main__":
    test_total()
    test_empty()

До вызова модели выполните python3 test_expenses.py. Первая проверка должна упасть. Если этого не произошло, проверьте файлы и путь импорта: нужное исходное состояние ещё не подтверждено. Важна неправильная арифметика, а не совпадение конкретного traceback или номера строки.

Затем передайте полное задание вместо одной ошибки:

Исправь total(rows) в expenses.py. Вклад строки — quantity × unit_price;
сохрани существующие входные значения Decimal. Пустой ввод должен давать 0.
Меняй только expenses.py, не меняй тесты и не устанавливай зависимости.
Выполни python3 test_expenses.py и сообщи фактический результат, причину,
изменённую строку и непроверенные предположения. Не делай commit или push,
не обращайся к внешним сервисам. Не объявляй невыполненные тесты выполненными.

Промпт фиксирует границы и независимо вычисляемый ответ, но не гарантирует соблюдение инструкций моделью. Просмотрите diff: тесты не должны быть ослаблены, а посторонние файлы — изменены. Здесь проверяются только корректные строки и пустой ввод. Отрицательные количества, отсутствующие ключи и некорректные значения требуют отдельного продуктового решения, а не придуманной внутри маленького исправления семантики.

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

После сессии выполните git diff -- expenses.py test_expenses.py и запустите тест самостоятельно. Фраза «тесты прошли» слабее фактического кода завершения процесса и его вывода. Проверьте обе строки расчёта и неизменность теста. Если модель заменила ожидаемый результат на $5.75, тест стал зелёным, но дефект остался: такой патч нужно отклонить.

Сохраните исходный commit, версию клиента, провайдера и модель, запрошенный effort, команду теста, результат, diff и решение проверяющего. Блокировку политикой до ответа модели обозначайте как «доступ заблокирован», а не «ошибка программирования». Отказ в разрешении инструмента тоже отличается от неверного патча. Корректно выглядящее предложение без выполненных тестов остаётся «патч предложен, не проверен» до независимого подтверждения.

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

Аккуратно вернитесь к прежней конфигурации

Если использовался только флаг запуска, завершите сессию и проверьте состояние следующей. Если менялось сохранённое значение, восстановите его через поддерживаемый список выбора или путь настройки и убедитесь в результате. Не трогайте управляемые параметры. Удаляйте только созданные вами учебные файлы; не выполняйте слепой reset или clean общего репозитория ради отмены пробы.

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

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

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

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