You've hit your session limit dans Claude Code : heure du reset de la limite et que faire (anciennement « Claude usage limit reached »)

Vous trouvez enfin votre rythme dans Claude Code, et ceci vous coupe net dans votre élan :

You've hit your session limit · resets 3:45pm

Autrement dit, vous avez épuisé, pour le moment, ce que votre forfait actuel autorise. Ce n'est ni une erreur ni un bug : c'est ainsi que fonctionnent les limites d'usage des abonnements (Pro / Max et similaires). La référence officielle des erreurs en liste quatre variantes, selon le quota épuisé (les heures sont des exemples) :

You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm
You've hit your Sonnet limit · resets 3:45pm

Les versions précédentes affichaient Claude usage limit reached. Your limit will reset at 3pm (America/Santiago). (la section 1 retrace l'évolution du texte). Ce qui agace, c'est qu'on ne voit pas clairement quel quota on a atteint, quand il revient, ni ce qu'on peut faire en attendant. Cet article détaille le sens des quatre messages, la structure de la limite à deux niveaux (5 heures + hebdomadaire), ce qui fait grimper la consommation, quoi faire au moment où vous atteignez le plafond, comment voir ce qu'il reste et la porte de sortie par l'API — d'après la documentation officielle.

Trois points clés d'emblée. (1) session limit est la fenêtre glissante de 5 heures et weekly limit la fenêtre hebdomadaire ; toutes deux sont communes à tous les modèles, donc changer de modèle ne rétablit pas l'accès. (2) Opus limit / Sonnet limit ne concernent que cette famille de modèles : passer avec /model à un modèle d'une autre famille vous permet de continuer. (3) Si vous pouvez attendre, Claude Code v2.1.234 et versions ultérieures peuvent reprendre votre tâche automatiquement après la réinitialisation. Sinon, passez aux crédits d'usage ou à l'API à l'usage. Les montants par forfait changent au fil du temps, alors confirmez toujours les chiffres dans la vue officielle en direct (/usage ou Settings → Usage).

Vous cherchez l'heure du reset ? Elle figure dans le message lui-même (« resets 3:45pm », à votre heure locale) : pour une limite de session, c'est la fin de la fenêtre glissante de 5 heures ; pour la limite hebdomadaire, le jour et l'heure indiqués, parfois dans plusieurs jours. Dans Claude Code, /usage affiche quand chaque quota se réinitialise ; sur claude.ai, Settings → Usage donne la date de réinitialisation hebdomadaire (section 5). La documentation officielle n'indique aucun moyen d'avancer le reset : Claude Code bloque les requêtes jusqu'à l'heure affichée. Pour continuer avant, changez de modèle si c'est une limite Opus ou Sonnet, sinon passez aux crédits d'usage ou à l'API (section 4).

1. Ce que dit le message — session, weekly, Opus, Sonnet

Le message actuel prend la forme « You've hit your [X] limit · resets [heure] » (« vous avez atteint votre limite [X] · réinitialisation à [heure] ») et nomme le quota épuisé. Selon la documentation officielle, Claude Code bloque les requêtes suivantes jusqu'à l'heure de réinitialisation affichée. L'heure est votre heure locale, et les signalements sur le dépôt officiel montrent souvent le fuseau horaire entre parenthèses, comme dans resets 4:20am (Europe/Rome).

Le point essentiel, c'est que c'est voulu par conception, pas un dysfonctionnement. Les forfaits Pro / Max de Claude ne sont pas « illimités » — il existe un plafond d'usage par fenêtre de temps et par semaine. Et Claude Code (CLI) et les applications Claude (web/desktop) partagent le même quota de forfait — l'aide officielle indique que « toute activité dans les deux outils est décomptée des mêmes limites d'usage. » Il est donc parfaitement normal que « j'ai utilisé le chat ET lancé Claude Code, et ensemble ils ont épuisé le quota plus vite. »

Deux autres lignes apparaissent dans la même situation. Elles concernent les mêmes quotas que les quatre messages ci-dessus.

• Usage limit reached · continuing automatically at 3:45pm · esc to cancel — Claude Code attend pour reprendre la tâche interrompue après la réinitialisation (v2.1.234 et ultérieures ; voir la section 4)
• You've used 85% of your session limit · resets 3:45pm — un avertissement avant que la fenêtre ne s'épuise

À l'inverse, les messages suivants ne signifient pas que votre quota de 5 heures ou hebdomadaire est épuisé, donc la solution est différente.

• API Error: Server is temporarily limiting requests (not your usage limit) — un bridage bref côté serveur, sans lien avec votre forfait. Patientez un peu et réessayez (depuis la v2.1.199, il est réessayé automatiquement avant d'être affiché)
• You've hit your monthly spend limit · raise it at claude.ai/settings/usage — les crédits d'usage qui paient ce qui dépasse votre forfait ont atteint une limite de dépense mensuelle. Relevez la limite, ou attendez la réinitialisation de la fenêtre du forfait si le message en indique une (sur Team / Enterprise, on lit individual spend limit, org's monthly spend limit, etc.)
• Usage credits required for 1M context — une vérification de droit d'usage pour la fenêtre de contexte de 1M de tokens, pas un quota épuisé. Revenez avec /model à un modèle sans le suffixe [1m]
• Request rejected (429) — une limite de débit d'une clé API ou d'un fournisseur cloud (voir la section 6)

2. La limite à deux niveaux — 5 heures + hebdomadaire (+ plafonds par modèle)

En août 2025, Anthropic a ajouté des limites d'usage hebdomadaires à Pro / Max, en plus de la fenêtre de 5 heures existante (en réaction aux gros utilisateurs qui le faisaient tourner en continu). Résultat : la limite d'abonnement actuelle compte deux étages. Selon la documentation officielle, l'usage est décompté en même temps sur le quota de session et sur le quota hebdomadaire, si bien qu'une seule rafale d'activité intense, comme un gros workflow réparti en parallèle, peut épuiser le quota hebdomadaire avant que la fenêtre de session ne se réinitialise.

L'exception est Ultra, le forfait à 200 $ (anciennement Max 20x, renommé le 31 octobre 2026). Selon l'aide d'Anthropic « What is the Ultra plan? », les comptes Ultra vérifiés n'ont pas de fenêtre de 5 heures : seulement le quota hebdomadaire (10 fois celui de Pro) et le quota hebdomadaire de Fable. Anthropic vérifie les comptes automatiquement à partir de l'historique du compte et des paiements ; tant que ce n'est pas fait, une limite temporaire de 5 heures s'applique. Si Settings → Usage n'affiche pas de barre « Current session », le compte est vérifié et le message session limit n'apparaît pas. Le forfait Max à 100 $ offre 5 fois le quota de Pro, sur la fenêtre de 5 heures comme sur la semaine (voir « What is the Max plan? » ; les deux vérifiées le 31 octobre).

Dans son guide d'origine (août 2025), Anthropic donnait des estimations approximatives du type « Pro : ~40-80 heures de Sonnet par semaine » et « Max 20x (aujourd'hui Ultra) : ~240-480 heures de Sonnet + ~24-40 heures d'Opus par semaine. » Cependant, Anthropic a depuis largement cessé de publier des chiffres d'heures fixes, et les limites ont été révisées à plusieurs reprises (même en 2026, des augmentations de la fenêtre de 5 heures ont été rapportées). Considérez donc ces chiffres comme des « estimations de l'époque », et confirmez toujours votre quota actuel dans la vue d'usage officielle. Cet article évite délibérément d'affirmer des valeurs actuelles précises.

3. Ce qui épuise votre quota

« Ça s'est épuisé plus vite que prévu » se ramène presque toujours à ces quatre facteurs, classés par impact.

En bref, plus le modèle est lourd, plus le contexte est grand, plus l'exécution est longue et parallèle, plus le quota fond vite. À l'inverse, abaisser délibérément ces quatre facteurs fait durer le même forfait nettement plus longtemps. Pour une optimisation globale, voir l'optimisation des coûts du codage IA, et pour des tactiques concrètes d'économie de tokens, voir l'économie de tokens dans Claude Code.

4. Cinq façons de continuer à travailler maintenant

Cinq manœuvres pour le moment où vous atteignez le plafond, selon la situation. Le choix dépend de « quel quota avez-vous atteint ? » (session / weekly / Opus / Sonnet dans le message) et de « pouvez-vous attendre ? ». Taper /rate-limit-options dans Claude Code affiche les choix dans un seul menu : attendre et continuer automatiquement, ajouter des crédits d'usage ou monter de forfait (la commande n'apparaît pas dans le menu des commandes, tapez-la en entier).

L'option C (attendre) est devenue quasi automatique avec la v2.1.234. Dans une session interactive connectée avec un abonnement claude.ai, quand une limite d'usage interrompt Claude en pleine tâche, Claude Code attend dans la session ouverte et poursuit la tâche après la réinitialisation. Pendant l'attente, une ligne en bas de la session indique :

Usage limit reached · continuing automatically at 3:45pm · esc to cancel

À la réinitialisation, il ne renvoie pas votre dernier message ; il envoie à Claude une consigne fixe pour reprendre la tâche là où elle s'était arrêtée. Les demandes d'autorisation s'affichent toujours comme d'habitude, donc la tâche peut s'arrêter sur l'une d'elles pendant votre absence. Pour annuler une attente, appuyez sur Esc avec un prompt vide ; pour désactiver complètement la reprise automatique, désactivez Continue automatically at usage limit dans /config. Claude Code ne lance pas l'attente de lui-même quand la réinitialisation est à plus de 24 heures (une limite hebdomadaire, par exemple) : ouvrez alors /rate-limit-options et choisissez Wait here, then continue automatically. Dans l'onglet Code de l'application de bureau, la carte de la limite de session propose une case Auto-continue when limits reset (pas celle de la limite hebdomadaire).

Connaître le basculement vers l'API (D) comme « porte de sortie » est puissant. Contrairement aux fenêtres de temps de l'abonnement, l'API n'a pas de réinitialisation de 5 heures ni hebdomadaire à attendre (vous payez ce que vous consommez ; elle a en revanche des limites de débit par minute et un plafond de dépense mensuel — voir la section 6). Voir Qu'est-ce qu'une API d'IA. Sur Pro / Max, activer les crédits d'usage avec /usage-credits (anciennement /extra-usage) permet de continuer au-delà du quota inclus, aux tarifs API standard (aide officielle). Sur Team / Enterprise, la même commande envoie une demande à votre administrateur.

5. Comment voir ce qu'il vous reste

Si vous pouvez voir « combien il reste », vous pouvez éviter totalement d'atteindre le plafond. Trois façons de vérifier.

1) Le /usage de Claude Code : affiche ce que vous avez consommé de chaque quota du forfait et quand chacun se réinitialise (/cost et /stats en sont des alias). Sur Pro, Max, Team et Enterprise, il affiche aussi une répartition par skill / sous-agent / plugin / serveur MCP (appuyez sur d / w pour basculer entre les dernières 24 heures et 7 jours ; la répartition est calculée à partir de l'historique de cette machine, donc l'usage sur d'autres appareils ou sur claude.ai n'est pas inclus). Il n'indique pas en revanche quelle session a consommé (comment voir l'usage par session). Avant qu'une fenêtre ne s'épuise, un avertissement comme You've used 85% of your session limit · resets 3:45pm peut apparaître, et vous pouvez garder rate_limits (pourcentage d'usage et heure de réinitialisation des fenêtres de 5 heures et de 7 jours) dans votre ligne d'état. 2) Application web/desktop : Settings → Usage affiche votre forfait, l'usage restant et la date de réinitialisation hebdomadaire ; dans l'application de bureau, l'anneau d'usage à côté du sélecteur de modèle l'affiche aussi. 3) Utilisateurs de l'API : les pages Usage / Limits de la Console et les en-têtes de réponse anthropic-ratelimit-*. Le bloc Session de /usage affiche un coût estimé calculé à partir des tokens. Notez que /status n'affiche pas votre quota : il indique avec quel compte et quel identifiant vous êtes connecté (voir la section 6).

