« Erreur API : 500 » de Claude Code : sa signification et les solutions qui fonctionnent

Les messages exacts

API Error: 500 {"type":"error","error":{"type":"api_error","message":"Internal server error"}}
API Error: 500 {"type":"error","error":{"type":"api_error","message":"Internal server error"},"request_id":null}
[Bug] Anthropic API Error: 500 Internal Server Error

Les trois correspondent à la même défaillance. Les deux premiers sont ceux qu’affiche le CLI ; le troisième est le titre des rapports de bug générés automatiquement que Claude Code soumet via /bug, ce qui explique pourquoi le suivi contient des centaines de tickets identiques — les plus récents de ce lot ont été déposés le 16 septembre et 22 septembre 2026, le dernier signalant à la fois des erreurs 500 et 529.

Pourquoi cela se produit

• Incident en amont. C’est de loin la cause la plus courante. Lorsqu’Anthropic subit une panne partielle, tous les utilisateurs d’un modèle voient des erreurs 500 au même moment — la vague de janvier 2026 dans #9066 a reçu une réponse du personnel d’Anthropic contenant un seul lien : la page d’état.
• Un modèle dégradé, les autres fonctionnent normalement. Les erreurs 500 sont souvent propres à un modèle. Dans #3127 la solution ayant reçu le plus de votes consistait simplement à passer d’Opus à Sonnet ; la même session fonctionnait alors.
• Contexte épuisé, compactage échoué. Le signalement initial #3127 a rencontré l’erreur 500 « lorsque le contexte restant est exactement de 0 % et que Claude Code n’a pas réussi à le compacter automatiquement ». Une requête trop volumineuse peut se manifester par une erreur 500 plutôt que par l’erreur plus explicite Prompt is too long 400.
• Une structure de requête particulière que le backend ne parvient pas à traiter. Plus rare ; #91801 des erreurs 500 ont été reproduites avec certains préfixes de prompt. Si un message provoque systématiquement une erreur 500 et que les autres n’en provoquent pas, modifiez ce message.

Solutions, dans l’ordre à essayer

• 1. Consultez status.claude.com. S’il y a un incident, aucune action de votre côté ne sera utile — attendez qu’il soit résolu.
• 2. Reprenez, ne redémarrez pas : claude -c reprend la dernière session ; le tour inachevé est relancé.
• 3. Changez de gamme de modèle pour la tâche en cours : /model → Sonnet si vous utilisiez Opus/Fable, ou l’inverse. La capacité et les défaillances sont propres à chaque modèle.
• 4. Si l’indicateur de contexte était proche de 0 % : /compact (ou /clear et redonnez les consignes), puis continuez. Passer à une (1M) variante du modèle fonctionne également.
• 5. Mettez à jour : claude update. Plusieurs bugs liés à 500 ont été corrigés côté client au fil du temps.
• 6. L’échec persiste sur un message précis ? Reformulez-le ou scindez-le — une erreur 500 liée à la structure de la requête est déterministe.

claude -c              # resume the session
/model claude-sonnet-5 # inside the session: another tier
/compact               # if the context was exhausted
claude update          # latest CLI

500 vs 529 vs 429

• 500 — le serveur a échoué. Réessayez, changez de modèle, vérifiez l’état du service.
• 529 — le serveur fonctionne, mais sa capacité est saturée (overloaded_error). Consultez le guide sur la surcharge.
• 429 — *vous* avez dépassé une limite. Consultez les limites de débit.
• 400 — la requête elle-même a été rejetée. Consultez Erreur API 400.

Pourquoi les passerelles en voient moins

Une erreur 500 provenant d’un compte en amont ne constitue un point de défaillance unique que si vous n’avez qu’un seul compte en amont. Cette passerelle en regroupe plusieurs et bascule une requête vers un autre lorsqu’un compte renvoie 500 ou 529, si bien que la plupart des erreurs 500 transitoires n’atteignent jamais votre terminal. Un véritable incident touchant l’ensemble du fournisseur vous atteint malgré tout — personne ne peut contourner l’indisponibilité du modèle. Configurez Claude Code pour utiliser cette passerelle avec ANTHROPIC_BASE_URL=https://aiprimetech.io et une clé de passerelle.

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

Questions fréquentes

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.