Après le retrait de Claude 3.5 Sonnet, comment diagnostiquer les erreurs 429 dans Cursor ? (2026)

Cursor affiche « 429 Too Many Requests » et les requêtes cessent de passer.
Le diagnostic le plus fiable consiste à identifier la couche qui renvoie le 429, puis à examiner le corps de réponse, les en-têtes de limitation et les journaux du proxy. Claude 3.5 Sonnet est retiré de l’API depuis le 28 octobre 2025 : une requête qui utilise encore son identifiant doit d’abord être corrigée, pas relancée davantage. Anthropic confirme cette date dans son registre des retraits de modèles.
Cet article s’adresse aux développeurs qui voient une erreur Cursor sans savoir si la requête passe par leur propre clé ou par un service intégré.
Il aide aussi les équipes qui utilisent LiteLLM à distinguer une limite du proxy d’un refus du fournisseur.
Les responsables d’intégrations anciennes y trouveront les vérifications nécessaires pour repérer un identifiant de modèle retiré.
Le code 429 indique une couche, pas encore une cause
Un 429 signifie que la requête a été refusée à la couche qui a répondu. Il ne désigne pas automatiquement Anthropic, Cursor ou LiteLLM comme responsable. Le client peut afficher un message simplifié, tandis que le proxy ou le fournisseur conserve des éléments plus utiles dans les en-têtes et le corps de la réponse.
La première question est donc : quelle réponse est effectivement visible ? Si Cursor contacte directement le fournisseur avec une clé personnelle, la réponse peut provenir de l’API de ce fournisseur. Si la requête traverse LiteLLM, le proxy peut la refuser avant de contacter le modèle, ou transmettre un refus venu de l’amont. Avec un service intégré au client, l’utilisateur n’a pas nécessairement accès à la réponse brute du fournisseur.
Anthropic décrit plusieurs dimensions de limitation, notamment les requêtes par minute (RPM), les jetons d’entrée par minute (ITPM) et les jetons de sortie par minute (OTPM). Une requête peut donc dépasser une contrainte sans que le simple nombre d’appels visibles dans l’éditeur permette de l’expliquer. Les limites applicables dépendent du compte et du contexte ; il ne faut pas déduire une valeur précise à partir d’un message d’erreur générique. La documentation officielle des limites de l’API détaille ces dimensions et les en-têtes associés.
Il faut aussi séparer une limite de débit d’un plafond de dépenses, d’une configuration de compte ou d’un modèle indisponible. Ces problèmes peuvent tous interrompre le travail, mais ils n’appellent pas la même correction. Pour les départager, relevez le code, le type d’erreur, son texte, l’heure de la requête et, lorsque c’est possible, les en-têtes complets. La documentation des erreurs de l’API Claude permet de comparer la réponse observée aux catégories documentées.
Clé personnelle dans Cursor : vérifier la réponse du fournisseur
Dans le parcours avec une clé personnelle, Cursor peut envoyer les requêtes au fournisseur configuré par l’utilisateur. Il faut donc commencer par vérifier le modèle sélectionné et la clé enregistrée, plutôt que d’attribuer immédiatement le problème au service de Cursor. La documentation de Cursor sur la configuration des clés API précise le fonctionnement de cette option et permet de vérifier quel parcours est activé.
Un cas fréquent est celui d’un développeur qui vient de modifier sa configuration, mais qui garde une ancienne sélection de modèle dans un profil ou un projet. L’éditeur peut afficher une erreur après l’envoi, alors que le nom du modèle, la clé et le fournisseur sélectionnés ne correspondent plus. L’ordre de vérification compte : confirmer la clé et le modèle, puis reproduire une seule requête contrôlée et conserver sa réponse.
Lorsque la réponse brute est accessible, examinez le corps et les en-têtes. Si la réponse fournit Retry-After, cette valeur indique le délai à respecter avant une nouvelle tentative ; ne la remplacez pas par une boucle de relance immédiate. Les en-têtes de limitation peuvent apporter des indices supplémentaires, mais leur présence et leur contenu varient selon la réponse. Il faut donc les lire comme des éléments de preuve, et non supposer que chaque erreur comporte tous les champs possibles.
Un 429 dans le parcours avec clé personnelle peut provenir d’une contrainte de débit du compte ou d’une autre règle côté fournisseur. Un refus d’authentification, un identifiant de modèle invalide ou une erreur de configuration constituent d’autres pistes, qui ne deviennent pas des limitations de débit parce que l’éditeur affiche un problème de requête. La distinction repose sur la réponse réelle et les informations disponibles dans le compte fournisseur, pas sur le seul libellé de l’interface.
Service intégré de Cursor : ce que l’utilisateur peut confirmer
Lorsque la requête utilise le service intégré, la responsabilité d’acheminement et les informations accessibles diffèrent du parcours avec une clé personnelle. L’utilisateur peut vérifier le modèle choisi, la fonctionnalité utilisée et le message affiché par Cursor. En revanche, sans réponse amont brute, il ne peut pas affirmer quel plafond interne a été atteint ni reconstituer les limites exactes du compte de service.
Dans ce scénario, il est utile de noter le moment de l’erreur, le modèle sélectionné, l’action qui l’a déclenchée et le message complet. Vérifiez également si l’erreur se reproduit dans une nouvelle conversation ou uniquement dans un projet donné : une différence de comportement peut orienter vers une sélection de modèle ou un contexte de requête distinct. Cela ne suffit toutefois pas à prouver la cause ; c’est un moyen de réduire le périmètre à transmettre au support du service.
Les demandes de vérification doivent porter sur des éléments que le fournisseur peut confirmer : disponibilité du modèle choisi, état du compte ou incident de service associé au moment concerné. Les détails tels que les en-têtes d’origine, le quota exact ou la limite appliquée ne sont pas déductibles d’un message de l’éditeur lorsque ces informations ne sont pas exposées. Une analyse sérieuse distingue donc les faits observés par l’utilisateur des données auxquelles seul le fournisseur a accès.
Cette séparation évite deux erreurs coûteuses : modifier une clé qui n’est pas utilisée, ou multiplier les relances pour un incident que seul le service intégré peut diagnostiquer. Si l’éditeur ne montre pas la réponse amont, conservez les éléments disponibles et demandez une vérification ciblée plutôt que d’inventer une valeur de RPM ou une limite de compte.
LiteLLM : confronter le journal d’entrée au résultat amont
Avec LiteLLM, un 429 peut être généré par le proxy lui-même ou transmis par le service amont. La différence se vérifie dans la chaîne de traitement : une requête refusée par une règle locale n’a pas le même parcours qu’une requête effectivement envoyée au fournisseur, puis rejetée par celui-ci. Le schéma officiel de l’architecture du proxy LiteLLM aide à comprendre ces frontières.
Comparez l’heure et l’identifiant de la requête dans le journal d’entrée avec les événements de routage et le résultat de l’appel amont. S’il n’existe aucune trace d’appel au fournisseur, examinez d’abord les règles appliquées au proxy : clé virtuelle, équipe, configuration du déploiement ou limite de concurrence locale. Si un appel amont a bien eu lieu et que le journal en conserve la réponse, inspectez son corps et ses en-têtes pour déterminer si le 429 a été transmis.
Il faut aussi examiner le groupe de modèles résolu et l’historique de routage. Une demande dirigée vers un groupe peut suivre une route différente de celle attendue ; des tentatives ou un mécanisme de secours peuvent ensuite modifier les traces observées. La documentation de LiteLLM sur les limites appliquées aux utilisateurs du proxy décrit les limites configurables à cette couche. La documentation du routeur LiteLLM couvre le routage et les comportements de nouvelle tentative. Ces références servent ici à interpréter les journaux, pas à déployer un proxy ni à écrire une stratégie de bascule.
Un incident typique survient après l’ajout d’un nouvel utilisateur ou d’une nouvelle équipe : certaines requêtes fonctionnent, puis une autre voie renvoie un 429. Si le proxy n’a enregistré aucune requête amont pour l’échec, augmenter la limite côté fournisseur ne changera rien. À l’inverse, si l’appel amont est présent et que le fournisseur retourne la réponse, modifier uniquement la limite locale ne supprimera pas la contrainte du compte amont.
Ancien identifiant de modèle : ne pas confondre retrait et limitation
Le retrait de Claude 3.5 Sonnet change l’interprétation des configurations anciennes. Le registre officiel indique que l’API Claude Sonnet 3.5 a été retirée le 28 octobre 2025. Une intégration qui continue à envoyer cet ancien identifiant doit être contrôlée avant d’analyser le comportement comme une limite de débit. Le registre des modèles retirés est la référence à consulter pour vérifier le statut.
Recherchez l’identifiant dans les réglages de Cursor, les variables d’environnement, les fichiers de configuration du projet et les correspondances de modèles du proxy. Une ancienne valeur peut se cacher dans un profil partagé ou un groupe de routage, même si la sélection visible dans l’éditeur semble correcte. Vérifiez aussi quelle configuration est réellement chargée au moment de la requête : le fichier modifié n’est pas nécessairement celui qui sert au processus actif.
Après avoir remplacé l’identifiant par un modèle actuellement disponible pour le compte et le parcours concernés, lancez une nouvelle requête et comparez les journaux. Si l’erreur disparaît, l’ancien identifiant était une piste déterminante. Si le 429 persiste, poursuivez le diagnostic à la couche qui répond. Le retrait d’un modèle et une limitation de débit sont deux problèmes distincts ; multiplier les reprises ne rend pas valide un identifiant qui ne l’est plus.
FAQ : interpréter les réponses sans extrapoler
Comment vérifier l’origine d’un 429 lorsque Cursor utilise une clé personnelle ?
Vérifiez dans les réglages que la clé personnelle et le fournisseur concernés sont effectivement sélectionnés. Puis, si le parcours expose la réponse brute, comparez le corps et les en-têtes à la documentation du fournisseur. En l’absence d’en-têtes amont, le texte affiché dans Cursor ne permet pas d’affirmer à lui seul qu’Anthropic a imposé la limitation.
Que signifient Retry-After et les en-têtes de limitation ?
Retry-After fournit un délai d’attente lorsqu’il figure dans la réponse ; il faut le respecter avant de retenter. D’autres en-têtes peuvent renseigner sur la contrainte de débit, mais ils ne sont pas nécessairement tous présents. Enregistrez la réponse réellement reçue et comparez ses champs à la documentation officielle, sans supposer qu’un en-tête absent confirme ou exclut une limite.
Un 429 LiteLLM vient-il forcément du fournisseur du modèle ?
Non. Le proxy peut appliquer une limite à une clé virtuelle, à une équipe ou au déploiement et rejeter la requête avant l’appel amont. Cherchez la trace d’entrée, le routage sélectionné et le résultat amont pour la même requête. Si aucun appel fournisseur n’a eu lieu, commencez par les règles du proxy ; si l’appel existe, examinez la réponse du fournisseur.
Comment contrôler une ancienne référence à Claude 3.5 Sonnet ?
Recherchez l’identifiant dans les sélections de Cursor, les fichiers de projet, les variables de configuration et les tables de correspondance de LiteLLM. Comparez ensuite le modèle résolu au registre officiel des retraits. Une erreur indiquant un modèle retiré ou inconnu ne prouve pas une limitation de débit : corrigez d’abord l’identifiant, puis vérifiez si une réponse 429 subsiste.
Choisir la prochaine vérification à partir des preuves
La branche de diagnostic dépend de ce qui a été réellement observé. Utilisez les conditions suivantes avant de modifier une configuration :
- Si la requête utilise une clé personnelle et que la réponse brute contient un 429 du fournisseur, examinez le corps, les en-têtes et l’état du compte fournisseur ; sinon, confirmez d’abord quel parcours Cursor utilise.
- Si
Retry-Afterest présent, attendez le délai indiqué avant la nouvelle tentative ; s’il est absent, ne lui substituez pas une durée inventée et vérifiez plutôt le corps de réponse et les journaux. - Si LiteLLM a reçu la requête mais n’a enregistré aucun appel amont, examinez ses limites locales, la clé virtuelle et la route sélectionnée ; si l’appel amont est visible, inspectez la réponse transmise par le fournisseur.
- Si l’identifiant Claude 3.5 Sonnet apparaît encore dans la configuration résolue, corrigez-le et vérifiez le statut du modèle avant de diagnostiquer une limitation de débit.
- Si le modèle est valide, mais que les journaux ne permettent pas d’identifier la couche, conservez les traces disponibles et demandez au service concerné de confirmer ce que ses journaux internes montrent.
| Parcours observé | Indice décisif | Vérification prioritaire |
|---|---|---|
| Clé personnelle dans Cursor | Réponse brute ou en-têtes du fournisseur disponibles | Comparer le corps et les en-têtes aux règles du fournisseur |
| Service intégré de Cursor | Message visible, sans réponse amont accessible | Vérifier le modèle, le parcours et les éléments de compte consultables |
| Proxy LiteLLM | Présence ou absence d’un appel amont dans les journaux | Distinguer refus local, routage et réponse transmise |
| Ancien modèle configuré | Identifiant retiré dans la configuration effectivement chargée | Remplacer l’identifiant puis observer une nouvelle réponse |
Ce tableau ne remplace pas les journaux : il indique quel élément rechercher en premier. Un message d’interface reste un indice, pas une preuve suffisante pour attribuer le problème à un fournisseur. En particulier, l’absence d’en-têtes visibles dans Cursor ne signifie pas qu’il n’existe aucune limite ; elle signifie que l’utilisateur n’a pas, à cet endroit, les éléments permettant d’en préciser la nature.
| Élément à conserver | Ce qu’il aide à départager | Limite d’interprétation |
|---|---|---|
| Corps d’erreur complet | Type d’erreur, message et catégorie renvoyée | Le texte peut être simplifié par le client ou le proxy |
| En-têtes de réponse | Délai d’attente et indices de limitation disponibles | Ils peuvent être absents ou différents selon le parcours |
| Journal d’entrée LiteLLM | Requête reçue, identité et route sélectionnée | Ne prouve pas à lui seul qu’un appel amont a eu lieu |
| Résultat de l’appel amont | Réponse du fournisseur ou absence d’appel | Dépend des journaux effectivement conservés |
| Identifiant de modèle résolu | Modèle réellement demandé par le client ou le proxy | Doit être comparé au statut officiel du modèle |
La relance aveugle est rarement un bon premier réflexe. Une stratégie de répétition trop agressive peut augmenter le nombre de requêtes et compliquer la lecture de l’incident. Une bascule vers un autre modèle ne garantit pas non plus un comportement de sortie identique : les réponses peuvent différer et les journaux suivre un autre chemin. Il est donc préférable de corriger le modèle retiré, d’attendre le délai explicitement renvoyé ou de traiter la limite à la couche qui l’impose, selon les preuves disponibles.
Pour conserver une trace exploitable, notez le moment de l’incident, le modèle résolu, le parcours de la requête, le texte d’erreur et les champs de réponse visibles. Dans un environnement avec proxy, ajoutez le résultat de routage et la présence ou l’absence d’un appel amont. Ces informations permettent de comparer une requête fonctionnelle à une requête en échec sans confondre une limite locale, une indisponibilité de modèle et une restriction du fournisseur.
Si le diagnostic pointe vers un problème de modèle ou de compte API, changer de machine ne lèvera pas la limite imposée par le service. En revanche, un environnement de développement séparé peut être utile lorsque la difficulté concerne la configuration locale, les outils ou la reproductibilité des essais. Un Mac distant ne remplace pas l’API Claude et ne constitue pas un correctif à un 429 du fournisseur.
La bonne décision oppose donc l’environnement actuel à un Mac de développement distinct uniquement lorsque le problème est bien lié à l’environnement : une configuration locale difficile à isoler, des outils de développement mélangés ou des essais qui doivent être reproduits dans une session séparée. Si le besoin porte sur une charge stable et permanente ou sur des interfaces physiques particulières, une machine locale peut rester plus appropriée. Pour un environnement temporaire, ProxyMac peut fournir une autre base de travail ; les modalités d’accès sont consultables dans la console ProxyMac et les informations de fonctionnement dans le centre d’aide ProxyMac. Cette option sépare le poste de développement du diagnostic API, sans prétendre résoudre une limitation Anthropic.