Le vrai coût en tokens de Claude Code sur un projet réel : notre facture détaillée

Tous les guides « claude code prix » vous récitent la même grille : Pro à 20 $/mois, Max à 100 $, API au million de tokens. J'ai lu les cinq premiers résultats Google. Aucun ne répond à la seule question qui compte quand vous pilotez un projet : combien ça coûte vraiment, en production, sur 30 jours ?

Voici notre facture. Pas un tableau marketing, pas une estimation « ça dépend ». Les chiffres réels d'un projet Next.js + Supabase + FastAPI livré en mai 2026, avec Claude Code comme agent principal sur chaque tâche.

Abonnement ou API : ce que vous payez vraiment

La confusion commence dès la page de tarifs d'Anthropic. Claude Code n'est pas un produit séparé. Il est inclus dans votre abonnement Claude (Pro, Max, Team, Enterprise) ou accessible via l'API au token. Ce sont deux modèles de facturation radicalement différents, et le choix entre les deux conditionne tout le reste.

Pourquoi le plan Pro est un piège pour les devs intensifs ?

Le plan Pro à 20 $/mois (17 $ en annuel, selon la page officielle de tarifs) donne accès à Claude Code, mais avec des quotas de requêtes « standard ». Concrètement, sur une session de refactoring un peu musclée (migration de 15 fichiers, réécriture de tests, commit), j'atteins le rate limit en 45 minutes. Le reste de la journée, je regarde le compteur se recharger.

D'après le guide de meydeey.com, le plan Max offre 5x plus de requêtes pour 100 $/mois, ou 20x pour 200 $/mois. La différence n'est pas un luxe : c'est la frontière entre un outil de production et un gadget qu'on utilise « quand il veut bien ».

L'API, elle, facture au token consommé. Opus 4.6 coûte 5 $ en input et 25 $ en output par million de tokens. Sonnet 4.6 descend à 3 $/15 $, et Haiku 4.5 à 1 $/5 $. Le détail qui change tout : au-delà de 200 000 tokens d'input dans une même requête, le tarif double automatiquement (d'après plateya.fr). Sur un projet avec une grosse codebase, vous franchissez ce seuil plus vite que vous ne le pensez.

Notre consommation réelle sur 30 jours

Le projet : un SaaS B2B (Next.js 15, Supabase, FastAPI) avec authentification, back-office admin, 12 endpoints API, une landing page et un système de notifications email. Deux développeurs, Claude Code en agent principal, Opus 4.6 comme modèle par défaut.

Comment se répartissent les tokens par type de tâche ?

J'ai catégorisé chaque session Claude Code sur le mois. La répartition m'a surpris. Le scaffolding initial (setup projet, boilerplate, config) pèse peu. Ce qui mange les tokens, ce sont les tâches itératives : debugging, refactoring, écriture de tests, revue de PR.

284 $ brut sur 30 jours pour deux devs. Avant toute optimisation, c'est le prix d'un Opus 4.6 utilisé sans retenue.

Ce chiffre fait peur. Mais il raconte une histoire incomplète. Sans prompt caching, sans routage de modèle, sans aucune discipline de contexte. C'est le scénario du pire, celui que personne n'affiche dans les comparatifs.

Quel poste gonfle le plus sans qu'on s'en rende compte ?

Le debugging et le refactoring, à eux seuls, représentent 31 % de la facture. La raison est mécanique : chaque itération de debug renvoie la totalité du contexte (fichiers ouverts, historique de conversation, output précédent). Sur une session de 90 minutes, le contexte cumule facilement 400 000 tokens d'input, ce qui déclenche le tarif doublé à 10 $/M.

J'ai mesuré qu'une seule session de debugging complexe (un bug de race condition sur les webhooks Stripe) a consommé 8,40 $ en tokens. Pour un bug. Quand vous lancez Claude Code en maintenance sur une codebase existante, ces sessions deviennent quotidiennes.

Les trois postes qui explosent la note

Derrière le chiffre global se cachent trois mécanismes précis. Les comprendre permet de les contrôler.

Pourquoi l'Extended Thinking coûte autant ?

L'Extended Thinking génère des blocs de raisonnement interne avant chaque réponse. Sur les tâches complexes (refactoring multi-fichiers, conception d'API), cette réflexion améliore la qualité. Mais elle multiplie les tokens output par 3 à 5x. Selon noxcod.com, l'Extended Thinking est activé par défaut sur les tâches complexes avec Claude Opus.

Sur notre projet, 40 % des tokens output provenaient de l'Extended Thinking. C'est le poste invisible par excellence : vous ne le voyez pas dans le code généré, mais il apparaît sur la facture.

Quand le contexte dépasse-t-il le seuil critique ?

Opus 4.6 accepte jusqu'à 1 million de tokens en contexte. La fenêtre est énorme, mais elle a un coût proportionnel. Mon constat après 30 jours : les sessions les plus chères ne sont pas celles qui traitent le plus de fichiers. Ce sont celles qui durent le plus longtemps sans compaction.

Après 45 minutes de conversation continue, le contexte dépasse systématiquement 200K tokens. À ce stade, chaque requête coûte le double. La discipline de compaction (résumer le contexte, relancer une session fraîche) divise la facture de ces sessions par deux.

Faut-il payer pour des sub-agents ?

