Astuces pour économiser les tokens Claude Code et que se passe-t-il quand vous atteignez la limite

L'une des premières choses que l'on remarque en utilisant Claude Code, c'est la rapidité avec laquelle il consomme les tokens. Vous vous êtes déjà dit « Je n'ai modifié qu'un seul fichier — comment ai-je déjà atteint la limite ? »

Cet article explique pourquoi Claude Code utilise autant de tokens, présente 10 techniques pratiques d'économie, et détaille ce qui se passe quand vous atteignez la limite et comment fonctionnent les coûts supplémentaires.

1. Pourquoi Claude Code consomme autant de tokens

Contrairement au chat classique, Claude Code est un système agentique. Une seule instruction de l'utilisateur déclenche plusieurs appels API internes pour accomplir la tâche.

Raisons spécifiques de la consommation élevée

• Prompt système + historique de conversation inclus à chaque tour : chaque message renvoie l'intégralité de l'historique, donc plus la conversation est longue, plus la consommation s'accélère
• Le contenu des fichiers est chargé dans le contexte : lors de la modification du code, le contenu du fichier cible est intégré au contexte. Les fichiers volumineux consomment davantage de tokens
• Les appels d'outils s'enchaînent : une seule instruction peut déclencher en interne la recherche, la lecture, la modification et la vérification de fichiers. Selon la documentation d'Anthropic, Claude Code envoie la conversation complète à chaque requête, et chaque fois que Claude utilise des outils, il envoie une requête de plus avec ces résultats (Manage costs effectively)
• Les tokens de réflexion comptent comme des sorties : le processus de « réflexion » interne de Claude Code consomme également des tokens

Le traitement de ce modèle se fait sur les serveurs d'Anthropic. Changer de PC pour une machine plus puissante ne modifie donc ni la consommation de tokens ni le temps que l'IA passe à réfléchir. Ce qui change avec le PC, ce sont le temps des commandes exécutées en local et la question de savoir si la mémoire suffit (voir « Configuration PC requise pour Claude Code et Codex »).

Pour en savoir plus sur les différences entre les modes de Claude, consultez notre article sur les différences entre Claude Chat, Cowork et Code.

2. Limites d'utilisation et tarifs par forfait

On utilise Claude Code soit en se connectant avec un forfait payant de Claude (Pro, Max, Team ou Enterprise), soit avec une clé API de la Claude Console. D'après la page de tarifs de Claude, la limite de chaque forfait se compte dans une fenêtre de session qui se renouvelle toutes les cinq heures, et les forfaits payants y ajoutent une limite hebdomadaire. Il n'y a pas de nombre fixe de messages : ce que vous pouvez faire dépend de la longueur des conversations, du modèle choisi et des fonctions utilisées (page de tarifs de Claude, consultée le 26 septembre 2026).

Sources : page de tarifs de Claude, centre d'aide d'Anthropic « What is the Pro plan? » et « What is the Max plan? », documentation de Claude Code « Manage costs effectively » (toutes consultées le 26 septembre 2026). Ultra est le nom pris le 31 octobre 2026 par l'ancien Max 20x. D'après « What is the Ultra plan? » (centre d'aide d'Anthropic), sa limite hebdomadaire vaut 10 fois celle de Pro, et les comptes vérifiés n'ont pas de limite de 5 heures (consulté le 31 octobre). La vérification se fait automatiquement d'après l'historique du compte et des paiements ; si la barre « Current session » n'apparaît pas sur la page d'utilisation des paramètres, votre compte est vérifié.

Fable, le modèle le plus haut de gamme, est traité à part. Dans le tableau comparatif de la page de tarifs, Pro ne peut l'utiliser qu'avec des crédits d'utilisation, tandis que Max et Ultra peuvent y consacrer jusqu'à 50 % de la limite hebdomadaire. Dans Claude Code, selon votre forfait, l'utilisation de Fable peut être facturée sur les crédits d'utilisation plutôt que sur le quota du forfait ; dans ce cas, la ligne Fable de /model affiche « Requires usage credits » et Claude Code demande confirmation avant de facturer (Model configuration).

