Claude Code · Dépannage
Erreur API Claude Code 529 overloaded : causes et correctifs
Une erreur 529 signifie que la requête a atteint l’API, mais que le modèle n’avait pas de capacité disponible à ce moment-là. Ce n’est pas un problème lié à votre clé ou à votre configuration, et cela se résorbe généralement tout seul. Voici comment la distinguer des autres erreurs et continuer à travailler.
Dernière vérification
Le texte de l’erreur
API Error: 529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}}Ce que cela signifie
L’API a accepté votre clé et votre requête, mais le modèle était surchargé et n’a pas pu la prendre en charge. Les pics sont courts et liés à un modèle précis, c’est pourquoi changer de modèle ou attendre une minute fonctionne généralement.
| Vérification | Si oui | Alors |
|---|---|---|
| D’autres requêtes ont fonctionné il y a un instant avec la même configuration | Capacité en amont | Réessayer ou changer de modèle |
| Un seul modèle échoue, les autres fonctionnent | Ce modèle est occupé | Utiliser un autre modèle pour le moment |
| Chaque requête échoue avec des erreurs 401, 404 ou de connexion | Ce n’est pas un problème de 529 | Voir les pages d’erreur associées ci-dessous |
Correctif étape par étape
1. Réessayer
Renvoyez le message après une courte pause. Claude Code conserve la conversation, donc rien n’est perdu.
2. Changer de modèle
Exécutez /model et choisissez un autre modèle Claude (par exemple Sonnet au lieu d’Opus) pour terminer la tâche, puis revenez-y plus tard.
3. Changer de canal
Sur aicodewith, chaque page de modèle indique l’état des canaux. Si un canal est occupé, choisissez-en un autre pour votre clé.
4. Vérifier votre endpoint
Exécutez /status et confirmez que l’endpoint est api.aicodewith.ai. Un mauvais endpoint affiche d’autres erreurs, mais cela vaut la peine de l’écarter.
~/.claude/settings.json{ "env": { "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_API_KEY": "", "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai" } }
Comment l’éviter
- Utilisez Sonnet ou Haiku pour le travail courant et réservez Opus aux problèmes difficiles ; les pics de charge touchent d’abord les plus grands modèles.
- Lancez moins de sous-agents en parallèle pendant les heures de pointe.
- Pour les jobs CI, réessayez avec un backoff au lieu de faire échouer le job à la première 529.
Les requêtes échouées sont-elles facturées ?
Les requêtes échouées (4xx/5xx, timeouts, connexions interrompues) ne sont pas facturées — vous n’êtes facturé que pour les requêtes qui aboutissent. Si une défaillance en amont est réessayée automatiquement et réussit, vous êtes facturé une seule fois.
Ça échoue toujours ?
- Consultez la page du modèle sur aicodewith : elle indique l’état récent de chaque canal.
- Recherchez la requête dans les enregistrements d’utilisation de votre tableau de bord pour voir son modèle, son statut et son coût.
- Envoyez un e-mail à support@aicodewith.com avec l’heure de l’erreur, le modèle et le texte de l’erreur (jamais votre clé API complète).
FAQ
Que signifie l’erreur 529 dans Claude Code ?
Le modèle était surchargé et n’a pas pu accepter la requête à ce moment-là. Votre clé et votre configuration sont correctes ; réessayez, changez de modèle avec /model ou changez de canal.
529 est-elle identique à 429 ?
Non. La 529 concerne la capacité côté modèle. La 429 signifie que vos propres requêtes ont dépassé une limite de débit ou de concurrence.
Puis-je choisir une option moins occupée ?
Oui. Chaque page de modèle liste ses canaux avec leur état récent ; choisissez un canal qui n’est pas surchargé, ou un autre modèle.
Combien de temps dure une 529 ?
Généralement de quelques secondes à quelques minutes. Si elle persiste pour un modèle, passez à un autre modèle ou canal.
Claude Code réessaie-t-il automatiquement ?
Oui, Claude Code réessaie les erreurs de surcharge de lui-même. L’erreur s’affiche lorsque les tentatives sont épuisées.
Les requêtes échouées sont-elles facturées ?
Les requêtes échouées (4xx/5xx, timeouts, connexions interrompues) ne sont pas facturées — vous n’êtes facturé que pour les requêtes qui aboutissent. Si une défaillance en amont est réessayée automatiquement et réussit, vous êtes facturé une seule fois.
Prêt à essayer ?
La facturation est par token, à partir d'un solde prépayé. Des limites de débit et de concurrence s'appliquent, et vous pouvez définir des plafonds de dépenses quotidiens, mensuels ou totaux pour chaque clé API.
Rubriques connexes
Sources
Claude et Claude Code sont des marques d’Anthropic PBC. aicodewith est une plateforme indépendante et n’est ni affiliée à Anthropic ni approuvée par Anthropic. Les formats d’erreur sont cités depuis Claude Code et peuvent changer. Vérifié le 2026-10-10.