Accueil › Claude Code › Erreurs › Surcharge / 529
Vue d’ensembleInstallationréférence de la CLITarifs et limitesAgent SDKCompétences et pluginsGitHubWeb, bureau et IDEModèlesErreursOpen source ?TutorielPour les étudiantsAutomatisation de l’assurance qualitéComparaison avec CursorComparaison avec Codex et OpenCodeSous-agentsHooksMCPÉcosystèmeVS CodeOpenRouterLimites de débitGuide en chinois
Dernière mise à jour : 11 octobre 2026

Erreur « Surchargé » de Claude (erreur API 529) : sa signification et la marche à suivre

API Error: 529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}} signifie que le modèle fonctionne, mais qu’il n’a pas la capacité de traiter votre requête pour le moment. Ce n’est pas une limite de votre compte — tous les utilisateurs de ce modèle rencontrent cette erreur au même moment. Les solutions consistent à attendre de manière judicieuse et à éviter un afflux simultané de requêtes.

TLDR

  • 529 = le modèle est saturé pour tout le monde. Votre clé et votre forfait ne sont pas en cause.
  • Claude Code réessaie automatiquement (« Nouvelle tentative dans N secondes… tentative x/10 ») ; laissez-le faire.
  • Changer de niveau avec /model fonctionne souvent immédiatement — la capacité est propre à chaque modèle.
  • Lancer de nombreux sous-agents à la fois rend les erreurs 529 corrélées ; réduisez le nombre d’exécutions en parallèle.

Ce que vous voyez

API Error (529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}}) · Retrying in 1 seconds… (attempt 1/10)
API Error (529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}}) · Retrying in 2 seconds… (attempt 3/10)

Ces lignes proviennent de #3572, la vague de juillet 2025 qui a recueilli 274 commentaires — dont beaucoup provenaient d’utilisateurs de l’offre Max à $200, ce qui illustre bien le problème : 529 concerne la capacité, et un abonnement plus cher n’en réserve aucune. L’erreur est encore signalée aujourd’hui : #91817 (« tentatives de réessai trop nombreuses »), #91849 et #91825 ont tous été soumis le 3 septembre 2026.

Pourquoi cela se produit

  • Pics de demande sur un modèle. Les nouvelles versions et les matinées en semaine aux États-Unis sont les pics habituels ; le dernier modèle phare est le plus sollicité.
  • Vos propres lancements en parallèle. #90043 a analysé 60 jours de transcriptions et constaté que la plupart des erreurs 529 survenaient par rafales : un orchestrateur lance N agents ensemble, ils sollicitent l’API en même temps, et la plupart des tâches du lot échouent dans la même minute.
  • Travail perdu. #89267 et un signalement connexe indiquent qu’une erreur 529 peut interrompre un sous-agent en arrière-plan au lieu de relancer sa requête — une rafale ne fait donc pas que vous ralentir, elle fait perdre des tâches.

Solutions

  • 1. Laissez le mécanisme de réessai intégré fonctionner. La plupart des erreurs 529 disparaissent au cours des 10 tentatives.
  • 2. Changez de gamme de modèle : /model passez à Sonnet (ou Opus) pour l’étape en cours ; revenez au modèle initial plus tard.
  • 3. Exécutez moins de sous-agents à la fois et échelonnez les lancements en parallèle ; une rafale de premières requêtes simultanées transforme une erreur 529 en dix.
  • 4. Relancez les sous-agents interrompus explicitement — vérifiez que chaque tâche lancée en parallèle est bien terminée.
  • 5. Privilégiez les heures creuses pour les gros travaux : les longues exécutions autonomes risquent bien moins de se heurter aux limites de capacité en dehors des heures de travail aux États-Unis.

529 vs 500 vs 429

  • 529 Surcharge — problème de capacité, qui touche tout le monde et reste temporaire. Attendez ou changez de modèle.
  • 500 — défaillance du serveur. Voir Erreur API 500.
  • 429 — votre propre limite (requêtes, tokens, simultanéité). Voir les limites de débit.

