Erreur 529, surcharge, panne : ce que Claude te dit
Un message rouge apparaît en plein travail. Erreur 529. Tu ne sais pas si c’est ton ordinateur, ta connexion, ton abonnement ou toi qui as fait une bêtise. Tu recharges, tu réessaies, et tu perds vingt minutes à te demander s’il faut payer plus cher pour que ça cesse.
Le premier chiffre du code donne la réponse. Une erreur en 4xx vient de ta demande — clé, facturation, limite, taille. Une erreur en 5xx vient de leurs serveurs, et la 529 en particulier signifie simplement que le service est temporairement surchargé. Tu n’as rien cassé.
La règle du premier chiffre
Il y a une chose à retenir de tout cet article, et elle tient en un chiffre.
Les codes d’erreur commencent par 4 ou par 5. Ce premier chiffre dit à qui est le problème.
Une erreur qui commence par 4 concerne ta demande : ta clé, ta facturation, ta limite, la taille de ce que tu envoies. Il y a quelque chose à corriger de ton côté.
Une erreur qui commence par 5 concerne leurs serveurs. Ta demande était valable, elle n’a simplement pas pu être traitée. Il n’y a rien à corriger chez toi.
Cette distinction règle à elle seule 90 % de l’angoisse. Avant de chercher ce que tu as cassé, regarde le premier chiffre.
Les erreurs qui viennent de chez eux
529 — surcharge. La documentation la nomme overloaded_error et la définit ainsi : le service est temporairement surchargé. Elle survient quand le trafic est élevé pour tout le monde, pas quand ton projet pose problème.
C’est la plus fréquente aux heures de pointe, et c’est la plus anxiogène parce qu’elle tombe sans prévenir au milieu du travail. Elle ne veut rien dire sur toi.
500 — erreur interne. Nommée api_error, elle signale un problème inattendu dans leurs systèmes. La recommandation officielle est de réessayer en espaçant progressivement les tentatives.
504 — délai dépassé. La demande a mis trop de temps à être traitée. Elle concerne surtout les traitements très longs.
Dans les trois cas, tu n’as rien à réparer. Tu as à attendre.
Les erreurs qui viennent de chez toi
429 — limite de débit atteinte. Celle-ci est à part, parce qu’elle est fréquente et souvent mal comprise. Elle ne signifie pas que le service est en panne : elle signifie que ton compte a atteint une limite. C’est une contrainte de rythme, et elle se traite en ralentissant — c’est le sujet de ce que veut dire « limite atteinte ».
401 — problème d’authentification. Ta clé est mal formée, révoquée ou expirée. Si tu viens d’en changer, c’est presque toujours celle-là. Attention : une clé révoquée ne redevient jamais valable, il faut en créer une nouvelle.
402 — problème de facturation. Un moyen de paiement à mettre à jour. Rien de technique.
403 — permission refusée. La clé est valable mais n’a pas le droit d’accéder à ce que tu demandes.
413 — demande trop lourde. Tu envoies plus que la taille maximale autorisée. En pratique : un fichier joint trop gros, ou une conversation devenue énorme.
400 — demande mal formée. Le fourre-tout des problèmes de format. Si tu passes par un outil et non par du code à toi, elle vient généralement de l’outil, pas de toi.
Ce qu’il faut faire, dans l’ordre
Regarde le premier chiffre. Cinq minutes de panique évitées.
Si c’est un 5, ouvre la page d’état. Elle est publique et s’appelle status.claude.com. Un incident déclaré t’épargne toute recherche. Si la page est verte et que l’erreur revient sans arrêt, alors seulement soupçonne ton côté.
Si c’est un 5, ne relance pas en boucle. C’est le réflexe naturel et c’est le mauvais : sur un service saturé, marteler ajoute à la saturation. Attends, puis espace tes tentatives.
Si c’est un 4, lis le nom de l’erreur, pas seulement son numéro. Chaque code a un nom qui dit exactement ce qui cloche : problème d’authentification, de facturation, de permission, de taille. Le nom est plus utile que le chiffre.
Ce qu’il ne faut pas faire
Demander à l’IA de réparer l’erreur. Sur une 529, il n’y a rien à réparer, et l’outil qui te répond est justement celui qui est saturé. Sur une 401, elle ne peut pas voir ta clé. Dans les deux cas, tu ajoutes des allers-retours à un problème qui n’en demande aucun.
Changer ton code parce qu’une erreur est apparue. C’est le meilleur moyen de casser quelque chose qui marchait, pour un problème qui venait d’ailleurs et qui aurait disparu tout seul. Si tu l’as déjà fait, reviens en arrière avant toute chose.
Créer une nouvelle clé « au cas où ». Sauf sur une 401 avérée, ça ne règle rien et ça t’oblige à remplacer la clé partout où elle était déjà installée.