Модель Claude отключили: чеклист замены ID в проекте
Если вендор отключил модель Claude, запросы по её идентификатору начнут падать, а замену нужно искать в каталоге Relay, а не в письме вендора. Названия там пишутся иначе, и рекомендованной замены в каталоге может не оказаться. Порядок работы такой: найти все упоминания старого ID, выбрать цель по каталогу, проверить её на своих примерах, вынести ID в одну точку и поставить проверку каталога в деплой.
Коротко
Relay не подставляет новую модель вместо старой: ID вне каталога получает 404
model_not_found.Каталог Relay пишет
claude-opus-4-8. Ищите точный ID и устаревшие варианты, которые остались в конфигурации.Скрипт ниже находит в репозитории ID известных семейств, которых нет в
GET /v1/models, и годится для CI.Переезд на Claude 4.7 и новее ломает вызовы с нестандартным
temperature.
Что случится с запросом к отключённой модели?
Relay отвечает по собственному каталогу. Для запросов генерации шлюз знает только модели со статусами active и paused, остальных для него нет. На практике встречаются три исхода.
| Ситуация | Ответ | Что делать |
|---|---|---|
| ID нет в каталоге: модель убрана или в строке опечатка | 404, код model_not_found | Заменить ID. Повтор того же запроса бесполезен |
| Модель на паузе, запрос генерации | 503, код model_unavailable, x-should-retry: false | Выбрать другую модель или ждать. Автоповтор не включать |
| Ключ ограничен списком моделей, новой в нём нет | 403, код model_not_allowed | Разрешить модель в настройках ключа |
Форма тела зависит от протокола. В формате OpenAI, то есть на /v1/chat/completions, /v1/responses и GET /v1/models/{id}, внутри error приходят type: not_found_error, code: model_not_found и request_id. В формате Anthropic на /v1/messages тело выглядит как type: "error", вложенный error с type и message и request_id на верхнем уровне, поля code там нет. Тот же request_id лежит в заголовке x-request-id, его указывают в обращении в поддержку.
Список моделей и запрос одной модели показывают только active. Поэтому модель на паузе в GET /v1/models не видна, а GET /v1/models/{id} отвечает на неё как на отсутствующую: 404 и model_not_found. Для проверки в деплое этого достаточно.
Старый ID Relay не переписывает на новый и модель за вас не выбирает. Молчаливая подмена изменила бы и качество ответов, и счёт, а узнали бы вы об этом из отчёта о расходах. Так что смена ID остаётся вашей задачей, и лучше решить её до того, как запросы упали.
Где в проекте прячется ID модели?
Заменить строку в коде проще всего. Остальное вспоминают уже после инцидента.
переменные окружения на каждом стенде, включая стейджинг и превью-окружения;
секреты в CI и конфиги раннеров;
фильтры дашбордов и алертов, где имя модели стоит в запросе;
cron-задачи и очереди с редким запуском, например раз в месяц;
README, примеры и сниппеты в вики, откуда новичок скопирует мёртвый ID;
сиды и фикстуры тестов;
настройки клиентов на машинах разработчиков;
список разрешённых моделей в самом ключе Relay.
Про клиентов отдельно. Для выбора модели Claude Code читает четыре переменные: ANTHROPIC_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL и ANTHROPIC_DEFAULT_HAIKU_MODEL. Последняя задаёт модель для фоновых задач. Если в ней стоит ID, которого нет в каталоге, основная сессия работает, а фоновые запросы получают 404. Диагностировать такое неприятно, поэтому проверяйте все четыре, а страница клиента в документации перечисляет ловушки подробнее.
Поиск по одному ID из каталога, например claude-opus-4-8, не найдёт ошибочный старый вариант из конфигурации. Поиск по префиксу claude- найдёт всё, но утонет в нужных строках. Скрипт ниже достаёт из файлов всё, что похоже на ID моделей семейств из каталога (Claude, GPT, Gemini, DeepSeek, Qwen, GLM, Kimi и другие), и сверяет с каталогом по именам и алиасам. Ключ для него не нужен, список моделей отдаётся без авторизации.
import json
import os
import re
import sys
from urllib.request import urlopen
BASE = os.environ.get("RELAY_BASE_URL", "https://relay-llm.ru/v1")
SKIP_DIRS = {".git", "node_modules", ".venv", "dist", "build"}
NOT_MODELS = ("claude-code", "claude-desktop")
FILE_SUFFIX = re.compile(r"\.(?:md|json|ya?ml|py|ts|js|txt)$")
def catalog_names():
with urlopen(BASE + "/models", timeout=20) as resp:
data = json.load(resp)["data"]
names = set()
for model in data:
names.add(model["id"].lower())
names.update(a.lower().split("/")[-1] for a in model.get("aliases", []))
return names
def id_pattern(names):
families = sorted({re.match(r"[a-z]+", name).group() for name in names}, key=len, reverse=True)
return re.compile(r"\b(?:%s)[a-z0-9.]*-[a-z0-9](?:[a-z0-9.\-]*[a-z0-9])?" % "|".join(families), re.I)
def walk(root):
for folder, dirs, files in os.walk(root):
dirs[:] = [d for d in dirs if d not in SKIP_DIRS]
for name in files:
path = os.path.join(folder, name)
if os.path.getsize(path) < 1_000_000:
yield path
def main(root):
known = catalog_names()
pattern = id_pattern(known)
stale = 0
for path in walk(root):
with open(path, encoding="utf-8", errors="ignore") as f:
for number, line in enumerate(f, 1):
for match in pattern.findall(line):
name = FILE_SUFFIX.sub("", match.lower())
if name not in known and not name.startswith(NOT_MODELS):
stale += 1
print("%s:%d: %s" % (path, number, match))
return 1 if stale else 0
if __name__ == "__main__":
sys.exit(main(sys.argv[1] if len(sys.argv) > 1 else "."))Запускайте из корня репозитория: python3 audit_ids.py .. Каждая найденная строка выводится как путь:строка: ID, а код возврата 1 останавливает CI. Имена claude-code и claude-desktop и расширения файлов в конце имени скрипт отбрасывает, но отчёт всё равно придётся читать глазами: старый ID в комментарии или changelog тоже попадёт в список. Семейства берутся из текущего каталога, так что модель, чьё семейство из каталога исчезло целиком, скрипт не заметит.
Как выбрать замену?
Начните с рекомендации вендора, но проверьте её по каталогу. Если рекомендованный ID не приходит в GET /v1/models, не переносите его в конфигурацию: запрос получит 404. Для замены выбирайте только точный ID из текущего ответа каталога.
Рекомендация и каталог могут разойтись. Из линейки Sonnet в текущем каталоге есть claude-sonnet-5. В проекте подойдёт только то, что отдаёт GET /v1/models.
Выбирая из того, что есть, смотрите на четыре вещи:
Протокол. Если клиент работает по Anthropic Messages, у модели в ответе
GET /api/public/modelsдолжно стоятьanthropic_messagesв полеprotocols. Для Chat Completions нуженopenai_chat.Окно контекста и предел ответа: поля
context_lengthиmax_output_tokensвGET /v1/models. Новая модель может оказаться короче старой по ответу.Возможности в карточке: инструменты, изображения, рассуждение. Нужное вам должно быть отмечено.
Цена в карточке. Число в код и в статьи не переписывайте.
Отдельная ловушка касается параметров. По странице вендора на 14 октября 2026 года Claude 4.7 и новее отвечают 400, если передать temperature, top_p или top_k с нестандартным значением. Relay остальные поля тела отдаёт модели без изменений, так что отказ придёт к вам. При переходе на claude-opus-4-8 уберите нестандартный параметр до первого запуска.
Прыгать на самую новую модель без проверки мы бы не стали. Поведение промптов у версий отличается: меняются длина ответа, формат, склонность к пояснениям. Прогоните свои примеры на двух кандидатах, как описано в статье про оценку моделей на своих данных, и берите ту, что проходит порог дешевле.
Как вынести ID в одну точку и не вернуться сюда?
ID должен жить в одной переменной окружения или в одной константе. Тогда следующая замена потребует правки одной строки, а не охоты по репозиторию.
Саму переменную защитите проверкой при деплое. Если модель исчезла из каталога или встала на паузу, деплой должен покраснеть до того, как пользователь получит ошибку:
curl -fsS "https://relay-llm.ru/v1/models/$LLM_MODEL" > /dev/nullcurl -f обрывает команду на ответе 404, а 404 приходит и на удалённую модель, и на модель на паузе. Ту же проверку полезно запускать по расписанию раз в неделю вместе со скриптом поиска. Мы бы ставили её в деплой: напоминание в календаре забывают, красный деплой нет.
Чем проверять замену, если юнит-тесты зелёные?
Юнит-тесты обычно подменяют клиента модели, поэтому смену ID они не замечают. Нужен хотя бы один сквозной прогон с настоящим обращением к API: обычный запрос, потоковый и, если используете инструменты, один вызов инструмента. Результат смотрите в журнале запросов: статус, токены и стоимость каждого вызова там видны. Тексты запросов и ответов Relay не хранит, так что сверять ответы придётся по своим логам.
Если упало на проде, порядок простой. Сначала сервис, ближайший к пользователю, затем фоновые задачи. Откатывать код не нужно: достаточно сменить ID и перезапустить.
Как не пропустить следующий срок?
По странице вендора на 14 октября 2026 года Anthropic предупреждает клиентов с активными развёртываниями не меньше чем за 60 дней до вывода публично выпущенной модели. Письма идут владельцам аккаунтов вендора. Если вы ходите к Claude через Relay, своего аккаунта у вендора у вас, скорее всего, нет, и о сроках придётся узнавать самим: из страницы вендора и из каталога.
Практичный минимум. Раз в неделю прогонять скрипт поиска и проверку статуса, а в календарь поставить дату вывода модели за месяц до срока. Каталог Relay живёт по своему расписанию, и модель способна встать на паузу раньше вендорского срока. Проверка статуса в деплое страхует от этого лучше, чем дата в календаре.
Частые вопросы
Подставит ли Relay новую модель вместо отключённой?
Нет. Запрос с ID, которого нет в каталоге, получает 404 с кодом model_not_found. Шлюз не переписывает старые имена на новые, а алиасы относятся только к моделям из каталога. Замену выбираете вы и меняете ID в конфигурации.
Чем `model_not_found` отличается от `model_unavailable`?
Первая ошибка значит, что такой модели в каталоге нет: повтор не поможет, исправьте ID. Вторая приходит на запрос генерации и значит, что модель в каталоге есть, но сейчас недоступна, в том числе пока для неё нет цены. Заголовок x-should-retry в этом случае равен false, поэтому автоматически запрос не повторяйте, а выберите другую модель.
Почему поиск по полному ID не находит все упоминания?
В конфигурации часто остаются ошибочные варианты ID рядом с действующим claude-opus-4-8. Поиск по одному написанию пропустит другое. Кроме того, ID бывают в переменных окружения, секретах CI и настройках клиентов, куда поиск по репозиторию не дотягивается. Скрипт выше закрывает файлы, остальные места пройдите по списку.
Где посмотреть, какие модели сейчас доступны?
В каталоге и в ответе Models API. Идентификатор копируйте без изменений, а порядок выбора описан в статье про действующий каталог. Если вы переносите приложение целиком, начните с чеклиста миграции OpenAI SDK.
Источники
Anthropic, страница о выводе моделей из работы, проверена 14 октября 2026 года: даты и рекомендованные замены Opus 4.1 и Sonnet 4.5, срок уведомления, отказ от
temperature,top_p,top_kна Claude 4.7 и новее.