109 lines
4.8 KiB
Markdown
109 lines
4.8 KiB
Markdown
# 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.
|
|
|
|
<table width="100%">
|
|
<tr>
|
|
<td><a href="../">← Retour à Claude Code Best Practice</a></td>
|
|
<td align="right"><img src="../../!/claude-jumping.svg" alt="Claude" width="60" /></td>
|
|
</tr>
|
|
</table>
|
|
|
|
---
|
|
|
|
## 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
|
|
|
|
1. Tu atteins la limite de débit de ton plan (les limites se réinitialisent toutes les 5 heures)
|
|
2. Si l'usage supplémentaire est activé avec des fonds disponibles, Claude Code continue sans interruption
|
|
3. 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 :
|
|
|
|
1. Active l'usage supplémentaire
|
|
2. Ajoute un moyen de paiement
|
|
3. Définis un **plafond de dépense mensuel** (ou choisis illimité)
|
|
4. 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](https://github.com/anthropics/claude-code/issues/12396) 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](../best-practice/claude-cli-startup-flags.md) pour la liste complète.
|
|
|
|
---
|
|
|
|
## Sources
|
|
|
|
- [Usage supplémentaire pour les plans Claude payants — Centre d'aide Claude](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)
|
|
- [Utiliser Claude Code avec ton plan Pro ou Max — Centre d'aide Claude](https://support.claude.com/en/articles/11145838-using-claude-code-with-your-pro-or-max-plan)
|
|
- [La commande slash /extra-usage est non documentée — GitHub Issue #12396](https://github.com/anthropics/claude-code/issues/12396)
|
|
- [Référence CLI Claude Code](https://code.claude.com/docs/en/cli-reference)
|