Limite d’utilisation Claude atteinte : que faire ?

Quelles sont les limites d’utilisation de Claude ?

Les limites d’utilisation de Claude reposent sur deux systèmes distincts. Commencez par déterminer lequel vous a bloqué. Un abonnement Claude (Pro, Max, Team ou Enterprise) fournit un quota d’utilisation glissant, partagé entre les modèles et avec Claude chat. Il vous bloque avec un message comme You've hit your session limit · resets 3:45pm. L’API Claude mesure autre chose : la vitesse à laquelle vous envoyez des requêtes et des tokens, comptabilisée par minute. Elle vous bloque avec une erreur HTTP 429 de type rate_limit_error et un en-tête retry-after indiquant le nombre de secondes à attendre.

Les solutions n’ont rien en commun. Une limite d’abonnement dépend de la quantité utilisée pendant une fenêtre donnée. Vous devez attendre la réinitialisation du quota ou acheter du volume supplémentaire. Une limite de débit de l’API dépend de votre vitesse actuelle. Elle disparaît en quelques secondes dès que vous ralentissez.

Les quotas des forfaits et les numéros de niveau des limites de débit changent souvent. Un chiffre erroné serait pire qu’une absence de chiffre. Ils ne sont donc pas indiqués ici. Utilisez les commandes plus loin pour lire vos propres valeurs.

Quelle limite avez-vous atteinte ? Lisez le message exact

Claude Code indique le système concerné dans le texte affiché. Vérifiez lequel s’applique avant de modifier quoi que ce soit.

• You've hit your session limit · resets 3:45pm correspond à une limite d’abonnement. Le quota glissant de votre forfait pour cette période est épuisé.
• You've hit your weekly limit · resets Mon 12:00am correspond au même système, mais sur la période plus longue.
• You've hit your Opus limit · resets 3:45pm correspond à une limite d’abonnement qui s’applique uniquement aux requêtes adressées à Opus. C’est le seul cas où changer de modèle peut résoudre le problème.
• API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com. correspond à une limite de débit de l’API. Vous avez atteint la limite configurée pour votre clé d’API, ou pour votre projet Amazon Bedrock ou Google Cloud. Le cas applicable dépend de la méthode d’authentification du client, car un client Bedrock ou Vertex est comptabilisé dans le quota de votre projet cloud, et non dans celui d’une organisation Anthropic.
• API Error: Server is temporarily limiting requests (not your usage limit) correspond à une limitation temporaire sans rapport avec le quota de votre forfait. Claude Code réessaie automatiquement avec un délai croissant avant d’afficher cette ligne.

Limites d’abonnement : session, semaine et fenêtre Opus

Un abonnement inclut un quota d’utilisation glissant. Une fois ce quota épuisé, Claude Code bloque les requêtes suivantes jusqu’à l’heure de réinitialisation indiquée dans le message. Deux caractéristiques de ce quota sont à l’origine de la plupart des confusions.

• Il est partagé avec Claude chat. Le travail effectué sur claude.ai consomme le même quota que le travail réalisé dans le terminal. Une après-midi intensive dans le chat réduit donc votre temps de codage le soir. Toutes les interfaces auxquelles vous vous connectez avec ce compte consomment le même pool. Sous Linux, l’application de bureau bêta et la CLI Claude Code utilisent donc un seul quota commun, et non un quota chacune.
• Il est partagé entre les modèles. Les limites de session et hebdomadaire ne disposent d’aucun budget par modèle. La limite Opus est la seule exception.

Dans Claude pour les offres Teams et Enterprise, la documentation décrit un quota par siège qui se réinitialise selon une fenêtre glissante de cinq heures et une fenêtre hebdomadaire. Ce quota est partagé avec Claude chat et Cowork, et sa taille dépend du niveau du siège (Standard ou Premium). Avec Pro et Max, l’heure de réinitialisation affichée dans le message et vos propres barres /usage sont les valeurs fiables. Ne vous fiez pas à un chiffre copié depuis un article de blog. Si vous choisissez encore un niveau d’abonnement, l’offre Claude dont vous avez besoin compare les restrictions de chaque offre.

