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 avec facturation par siège) fournit un quota d’utilisation glissant, partagé entre les modèles, à l’exception de quelques plafonds propres à certaines familles de modèles. Ce quota est également partagé avec Claude chat. Lorsque vous l’atteignez, Claude vous bloque avec un message tel que You've hit your session limit · resets 3:45pm. Les offres Enterprise actuelles facturées à l’usage sont l’exception : elles n’incluent aucun quota, et toute l’utilisation est facturée aux tarifs de l’API dès le premier token. L’API Claude mesure autre chose : la vitesse à laquelle vous envoyez les requêtes et les tokens, par minute. Elle vous bloque avec une erreur HTTP 429 de type rate_limit_error, généralement accompagnée d’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 donc attendre la réinitialisation, acheter du quota supplémentaire ou utiliser une réinitialisation gratuite si votre offre vous en a accordé une. 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 offres et les numéros de niveau des limites de débit changent souvent. Un chiffre incorrect est pire qu’une absence de chiffre. Ils ne sont donc pas indiqués ici. Consultez les valeurs de votre compte avec les commandes présentées plus loin.

Quelle limite avez-vous atteinte ? Lisez le message exact

Claude Code indique le système concerné dans le texte affiché. Identifiez le vôtre 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, sur une 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 Opus. Utiliser un modèle qui ne fait pas partie de la famille Opus vous permet de continuer.
• You've hit your Sonnet limit · resets 3:45pm correspond au même type de limite liée à une famille de modèles, mais uniquement pour les requêtes Sonnet. Utiliser un modèle qui ne fait pas partie de la famille Sonnet vous permet de continuer.
• Un message qui commence par Fable limit reached signifie que vous avez utilisé la part de votre quota hebdomadaire que les modèles Fable peuvent consommer. Continuer avec Fable décompte des crédits d’utilisation. Claude Code vous demande donc d’abord de confirmer. Sélectionnez un autre modèle avec /model pour rester dans les limites de votre forfait.
• 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. Avec une clé d’API Anthropic, il s’agit de la limite de débit de votre organisation ou d’une limite inférieure définie sur l’espace de travail auquel la clé appartient. Avec Amazon Bedrock ou Google Cloud, il s’agit du quota de votre projet cloud. Le système concerné 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 indépendante du quota de votre forfait. Claude Code réessaie automatiquement avec un backoff avant d’afficher cette ligne.

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

Un abonnement Pro, Max, Team ou Enterprise basé sur des seats inclut un quota d’utilisation glissant. Lorsqu’il est épuisé, Claude Code bloque les requêtes suivantes jusqu’à l’heure de réinitialisation indiquée dans le message. Deux propriétés 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 effectué dans le terminal. Une après-midi intensive dans le chat réduit donc votre capacité de codage le soir. Toutes les interfaces auxquelles vous vous connectez avec ce compte consomment le même pool. Sous Linux, l’application desktop bêta et la CLI Claude Code se partagent donc un seul quota, et non un quota chacune.
• Il est partagé entre les modèles. Les limites de session et hebdomadaires utilisent un seul pool pour tous les modèles. Les exceptions sont les plafonds propres aux familles de modèles : les limites Opus et Sonnet, ainsi que, sur les seats Max et Premium, une allocation Fable pouvant atteindre 50% de vos limites hebdomadaires. Sur les seats Pro et Standard, Fable n’est pas inclus dans les limites de l’abonnement et est facturé sur les crédits d’utilisation dès la première requête.

