Quota Claude Code épuisé : que faire ? Identifiez d'abord quel verrou a sauté. Pro et Max ont tous deux deux limites : la « fenêtre de 5 heures » et le « quota hebdomadaire ». Le site web de Claude, l'application de bureau et Claude Code partagent le même quota. Le « 20x » de Max 20x désigne, selon la documentation officielle, une fenêtre de 5 heures 20 fois plus grande que celle de Pro, et non un total hebdomadaire 20 fois supérieur. Si la fenêtre de 5 heures est épuisée, il suffit d'attendre la réinitialisation. Si c'est le quota hebdomadaire et que vous ne voulez pas vous arrêter, basculez Claude Code sur une clé API : la facturation se fait à l'usage et n'est plus soumise aux limites de 5 heures et hebdomadaires de l'abonnement.
En bref
| Situation | Que faire |
|---|---|
| Fenêtre de 5 heures épuisée | Attendez la réinitialisation de la fenêtre, ou économisez avec /compact, une nouvelle session ou le passage à Sonnet 5.5 |
| Quota hebdomadaire épuisé | Attendez l'heure de réinitialisation hebdomadaire fixe, ou basculez Claude Code sur une clé API pour continuer à travailler |
| Savoir ce qu'il vous reste | Avec un compte d'abonnement, consultez /usage et Settings > Usage sur le site officiel. Avec une clé API, /usage n'affiche que la consommation de la session en cours |
Texte original du centre d'aide d'Anthropic : « Paid plans have two types of usage limits: a session limit that resets every five hours, and weekly limits that reset once every week. » Source :How do usage and length limits work?
Le « 20x » concerne la fenêtre de 5 heures. Texte original : « Max 20x includes 20 times the Pro plan's per-session usage allowance. » « Max plans also have a weekly usage limit that applies across all models. » Source :What is the Max plan?
Claude et Claude Code partagent le même quota. Texte original : « Both Pro and Max plans have a five-hour session limit and a weekly limit. Max plans also have a separate weekly limit for Fable. These limits are shared across Claude and Claude Code, meaning all activity in both tools counts against the same limits. » Source :Use Claude Code with your Pro or Max plan
Le quota hebdomadaire de Max 20x vaut combien de fois celui de Pro ?
La documentation officielle indique seulement que la fenêtre de 5 heures est multipliée par 20 et ne publie aucun facteur pour le quota hebdomadaire. Les mesures des utilisateurs donnent un résultat nettement inférieur à 20 :
- Selon un retour d'utilisateur, le quota hebdomadaire de Max 20x ne représenterait « environ que 9,7 fois celui de Pro » d'après ses mesures, et il résume : « la fenêtre de 5 heures et la limite hebdomadaire sont deux verrous distincts » (@JkwuRmsl).
- Selon un autre retour d'utilisateur, « The "20x" doesn't mean you get 20 times more Claude for the whole week. It only means each 5 hour session is 20 times bigger than Pro's. », et le quota hebdomadaire de 20x ne représenterait qu'environ le double de celui de Max 5x (@buildwithhassan).
Avant de passer à Max 20x, demandez-vous donc ce que vous atteignez habituellement : la fenêtre de 5 heures ou le quota hebdomadaire. Si vous ne butez que sur la fenêtre de 5 heures, le 20x est très utile. Si vous atteignez souvent le quota hebdomadaire, la marge supplémentaire est moins importante que le nom ne le laisse penser.
Comment consulter le quota restant
| Méthode | Ce que vous voyez |
|---|---|
| /usage | La consommation de la session en cours ; pour un compte d'abonnement, l'utilisation du quota du forfait s'affiche aussi |
| /status | Version, modèle, compte et informations de connexion |
| Settings > Usage sur le site officiel | L'heure de la prochaine réinitialisation |
Texte original de la documentation officielle de Claude Code : /usage « Show session cost, plan usage limits, and activity stats. On a Pro, Max, Team, or Enterprise plan, includes a breakdown of what counts against your plan limits » ; /status « Open the Settings interface on the Status tab, showing version, model, account, and connectivity ». /cost et /stats sont des alias de /usage. Source :Claude Code Docs : Commands.
Texte original du centre d'aide : « The weekly limit resets at a fixed time each week that is assigned to your account. Your reset day and time stay the same regardless of when you start using Claude or when your subscription begins … You can see your next reset time in Settings > Usage. »
Test réel : ce qu'affichent /status et /usage avec une clé API
Sous Claude Code 2.1.308, dans un HOME indépendant et vierge, nous avons relié la clé API d'AI Code With via un settings.json global, puis exécuté ces deux commandes.
Au démarrage, la barre de titre indique directement, après le modèle, une facturation à l'usage de l'API :
Claude Code v2.1.308
Opus 5.5 · API Usage Billing
En mode interactif, saisissez /status : la page Status s'ouvre en moins de 3 secondes (capture) :
Version: 2.1.308
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://api.aicodewith.ai
Model: Default (claude-opus-5-5)
Setting sources: User settings
Après avoir posé une question, saisissez /usage : la page Usage s'ouvre en moins de 3 secondes (capture, lignes de montants omises) :
Session
Total duration (API): 5s
Total duration (wall): 29s
Total code changes: 0 lines added, 0 lines removed
Usage by model:
claude-opus-5-5: 8 input, 138 output, 10.4k cache read, 2.6k cache write
Conclusion : avec une API Key, /usage n'affiche que les statistiques de la session en cours, sans les barres de progression de la fenêtre de 5 heures ni du quota hebdomadaire de l'abonnement. /status affiche ANTHROPIC_AUTH_TOKEN et l'adresse personnalisée, sans aucune information de compte d'abonnement.
En mode non interactif, avec claude -p, ces deux commandes donnent des résultats différents :
/status isn't available in this environment.
claude -p "/usage" répond en 0,4 seconde, avec uniquement les statistiques de session (aucune requête n'avait encore été envoyée, tout est à 0) :
Total duration (API): 0s
Total duration (wall): 0s
Total code changes: 0 lines added, 0 lines removed
Usage: 0 input, 0 output, 0 cache read, 0 cache write
Pour consulter le quota dans un script, utilisez /usage. /status n'est disponible qu'en mode interactif.
Pourquoi le quota baisse plus vite ces derniers temps
1. Selon SemiAnalysis, certains comptes Max font l'objet d'un test A/B. Le 22 octobre, SemiAnalysis a publié sur X : « We detected an A/B test going on that DECREASES your monthly API-value by ~20% while INCREASING your 5h usage limits by ~20%. This only affects SOME » (publication d'origine de SemiAnalysis). Selon ce qui a été rapporté, ils ont comparé deux comptes Max 20x : l'un avait une fenêtre de 5 heures supérieure d'environ 19 % et un quota hebdomadaire inférieur d'environ 20 % (Tech City Authority).
Anthropic n'a pas confirmé ce test. Selon ce qui a été rapporté, avant la publication de SemiAnalysis, Boris Cherny d'Anthropic avait répondu à un utilisateur « No changes on our end », et Lydia Hallie, de l'équipe Claude Code, avait elle aussi indiqué « our limits haven't changed » (Tech City Authority). Ces deux réponses sont antérieures à la publication de SemiAnalysis.
Qui est le plus touché : la fenêtre de 5 heures peut être réinitialisée plusieurs fois par jour, donc les gros utilisateurs butent d'abord sur le quota hebdomadaire, et 20 % de moins, c'est une vraie perte. Ceux qui n'atteignent que de temps en temps la fenêtre de 5 heures trouveront au contraire la limite plus souple.
2. Reprendre une longue conversation restée inactive coûte cher. D'après les retours d'utilisateurs, le client Claude Code affiche un avertissement avant de reprendre une longue conversation (@pumpccc, Opus 5.5) :
This conversation has been inactive for 3h 4m and is 358.4k tokens long. Resuming it will use about 7% of your 5-hour usage limit.
Autrement dit, reprendre simplement une ancienne conversation de 350 000 tokens consomme déjà environ 7 % de la fenêtre de 5 heures.
3. Le quota est partagé entre le web et Claude Code. Si vous avez beaucoup discuté sur le web dans la journée, il en restera moins pour Claude Code le soir.
Comment économiser du quota
- Lancez /compact sur les longues conversations. Selon la documentation officielle, la commande résume la conversation pour libérer de l'espace. Quand la conversation est déjà longue, compressez avant de continuer. Pour l'option de compression automatique en cas d'inactivité, voir « Qu'est-ce que l'Idle Compaction de Claude Code ? ».
- Ouvrez directement une nouvelle session pour les longues sessions restées inactives. Ne reprenez pas une ancienne conversation de plusieurs centaines de milliers de tokens : ouvrez une nouvelle session avec /clear, consignez les points clés dans un fichier de passation, puis poursuivez. La méthode est décrite dans « Comment passer la main à Codex en cours de route depuis Claude Code ? Transmettre le contexte avec handoff.md ».
- Passez à Sonnet 5.5 pour les tâches courantes. Basculez avec /model claude-sonnet-5-5, puis revenez à Opus 5.5 pour les problèmes difficiles. Pour faire votre choix, voir « Quel modèle utiliser avec Claude Code ? » et « Claude Sonnet 5.5 vs Opus 5.5 ».
- Limitez le nombre de sous-agents en parallèle. Chaque sous-agent a son propre contexte : en ouvrir beaucoup en même temps cumule la consommation de quota.
- Attention au Fast Mode. Pour l'activation et les limites, voir « Comment utiliser le Fast Mode de Claude Opus 5.5 ».
Texte original du centre d'aide : « Your usage is affected by several factors, including the length and complexity of your conversations, the features you use, which Claude model you're chatting with, and the effort level you've selected. »
Quota insuffisant : passez à une API Key
Une fois le quota d'abonnement épuisé, les options officielles sont d'attendre la réinitialisation, d'activer les usage credits, ou de passer à un compte Console pour utiliser l'API. Vous pouvez aussi connecter Claude Code à une API Key AI Code With : facturation à l'usage, sans les limites de la fenêtre de 5 heures ni du quota hebdomadaire de l'abonnement.
Texte original du centre d'aide : « Switch to a Claude Console account and purchase API usage credits for intensive coding sprints. » « Wait until your usage limits reset. » Source : Use Claude Code with your Pro or Max plan
Étape 1 : créer une API Key
Étape 2 : écrire le settings.json global
Ouvrez ~/.claude/settings.json et renseignez les valeurs dans env (ANTHROPIC_BASE_URL sans /v1) :
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
"ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
}
}
Relancez Claude Code. Si la barre de titre affiche « API Usage Billing » et que la ligne Auth token de /status indique ANTHROPIC_AUTH_TOKEN, c'est que vous passez bien par la Key. Pour le détail des champs et les questions fréquentes, voir « Comment connecter Claude Code à une API tierce ? Tutoriel sur la Base URL, l'API Key et la configuration du modèle ».
Pour revenir à l'abonnement : supprimez ces deux lignes de settings.json, puis exécutez claude login dans le terminal et connectez-vous avec votre compte Pro ou Max.
Questions fréquentes
Quand le quota hebdomadaire est-il réinitialisé ?
À heure fixe chaque semaine. Cet horaire est attribué à votre compte et ne dépend ni du moment où vous avez commencé à l'utiliser ni de celui où vous vous êtes abonné. Vous pouvez voir la prochaine réinitialisation dans Settings > Usage sur le site officiel.
À partir de quand la limite de 5 heures de Claude est-elle calculée ?
La documentation officielle indique que la fenêtre de 5 heures « resets every five hours ». Une fois la fenêtre épuisée, il suffit d'attendre sa réinitialisation. Pendant ce temps, Claude sur le web et Claude Code sont tous deux limités, car ils partagent le même quota.
Peut-on utiliser l'abonnement et l'API Key en même temps ?
Claude Code n'utilise qu'un seul mode à la fois. Si settings.json contient ANTHROPIC_AUTH_TOKEN et l'adresse, il passe par la Key. Si vous les supprimez et lancez claude login avec un compte d'abonnement, il passe par l'abonnement. Vous pouvez utiliser l'abonnement en journée, puis basculer sur la Key une fois le quota épuisé.
Peut-on utiliser la même Key dans Codex ?
Oui. Il suffit de renseigner l'adresse et la Key dans ~/.codex/config.toml, voir « Guide de configuration de config.toml pour Codex ». Pour les règles de quota propres à Codex, voir « Codex : tarification et raisons de la baisse rapide du quota ».
Sources
- Claude Help Center : How do usage and length limits work?
- Claude Help Center : What is the Max plan?
- Claude Help Center : Use Claude Code with your Pro or Max plan
- Claude Code Docs : Commands
- Publication d'origine de SemiAnalysis
- Tech City Authority : Anthropic is reportedly A/B testing Claude Max usage limits
- @JkwuRmsl, @buildwithhassan, @pumpccc