4.8 KiB
Claude Code : Usage, limites de débit & usage supplémentaire
Comprendre comment fonctionnent les limites d'usage dans Claude Code et comment continuer à travailler quand tu les atteins.
| ← Retour à Claude Code Best Practice |  |
Vue d'ensemble
Claude Code sur les plans par abonnement (Pro, Max 5x, Max 20x) a des limites d'usage qui se réinitialisent sur une fenêtre glissante. Trois commandes slash intégrées t'aident à surveiller et gérer l'usage :
| Commande | Description | Disponible pour |
|---|---|---|
/usage |
Vérifier les limites du plan et le statut de la limite de débit | Pro, Max 5x, Max 20x |
/extra-usage |
Configurer le dépassement à la consommation quand les limites sont atteintes | Pro, Max 5x, Max 20x |
/cost |
Afficher l'usage de tokens et la dépense pour la session courante | Utilisateurs avec clé API |
/usage — Vérifier tes limites
Affiche les limites d'usage de ton plan actuel et le statut de la limite de débit. Utile pour vérifier combien de capacité il te reste avant d'atteindre une limite.
/extra-usage — Continuer au-delà des limites
La commande /extra-usage configure une facturation de dépassement à la consommation pour que Claude Code continue à travailler de façon transparente quand tu atteins les limites de débit de ton plan, au lieu de te bloquer.
Comment ça fonctionne
- Tu atteins la limite de débit de ton plan (les limites se réinitialisent toutes les 5 heures)
- Si l'usage supplémentaire est activé avec des fonds disponibles, Claude Code continue sans interruption
- Les tokens de dépassement sont facturés au tarif API standard, séparément de ton abonnement
Mise en place
La commande /extra-usage dans le CLI te guide dans la configuration. Tu peux aussi la configurer sur le web dans Settings > Usage sur claude.ai :
- Active l'usage supplémentaire
- Ajoute un moyen de paiement
- Définis un plafond de dépense mensuel (ou choisis illimité)
- Optionnellement, ajoute des fonds prépayés avec rechargement automatique quand le solde descend sous un seuil
Détails clés
| Détail | Valeur |
|---|---|
| Limite de consommation quotidienne | 2 000 $/jour |
| Facturation | Séparée de l'abonnement, au tarif API standard |
| Fenêtre de réinitialisation des limites | Toutes les 5 heures |
Problème connu
En février 2026, la commande CLI /extra-usage est non documentée et peut ouvrir une fenêtre de connexion sans options de configuration claires. Configurer via l'interface web claude.ai est la voie la plus fiable pour l'instant.
/cost — Dépense de session (utilisateurs API)
Pour les utilisateurs s'authentifiant avec une clé API (pas un plan par abonnement), /cost affiche :
- Le coût total de la session courante
- La durée API et le temps mur
- La répartition de l'usage de tokens
- Les changements de code effectués
Cette commande n'est pas pertinente pour les abonnés Pro/Max.
Mode Fast et usage supplémentaire
Le mode fast (/fast) utilise Claude Opus 4.6 avec une sortie plus rapide. Il a une relation de facturation particulière avec l'usage supplémentaire :
- L'usage du mode fast est toujours facturé à l'usage supplémentaire dès le premier token
- Cela s'applique même s'il te reste de l'usage sur ton plan par abonnement
- Le mode fast ne consomme pas les limites de débit incluses de ton plan
Cela signifie que tu dois avoir l'usage supplémentaire activé et approvisionné pour utiliser /fast.
Drapeaux de démarrage du CLI
Deux drapeaux de démarrage concernent les budgets d'usage (utilisateurs avec clé API uniquement, mode print) :
| Drapeau | Description |
|---|---|
--max-budget-usd <AMOUNT> |
Montant maximum en dollars pour les appels API avant arrêt |
--max-turns <NUMBER> |
Limiter le nombre de tours agentiques |
Voir la Référence des drapeaux de démarrage du CLI pour la liste complète.