После вывода Claude 3.5 Sonnet из эксплуатации, как определить причину 429 в Cursor? (2026)

Сначала определите, какой слой вернул HTTP 429, и только затем проверяйте лимиты, журналы и модельный идентификатор: сам код ответа не доказывает, что запрос ограничил Anthropic. Если запрос всё ещё адресован Claude 3.5 Sonnet через API Anthropic, сначала проверьте модель — она выведена из эксплуатации, и дополнительные повторы не вернут её в доступность.
Материал подойдёт разработчикам, у которых в Cursor возникает 429, но неясно, используется ли собственный API-ключ или встроенный сервис.
Инженеры с LiteLLM смогут отделить ограничения шлюза от ответа провайдера.
Командам с прежней интеграцией Claude 3.5 Sonnet он поможет проверить старый идентификатор модели.
Сначала установите границу, на которой появился 429
HTTP 429 сообщает об ограничении запроса, но не называет ответственный компонент. Запрос может быть ограничен клиентом или его путём к сервису, API-провайдером либо шлюзом LiteLLM. Поэтому полезно записать не только текст уведомления в Cursor, но и маршрут: откуда взяты учётные данные, куда отправляется запрос и какой компонент сформировал видимый ответ.
Есть и отдельная причина не начинать с настройки повторов. По официальной записи Anthropic, API-версия Claude Sonnet 3.5 была выведена из эксплуатации 28 октября 2025 года. Сверьте актуальное состояние модели и формулировку её идентификатора с официальной записью Anthropic о выводе моделей из эксплуатации. Запрос к неактивной модели и ограничение частоты — разные неисправности: одна проверяется по доступности модели и ответу об ошибке, другая — по данным о лимите.
Для отладки заведите короткую запись инцидента: время, выбранная модель, тип подключения, видимый текст ошибки и наличие ответа от промежуточного сервиса. Не сохраняйте в таком отчёте API-ключи, токены авторизации или содержимое запросов, если оно содержит закрытые данные. Для первого этапа достаточно установить маршрут и найти журнал именно того слоя, который мог сформировать ответ.
| Признак | Что он позволяет предположить | Чего он сам по себе не доказывает |
|---|---|---|
| Cursor показывает 429 | Клиент получил или отобразил ошибку с таким кодом | Что лимит применил именно Anthropic |
| В ответе есть сведения о rate limit | Ответ, вероятно, содержит данные о лимитировании на конкретном участке пути | Что это лимит организации, а не шлюза или другого промежуточного компонента |
| В журнале LiteLLM виден исходящий вызов | Шлюз передал запрос дальше | Что именно шлюз сформировал итоговый 429 |
| Конфигурация содержит старую модель | Запрос может адресоваться выведенной из эксплуатации модели | Что любое сообщение об ошибке обязательно означает лимит |
При собственном API-ключе Cursor: отделите прямой путь от встроенного
Когда Cursor настроен на собственный ключ провайдера, сначала сверьте выбранную модель, сохранённый ключ и включённый способ подключения. Документация Cursor описывает, где задаются API-ключи и какие параметры доступны для этой настройки: инструкция Cursor по API-ключам. Это помогает выяснить, направлен ли запрос с ключом разработчика или используется встроенный сервис Cursor.
Сам по себе экран настроек не всегда показывает полный маршрут конкретного сбоя. Зафиксируйте выбранный способ доступа и сопоставьте его со временем ошибки. Если предоставляющий API сервис доступен напрямую и клиент или промежуточный компонент сохраняет исходный ответ, проверьте тело ответа и заголовки. Важны сведения о состоянии лимита и retry-after, если они присутствуют. Anthropic описывает назначение 429, заголовка retry-after и заголовков состояния лимита в документации по ограничениям API, а значения кодов и формат ошибок — в справочнике ошибок Claude API.
Не приравнивайте два разных случая: 429 от API при использовании собственного ключа и сообщение от встроенного сервиса Cursor. В первом случае сведения по ключу и ответу провайдера могут помочь установить, какая именно квота затронута. Во втором необходимо сначала подтвердить, что запрос действительно проходил через встроенный путь, а затем сверить пользовательское сообщение с состоянием сервиса или учётной записи. Условия доступа и диагностические данные у этих путей не обязаны совпадать.
Если доступен исходный ответ, сохраните его статус, относящиеся к ограничению заголовки и тело ошибки без секретов. Если доступен только текст уведомления Cursor, отметьте, что исходные заголовки недоступны. Это не мелочь: по одному пользовательскому сообщению нельзя надёжно вывести RPM, лимит входных или выходных токенов либо конкретный предел учётной записи. Актуальные ограничения и связанные заголовки следует сверять с официальными правилами Anthropic, а не восстанавливать по косвенным признакам.
Что проверить в режиме встроенного сервиса
Встроенный путь требует другого порядка диагностики. Сначала установите выбранную модель и фактический вариант доступа, затем запишите точный текст ошибки и проверьте доступное состояние учётной записи или сервиса. Не подменяйте проверку предположениями о квоте Anthropic: если клиент не показывает исходный ответ API, нет основания утверждать, что видимый 429 сформировал именно этот провайдер.
Практическая граница ответственности выглядит так:
| Доступные данные | Что можно проверить самостоятельно | Что требуется уточнить у сервиса |
|---|---|---|
| Выбор модели и режим подключения | Совпадают ли настройки с ожидаемым путём запроса | Какой компонент сформировал ответ, если маршрут скрыт |
| Текст ошибки в интерфейсе | Сохраняется ли ошибка при корректной конфигурации модели | Есть ли у сервиса инцидент или ограничение, относящееся к учётной записи |
| Исходных заголовков нет | Можно зафиксировать, что сведений о лимите в клиенте нет | Какие лимиты применялись к конкретному запросу, если сервис может проверить его по журналам |
Направляйте запрос в поддержку с временем события и безопасным фрагментом ошибки, а не с ключом или полным секретным запросом. Если сервис не раскрывает исходный ответ и журнал, оставьте причину как неподтверждённую. Это точнее, чем приписывать ошибку провайдеру по одному коду.
При LiteLLM: сравните входящий запрос и результат вызова провайдера
В LiteLLM важно различить два ответа: тот, который шлюз вернул клиенту, и тот, который он получил от вышестоящего сервиса. Проверьте журналы на предмет входящего запроса и исходящего вызова, затем сопоставьте их по времени и идентификатору запроса, если он доступен. В документации об архитектуре обработки запросов LiteLLM Proxy описан путь через прокси. Это полезная схема для поиска границы между клиентом, шлюзом и поставщиком модели.
Отдельно проверьте конфигурацию виртуального ключа, команды или развёртывания: внутреннее ограничение может сработать до обращения к поставщику. Если исходящего вызова не было, а 429 уже записан шлюзом, исследуйте настройки доступа и лимитов LiteLLM. Если вызов был, сравните его результат с ответом клиенту: провайдер мог вернуть ограничение, а шлюз — передать или обработать его. Сведения о настройке ограничений пользователей и ключей приведены в документации LiteLLM по лимитам Proxy.
Учитывайте также маршрутизацию, повторы и переход на другую модель. Журнал может показать, что шлюз выбрал другую цель после ошибки или повторил вызов; наличие такой записи не превращает первопричину в локальный лимит. Сверьте фактический маршрут с правилами Router и историей повторов, описанными в документации LiteLLM по маршрутизации. Здесь задача — локализовать источник 429, а не менять правила отказоустойчивости до того, как установлена причина.
| Наблюдение в журналах LiteLLM | Наиболее обоснованное направление проверки | Следующий шаг |
|---|---|---|
| Запрос принят, исходящего обращения нет | Ограничение могло сработать внутри шлюза | Проверить виртуальный ключ, настройки команды и лимиты развёртывания |
| Видны исходящий вызов и 429 от провайдера | Нужно исследовать ответ вышестоящего API | Сверить тело ответа и заголовки с документацией провайдера |
| Видны повтор или смена модели | Запрос прошёл по дополнительному маршруту | Установить, какой вызов получил ограничение и какой ответ вернулся клиенту |
| В журналах нет связанной записи | Источник пока не установлен | Проверить, тот ли экземпляр шлюза и временной интервал исследуются |
На практике одна настройка не отвечает на все вопросы. Например, 429 в Cursor при настроенном LiteLLM ещё не доказывает ни ошибку Router, ни ограничение провайдера. Если журнал показывает входящий запрос, но не содержит соответствующей записи об исходящем вызове, сначала выясняйте, почему запрос не прошёл дальше. Если исходящий ответ есть, не заменяйте его общим описанием ошибки из интерфейса — сравнивайте конкретные сведения.
Старый Claude 3.5 Sonnet: модельный идентификатор — отдельная проверка
После вывода модели из эксплуатации найдите её идентификатор во всех конфигурационных точках: в настройках выбора модели Cursor, переменных окружения приложения, карте моделей LiteLLM и конфигурации клиента, который передаёт запрос. Сопоставьте найденное значение с официальной записью Anthropic о состоянии и сроках вывода моделей. Проверяйте не только человекочитаемое имя, но и фактическое значение, которое отправляется в запросе.
Затем разделите два вида ошибки. Сообщение о недоступной или неизвестной модели требует проверки идентификатора и актуального состояния модели. Ответ о превышении лимита требует проверки данных о rate limit и того, какой слой его сформировал. Точная формулировка ошибки зависит от ответа API и обработки в клиенте или шлюзе; классифицируйте её по исходному ответу, если он доступен, сверяясь со справочником Anthropic по ошибкам API.
После перехода на подтверждённую доступную модель повторите проверку маршрута и сохраните новый ответ. Если ошибка изменилась с сообщения о модели на 429, это новый диагностический факт, а не доказательство того, что первоначальная причина тоже была ограничением частоты. Сравнивайте записи до и после изменения, не смешивая их.
Важно: многократные повторы способны увеличить число запросов и затруднить диагностику. Переключение на другую модель тоже не гарантирует одинаковый формат ответа или поведение приложения. Сначала подтвердите активную модель и источник ошибки, затем меняйте маршрут.
Решение по свидетельствам: повторять запрос или искать другой слой
Для первичной сортировки используйте условия, а не предположение по коду статуса:
- Если исходный ответ провайдера содержит
retry-after, зафиксируйте его и выдержите указанное время, ориентируясь на правила Anthropic для обработки ограничений. Не добавляйте повторы чаще, чем допускает ответ. - Если исходных заголовков нет, не вычисляйте по сообщению Cursor конкретный RPM или токенный предел. Сначала установите путь запроса и выясните, может ли сервис предоставить исходный ответ.
- Если LiteLLM зарегистрировал входящий запрос, но не исходящий вызов, проверяйте лимиты и настройки самого шлюза. Сверяйте это с документацией LiteLLM по ограничениям пользователей.
- Если есть исходящий ответ с 429, исследуйте ответ провайдера и его заголовки, затем отдельно проверьте, как Router обработал результат.
- Если в маршруте остался старый идентификатор Claude 3.5 Sonnet, сначала замените его на модель, доступность которой подтверждена документацией. Не пытайтесь устранить проблему недоступной модели повторными запросами.
- Если источник не подтверждён, сохраните временную отметку, текст ошибки, выбранную модель и доступные журналы. Не меняйте одновременно ключ, модель, лимит и маршрут: тогда будет трудно установить, какое изменение повлияло на результат.
Этот порядок особенно полезен, когда сообщения разных слоёв выглядят похоже. Ошибка в интерфейсе — свидетельство того, что клиент получил неуспешный результат, но не карта всего маршрута. Журнал шлюза показывает, где запрос прошёл или остановился; исходные заголовки дают более точные сведения об ограничении; проверка модели исключает устаревший адрес назначения. Чем больше из этих фактов сохранено, тем меньше риск принять ограничение шлюза за лимит Anthropic или наоборот.
Где заканчивается API-диагностика и начинается среда разработки
Запуск Cursor, локального проекта или самого LiteLLM на Mac не изменяет лимиты API-провайдера. Рабочая станция отвечает за среду разработки и запуск инструментов. Шлюз отвечает за приём и маршрутизацию запросов. Модельный API — за собственный ответ и ограничения. Эти роли полезно разделять и в журнале инцидента, и при выборе инфраструктуры.
Локальная среда удобна, если приложение и шлюз должны работать рядом с проектом и доступны все нужные ресурсы. Но у такого подхода есть издержки: состояние машины может зависеть от локальной конфигурации, доступность сервиса — от запущенных процессов, а воспроизведение проблемы на другом компьютере может потребовать переноса настроек. Удалённый Mac может дать отдельную управляемую среду для разработки и тестирования доступа, но он не снимает ограничения API и не превращается в средство повышения квоты.
Для команд, которым важно отделять рабочую машину от локального окружения, полезно заранее проверить доступ к консоли ProxyMac и справочные материалы ProxyMac. Эти ссылки относятся к организации среды и доступу, а не к лимитам Anthropic: перед переносом задач нужно отдельно определить, где будут храниться секреты, как будет подключаться шлюз и какие журналы доступны для диагностики.
Если нынешняя схема держится на одном постоянно включённом компьютере, она может быть неудобна из-за привязки к конкретной машине, зависимости от её локального состояния и сложностей с воспроизведением сбоя. Аренда Mac у ProxyMac уместна, когда нужен отдельный временный или удалённый контур для разработки и проверки клиентского пути. Она не исправит 429 со стороны модели и не заменит диагностику API; зато позволит отделить проблемы рабочей среды от проблем шлюза и провайдера. Если задача требует постоянной тяжёлой нагрузки или физического подключения оборудования, сначала сравните аренду с собственной машиной. Для временной разработки и проверки маршрута Mac-среда может быть удобнее, чем поддерживать ещё один локальный компьютер, но решение о лимите всё равно принимается по ответу API и журналам.