Pourquoi changer de modèle avec /model ne rétablit pas l’accès

C’est l’erreur la plus fréquente, et la documentation est claire : les limites de session et hebdomadaires sont communes à tous les modèles. Changer de modèle ne rétablit donc pas l’accès. Sélectionner un modèle moins puissant après avoir épuisé votre fenêtre de session change le modèle qui répondrait. Cela ne modifie pas le quota restant, car ce quota n’a jamais été attribué à un modèle précis. Le changement n’a donc rien à libérer.

L’exception concerne la limite Opus, qui est réellement spécifique à ce modèle. Si le message affiche You've hit your Opus limit, alors /model est la bonne solution. Passez à un autre modèle et continuez à travailler, car seules les requêtes Opus étaient bloquées.

La deuxième erreur consiste à considérer la limite comme un bug. Réinstaller l’application ou s’authentifier de nouveau ne change rien. Le quota redevient disponible lorsque la fenêtre est réinitialisée ou lorsque vous achetez des crédits d’utilisation.

Que faire lorsque vous atteignez une limite d’abonnement

1. Consultez l’heure de réinitialisation. Une fenêtre de session est courte. Une fenêtre hebdomadaire ne se résout pas en attendant devant votre bureau.
2. S’il s’agit de la limite Opus, exécutez /model et sélectionnez un autre modèle.
3. Exécutez /usage pour afficher les limites de votre forfait, vos barres de consommation et leur heure de réinitialisation. /cost est un alias du même écran.
4. Exécutez /usage-credits pour continuer à travailler après avoir atteint la limite. Avec les forfaits Pro et Max, cette commande ouvre vos paramètres de facturation. Avec les forfaits Team et Enterprise, elle ouvre les paramètres d’utilisation de votre organisation ou envoie une demande à vos administrateurs si vous n’avez pas accès à la facturation.
5. Si vous atteignez la même limite chaque semaine, le forfait est mal dimensionné pour votre façon de travailler. Les solutions pour dépasser une limite d’utilisation méritent d’être évaluées une fois, plutôt qu’à chaque réinitialisation.

/usage-credits nécessite un abonnement claude.ai connecté via /login. Cette fonctionnalité n’est pas disponible avec l’authentification par clé API, car une clé API ne dispose d’aucun quota de forfait à étendre.

Les crédits d’utilisation ont un effet secondaire important à connaître. La durée de vie du prompt cache est d’une heure avec un abonnement et passe à cinq minutes lorsque vous utilisez des crédits. Les tours suivants démarrent donc plus souvent sans cache, et l’utilisation des tokens de Claude Code augmente pour le même travail.

Les messages qui ressemblent à des limites d’utilisation, mais qui n’en sont pas

Quatre erreurs de Claude Code sont signalées comme des limites d’utilisation, alors qu’elles ne le sont pas.

• Un avertissement de contexte ou d’auto-compactage n’est pas une limite d’utilisation. /context affiche une ligne telle que Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue. lorsque la conversation dépasse la fenêtre de contexte du modèle. L’historique ancien est résumé pour libérer de l’espace, et votre quota de forfait reste inchangé.
• Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again. signifie que /compact a échoué, car il ne reste pas assez de contexte disponible pour contenir le résumé qu’il produirait.
• Credit balance is too low signifie que votre organisation Console n’a plus de crédits prépayés. Ajoutez des crédits à l’adresse platform.claude.com/settings/billing, qui propose également le rechargement automatique.
• API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context correspond à une vérification des droits, et non à un quota épuisé. Sélectionnez la variante du modèle sans le suffixe [1m], ou définissez CLAUDE_CODE_DISABLE_1M_CONTEXT=1.

Une autre erreur vient de l’API. Une erreur 413 request_too_large indique une limite de taille pour une requête individuelle, et non une limite de débit.

Limites de débit de l’API : ce que le code 429 compte réellement

L’API Messages mesure trois éléments, séparément pour chaque classe de modèles.

• requêtes par minute (RPM)
• tokens d’entrée par minute (ITPM)
• tokens de sortie par minute (OTPM)