Pour une comparaison détaillée des tarifs, consultez notre article sur la comparaison des prix Claude vs ChatGPT.

3. 10 techniques pour économiser les tokens

En appliquant les techniques suivantes, vous pouvez réduire considérablement votre consommation de tokens.

Cela dit, avant de commencer à couper, mieux vaut mesurer ce qui occupe réellement le contexte. Lisez la répartition avec /context, vérifiez la consommation réelle avec /usage et obtenez le coût par Skill avec /skill-doctor. Nous traitons cela en détail dans qu'est-ce qui dévore vraiment votre contexte Claude Code.

Astuce 1 : Réinitialisez le contexte régulièrement avec /clear

Lorsque vous passez à une tâche différente, exécutez /clear pour réinitialiser la conversation. L'historique résiduel signifie que des tokens inutiles sont renvoyés à chaque message.

# Après avoir terminé le travail sur l'authentification
/clear

# Commencer la tâche suivante
"Ajouter une fonctionnalité de paiement"

Astuce 2 : Compressez les conversations avec /compact

Vous pouvez compresser une longue conversation en cours de session. Ajoutez des instructions personnalisées pour ne conserver que l'essentiel.

# Compression basique
/compact

# Compression avec instructions personnalisées
/compact Garde uniquement les modifications de code et les spécifications d'API

Cela dit, vous n'y gagnez pas davantage en appuyant plus souvent. Le coût d'une compaction dépend fortement de la chaleur du cache de prompt, et l'appuyer juste après une pause est le cas le plus cher de tous. Le bon moment pour le faire est traité en détail dans quand appuyer sur /compact.

Astuce 3 : Nommez exactement ce qu'il faut lire

Quand la demande est vague, Claude Code cherche largement les fichiers qui pourraient être utiles et les lit, et le contexte grossit d'autant. La documentation d'Anthropic dit la même chose : une demande vague comme « améliore cette base de code » déclenche un balayage large, alors qu'une demande précise comme « ajoute une validation des entrées à la fonction login de auth.ts » permet de travailler avec un minimum de lectures (Manage costs effectively). Si vous savez déjà quel fichier compte, référencez-le avec @ et Claude l'ajoute à la conversation sans avoir à le chercher (Common workflows). Un fichier référencé avec @ entre avec tout son contenu, et un répertoire donne la liste des fichiers plutôt que leur contenu : ne référencez donc que les fichiers utiles.

