Quand Claude Code affiche « limite atteinte », commencez par identifier la limite : abonnement, débit API, plafond de dépenses ou problème de compte. Le bon remède peut être d'attendre une réinitialisation, d'activer des crédits officiels, de réduire les appels simultanés ou de corriger une clé. Acheter un autre forfait avant ce diagnostic risque de laisser le problème intact.
Quel message voyez-vous ?
| Symptôme | Vérification | Action adaptée |
|---|---|---|
| Quota du forfait atteint, heure de reprise affichée | Compte Claude et page d'utilisation | Attendre, comparer un autre forfait ou les crédits d'utilisation |
| API 429 avec indication de débit | Message, requêtes simultanées et en-tête de reprise | Ralentir et respecter le délai communiqué |
| Plafond de dépenses ou paiement refusé | Solde, limites du compte et facturation | Corriger la limite ou le paiement concerné |
| API 401 ou 403 | Clé, domaine de destination et droits | Corriger l'identification ou l'autorisation |
| Conversation trop longue | Taille du contexte et message exact | Résumer le travail et réduire le contexte utile |
Les codes ci-dessous décrivent l'API Anthropic. Si Claude Code passe par un autre fournisseur, consultez également sa documentation : un intermédiaire peut présenter ses propres messages et plafonds.
1. Si vous utilisez un abonnement Claude
Ouvrez les paramètres d'utilisation du compte connecté. Relevez le quota concerné et l'heure indiquée, plutôt que de déduire une durée universelle à partir d'un message trouvé ailleurs. Vérifiez aussi que Claude Code utilise bien le compte attendu.
Anthropic distingue les limites d'utilisation et de longueur. L'utilisation de Claude et de Claude Code peut partager la même allocation du compte. Ouvrir une nouvelle fenêtre ou une nouvelle conversation ne crée donc pas un quota supplémentaire. En revanche, alléger un contexte devenu volumineux peut réduire le travail demandé au modèle lors des appels suivants.
Pour continuer après l'allocation incluse, les forfaits personnels éligibles disposent de crédits d'utilisation officiels. Ils sont facturés séparément, aux tarifs API standard. Dans les paramètres d'utilisation, vérifiez leur activation, les fonds disponibles et le plafond de dépenses. C'est une option à comparer avec l'attente, un changement de forfait ou un compte API distinct.
2. Si l'API renvoie 429
Consultez le texte de l'erreur et les limites API. Pour une limite de débit, réduisez les tâches simultanées et respectez le délai retry-after lorsqu'il est présent. Relancer immédiatement plusieurs agents peut maintenir le même blocage.
Un 429 peut aussi correspondre au plafond mensuel du niveau API ou à certaines limites de dépenses de l'espace Claude Code. Un plafond mensuel peut ne pas fournir de délai de reprise. Vérifiez alors la facturation et le plafond associé au compte ; une boucle de tentatives ne les augmente pas. L'absence d'un en-tête, à elle seule, ne suffit pas à conclure : lisez aussi le message.
3. Si le problème concerne le solde ou l'authentification
La référence des erreurs Anthropic distingue notamment 401 pour l'authentification, 403 pour les droits et 402 pour la facturation. Certaines limites de dépenses peuvent aussi apparaître sous un code 400. Le code HTTP seul ne remplace donc pas le détail de l'erreur.
Vérifiez le domaine auquel la requête est envoyée et le compte qui a créé la clé. Un abonnement Claude, un solde Console et un solde chez un fournisseur tiers ne sont pas interchangeables. Une recharge chez un fournisseur ne finance pas automatiquement les autres. Après correction, utilisez une petite requête pour confirmer le compte débité avant de reprendre une tâche importante.
4. Continuer avec une facturation API séparée
La documentation des passerelles précise qu'un identifiant de passerelle actif remplace l'identité d'abonnement pour la session. Définir uniquement l'adresse de base n'opère pas ce changement : la connexion enregistrée peut rester active. Configurez donc ensemble l'adresse, l'identifiant et le modèle attendus.
Le guide prix et configuration de Claude Code explique la voie Kunavo en français. Le catalogue affiche actuellement Claude Sonnet 4.6 à $1.20 en entrée et $6.00 en sortie par million de tokens. Le guide des prix API Claude détaille les unités à comparer. Une tâche peut contenir plusieurs appels ; son coût dépend aussi du contexte, du cache et des reprises.
Si cette séparation vous convient, créez votre compte Kunavo, configurez une clé, puis contrôlez le premier appel dans votre historique d'utilisation. Ce compte possède ses propres contraintes ; il ne transforme pas Claude Code en service illimité.
Préparer une demande d'aide utile
Si le blocage persiste, conservez les informations suivantes. Elles permettent de distinguer un problème de configuration d'une limite appliquée au bon compte, sans publier votre clé secrète :
Interface et version de Claude Code :
Compte utilisé : abonnement / Console / fournisseur tiers
Modèle et nom de domaine de l'API :
Message exact et code HTTP éventuel :
Heure de réinitialisation affichée :
En-tête retry-after, s'il existe :
Identifiant de requête, s'il existe :Gardez également votre travail local et l'état de la tâche. Après rétablissement de l'accès, demandez à l'agent de vérifier les fichiers déjà modifiés avant de recommencer, afin d'éviter de répéter des étapes achevées ou de perdre le contexte de votre correction.
Questions fréquentes
Que faire quand Claude Code affiche « limite atteinte » ?
Identifiez d'abord le compte qui fournit les réponses. Pour un abonnement, consultez l'heure de réinitialisation et les options de crédits d'utilisation. Pour une API, lisez le message complet : débit, plafond de dépenses, facturation et authentification demandent des corrections différentes.
Un code 429 signifie-t-il toujours qu'il faut attendre ?
Non. L'API Claude utilise aussi 429 pour certains plafonds de dépenses. Un dépassement de débit peut nécessiter une attente et moins de requêtes simultanées ; un plafond financier demande de vérifier les limites et la facturation du compte. Le message et les en-têtes permettent de choisir la bonne branche.
Une nouvelle conversation remet-elle mon quota à zéro ?
Non. Une nouvelle conversation peut réduire le contexte transmis, mais elle ne réinitialise pas l'allocation du compte. La limite de longueur d'une conversation et la limite d'utilisation de votre abonnement sont deux contraintes distinctes.
Une clé Kunavo supprime-t-elle toutes les limites ?
Non. Une configuration API avec une clé Kunavo utilise un compte et une facturation séparés de l'abonnement Claude. Elle reste soumise au solde, aux limites et aux modèles disponibles chez Kunavo. Changer uniquement l'adresse de base sans configurer le bon identifiant ne suffit pas à changer la facturation.
Sources officielles vérifiées le 17 septembre 2026.