Ce que coûte réellement une tâche Claude Code
Un correctif, un scaffold et un refactor sont trois factures différentes : anatomie du coût par tâche — tours, croissance du contexte, le prix réel d'une tâche.
Les chiffres mensuels cachent celui qui change vraiment votre comportement : le coût d'une tâche. Un petit correctif et un refactor d'après-midi ne sont pas le même produit, mais la facture les montre en une tache floue. Ce post décompose la dépense d'agent jusqu'à l'unité où vous décidez vraiment — la tâche.
Transparence d'emblée : j'opère Teapot Router, une passerelle pour GPT et Claude Code. L'anatomie ci-dessous est l'économie du protocole, pas un argument produit — elle vaut pour tout endpoint compatible Anthropic.
Le mois cache la tâche
Les moyennes mensuelles sont une comptabilité honnête et un volant inutile. Dans le mois d'un même développeur, le coût par tâche varie bien plus que le coût par personne — les tâches d'un même dev diffèrent d'un ordre de grandeur selon la forme, pas l'effort. Trois formes couvrent presque tout ce que font les agents :
- Le correctif chirurgical. Peu de tours, contexte resserré, le fichier déjà lu auparavant — le cache fait l'essentiel du travail. La forme la moins chère, celle qui donne l'impression que les agents sont gratuits.
- Le scaffold ou la nouvelle fonctionnalité. Beaucoup de tours, mais le contexte croît de façon prévisible et le préfixe stable (instructions, conventions, fichiers précédents) cache bien. Coût moyen, très prévisible.
- Le refactor profond ou la session marathon. Des centaines de tours, un contexte en boule de neige tour après tour, et le taux de réussite de cache qui décide la facture plus que le tarif public du modèle. C'est là que les budgets meurent.
La boule de neige du contexte
Le mécanisme qui renchérit la forme trois : les agents sont sans état sur le fil. Le tour 15 renvoie toute la conversation précédente — prompt système, fichiers lus, résultats d'outils. L'entrée de chaque tour grossit avec tout ce qui précède, donc le coût par tour grimpe dans une longue session même à prix par token fixe. Des sessions découpées en tâches bornées paient leur contexte une fois chacune ; une session sans fin paie tout, encore et encore. La forme de la session est une décision de coût autant que de productivité.
Pourquoi la même tâche facture différemment
Deux devs lancent le même refactor et voient des factures très différentes. Les suspects, par ordre d'impact : le comportement de cache (préfixe stable relu à bas prix contre préfixe volatil repayé à froid), la discipline de session (sessions bornées neuves contre une méga-session continue) et le routage de modèle (flagship à chaque étape contre flagship sur les demandes dures uniquement). Rien de tout cela n'est écrit au tarif — c'est dans les données par requête, seul lieu pour juger « pourquoi c'était cher ».
Mesurez à la tâche, décidez à la tâche
Si votre passerelle permet d'étiqueter les requêtes ou d'attribuer des clés par projet, la tâche devient votre unité de coût : ce refactor a coûté tant, cette voie de correctifs tant par semaine. C'est cette granularité qui rend défendable le budget mensuel du post précédent — on ne dispute plus une moyenne magique, on lit un registre par tâche. Sans étiquetage, sessions bornées plus clés par projet sont le substitut praticable.
Le mois est l'unité de budget ; la tâche est l'unité de décision. Connaissez vos trois formes de tâche, surveillez la boule de neige du contexte et lisez le coût là où il se mesure — par requête, par tâche — et le chiffre mensuel ne surprend plus personne.
FAQ
Combien coûte une tâche typique ?
Il n'existe pas de chiffre universel honnête — tout dépend de la forme (tours, croissance du contexte, comportement de cache). Modélisez avec la calculatrice sur teapotrouter.com/en/claude-code-cost-calculator, puis vérifiez sur votre registre par requête après une semaine.
Pourquoi ma petite tâche a coûté si cher ?
Presque toujours la boule de neige : une longue session où chaque tour repaye toute la conversation, ou un motif de cache manqué qui relit à froid. Les deux apparaissent dans les colonnes de tokens par requête avant de devenir des dollars.
Comment attribuer les coûts à des tâches précises ?
Étiquetez les requêtes ou utilisez des clés par projet à la passerelle, puis regroupez le registre par étiquette. Sans étiquetage, sessions bornées plus clés par projet sont le substitut pratique.