Votre organisation dispose également d’une limite de dépenses. Il s’agit d’un plafond mensuel pour le coût d’utilisation de l’API. Une fois le plafond de votre tier atteint, l’utilisation de l’API est suspendue jusqu’au mois suivant, sauf si vous demandez une limite plus élevée. Aucune boucle de nouvelle tentative ne peut résoudre ce problème.

Quatre mécanismes déterminent le moment où le code 429 est renvoyé.

• Les limites s’appliquent à chaque classe de modèles. Elles s’appliquent séparément à chaque modèle. Vous pouvez donc utiliser simultanément plusieurs modèles, jusqu’à leurs limites respectives. Certaines familles partagent un bucket : la limite de débit Opus est commune à Claude Opus 4.8, Opus 4.7, Opus 4.6 et Opus 4.5, tandis que Claude Sonnet 5 dispose de sa propre limite.
• La capacité se reconstitue en continu. L’API utilise un algorithme de token bucket. La capacité se reconstitue donc en continu, au lieu d’être réinitialisée à un moment précis. Une limite de 60 requêtes par minute peut être appliquée comme une requête par seconde. 60 requêtes envoyées simultanément peuvent donc quand même échouer.
• Sur la plupart des modèles, seuls les tokens d’entrée non mis en cache sont comptabilisés dans l’ITPM. input_tokens et cache_creation_input_tokens sont comptabilisés. cache_read_input_tokens ne l’est pas sur la plupart des modèles Claude, Claude Haiku 3.5 constituant l’exception documentée. La mise en cache libère donc de la marge par rapport aux limites de débit et réduit aussi le coût. Pour la sortie, une valeur élevée de max_tokens n’est pas comptabilisée dans l’OTPM, car l’OTPM ne compte que les tokens effectivement générés.
• Les limites s’appliquent au niveau de l’organisation. Un workspace peut recevoir une limite inférieure. Les limites de l’organisation s’appliquent toujours, même si le total des limites des workspaces est supérieur. Une limite que vous n’avez pas remplacée sur un workspace est héritée de l’organisation. Elle n’est pas illimitée.

Les tiers nommés Start, Build, Scale et Custom définissent les valeurs effectives. Ils sont attribués automatiquement selon votre historique d’utilisation et l’état de votre compte. Les nouvelles organisations peuvent commencer avec des limites inférieures aux limites standard publiées. Un premier code 429 peut donc apparaître plus tôt que ne le prévoit un tableau. Une forte hausse de l’utilisation déclenche des limites d’accélération. Celles-ci renvoient le code 429 alors que vous êtes encore dans votre tier. Augmentez donc progressivement le trafic. Chaque valeur publiée est un plafond : les limites documentées correspondent à l’utilisation maximale autorisée, et non à des minimums garantis. Pour demander une limite plus élevée, utilisez la commande "Request rate limit increase" sur la page Limits de la Claude Console.

Lire un code 429 : retry-after, en-têtes et nouvelles tentatives du SDK

Chaque erreur d’API renvoie la même enveloppe : un objet error imbriqué qui contient le type et le message, ainsi qu’un champ request_id de premier niveau.

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "<names the rate limit you exceeded>"
  },
  "request_id": "req_011CSHoEeqs5C35K2UUqR7Fy"
}

Les en-têtes contiennent les autres informations.

• retry-after indique le nombre de secondes à attendre avant de pouvoir relancer la requête. Toute nouvelle tentative effectuée plus tôt échoue.
• anthropic-ratelimit-requests-limit, anthropic-ratelimit-requests-remaining et anthropic-ratelimit-requests-reset décrivent votre budget de requêtes.
• anthropic-ratelimit-input-tokens-* et anthropic-ratelimit-output-tokens-* fournissent les mêmes informations pour ITPM et OTPM, avec les suffixes limit, remaining et reset.
• anthropic-ratelimit-tokens-* affiche les valeurs correspondant à la limite la plus restrictive actuellement appliquée.

