Les limites d’usage de Claude Code tombent souvent au pire moment : l’agent est au milieu d’une modification, les tests n’ont pas tourné et la prochaine fenêtre est dans plusieurs heures. Cet article explique pourquoi la limite se remplit, comment la faire durer et que faire pour que le travail ne s’arrête pas quand elle est atteinte.
Une précaution d’emblée : utiliser plusieurs comptes n’est pas traité de la même manière dans les conditions de chaque fournisseur. N’appliquez la section sur le changement de compte ci-dessous que dans la mesure où les conditions de votre fournisseur le permettent.
Pourquoi les limites d’usage de Claude Code se remplissent
Quand Claude Code et Codex tournent sur un abonnement, l’usage est plafonné par fenêtres de temps, par exemple 5 heures et une semaine. Voici ce qui la consomme le plus :
- Un gros contexte de base : le prompt système, les définitions d’outils, les plugins et les serveurs MCP sont relus à chaque tour.
- De longues conversations : une conversation non compactée embarque plus de tokens à chaque tour.
- Des agents en parallèle : chaque agent d’un même compte puise dans la même limite.
- Des modèles coûteux et un effort élevé : plus de puissance que les tâches simples n’en demandent.
D’abord, faire durer la limite
Avant de changer de compte, le moyen le moins cher est de faire le même travail en consommant moins.
Réduire le contexte
Dans nos mesures, la première requête de Claude Code pesait environ 34,4k tokens avec une configuration standard, contre 13,3k avec le profil léger. Comme ce contexte de base est relu à chaque tour, l’écart s’accumule sur les longues sessions. Détails dans réduire la consommation de tokens de Claude Code.
Compacter la conversation
/compact résume une longue conversation. Dans AgentVera, vous pouvez définir un seuil et compacter automatiquement.
Réduire la tâche
Plutôt que « réécris tout le module », donnez des tâches mesurables qui avancent pas à pas. Moins de fichiers sont lus, moins de contexte est transporté.
Limiter le parallélisme inutile
Quatre agents sur un même compte remplissent la limite quatre fois plus vite. Passez en revue les agents qui ont vraiment besoin de tourner en parallèle.
Surveiller l’usage restant
Mieux vaut voir la limite arriver que la découvrir quand l’agent tombe en erreur. La barre d’état d’AgentVera affiche l’usage restant sur 5 heures et sur la semaine de chaque compte avec de petites jauges ; une valeur qui atteint un niveau critique passe au rouge. Cliquez dessus pour le détail des limites.
Les limites sont lues depuis le service d’usage d’Anthropic pour Claude, et compte par compte via codex app-server pour Codex. À savoir : ce ne sont pas des contrats d’API publics et stables.
Si vous avez activé les notifications Telegram, l’alerte de limite arrive aussi sur votre téléphone. L’application mobile AgentVera envoie une notification quand un compte atteint 90 % de sa limite, et son écran Limits affiche l’usage de chaque compte.
Bascule automatique avec les chaînes de comptes
Si les conditions de votre fournisseur vous permettent d’utiliser plusieurs comptes (par exemple un compte personnel et un compte professionnel distincts), le changement de compte d’AgentVera évite que le travail ne s’arrête quand une limite est atteinte.
Comment ça marche
- Ajoutez vos comptes dans Settings → Accounts. Chaque compte reçoit son propre dossier de configuration (
CLAUDE_CONFIG_DIRpour Claude,CODEX_HOMEpour Codex). - Connectez-vous à chaque compte avec la commande de connexion propre à la CLI (
claude auth login,codex login). AgentVera ne stocke ni mots de passe ni tokens. - Dans les réglages de changement de compte, activez la chaîne de comptes Claude ou Codex et définissez l’ordre. Une chaîne demande au moins deux comptes.
- Réglez le seuil. Par défaut, la bascule a lieu quand il reste 3 % ou moins sur la limite de 5 heures ou la limite hebdomadaire d’un compte.
Quand l’usage restant passe sous le seuil, ou que la CLI signale une limite, les agents de ce compte passent au compte disponible suivant. Après le dernier compte, la chaîne reboucle sur le premier.
Que devient la conversation ?
Si le transfert de la conversation vers le nouveau compte est activé, le journal de conversation est copié dans le dossier du nouveau compte et l’agent reprend où il s’était arrêté. Sinon, une nouvelle conversation démarre.
Quand une connexion a expiré
Si un compte de la chaîne est déconnecté ou si sa connexion a expiré, AgentVera le détecte, signale qu’une connexion est nécessaire et fait passer l’agent au prochain compte fonctionnel. Un changement manuel échoue aussi d’emblée, au lieu de laisser l’agent sur un écran de connexion.
Tableau de décision
| Situation | Piste suggérée |
|---|---|
| La limite se remplit de temps en temps | Réduire le contexte, utiliser /compact |
| Elle se remplit vite avec des agents en parallèle | Revoir le nombre d’agents et la taille des tâches |
| Vous avez plusieurs comptes autorisés par vos conditions | Chaîne de comptes et seuil |
| La limite n’est jamais suffisante | Envisager une offre supérieure chez votre fournisseur |
Que se passe-t-il quand la limite est atteinte ?
Sans chaîne de comptes, quand la limite est atteinte, la CLI affiche un avertissement et l’agent ne peut plus envoyer de nouvelles requêtes. Vous avez trois options :
- Attendre : mettez l’agent en pause jusqu’à la prochaine fenêtre. La conversation n’est pas perdue ; reprenez quand la limite se réinitialise.
- Passer le relais : continuez avec un autre outil. Par exemple, transmettez à Codex, via un flux, le travail que Claude Code n’a pas terminé. L’historique de conversation ne passe pas d’un outil à l’autre, mais l’état courant et la liste de tâches le peuvent.
- Changer de compte : si vous avez un second compte autorisé par vos conditions et qu’une chaîne est configurée, la bascule se fait toute seule.
Passer le relais réduit l’impact des limites même sans chaîne de comptes. Un agent qui laisse des notes sur le tableau partagé des agents laisse un bon point de départ au suivant.
Penser les limites à l’échelle d’une équipe
Avec plusieurs développeurs, les limites passent d’un problème personnel à un sujet de planification :
- Qui fait quel travail sur quel compte ? Les comptes partagés peuvent se remplir à des moments inattendus.
- Quand tournent les longues tâches ? Déplacer les tâches planifiées hors des heures chargées protège la limite de la journée.
- Quelles tâches peuvent utiliser un profil moins coûteux ? Le profil léger pour les agents de documentation et de tests.
Les tâches planifiées d’AgentVera envoient un message à un agent selon un calendrier cron ; si l’agent est occupé, choisissez d’attendre, d’envoyer quand même ou d’ignorer.
Idées reçues
- « Si je raccourcis le prompt, je n’atteindrai pas la limite. » Le prompt ne représente généralement qu’une petite part du total ; le contexte de base et l’historique de la conversation pèsent plus.
- « Changer de compte réinitialise la conversation. » Avec le transfert de conversation activé, l’agent reprend où il s’était arrêté.
- « Le compteur d’usage est toujours exact. » Les compteurs lisent les services d’usage des fournisseurs ; ce ne sont pas des API publiques stables et les valeurs peuvent changer.
Points d’attention en ajoutant des comptes
Si vous configurez une chaîne de comptes, une installation soignée évite les mauvaises surprises :
- Connectez-vous à chaque compte séparément. Les comptes utilisent des dossiers de configuration distincts : se connecter à l’un n’affecte pas les autres.
- Choisissez l’ordre à dessein. Placez en tête le compte que vous voulez utiliser le plus ; les autres attendent en réserve.
- Ajustez le seuil à votre travail. Un seuil très bas consomme les derniers pour cent, mais augmente le risque d’atteindre la limite en plein tour.
- Laissez la conversation suivre. Sur les longues tâches, laisser l’agent continuer coûte moins cher que tout réexpliquer dans une nouvelle conversation.
Check-list
- Surveillez-vous l’usage restant dans la barre d’état ?
- Des agents tournent-ils avec plus de contexte que nécessaire ?
- Les longues conversations sont-elles compactées ?
- Si vous utilisez une chaîne de comptes, avez-vous lu les conditions de votre fournisseur ?
- Chaque compte de la chaîne est-il connecté ?
Pour conclure
Le premier remède aux limites d’usage de Claude Code est de faire le même travail en consommant moins : contexte plus léger, conversations compactées et tâches ciblées. Voir les limites venir supprime les surprises. Là où les conditions de votre fournisseur le permettent, une chaîne de comptes laisse l’agent reprendre où il en était quand une limite est atteinte.
AgentVera réunit compteurs d’usage, profils de contexte et chaînes de comptes dans une seule application. Consultez la page Claude Code pour le détail, ou démarrez avec l’offre gratuite.