6. Limites de l'abonnement vs limites de l'API

On les confond facilement, mais les limites de l'abonnement (Pro/Max) et les limites de l'API sont des systèmes entièrement différents. Connaître la différence rend la décision de basculer rapide quand ça compte.

L'essentiel : l'abonnement vous arrête par fenêtre de temps, alors que l'API n'a ni fenêtre de 5 heures ni fenêtre hebdomadaire. Donc pour un travail à échéance que vous ne pouvez vraiment pas arrêter, basculer sur une clé API est la manœuvre standard. Après la bascule, lancez /status pour confirmer l'identifiant actif. Une ANTHROPIC_API_KEY approuvée restée dans votre environnement fait passer les requêtes par cette clé même si vous vouliez utiliser votre abonnement. À l'inverse, si Credit balance is too low s'affiche alors que vous pensez être sur votre abonnement, c'est le signe qu'une clé API de la Console est utilisée. La marche à suivre est détaillée dans Your credit balance is too low to access the Anthropic API : solutions. Pour les détails de l'API, voir la page officielle des limites de débit.

7. Liste de prévention

Une liste de contrôle opérationnelle pour ne plus « tomber à court au pire moment ».

(1) Mettez Sonnet par défaut et passez à Opus avec /model uniquement pour les parties difficiles (préservez le plafond hebdomadaire Opus). (2) Gardez le contexte léger avec des /compact / /clear fréquents. (3) Vérifiez votre solde et votre date de réinitialisation avec /usage avant un gros travail. (4) Réduisez les MCP inutiles et les boucles automatiques ; ne joignez que les fichiers nécessaires. (5) Les jours d'échéance, ayez l'API à l'usage prête (pour ne pas caler quand l'abonnement s'épuise). (6) Si vous êtes chroniquement à court, envisagez de monter de forfait ou de déplacer cette charge de travail vers l'API.