Les en-têtes de réinitialisation contiennent des horodatages RFC 3339. Les en-têtes indiquant le nombre de tokens restants sont arrondis au millier le plus proche. Utilisez-les donc comme indicateur. Le mode rapide dispose de son propre pool et de ses propres en-têtes anthropic-fast-*. Lisez tous ces en-têtes dans n’importe quel appel réussi :

curl -s -D - -o /dev/null https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}' \
  | grep -i 'ratelimit\|retry-after\|request-id'

Chaque réponse contient également un en-tête request-id unique, par exemple req_018EeWyXxfu5pfWkrYcMdjWG. Il apparaît sous la forme request_id dans les corps d’erreur et sous la forme _request_id dans les réponses des SDK Python et TypeScript. Indiquez cette valeur lorsque vous contactez le support.

Vérifiez d’abord si vous avez réellement besoin d’une boucle de backoff avant d’en écrire une. Les SDK officiels relancent automatiquement les échecs temporaires, notamment les erreurs de connexion, les limites de débit et les erreurs serveur 5xx, avec un backoff exponentiel, 2 fois par défaut, en respectant l’en-tête retry-after lorsqu’il est présent. Chaque client accepte une option de nombre maximal de tentatives pour modifier ou désactiver ce comportement.

import anthropic

client = anthropic.Anthropic(max_retries=5)  # the SDK default is 2

try:
    msg = client.messages.create(
        model="claude-sonnet-5",
        max_tokens=1024,
        messages=[{"role": "user", "content": "hello"}],
    )
except anthropic.RateLimitError as err:
    headers = err.response.headers
    print("still limited after retries; wait", headers.get("retry-after"), "seconds")
    print("request id:", headers.get("request-id"))

529 overloaded_error n’est pas de votre fait

Un code 429 indique que vous avez envoyé des requêtes trop rapidement. Un code 529 overloaded_error indique que l’API est temporairement surchargée. Cela peut se produire lorsque le trafic est élevé pour l’ensemble des utilisateurs de l’API. Votre clé et votre code ne sont pas en cause. Effectuez une nouvelle tentative avec un backoff exponentiel. Les SDK le font déjà pour les réponses 5xx. Si le problème persiste, consultez status.claude.com. Un code 500 api_error correspond à une erreur interne que vous devez traiter de la même manière. Aucun de ces deux codes n’est une limite de débit.

Consultez vos propres limites plutôt qu’un tableau

Avec un abonnement, /usage est l’écran important. Il affiche les barres d’utilisation de votre forfait et le détail de ce qui les a consommées. d ou w permettent de basculer entre les dernières 24 heures et les 7 derniers jours. Deux points sont à noter. Le bloc Session affiche l’utilisation des API tokens et s’adresse aux utilisateurs de l’API. Les abonnés peuvent donc ignorer le montant en dollars affiché. Les chiffres proviennent de l’historique local des sessions sur cette machine. L’utilisation depuis un autre appareil ou depuis claude.ai n’est donc pas incluse.

Du côté de l’API, la page Usage de la Claude Console affiche deux graphiques : « Rate Limit - Input Tokens » et « Rate Limit - Output Tokens ». Le graphique d’entrée représente le maximum horaire de tokens d’entrée non mis en cache par minute, comparé à votre limite ITPM actuelle. Votre taux de cache est affiché à côté. Vous pouvez ainsi surveiller l’approche d’une limite au lieu d’attendre de l’atteindre en production.

Pour lire vos limites configurées par programmation :

curl -s https://api.anthropic.com/v1/organizations/rate_limits \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"

Cette opération nécessite une clé Admin API. GET /v1/organizations/workspaces/{workspace_id}/rate_limits fournit la même information pour un workspace. Ces deux opérations sont en lecture seule. Pour modifier une limite, utilisez l’onglet Limits dans la Console.

Utiliser moins pour subir moins de limites

Les deux systèmes mesurent la même chose en interne. Ces leviers fonctionnent donc dans les deux cas.

