Как переключить Claude Code на Opus 5.5 и закрепить модель
Переключите Claude Code по полному ID или алиасу opus, устраните 400 из-за старого клиента, учтите medium effort и корректно разберите fallback после refusal.
Содержание
Вы запускаете /model, выбираете Opus, но Claude Code продолжает отвечать так, будто работает другая модель, либо сразу возвращает 400. Чтобы перейти на Opus 5.5 без путаницы, проверяйте отдельно команду выбора модели, версию Claude Code и возможный fallback после отказа системы безопасности.
Для воспроизводимой настройки указывайте полный ID модели. Алиас opus имеет смысл использовать только после проверки, что он действительно разрешается в Opus 5.5. Учтите и ещё одно изменение: у Opus 5.5 значение effort по умолчанию — medium, а не high, как у Opus 5.
Полный ID надёжнее фиксирует Opus 5.5
Самый однозначный вариант:
/model claude-opus-5-5Anthropic описывает claude-opus-5-5 как фиксированный ID без суффикса с датой. Такой вариант лучше подходит для командных инструкций, проектной документации и сторонних провайдеров: сразу видно, какую модель должен запросить клиент.
Короткая команда выглядит так:
/model opusИспользуйте её только тогда, когда Claude Code или сервис за вашим Base URL показывает, что алиас ведёт именно на Opus 5.5. Для быстрой интерактивной работы алиас удобен, но при разборе ошибок полный ID проще проверить.
| Задача | Что выбрать | Почему |
|---|---|---|
| Зафиксировать точную модель | /model claude-opus-5-5 | ID указан явно, настройка воспроизводима |
| Быстро выбрать текущий Opus | /model opus | Команда короче, но результат нужно проверить |
| Найти проблему у стороннего провайдера | Сначала полный ID | Так проще отличить ошибку алиаса от отсутствия модели |
Если Claude Code работает через Anthropic-совместимый Base URL, например BetterToken, команда /model остаётся той же; до переключения убедитесь, что провайдер действительно публикует claude-opus-5-5, а не только принимает общий алиас.
Перед переключением обновите Claude Code
Старый клиент может не знать новую модель, даже если ваш аккаунт или провайдер уже её поддерживает. Сначала выполните:
claude updateПосле обновления перезапустите текущую сессию Claude Code. Если вы работаете через настольное приложение Claude, обновите и его, затем снова выберите модель по полному ID.
В одном issue от 22 сентября 2026 года зафиксирован конкретный пример: Claude Code 2.1.257 получил ошибку claude_code_version_too_old, а ответ требовал версию 2.1.280 или новее. Это подтверждает наличие проверки версии, но не означает, что 2.1.280 навсегда останется единым минимальным номером. Ориентируйтесь на минимум, указанный в вашей фактической ошибке.
Переключайте и проверяйте модель по порядку
Так одна проблема не скроет другую:
- Выполните
claude updateи перезапустите Claude Code. - В нужной рабочей сессии введите
/model claude-opus-5-5. - Проверьте модель, которую Claude Code показывает после команды. Сам факт принятия команды ещё не доказывает успешное переключение.
- Перед длительной или дорогой задачей снова откройте
/modelи перепроверьте текущий выбор.
Если полный ID работает, а /model opus выбирает не то, продолжайте использовать полный ID. Это больше похоже на проблему разрешения алиаса, а не на отсутствие доступа к Opus 5.5.
Если не работает ни один вариант и используется сторонний endpoint, проверьте каталог моделей и маппинг у провайдера. Официальный Claude API может уже принимать стандартный ID, тогда как совместимый шлюз ещё не добавил его или использует собственные имена.
По умолчанию effort равен medium
Claude Opus 5.5 всегда использует adaptive thinking, а документированное значение effort по умолчанию — medium. У Opus 5 по умолчанию было high, поэтому после смены модели могут измениться задержка, расход токенов и глубина рассуждений, даже если в интерфейсе Claude Code вы больше ничего не меняли.
Для обычной работы в Claude Code не нужно придумывать отдельное значение effort только ради переключения. Сначала подтвердите модель и оцените поведение на реальной задаче. Если клиент или API-шлюз позволяет менять effort, задавайте уровень осознанно, а не рассчитывайте на прежний default.
В собственных интеграциях учитывайте и правила запроса Opus 5.5: модель отклоняет отключение thinking и ручной thinking budget. Если модель выбрана, но первый запрос всё равно заканчивается 400, проверяйте преобразования payload на шлюзе, а не повторяйте /model по кругу.
Помеченное сообщение может уйти на fallback
Отказ по правилам безопасности — это отдельный путь, а не обычная смена модели. На уровне API Opus 5.5 может вернуть HTTP 200 со stop_reason: "refusal" и объектом stop_details. Если в клиенте или у провайдера настроен fallback, этот конкретный запрос может быть повторён на другой модели.
Считайте это fallback для одного запроса, а не доказательством того, что сохранённый выбор /model навсегда изменился. Перед продолжением важной работы снова откройте /model и проверьте активную модель. Anthropic также указывает, что при переходе с Opus 5.5 на большинство других моделей последующие ходы выполняются без прежних thinking blocks Opus 5.5. Поэтому важные ограничения лучше сформулировать заново.
Практический порядок действий:
- Прочитайте уведомление об отказе или пометке, не отправляйте тот же запрос без изменений.
- Если задача допустима, уберите или переформулируйте часть, которая вызвала классификатор.
- Проверьте, был ли включён fallback у клиента или провайдера.
- Перед возвратом к задаче с фиксированной моделью снова подтвердите Opus 5.5.
Частые ошибки и что проверять
| Симптом | Сначала проверьте | Что сделать |
|---|---|---|
400 с claude_code_version_too_old | Версию Claude Code или desktop-клиента | Выполнить claude update, перезапустить и повторить полный ID |
| Opus 5.5 отсутствует в списке | Каталог клиента или провайдера | Обновить клиент, затем проверить доступность у провайдера |
/model opus выбирает неожиданную модель | Разрешение алиаса | Использовать /model claude-opus-5-5 и сверить отображаемый выбор |
| Полный ID принят, но первый запрос даёт 400 | Несовместимый upstream payload | Проверить отключение/manual thinking и переписывание запроса шлюзом |
| Сообщение помечено, отвечает другая модель | Fallback после refusal | Изучить отказ, проверить модель и повторить ключевые ограничения |
| После смены модели в середине сессии теряется связность | Thinking blocks могли не перейти | Проверить модель и дать новой итерации нужный контекст |
Финальная проверка перед работой
- Claude Code обновлён и перезапущен.
/model claude-opus-5-5принимается без ошибки версии.- Отображаемая модель действительно разрешается в Opus 5.5.
- Без явной настройки вы ожидаете
mediumeffort. - После помеченного или отклонённого запроса вы проверили, не сработал ли fallback.
Когда все пять пунктов подтверждены, полный ID даёт самый воспроизводимый результат. Алиас opus остаётся удобным для быстрого переключения, но его результат следует проверять, а не предполагать.