Sur Claude for Teams et Enterprise basé sur des seats, le fonctionnement documenté repose sur un quota par seat 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 seat (Standard ou Premium). Les plans Enterprise actuels basés sur l’utilisation fonctionnent différemment : aucun quota inclus ne peut être épuisé, l’utilisation est facturée aux tarifs API et le plafond correspond aux limites de dépenses définies par les administrateurs au niveau de l’organisation et pour chaque utilisateur. Sur un plan accompagné par l’équipe commerciale, une utilisation bloquée par une limite de dépenses reprend au début de la période de facturation suivante, sauf si un owner augmente d’abord la limite. Sur un plan self-serve, l’utilisation s’arrête également lorsque le solde de crédits prépayés est épuisé, jusqu’à ce qu’un owner en achète davantage. Sur Pro et Max, l’heure de réinitialisation affichée dans le message et vos propres barres /usage sont les valeurs fiables, et non un chiffre copié d’un article de blog. Si vous hésitez encore entre plusieurs niveaux, le plan Claude dont vous avez besoin compare les restrictions appliquées par chacun.

Pourquoi changer de modèle avec /model ne rétablit pas une session ou une limite hebdomadaire

C’est l’erreur la plus fréquente, et la documentation est claire : les limites de session et les limites hebdomadaires sont partagées entre tous les modèles. Changer de modèle ne rétablit donc pas l’accès. Sélectionner un modèle plus petit une fois la fenêtre de session épuisée change le modèle qui répondrait. Cela ne modifie pas le quota restant, car les quotas de session et hebdomadaire ne sont pas gérés par modèle. Le changement de modèle ne libère donc rien.

Les plafonds propres aux familles de modèles font exception. Si le message affiche You've hit your Opus limit ou You've hit your Sonnet limit, /model est la correction appropriée. Passez à un modèle qui n’appartient pas à cette famille et poursuivez votre travail, car seules les requêtes de cette famille étaient bloquées. La limite de Fable pour les forfaits Max et Premium fonctionne de la même manière : passez à un autre modèle pour continuer à travailler dans le cadre de votre forfait, ou continuez avec Fable en utilisant des crédits de consommation. Fable utilise toutefois les limites hebdomadaires standard de votre forfait plus rapidement que les autres modèles. Changer de modèle n’ajoute aucun quota : les autres modèles utilisent la même limite hebdomadaire globale, qui continue de s’appliquer et peut toujours être atteinte.

Considérer la limite comme un bug est la deuxième erreur fréquente. Réinstaller l’application ou s’authentifier à nouveau ne change rien. Le quota revient lorsque la fenêtre est réinitialisée ou lorsque vous dépensez un renouvellement gratuit de limite. Acheter des crédits de consommation ne recharge pas ce quota : vos requêtes passent à une facturation à l’usage sur ces crédits et continuent de fonctionner, tandis que les limites incluses sont toujours réinitialisées selon leur calendrier habituel.

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 poste. Avec Claude Code v2.1.234 ou version ultérieure, /rate-limit-options peut attendre la réinitialisation, puis reprendre automatiquement la tâche interrompue.
2. S’il s’agit de la limite Opus, Sonnet ou Fable, exécutez /model et sélectionnez un modèle qui n’appartient pas à cette famille.
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. Consultez Settings > Usage sur claude.ai ou dans Claude Desktop, puis recherchez la section Resets. Certains forfaits peuvent ponctuellement bénéficier d’une réinitialisation gratuite de la limite. Cliquez sur « Reset for free » pour rétablir immédiatement à son maximum votre limite de session de cinq heures ou votre limite hebdomadaire, selon celle concernée par l’offre. Le bouton n’est pas disponible dans Claude Code depuis un terminal ou un IDE, ni dans Claude Mobile. Chaque offre expire.
5. Exécutez /usage-credits pour continuer à travailler au-delà de la limite. Avec Pro et Max, cette commande ouvre vos paramètres de facturation. Avec 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.
6. Si vous atteignez la même limite chaque semaine, le forfait n’est pas adapté à votre manière de travailler. Les solutions pour dépasser une limite d’utilisation méritent d’être examinées une fois, plutôt qu’à chaque réinitialisation.

