Claude Code API Error 429 rate limited : comment la corriger

Le texte de l'erreur

API Error: 429 {"type":"error","error":{"type":"rate_limit_error","message":"..."}}

Ce que cela signifie

L'utilisation de l'API en paiement à l'usage n'a pas de quota de 5 heures ni hebdomadaire, mais elle a des limites de débit et de concurrence. Lorsqu'un pic de requêtes les dépasse, les requêtes supplémentaires reçoivent un 429 et peuvent être réessayées peu après.

Correctif étape par étape

1. 1. Réduire le parallélisme

   Fermez les sessions Claude Code supplémentaires et demandez moins de sous-agents parallèles. Les scripts et jobs CI qui partagent la même clé comptent aussi.

2. 2. Patienter et réessayer

   Marquez une courte pause et envoyez à nouveau le message.

3. 3. Séparer les clés

   Donnez à chaque coéquipier ou pipeline sa propre clé afin qu'un job chargé soit facile à repérer dans les relevés d'utilisation.

4. 4. Vérifier le solde et les plafonds

   Si l'erreur mentionne plutôt un solde ou un plafond de dépenses, rechargez ou augmentez le plafond de la clé.

Comment l'éviter

• •Gardez un nombre modéré d'agents simultanés.
• •Ajoutez une nouvelle tentative avec backoff aux scripts et à la CI.
• •Utilisez /compact et /clear pour que chaque tour envoie moins de contexte.

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 un échec en amont est automatiquement réessayé et réussit, vous êtes facturé une seule fois.

Ça ne fonctionne toujours pas ?

• •Consultez la page du modèle sur aicodewith : elle indique l'état récent de chaque canal.
• •Recherchez la requête dans les relevés 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).

État et prix des modèlesContacter le supportDocumentation

FAQ