2026-11-09 · 6 min de lecture

Les limites de Claude Code : la fenêtre de 5 heures, le plafond hebdo, et tous les chemins après le mur

Les limites d'abonnement sont deux horloges qui tournent en même temps : une fenêtre glissante de 5 heures et un plafond hebdomadaire. Comment elles tournent, pourquoi Opus vide le bassin hebdo en premier, ce que dit vraiment un 429, et les cinq sorties classées par coût.

Les limites ont cette particularité de n'exister qu'au moment précis où vous êtes occupé. Elles n'arrivent pas avec une facture mensuelle ; elles choisissent l'instant où vous êtes à mi-refonte, un vendredi, et transforment votre agent en champ de texte qui ne sait plus dire que « réessayez plus tard ». Ce billet n'est pas un guide de contournement — ce n'est pas un objectif légitime. C'est une dissection : quelles horloges tournent, ce que la machine vous dit quand vous touchez le mur, quelles sorties existent vraiment, et le prix de chacune affiché sur la porte.

Divulgation d'emblée : j'opère Teapot Router, une passerelle API à l'usage pour Claude Code. J'ai donc un intérêt évident dans l'une des sorties ci-dessous — c'est pourquoi elles sont classées du moins cher au plus cher, la gratuite en premier ; à vous de juger si le classement est honnête.

Les limites sont deux horloges qui tournent à la fois

La limite d'un abonnement Claude Code n'est pas un chiffre, ce sont deux : une fenêtre glissante de 5 heures, et un plafond hebdomadaire. La fenêtre démarre quand vous démarrez et se réinitialise cinq heures plus tard ; le plafond hebdo couvre toute la semaine et accumule ce que les fenêtres ne pardonnent pas. Le pic de mardi après-midi n'occupe pas que la fenêtre de mardi — il puise dans le bassin de la semaine.

Alors « ça vient de se réinitialiser, pourquoi suis-je encore limité » n'est presque jamais un bug. Une fenêtre de 5 heures pleine, c'est une sensation ; un plafond hebdo épuisé, c'en est une autre — et dans le second cas, même une fenêtre fraîchement vidée attend que la semaine tourne. /usage montre devant quelle horloge vous êtes réellement.

  • La fenêtre de 5 heures : glissante, décide si vous pouvez continuer maintenant.
  • Le plafond hebdo : cumulatif, décide combien de semaine il vous reste.
  • Elles mesurent séparément — celle qui se remplit la première est celle qui vous arrête.

Pourquoi Opus vide toujours le plafond hebdo en premier

Le plafond hebdo mesure l'usage, et un modèle phare consomme plusieurs fois plus par tour qu'un modèle léger — contexte plus long en entrée, complétions plus longues en sortie. La même journée intensive à 8 heures draine le bassin hebdo plusieurs fois plus vite sur Opus que sur Sonnet. D'où la fameuse asymétrie : quelques jours d'Opus en début de semaine vident le plafond même si le quota spécifique Sonnet reste intact — le bassin est partagé, et une allocation dédiée ne remplit pas le réservoir général.

Ce n'est pas une punition des gros utilisateurs ; c'est la structure tarifaire qui fait exactement ce qu'elle annonce. Un abonnement est une assurance à prime fixe et usage plafonné — la prime se moque du modèle, mais le bassin a un fond. Vu ainsi, « changer de modèle » et « changer de facturation » cessent d'être du folklore : ce sont deux variables d'une même arithmétique.

Ce qui se passe vraiment au pied du mur

Le symptôme de surface, c'est un 429. Ce n'est pas tant une erreur que le protocole qui dit la vérité : quota dépensé, heure de réinitialisation dans les en-têtes de réponse. La plupart des clients relaient cette heure — donc le premier réflexe au mur n'est pas de changer d'outil, c'est de lire l'horloge et de décider comment passer l'heure qui vient.

Une chose à dire clairement : ce mur existe sur le chemin de l'abonnement. Le chemin API à l'usage n'a ni fenêtre de 5 heures ni bassin hebdo ; ses limites sont d'une autre espèce (débit par minute, plafonds mensuels par palier) qu'un développeur seul devant son code ne rencontre pour ainsi dire jamais. Cela n'en fait pas un meilleur chemin — il échange le mur contre un compteur — mais c'est l'embranchement où toutes les sorties ci-dessous se séparent.