/usage-credits nécessite un abonnement claude.ai authentifié via /login. Cette option 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. Par défaut, Claude Code conserve le cache des prompts de votre conversation principale pendant une heure lorsque vous restez dans le quota inclus de votre abonnement. Il réduit cette durée à cinq minutes lorsque vous utilisez des crédits. Les tours suivants repartent alors plus souvent de zéro, et la consommation de tokens de Claude Code augmente pour une même tâche. Les sous-agents sont en dehors de ce quota de conversation principale. Leur durée est donc de cinq minutes, même dans le cadre de l’utilisation incluse du forfait. En définissant vous-même le TTL avec le paramètre promptCacheTtl ou CLAUDE_CODE_PROMPT_CACHE_TTL dans Claude Code v2.1.242 ou version ultérieure, vous conservez une durée d’une heure pendant l’utilisation de crédits.

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’aucune ne l’est.

• Un avertissement concernant le contexte ou la compaction automatique n’est pas une limite d’utilisation. /context affiche une ligne telle que Context exceeds the 200k-token limit by 94k tokens, suivie de la commande qui libère de l’espace, lorsque la conversation dépasse la fenêtre de contexte du modèle. La compaction résume l’historique ancien pour libérer de l’espace, mais elle n’est pas gratuite : /compact lit la conversation qu’elle résume. La compaction d’un contexte volumineux constitue donc elle-même une requête importante pour votre forfait. Lorsque vous préférez repartir de zéro plutôt que conserver la continuité, /clear ne coûte rien.
• Prompt is too long · automatic compaction failed: <the underlying error> signifie que la compaction automatique elle-même a échoué à cause de l’erreur indiquée. /compact continue d’échouer avec cette même erreur tant que vous ne l’avez pas résolue.
• Credit balance is too low signifie que votre organisation Console n’a plus de crédits prépayés, ou que Claude Code envoie les requêtes d’un abonné avec une clé API Console ; /status indique quel identifiant est actif. Ajoutez des crédits sur 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 (they take effect after you restart Claude Code), or /model to switch to standard context vérifie les droits d’accès. Il ne signale pas un quota épuisé. Si vous avez sélectionné une variante [1m] d’Opus 4.6 ou de Sonnet 4.6, choisissez la variante sans le suffixe [1m], ou définissez CLAUDE_CODE_DISABLE_1M_CONTEXT=1. Si le message apparaît au milieu d’une conversation parce que le contexte a dépassé 200K tokens, Claude Code compacte automatiquement le contexte pour repasser sous la limite standard. Sonnet 5 et les versions ultérieures, Opus 4.7 et les versions ultérieures, Haiku 5.5 et les modèles Fable utilisent une fenêtre native de 1M et ne comportent aucun suffixe à supprimer ; c’est cette variable qui les limite à 200K.

Une autre erreur vient de l’API. Une erreur 413 request_too_large indique une limite de taille pour une requête unique, 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 a également une limite de dépenses. Il s’agit d’un plafond mensuel différent, qui limite le coût de l’utilisation de l’API. Une fois le plafond de dépenses de votre tier atteint, l’utilisation de l’API est suspendue jusqu’au mois suivant, sauf si vous demandez une limite supérieure. Ce cas renvoie également un 429 rate_limit_error, mais sans en-tête retry-after et avec enforced_spend_limit_reached dans error.details.error_code. Aucune boucle de nouvelle tentative ne permet de résoudre ce problème. Une limite de dépenses inférieure que vous définissez vous-même dans la Console, pour l’organisation ou pour un workspace, se manifeste encore différemment : les requêtes renvoient HTTP 400 invalid_request_error avec un message commençant par You have reached your specified API usage limits, ou You have reached your specified workspace API usage limits pour un workspace. Augmenter ou supprimer cette limite rétablit l’accès. L’exception concerne le workspace Claude Code : les requêtes Claude Code qui dépassent la limite de dépenses de ce workspace peuvent renvoyer un 429 avec un en-tête retry-after.

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