❌ « Améliore cette base de code »
→ Claude cherche largement et lit tout ce qui semble lié (plus de tokens d'entrée)

✅ « Ajoute une validation des entrées à la fonction login de @src/auth.ts »
→ Le travail reste sur le fichier qui compte

Astuce 4 : Changez de modèle selon la tâche

Il n'est pas nécessaire d'utiliser un modèle haut de gamme pour chaque tâche. Au 26 septembre 2026, le modèle par défaut de Claude Code est Opus 5.5, que ce soit sur Pro, Max, Team, Enterprise ou l'API (Model configuration). Au token, en revanche, Sonnet, de milieu de gamme, coûte environ la moitié d'Opus, et le léger Haiku est encore moins cher : au 12 octobre 2026, Haiku 5.5 coûte 40 fois moins qu'Opus pour des prompts jusqu'à 100 000 tokens (voir le tableau de la section 5). La documentation d'Anthropic indique aussi que Sonnet gère bien la plupart des tâches de programmation pour moins cher qu'Opus, recommande de réserver Opus aux décisions d'architecture complexes et au raisonnement en plusieurs étapes, et suggère de spécifier Haiku pour les tâches simples des sous-agents (Manage costs effectively). Sur les abonnements aussi, ce que vous pouvez faire dépend du modèle choisi. Même si les rapports évoluent avec une nouvelle version, le critère reste le même : choisir le niveau selon la difficulté de la tâche.

# Utiliser Sonnet pour le codage courant
/model sonnet

# Utiliser Opus pour les décisions d'architecture ou le refactoring complexe
/model opus

Astuce 5 : Demandez des réponses plus courtes

Des réponses plus longues de l'IA signifient plus de tokens en sortie. Des instructions comme « code uniquement » ou « répondez en une ligne » réduisent les sorties inutiles.

❌ "Corrige cette fonction"
→ L'IA génère une longue explication + code + notes (beaucoup de tokens en sortie)

✅ "Corrige cette fonction. Pas d'explication, juste le code"
→ Code uniquement (nettement moins de tokens en sortie)

Astuce 6 : Limitez les tokens de réflexion

Dans Claude Code, la réflexion étendue (extended thinking) est activée par défaut, et les tokens de réflexion sont facturés comme des tokens de sortie. Selon le modèle, le budget par défaut peut atteindre plusieurs dizaines de milliers de tokens par requête. Pour un travail qui ne demande pas de raisonnement approfondi, baisser le niveau d'effort avec /effort (ou dans /model) réduit le coût. Opus 5.5 et les modèles Fable réfléchissent toujours : sur ces modèles, on règle l'effort (Manage costs effectively). L'effort par défaut d'Opus 5.5 est medium ; celui de la plupart des autres modèles est high (Model configuration).

# Effort réduit pour les tâches simples
/effort low

Astuce 7 : Gardez CLAUDE.md concis

CLAUDE.md (le fichier d'instructions du projet) est chargé dans le contexte au démarrage de la session, puis transporté dans chaque requête suivante. S'il contient des instructions pas à pas pour des tâches précises, comme les revues de PR ou les migrations de base de données, vous payez ces tokens même pendant un travail sans rapport. La recommandation officielle est de déplacer ces instructions dans des skills, qui ne se chargent que lorsqu'on les invoque (Manage costs effectively).

Astuce 8 : Exploitez les sous-agents

Confiez à un sous-agent le travail qui produit beaucoup de sortie, comme lancer des tests, récupérer de la documentation ou analyser des fichiers de logs. La sortie volumineuse reste dans le contexte du sous-agent et seul un résumé revient dans la conversation principale. Les requêtes du sous-agent comptent tout de même dans votre consommation ; pour dépenser moins, donnez-lui un modèle plus petit comme Haiku (Manage costs effectively).

Astuce 9 : Fournissez les spécifications dès le départ pour éviter les reprises

Un échange du type « construis-le, puis corrige-le, puis modifie-le » gaspille des tokens. Fournir des spécifications claires dès le début évite les reprises et maintient une consommation linéaire.

❌ Schéma conversationnel (croissance exponentielle des tokens) :
"Construis une fonctionnalité de connexion" → "Ajoute la validation"
→ "En fait, passe à l'authentification par e-mail" → "Change aussi l'interface"

✅ Schéma spécifications d'abord (croissance linéaire des tokens) :
"Construis une fonctionnalité de connexion avec ces spécifications :
- Authentification par e-mail + mot de passe
- Validation de l'e-mail (vérification du format + doublons)
- Exigences du mot de passe : 8+ caractères, alphanumériques
- Interface du formulaire : centrée, style carte"

Pour en savoir plus sur la rédaction de prompts efficaces, consultez notre article sur les astuces de prompts pour le développement d'applications IA.

Astuce 10 : Surveillez vos formats de fichiers

Avec l'API Claude, chaque page d'un PDF coûte les tokens de son texte extrait (en général 1 500 à 3 000 tokens par page), plus ceux de la page convertie en image (documentation de l'API Claude, « PDF support »). Claude Code lit en entier les PDF courts et lit ceux de plus de 10 pages par tranches de 20 pages au maximum (Tools reference). Indiquez seulement les pages utiles, ou convertissez le fichier en texte avant de le transmettre.

4. Que se passe-t-il à la limite ? La fenêtre de 5 heures, la limite hebdomadaire et les crédits d'utilisation

Commençons par l'essentiel : un abonnement peut bel et bien entraîner des frais supplémentaires, mais jamais de lui-même. Pour continuer au-delà de la limite, vous devez activer vous-même les crédits d'utilisation (usage credits) et prépayer un solde. Sinon, Claude Code s'arrête simplement à la limite, vous attendez le renouvellement de la fenêtre et votre facture ne change pas (centre d'aide d'Anthropic, « Manage usage credits for paid Claude plans »).

Deux niveaux de limite : la fenêtre de 5 heures et la limite hebdomadaire

• Fenêtre de 5 heures (limite de session) : un quota qui se renouvelle toutes les cinq heures. Pro, Max et Team en ont tous une
• Limite hebdomadaire : un plafond hebdomadaire commun à tous les modèles. Il se renouvelle au jour et à l'heure fixes attribués à votre compte, qui ne dépendent ni du moment où vous commencez à utiliser Claude ni de la date de votre abonnement. La prochaine réinitialisation s'affiche dans Settings > Usage sur claude.ai (centre d'aide, « What is the Pro plan? » et « What is the Max plan? »)
• Limites par modèle : certaines limites ne s'appliquent qu'à Opus ou qu'à Sonnet

La consommation est déduite en même temps de la fenêtre de 5 heures et de la limite hebdomadaire. Un pic d'activité intense, comme lancer beaucoup de sous-agents d'un coup, peut épuiser la limite hebdomadaire avant que la fenêtre de 5 heures ne se renouvelle. À l'approche d'une limite, un avertissement comme You've used 85% of your session limit · resets 3:45pm apparaît, et une fois la limite atteinte Claude Code s'arrête avec des messages comme ceux-ci (documentation de Claude Code, « Error reference ») :

You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm

Vos options quand vous atteignez la limite sur Pro ou Max

Sources : documentation de Claude Code « Error reference » et « Wait for a usage limit to reset », centre d'aide d'Anthropic « Use Claude Code with your Pro or Max plan » et la FAQ de la page de tarifs de Claude (consultées le 26 septembre 2026). Que faire face à chaque message : voir You've hit your session limit dans Claude Code : ce que cela signifie et que faire.

Comment fonctionnent les crédits d'utilisation (Pro et Max)

• Où les activer : dans la section « Usage credits » de Settings > Usage sur claude.ai. Dans Claude Code, /usage-credits ouvre cette page dans le navigateur (uniquement si vous êtes connecté avec un abonnement claude.ai ; indisponible avec une clé API)
• Paiement : prépayé. Vous achetez un solde avec « Add funds » et pouvez activer la recharge automatique (auto-reload) pour le compléter quand il baisse
• Garde-fou : vous pouvez fixer une limite de dépenses mensuelle (ou choisir « Set to unlimited »). Si vous l'atteignez alors qu'il reste des crédits, Claude Code vous demande s'il faut relever ou supprimer la limite
• Tarif : le tarif standard de l'API (tableau de la section 5), qui apparaît comme une facturation distincte de l'abonnement. La fenêtre de 5 heures continue de se renouveler normalement
• Confirmation : vous êtes prévenu à l'approche de la limite et quand vous l'atteignez, et devez confirmer avant de continuer sur les crédits
• Les désactiver : à tout moment dans Settings > Usage ; vous n'utilisez alors plus que le quota de votre forfait

Deux détails passent facilement inaperçus. Le premier est la durée de vie du cache. Dans le quota du forfait, le cache de la conversation principale de Claude Code dure une heure, mais il tombe à cinq minutes pendant que vous consommez des crédits d'utilisation. Une pause de plus de cinq minutes et le message suivant relit toute la conversation : les crédits partent plus vite (Manage costs effectively). Le second est l'expiration. Dans la plupart des pays, les crédits achetés n'expirent pas, mais dans certaines juridictions comme le Japon, ils expirent six mois après l'achat à partir du 10 septembre 2026, avec un e-mail d'avertissement sept jours avant.

Si vous ne voulez jamais payer de supplément

• N'activez pas les crédits d'utilisation (s'ils sont activés, désactivez-les dans Settings > Usage)
• Ne laissez pas la variable d'environnement ANTHROPIC_API_KEY définie. Si elle l'est, Claude Code s'authentifie avec cette clé API au lieu de votre abonnement, et votre consommation est facturée comme une utilisation de l'API (centre d'aide, « Use Claude Code with your Pro or Max plan »). /status indique le compte avec lequel vous travaillez
• Connectez-vous uniquement avec votre compte Pro ou Max, sans ajouter d'identifiants Claude Console (API) (même article)

Team et Enterprise

• Team et Enterprise au siège : la consommation de chaque membre est déduite d'un quota par siège qui se renouvelle sur une fenêtre de cinq heures et sur une fenêtre hebdomadaire. Ce quota est partagé avec le chat et Cowork, et sa taille dépend du type de siège (standard ou premium). Les membres ne peuvent continuer au-delà que si un administrateur active les crédits d'utilisation, avec des limites de dépenses au niveau de l'organisation, d'un groupe ou d'un membre (Manage costs effectively). Sur Team, les crédits sont prépayés ; sur Enterprise au siège, la consommation réelle est facturée en fin de mois (centre d'aide, « Manage usage credits for Team and seat-based Enterprise plans »)
• Si un membre sans droits de facturation lance /usage-credits, Claude Code demande confirmation puis envoie une demande aux administrateurs
• Enterprise à la consommation (nouveaux contrats et libre-service) : pas de quota par siège ; toute la consommation est facturée au tarif de l'API dès le premier token. Elle s'arrête quand la limite de dépenses de l'organisation ou du membre est atteinte (centre d'aide, « How am I billed for my Enterprise plan? »)

Clé API (paiement à l'usage)

• Pas de fenêtre de 5 heures ni de limite hebdomadaire : tout ce que vous consommez est facturé
• Si vous dépassez une limite de débit par minute (requêtes, tokens d'entrée ou tokens de sortie par minute), vous recevez une erreur 429, avec un en-tête retry-after qui indique combien de temps attendre
• Chaque niveau d'utilisation, qui dépend de votre historique, a un plafond de dépenses mensuel (Start 500 $, Build 1 000 $, Scale 200 000 $). Une fois atteint, l'utilisation est suspendue jusqu'au 1er du mois suivant à 00:00 UTC. Vous pouvez aussi fixer vous-même une limite plus basse (documentation de l'API Claude, « Rate limits »)
• Pour une organisation, il est aussi possible de fixer des limites de dépenses sur les espaces de travail de la Claude Console (Manage costs effectively)
• Les forfaits Max et Team incluent chaque mois des crédits utilisables sur l'API (100 $ avec Max, 200 $ avec Ultra). On les obtient en liant une organisation de la Claude Console, et ils couvrent aussi claude -p lancé avec une clé API, mais pas Claude Code en mode interactif (« Les crédits API mensuels des forfaits Max et Team de Claude »)

Vérifier ce qu'il vous reste et ce que vous avez dépensé

• /usage : les barres d'utilisation du forfait, les dépenses du mois en crédits d'utilisation et le détail de ce qui a consommé votre quota (skills, sous-agents, serveurs MCP, etc.). /cost et /stats en sont des alias. Le détail est calculé à partir de l'historique des sessions de cette machine : l'utilisation sur d'autres appareils ou sur claude.ai n'y figure pas
• Settings > Usage sur claude.ai : l'avancement de la fenêtre de 5 heures et de la limite hebdomadaire, et l'heure de renouvellement de chacune
• Ligne d'état : ajoutez les champs rate_limits pour garder en permanence le reste à l'écran
• /status : le compte avec lequel vous travaillez
• Avec une clé API : la page Usage de la Claude Console (platform.claude.com/usage)

Sources : Manage costs effectively, Error reference, Commands (consultées le 26 septembre 2026).

5. Comment fonctionne la tarification API à l'usage

Via l'API, le prix par token dépend du niveau du modèle (sommet, haut, intermédiaire, léger). Les prix changent d'une version à l'autre, mais les rapports — plus le niveau est élevé, plus c'est cher ; la sortie coûte cinq fois l'entrée ; ce qui est lu depuis le cache coûte bien moins que l'entrée — se sont maintenus jusqu'ici d'une génération à l'autre. Prix au 12 octobre 2026 :

* MTok = 1 million de tokens. Source : Claude Platform Docs, « Pricing » (consulté le 12 octobre 2026). Les prix de Haiku 5.5 valent pour des prompts jusqu'à 100 000 tokens ; au-delà, ils passent à 0,50 $ en entrée, 2,50 $ en sortie et 0,05 $ en lecture du cache. La lecture du cache de Sonnet 5.5 est passée de 10 % à 5 % de l'entrée le 7 octobre 2026. L'ancien Haiku 4.5 (1 $ en entrée, 5 $ en sortie) est désormais un modèle legacy, toujours disponible. Pour les prix actuels et la comparaison des modèles, voir notre comparatif des prix d'Opus, Sonnet et Haiku ; pour les modèles actuels de chaque éditeur, la liste des modèles actuels et de leurs dates de coupure.

Qu'est-ce que le cache de prompt ?

Anthropic propose une fonctionnalité de cache de prompt : quand le même contexte (prompt système et conversation récente) est réutilisé, ce qui est lu depuis le cache coûte 10 % du prix d'entrée de base (et encore moins sur Opus 5.5 et Sonnet 5.5, à 5 %, et sur Fable 5.1, à 2,5 %, comme dans le tableau ci-dessus). En contrepartie, l'écriture dans le cache coûte 1,25 fois l'entrée pour une durée de vie de 5 minutes, et 2 fois pour une heure.

La durée de vie du cache dépend de la façon dont vous êtes facturé. Dans le quota d'un abonnement, Claude Code donne à la conversation principale un cache d'une heure ; avec des crédits d'utilisation, une clé API ou un fournisseur cloud, la valeur par défaut est de cinq minutes (documentation de Claude Code, « Prompt caching »). Avec cinq minutes, une pause plus longue fait expirer le cache, et le message suivant réécrit tout le contexte dans le cache. Régler promptCacheTtl sur 1h porte la conversation principale à une heure (avec un prix d'écriture plus élevé).

Pour utiliser des modèles comme DeepSeek, GLM ou Kimi à la place de Claude depuis Claude Code afin de réduire les coûts, ainsi que leurs points de vigilance (cache, facturation de la recherche, destination du code), consultez notre article Comment utiliser DeepSeek, GLM et Kimi avec Claude Code.

6. Résumé

FAQ

Sources

Sources primaires vérifiées (récupérées le 26 septembre 2026) : documentation de Claude Code Manage costs effectively / Error reference / Interactive mode / Prompt caching / Model configuration / Commands / Tools reference ; documentation de l'API Claude Pricing / Rate limits / PDF support ; la page de tarifs de Claude ; centre d'aide d'Anthropic crédits d'utilisation (Pro et Max) / crédits d'utilisation (Team et Enterprise) / Claude Code avec Pro ou Max / forfait Pro / forfait Max / facturation Enterprise. Les prix, les limites et la disponibilité peuvent changer : vérifiez les pages officielles avant de vous abonner.