Anthropic отключает старые модели по расписанию и предупреждает заранее, обычно за пару месяцев. Проблема не в сроках, а в том, что имя модели живёт в десятке мест, и половину из них вспоминают уже после падения.
Ниже готовый порядок действий.
Шаг 1. Найдите все упоминания
Начните с грепа по всему репозиторию, включая конфиги и инфраструктуру:
grep -rn "claude-" . \
--include="*.ts" --include="*.tsx" --include="*.py" \
--include="*.go" --include="*.yml" --include="*.yaml" \
--include="*.json" --include="*.env*" --include="*.tf"
Не ограничивайтесь кодом. Модель часто зашита в конфиг раннера или в терраформ.
Шаг 2. Пройдите места, куда grep не дотянется
Список, который закрывает большую часть забытого:
- переменные окружения в панели хостинга, отдельно на каждом стенде
- секреты в CI
- дашборды и алерты, где имя модели в фильтре
- планировщики и фоновые задачи, которые запускаются раз в неделю или раз в месяц
- документация и README, откуда новый разработчик скопирует мёртвый ID
- шаблоны и сиды в тестовых данных
Шаг 3. Определите цель миграции
Обычно замена это смена строки. Anthropic указывает рекомендованную замену в уведомлении, и поведение при этом почти не меняется.
Если переезжаете сразу на свежую модель, а не на ближайшую замену, заложите время на проверку промптов: у новых версий бывает другая склонность к длине ответа и к формату.
Шаг 4. Сделайте имя модели одной константой
Это то, что снимает проблему навсегда. Одна переменная окружения или одна константа в коде, а не россыпь литералов.
export const MODEL = process.env.LLM_MODEL ?? 'claude-opus-4-8'
Следующая миграция станет правкой одной строки в одном месте.
Шаг 5. Проверьте под нагрузкой, а не в юнит-тестах
Юнит-тесты обычно мокают провайдера, поэтому смену модели они не поймают. Нужен хотя бы один интеграционный прогон, который реально дёргает API.
Шаг 6. Заведите напоминание
Подпишитесь на страницу с датами отключений и поставьте себе напоминание за месяц. Это дешевле, чем чинить прод по факту.
Что меняется, если вы работаете через шлюз
Мы отдаём стабильные ID моделей через свой эндпоинт, поэтому смена версии на стороне поставщика не ломает ваш код. Список доступных моделей всегда лежит на странице цен.
Формат при этом остаётся тем же, и Anthropic Messages, и OpenAI-совместимый, так что уйти от нас так же просто, как прийти.