• Les limites sont propres à chaque classe de modèles. Elles s’appliquent séparément à chaque modèle. Vous pouvez donc utiliser plusieurs modèles simultanément, dans la limite propre à chacun. Certaines familles partagent un même compartiment : 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 de se réinitialiser à un instant fixe. Une limite de 60 requêtes par minute peut être appliquée comme une requête par seconde. Dans ce cas, 60 requêtes envoyées simultanément échouent malgré tout.
• 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 au niveau de la limite de débit, en plus de réduire les coûts. Pour les sorties, un max_tokens élevé n’est pas comptabilisé dans l’OTPM, car l’OTPM ne compte que les tokens effectivement produits.
• Les limites sont définies au niveau de l’organisation. Vous pouvez attribuer une limite inférieure à un workspace. Les limites applicables à l’organisation restent toujours en vigueur, même si la somme des limites des workspaces est supérieure. 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 la situation de votre compte. Les nouvelles organisations et celles qui disposent de peu d’historique d’utilisation peuvent commencer dans le tier Evaluation, avec des limites inférieures aux limites standard publiées. Un premier 429 peut donc survenir plus tôt que ne l’indique un tableau. Une forte augmentation de l’utilisation déclenche des limites d’accélération. Celles-ci renvoient des 429 alors que vous êtes encore dans les limites de votre tier. Augmentez donc progressivement le trafic. Chaque valeur publiée est un plafond : les limites documentées représentent l’utilisation maximale autorisée, et non des minimums garantis. Pour demander une limite supérieure, utilisez « Request tier increase » sur la page Rate limits de la Claude Console.

Lire une réponse 429 : retry-after, en-têtes et nouvelles tentatives du SDK

Chaque erreur d’API renvoie la même enveloppe : un objet error imbriqué contenant le type et le message, ainsi qu’un champ request_id au niveau supérieur.

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

Les autres informations se trouvent dans les en-têtes.

• retry-after indique le nombre de secondes à attendre avant de pouvoir réessayer la requête. Les nouvelles tentatives lancées plus tôt échoueront. Les réponses 429 ne le contiennent pas toutes, et la réponse 429 due à la limite de dépenses ne le contient jamais.
• 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 mêmes suffixes indiquant la limite, le quota restant et la réinitialisation.
• anthropic-ratelimit-tokens-* affiche les valeurs correspondant à la limite la plus restrictive actuellement appliquée.

Les en-têtes de réinitialisation contiennent des timestamps RFC 3339. Les en-têtes indiquant le nombre de tokens restants sont arrondis au millier le plus proche. Utilisez-les donc comme une estimation. Le mode Fast possède son propre pool et ses propres en-têtes anthropic-fast-*. Lisez tous ces en-têtes lors de 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 le nom request_id dans les corps de réponse d’erreur et sous le nom _request_id dans les réponses des SDK Python et TypeScript. Indiquez-le lorsque vous contactez le support.

Vérifiez d’abord si vous avez réellement besoin d’une boucle de temporisation avant d’en écrire une. Les SDK officiels relancent automatiquement les erreurs temporaires, notamment les erreurs de connexion, les limites de débit et les erreurs serveur 5xx, avec une temporisation exponentielle. Ils effectuent deux nouvelles tentatives par défaut et respectent l’en-tête retry-after lorsqu’il est présent. Chaque client accepte une option de nombre maximal de nouvelles 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 directement vos 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 permet de basculer entre les dernières 24 heures et les 7 derniers jours. Deux précisions sont nécessaires. 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 qui y figure. 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.

Côté API, la page Usage de la Claude Console affiche deux graphiques : « Rate Limit - Input Tokens » et « Rate Limit - Output Tokens ». Le graphique des entrées compare le maximum horaire de tokens d’entrée non mis en cache par minute à votre limite ITPM actuelle. Il affiche aussi votre taux de cache. Vous pouvez ainsi surveiller l’approche d’une limite avant 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 des identifiants Admin API : une clé Admin API, un token OAuth disposant de la portée org:admin, ou une clé personnelle ou de compte de service qui n’est pas limitée à un workspace. Les clés API de workspace ne fonctionnent pas. GET /v1/organizations/workspaces/{workspace_id}/rate_limits effectue la même opération pour un workspace. Ces deux commandes sont en lecture seule. Pour modifier une limite, utilisez la page Rate limits de la Console.