Le Claude Agent SDK permet de lancer des sous-agents sur des tâches parallèles. C'est puissant pour les migrations massives, mais chaque sub-agent consomme son propre contexte. Sur un refactoring de 40 fichiers, j'ai lancé 4 sub-agents en parallèle. Résultat : 12 $ de tokens en 20 minutes. L'approche séquentielle avec un seul agent aurait coûté 4 $, pour un résultat comparable.

Les sub-agents se justifient quand le temps compte plus que les tokens. Pour le budget, la file d'attente séquentielle reste moins chère.

Réduire la facture sans sacrifier la qualité

Après le choc de la première semaine, j'ai appliqué trois leviers. La facture du mois suivant est passée de 284 $ à 47 $.

Comment le prompt caching divise-t-il la facture par 5 ?

Le prompt caching, selon la documentation Anthropic, réduit le coût des cache hits jusqu'à 90 %. En pratique, cela signifie que les fichiers CLAUDE.md, ARCHITECTURE.md et les conventions de votre projet (qui sont rechargés à chaque requête) ne coûtent presque rien après la première lecture.

Sur notre projet, les 27M de tokens d'input contenaient environ 60 % de contenu répété (fichiers de contexte, historique récent). Avec le caching activé, ces 16M de tokens passent de 5 $/M à 0,50 $/M. L'économie : 72 $ récupérés sur le seul poste input.

C'est le levier le plus simple et le plus rentable. Si vous n'avez rien optimisé d'autre, commencez par structurer vos fichiers de contexte projet. J'en parle en détail dans mon retour sur les plugins de contexte Claude Code.

Le routage de modèle change-t-il la donne ?

Toutes les tâches ne méritent pas Opus 4.6. Les commits, le linting, la génération de boilerplate fonctionnent aussi bien avec Sonnet 4.6 (3x moins cher) ou Haiku 4.5 (5x moins cher). J'ai configuré Claude Code pour router automatiquement les tâches simples vers Haiku et les tâches moyennes vers Sonnet.

Résultat : sur les 27M de tokens input, seuls 8M sont traités par Opus. Le reste descend sur Sonnet ou Haiku. L'économie atteint 55 % par rapport au tout-Opus.

Selon une étude McKinsey de 2025 sur les outils IA en développement, les équipes qui optimisent le routage de modèles réduisent leurs coûts d'inférence de 40 à 70 % sans impact mesurable sur la qualité du code produit.

L'alternative DeepSeek : 10x moins cher, vraiment ?

La vidéo de Matheus Battisti (Hora de Codar) documente un setup « DeepClaude » qui utilise DeepSeek V4 comme modèle via l'API, piloté par Claude Code ou OpenCode comme agent. Son argument : un projet complet (Next.js, auth, SQLite, intégration IA) pour 11 centimes de dollar en scaffolding, moins de 30 centimes au total.

Quels compromis implique le passage à DeepSeek ?

Les chiffres sont réels : l'input DeepSeek Flash coûte quelques centimes par million de tokens, l'output environ 30 centimes. C'est effectivement 10x moins qu'Opus. Mais après avoir testé ce setup sur un projet client, je note trois limites concrètes.

Le temps de réponse d'abord. Battisti le mentionne : la deuxième itération a pris 25 minutes. Sur Opus, la même tâche prend 5 à 8 minutes. Quand votre TJM dépasse 500 €, le temps d'attente coûte plus que les tokens économisés.

La qualité ensuite. DeepSeek produit du code fonctionnel sur le scaffolding. Sur le debugging complexe ou le refactoring architectural, les suggestions sont moins précises. J'ai compté 40 % de « re-prompts » supplémentaires par rapport à Opus sur les tâches non triviales.

La fiabilité enfin. Le tool use (lecture de fichiers, exécution de commandes) passe par un modèle tiers qui n'a pas été conçu pour l'agent harness de Claude Code. Les erreurs de parsing sont fréquentes. Pour un side project, c'est acceptable. Pour de la production client avec des tests automatiques générés, je ne prends pas ce risque.

DeepSeek est un excellent choix pour le prototypage et les MVPs. Pour la production sérieuse, le combo Opus (tâches critiques) + Haiku (tâches simples) reste mon choix, avec un coût maîtrisé si vous appliquez les leviers décrits plus haut.

Verdict : combien devez-vous budgéter ?

La réponse dépend de votre profil, et je vais la donner sans « ça dépend ».

Dev solo, 1 projet actif : le plan Max 5x à 100 $/mois couvre largement vos besoins. Vous ne vous souciez pas des tokens, vous codez. C'est le choix que je recommande si votre temps vaut plus que l'optimisation de centimes.

Équipe de 2-5 devs, plusieurs projets : passez à l'API avec routage de modèles et prompt caching. Budget réaliste : 40 à 80 $ par dev et par mois, soit moins qu'un plan Max par personne, avec une flexibilité totale. Le plan Team à 30 $/utilisateur/mois (selon meydeey.com) ne suffit pas en quotas pour un usage intensif.

Agence ou ESN, 10+ projets en parallèle : l'API est le seul choix viable. Avec une architecture de contexte bien structurée (CLAUDE.md, fichiers de conventions, compaction systématique), on descend autour de 25 $ par dev et par mois. C'est le modèle que j'applique chez GoLive Software avec une combinaison devs offshore + Claude Code + process stricts.

Les guides de prix qui se contentent de lister Pro / Max / Team passent à côté du sujet. Le coût réel de Claude Code, c'est votre discipline de contexte, votre stratégie de routage et votre capacité à industrialiser les sessions. Les tokens sont un multiplicateur, pas un prix fixe.