Sur cette passerelle

La passerelle répartit le trafic entre plusieurs comptes en amont et, en cas d’erreur 529, réessaie sur un autre compte avant d’abandonner ; un seul compte saturé ne bloque donc pas votre session. Si un modèle est saturé partout, vous verrez tout de même l’erreur — choisissez une autre gamme de modèle avec /model. La configuration reste la même : ANTHROPIC_BASE_URL=https://aiprimetech.io et une clé de passerelle.

Vous en avez assez de lutter contre ce problème ?

Exécutez plutôt Claude Code via la passerelle AI Prime Tech : les mêmes modèles Claude sur les propres comptes en amont de la passerelle, deux variables d’environnement à modifier pour basculer, et les nouveaux comptes reçoivent 5 $ de crédit API offert avec le code FIXIT — sans carte bancaire.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Créer un compte avec le code FIXIT

Questions fréquentes

Que signifie l’erreur de surcharge de Claude ?

Le modèle n’a aucune capacité disponible à cet instant (HTTP 529, overloaded_error). Cela touche tous les utilisateurs de ce modèle et se résout spontanément.

Comment corriger l’erreur API 529 de Claude ?

Laissez Claude Code réessayer, changez de gamme de modèle avec /model et exécutez moins de sous-agents en parallèle. Pour les gros travaux, choisissez les heures creuses.

Un abonnement Max permet-il d’éviter les erreurs de surcharge ?

Non. 529 concerne la capacité, pas les limites de l’offre — les utilisateurs de Max la signalent aussi souvent que les autres.

Utilisez Claude Code sur la passerelle

Les mêmes modèles, deux variables d’environnement, des crédits valant 7.69231× leur valeur nominale — ou une offre illimitée à tarif forfaitaire. Nouveaux comptes : 5 $ de crédit API offert avec le code FIXIT.

Obtenir une clé API Voir les offres illimitées

AI Prime Tech est une passerelle API indépendante et n’est ni affiliée à Anthropic, ni approuvée ou parrainée par Anthropic. « Claude » et « Claude Code » sont des marques commerciales d’Anthropic. Les fonctionnalités de Claude Code décrites ici correspondent à la documentation publique d’Anthropic au moment de la rédaction et évoluent fréquemment ; les prix et les listes de modèles de cette page proviennent des paramètres en temps réel de cette passerelle.

Autres guides Claude Code

Les erreurs de Claude Code et comment les résoudre« Erreur API : 500 » de Claude Code : sa signification et les solutions qui fonctionnentErreur API 400 de Claude Code : prompt trop long, concurrence des appels d’outils et autres casErreurs OAuth de Claude Code : délai de 15000 ms dépassé et code d’état 500« Le processus Claude Code s’est terminé avec le code 1 » : comment trouver l’erreur réelle et la corrigerClaude : « Prompt trop long », « Entrée trop longue pour le modèle demandé » et « Limite de contexte atteinte » — ce qui remplit la fenêtre et comment libérer de la placeLimite d’utilisation de Claude atteinte : limites de session, hebdomadaires et d’Opus, « limites d’utilisation de l’API spécifiées », « solde de crédits trop faible » — et la marche à suivreClaude Code 401 et 403 : identifiants d’authentification invalides, clé API invalide, « Non connecté », host_not_allowedErreurs de connexion de Claude Code : ECONNRESET, connexion perdue en cours de réponse, « En attente de la réponse de l’API », « Impossible de se connecter à l’API », erreurs de certificat SSLClaude Code se fige, reste bloqué ou ne répond plus : comment trouver où il bloque et le débloquerClaude.ai ne fonctionne pas : « Un problème est survenu », contraintes de capacité, « Limite de 5 heures atteinte », « Erreur lors de votre connexion » et autres cas