Utiliser moins, pour rencontrer 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 deux tâches sans rapport ne coûte rien. L’utilisation des tokens de Claude Code couvre complètement 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 également /status : un ANTHROPIC_API_KEY oublié achemine les requêtes via une clé de niveau inférieur au lieu de votre abonnement.
• Déplacer le travail non interactif 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, selon ses propres limites de débit. Une tâche nocturne ne vient ainsi plus concurrencer votre session.

Le travail qui injecte beaucoup de données dans le contexte est le plus sensible à ce problème : si vous analysez des actions et des options avec des données de marché en temps réel, extraire uniquement la portion nécessaire à chaque question coûte une fraction de ce que coûterait le collage de tableaux complets de cours et de chaînes d’options. Le travail par à-coups piloté par un programme plutôt que par une personne doit utiliser une clé d’API dès le départ. Ce déplacement modifie aussi le mode de facturation, en plus du mode de mesure, puisque l’API Claude ne propose pas de niveau gratuit. Les forfaits Max et Team incluent bien des crédits mensuels d’API pour exécuter vos propres applications et agents, une fois que vous avez associé une organisation Console. Ces crédits ne couvrent pas Claude Code et ne modifient pas les limites d’utilisation de votre forfait. 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 continue malgré une coupure de connexion si vous gardez Claude Code exécuté sur un VPS dans tmux.

FAQ

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

Les limites de session et les limites hebdomadaires sont partagées entre tous les modèles. Cette allocation dépend du plan, pas du modèle. /model change donc le modèle qui répond, mais pas l’allocation restante. Les exceptions sont les limites propres à une famille de modèles : You've hit your Opus limit et You've hit your Sonnet limit s’appliquent uniquement à cette famille, et la limite Fable des offres Max et Premium plafonne uniquement Fable. Dans ce cas, changer de modèle est la solution documentée.

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

Elle signifie généralement que votre organisation a atteint une limite de débit pour cette catégorie de modèle : requêtes par minute, tokens d’entrée par minute ou tokens de sortie par minute. La réponse contient généralement un en-tête retry-after indiquant le nombre de secondes à attendre, et les nouvelles tentatives immédiates échouent. Les SDK officiels réessaient déjà automatiquement 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 lorsqu’il est présent. Une erreur 429 reçue alors que vous êtes encore sous les limites de votre niveau indique une limite d’accélération due à une augmentation soudaine du volume. Une erreur 429 avec enforced_spend_limit_reached dans error.details.error_code, qui ne contient jamais d’en-tête retry-after, indique le plafond mensuel de dépenses. Attendre quelques minutes ne le supprimera pas. Les requêtes Claude Code peuvent également recevoir une erreur 429 lorsque l’espace de travail Claude Code atteint une limite de dépenses configurée pour celui-ci.

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

Dans Claude Code, exécutez /usage pour afficher les jauges de votre plan, les heures de réinitialisation et le détail de l’utilisation. /cost est un alias, et d ou w permet de basculer entre les dernières 24 heures et les 7 derniers jours. Ces chiffres proviennent de l’historique de session local. Ils n’incluent donc pas l’utilisation effectuée depuis d’autres appareils ni depuis claude.ai. Pour l’API, la Console affiche vos limites de débit, et GET /v1/organizations/rate_limits renvoie les limites configurées avec des identifiants Admin API, par exemple une clé Admin API.

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

Parfois. Exécutez /usage-credits pour acheter du volume supplémentaire au-delà du plafond avec Pro et Max, ou pour en demander à un administrateur avec Team et Enterprise. Cette commande nécessite une connexion claude.ai via /login et n’est pas disponible avec une authentification par clé API. Sinon, attendez l’heure de réinitialisation, utilisez une réinitialisation gratuite de la limite si Settings > Usage sur claude.ai ou Claude Desktop en propose une, changez de modèle s’il s’agissait de la limite Opus, Sonnet ou Fable, ou déplacez le travail vers une clé API, qui mesure l’utilisation par minute plutôt que par fenêtre.