Cinq sorties, classées par coût

Les options après le mur ont toujours été écrites quelque part ; elles sont simplement éparpillées entre documents. Réunies et ordonnées par « essayez d'abord le moins cher » :

  1. Attendre la réinitialisation. La fenêtre de 5 heures tourne vite et ne coûte rien. Pour le scénario « un dernier effort » : parquez la tâche, finissez-la après le tour de fenêtre.
  2. Compacter le contexte. /compact, ou une session neuve. Chaque tour renvoie la conversation jusqu'ici ; couper le poids mort rend chaque tour restant moins cher. Ça ne restaure pas le quota, mais ça l'étire.
  3. Descendre d'un modèle. Les éditions balisées et les greps n'ont pas besoin du phare ; garder Opus pour les vrais arbitrages d'architecture ralentit aussitôt la brûlure hebdo. La sortie la plus sous-estimée : le modèle par défaut de la plupart des gens surclasse la plupart de leurs tâches.
  4. Monter de palier. Si votre forme, c'est des heures par jour concentrées sur le phare, le bassin plus grand est réellement moins cher à l'unité — c'est à cela que servent les paliers. Utilisez-les.
  5. Passer à l'usage. Le mur disparaît et le compteur démarre. Ça convient aux usages divers, occasionnels ou répartis — et à ceux qui heurtent le mur plus d'une fois par mois, parce que le temps bloqué est aussi un coût.

Quelle forme d'usage doit s'arrêter où

Les quatre premières sorties n'ont pas besoin de cet essai ; quiconque a touché le mur une fois les apprend seul. L'endroit où il vaut la peine de poser une multiplication, c'est entre la quatrième et la cinquième : monter de palier, ou passer à l'usage.

La matière première de cette décision, c'est votre propre forme d'usage : heures concentrées par jour, intensité des tâches, comportement du cache. Mettez-les dans un calculateur de coûts et sort le point d'équilibre — les heures par jour où la dépense à l'usage rattrape le prix du forfait. Sous la ligne, l'usage est moins cher ; au-dessus, le forfait gagne et le mur est la prime d'assurance que vous avez choisie. Pas de réponse universelle, seulement votre propre multiplication.

Une asymétrie à connaître : le prix d'un forfait est verrouillé, les tarifs à l'usage suivent la grille. Qui choisit le compteur devrait exiger une grille lisible par machine et un relevé par requête — sinon « le compteur tourne » devient discrètement « le compteur tourne dans une boîte fermée ».

Les limites ne sont pas l'ennemie ; elles sont la clause du contrat signé avec votre abonnement : usage plafonné contre coût mensuel plafonné. La douleur du mur, c'est le contrat qui rappelle ses termes. Vous n'avez pas cinq sorties à mémoriser — vous avez une forme à connaître. La forme claire, choisir où s'arrêter devient une multiplication à un chiffre.

FAQ

Toutes les combien de temps les limites se réinitialisent-elles ?

La fenêtre glissante de 5 heures se réinitialise cinq heures après son départ ; le plafond hebdo se recharge au rythme de la semaine. Ils sont indépendants — une fenêtre neuve ne remplit pas le bassin hebdo. Limité ? /usage dit devant quelle horloge vous êtes.

La voie API à l'usage a-t-elle aussi des limites ?

Oui, mais d'une autre espèce : requêtes par minute et débit de tokens (RPM/ITPM/OTPM) plus des plafonds mensuels par palier — pas de fenêtre de 5 heures ni de bassin hebdo. Pour un développeur seul, elles sont invisibles ; elles mesurent les rafales et les totaux mensuels.

J'ai eu un 429. Quelque chose est cassé ?

Non — le 429 est le serveur qui rapporte son quota dépensé et son heure de reprise, inscrite dans les en-têtes. Lisez l'horloge, puis choisissez : attendre la fenêtre, compacter, ou prendre l'une des cinq sorties ci-dessus.

Tous les articles