К содержимому
Блог

Модель Claude отключили: чеклист замены ID в проекте

Модель 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 и другие), и сверяет с каталогом по именам и алиасам. Ключ для него не нужен, список моделей отдаётся без авторизации.

python
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.

Каталог моделей

Выбирая из того, что есть, смотрите на четыре вещи:

  1. Протокол. Если клиент работает по Anthropic Messages, у модели в ответе GET /api/public/models должно стоять anthropic_messages в поле protocols. Для Chat Completions нужен openai_chat.

  2. Окно контекста и предел ответа: поля context_length и max_output_tokens в GET /v1/models. Новая модель может оказаться короче старой по ответу.

  3. Возможности в карточке: инструменты, изображения, рассуждение. Нужное вам должно быть отмечено.

  4. Цена в карточке. Число в код и в статьи не переписывайте.

Отдельная ловушка касается параметров. По странице вендора на 14 октября 2026 года Claude 4.7 и новее отвечают 400, если передать temperature, top_p или top_k с нестандартным значением. Relay остальные поля тела отдаёт модели без изменений, так что отказ придёт к вам. При переходе на claude-opus-4-8 уберите нестандартный параметр до первого запуска.

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

Как вынести ID в одну точку и не вернуться сюда?

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

Саму переменную защитите проверкой при деплое. Если модель исчезла из каталога или встала на паузу, деплой должен покраснеть до того, как пользователь получит ошибку:

bash
curl -fsS "https://relay-llm.ru/v1/models/$LLM_MODEL" > /dev/null

curl -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.

Источники

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.