Conclusion

Le You've hit your session limit · resets 3:45pm de Claude Code (l'ancienne formulation était Claude usage limit reached) n'est pas une erreur : c'est ainsi que fonctionnent les limites d'usage de l'abonnement. Le message nomme le quota épuisé : session = la fenêtre glissante de 5 heures, weekly = la fenêtre hebdomadaire (toutes deux communes à tous les modèles, donc changer de modèle n'aide pas) et Opus / Sonnet = un plafond propre à cette famille. Comme Claude Code et les applications Claude partagent le même quota du forfait, ils peuvent l'épuiser plus vite ensemble.

Le plus gros consommateur est le choix de modèle (Opus en tête), puis la taille du contexte, les exécutions longues et continues, et les sous-agents/MCP. Quand vous atteignez le plafond : pour un plafond Opus/Sonnet, A : changer de modèle ; pour une limite de session, C : attendre la réinitialisation (automatique depuis la v2.1.234) ; si vous ne pouvez pas attendre, D : API à l'usage / E : crédits d'usage ou forfait supérieur. B : alléger le contexte fait durer la prochaine fenêtre. Consultez votre solde avec /usage et Settings → Usage. Et comme les chiffres exacts sont révisés au fil du temps, ne les mémorisez pas — vérifiez-les dans la vue officielle en direct. Voir aussi : économiser des tokens et coûts supplémentaires, tarifs Opus/Sonnet/Haiku, récapitulatif des erreurs Claude Code.

FAQ

Q. « You've hit your session limit » est-il un bug ? Je paie pour ça.
A. C'est voulu par conception, pas un bug. Pro / Max et les autres abonnements ne sont pas « illimités » — il existe des plafonds d'usage par fenêtre de 5 heures (session) et par semaine (weekly). Même en payant, dès que vous dépassez ce que ce quota couvre, vous êtes mis en pause temporairement, et l'accès revient à l'heure de resets affichée. Notez que Claude Code et les applications Claude partagent le même quota, alors utiliser les deux l'épuise plus vite.

Q. Quand se réinitialise-t-il ? Il affichait « resets 3:45pm ».
A. Pour une session limit, c'est l'heure de réinitialisation de la fenêtre de 5 heures (votre heure locale). Une weekly limit indique un jour ou une date, comme dans resets Mon 12:00am, et peut être dans plusieurs jours. Vous pouvez vérifier chaque réinitialisation dans /usage ou sous Settings → Usage. Si même le quota hebdomadaire est épuisé, vos options sont d'attendre, d'utiliser des crédits d'usage, de basculer sur l'API à l'usage ou de monter de forfait.

Q. Qu'est-ce qui change avec « Claude usage limit reached » ?
A. C'est l'ancienne formulation de la même limite d'usage. Dans les signalements du dépôt officiel, on voit en 2025 Claude usage limit reached. Your limit will reset at …, à partir de décembre 2025 environ You've hit your limit · resets …, et à partir de mai 2026 environ le message qui nomme le quota, You've hit your session limit, et ses variantes. Si vous voyez encore l'ancienne formulation, mettre à jour avec claude update vous indique quel quota vous avez atteint et vous donne la reprise automatique à partir de la v2.1.234.

Q. Pourquoi est-ce que j'atteins la limite si vite ?
A. Le facteur principal est le choix de modèle. Opus épuise le quota bien plus vite que Sonnet. En plus, un gros contexte, les exécutions longues et continues, et l'usage intensif de sous-agents ou de MCP font grimper la consommation. L'usage est décompté en même temps sur le quota de session et sur le quota hebdomadaire, donc un travail intense et soutenu, comme des exécutions en parallèle, peut aussi épuiser tôt le quota hebdomadaire. Rien que passer le travail routinier sur Sonnet avec /model et alléger le contexte avec /compact fait une grande différence.

Q. Comment continuer tout de suite sans attendre ?
A. (1) Pour You've hit your Opus limit / Sonnet limit, passez à un modèle d'une autre famille avec /model (cela n'aide pas pour les limites de session et hebdomadaire), (2) activez les crédits d'usage avec /usage-credits (continuez au-delà du quota inclus aux tarifs API standard), (3) basculez sur une clé API à l'usage (ni fenêtre de 5 heures ni fenêtre hebdomadaire), (4) montez de forfait avec /upgrade. Pour un travail à échéance, avoir l'API à l'usage prête à l'avance est la solution sûre.

Q. Puis-je vérifier ce qu'il me reste ?
A. Oui. Dans Claude Code, /usage affiche ce que vous avez consommé de chaque quota, quand chacun se réinitialise et une répartition par skill, sous-agent et serveur MCP ; mettre rate_limits dans votre ligne d'état le garde sous les yeux. Dans l'application web/desktop, Settings → Usage affiche votre forfait, l'usage restant et la date de réinitialisation hebdomadaire. Vérifier une fois avant un travail lourd permet d'éviter d'atteindre le plafond.