• Dépenser moins de tokens par tour. Les sessions continues gardent le cache à chaud, et /clear entre des tâches sans rapport ne coûte rien. La consommation de tokens de Claude Code couvre entièrement ces leviers.
• Réduire l’effort. Les niveaux sont low, medium, high, xhigh et max. Le menu /effort propose aussi ultracode, qui augmente la dépense au lieu de la réduire. Un raisonnement approfondi n’apporte rien pour un renommage mécanique.
• Réduire la concurrence après une erreur 429. Diminuez CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY et évitez de lancer de nombreux sous-agents en parallèle. Exécutez aussi /status : un ANTHROPIC_API_KEY résiduel fait passer les requêtes par une clé de niveau inférieur au lieu de votre abonnement.
• Déplacer les tâches non interactives vers l’API Message Batches. Elle traite de gros volumes de manière asynchrone, avec une remise de 50% sur les tokens d’entrée et de sortie, et dispose de ses propres limites de débit. Une tâche nocturne cesse ainsi de concurrencer votre session.

Les tâches qui injectent beaucoup de données dans le contexte sont les plus touchées : si vous analysez des actions et des options avec des données de marché en temps réel, extraire la portion nécessaire à chaque question coûte une fraction de ce que coûte le collage de tableaux complets de cotations et de chaînes d’options. Les tâches exécutées par un programme plutôt que par une personne doivent utiliser une clé d’API dès le départ. Ce changement modifie à la fois votre mode de paiement et votre mode de comptabilisation, car l’API Claude ne propose pas de niveau gratuit au-delà du petit crédit accordé lors de l’inscription. Votre première application Claude API sur un VPS explique la gestion des clés et les nouvelles tentatives. Une longue exécution d’agent survit à une coupure de connexion si vous gardez Claude Code exécuté sur un VPS dans tmux.

FAQ

Pourquoi changer de modèle ne résout-il pas ma limite d’utilisation de Claude ?

Les limites par session et les limites hebdomadaires sont communes à tous les modèles. Le quota dépend du forfait, et non du modèle. /model détermine donc le modèle qui répond, mais pas le quota restant. La seule exception est You've hit your Opus limit, qui s’applique uniquement aux requêtes vers Opus. Dans ce cas, changer de modèle est la solution indiquée dans la documentation.

Que signifie l’erreur 429 rate_limit_error et combien de temps dois-je attendre ?

Cette erreur signifie que votre compte a atteint une limite de débit pour cette catégorie de modèles : requêtes par minute, tokens d’entrée par minute ou tokens de sortie par minute. La réponse contient un en-tête retry-after indiquant le nombre de secondes à attendre. Les nouvelles tentatives effectuées trop tôt échouent. Les SDK officiels relancent déjà automatiquement les requêtes après les limites de débit et les erreurs 5xx, avec un backoff exponentiel, deux fois par défaut, en respectant cet en-tête. Une erreur 429 qui survient alors que vous êtes encore dans les limites de votre niveau indique probablement une limite d’accélération due à une augmentation soudaine du trafic.

Comment consulter mes limites d’utilisation de Claude et connaître leur réinitialisation ?

Dans Claude Code, exécutez /usage pour afficher les barres correspondant à votre forfait, les heures de réinitialisation et le détail de l’utilisation. /cost est un alias. d ou w permet de basculer entre les dernières 24 heures et les 7 derniers jours. Ces chiffres proviennent de l’historique local des sessions. Ils ne tiennent donc pas compte de l’utilisation depuis d’autres appareils ni depuis claude.ai. Pour l’API, la Console affiche vos limites de débit. GET /v1/organizations/rate_limits renvoie vos limites configurées lorsqu’il est utilisé avec une clé API Admin.

Puis-je continuer à travailler après avoir atteint la limite de mon forfait Claude ?

Parfois. Exécutez /usage-credits pour acheter du quota supplémentaire au-delà de la limite avec les forfaits Pro et Max, ou pour en demander l’activation à un administrateur avec les forfaits Team et Enterprise. Cette commande nécessite une connexion à claude.ai via /login. Elle n’est pas disponible avec une authentification par clé API. Sinon, attendez l’heure de réinitialisation, changez de modèle s’il s’agissait de la limite Opus, ou utilisez une clé API. Celle-ci applique une facturation à la minute plutôt que par fenêtre.