Description : Comprendre le mail de Claude Console, distinguer la facturation directe de l’API de Claude Code et vérifier si la mise en cache réduit réellement les dépenses.
1. Une mauvaise note envoyée par une IA ?
Le message annonce : « Your prompt cache hit rate is low ». Puis il suggère que les dépenses directes liées à l’API pourraient baisser jusqu’à environ 45 %. On croirait presque que Claude vient de noter votre manière de poser des questions.
Mais il ne s’agit ni d’un reproche ni d’une panne. Le sujet est le coût de retraitement des mêmes instructions dans des appels répétés. Le mail ne constitue pas non plus une remise automatique. [1]
2. Refaire la formation d’accueil chaque matin
Imaginez un logiciel qui transmet vingt pages de règles à Claude avant chaque demande. Un jour, il résume un tableau ; le lendemain, il classe des courriels. La question change, pas le règlement.
Sans réutilisation, ce texte commun est facturé comme une entrée ordinaire à chaque appel. Lorsqu’un cache correspond au préfixe déjà traité, l’API peut le réemployer pendant sa durée de validité. C’est comme cesser d’imposer chaque matin la journée d’intégration à un salarié déjà en poste.
L’ordre compte : placez les instructions stables au début, puis les dates, identifiants et requêtes variables. Une information qui change dès la première ligne peut empêcher la correspondance. [1]
3. Les 45 % ne sont pas une promotion universelle
Ce pourcentage est une estimation du potentiel d’économie sur le trafic facturé directement par l’API. Une facture de 100 dollars qui baisserait réellement de 45 % passerait à 55 dollars. Ce calcul n’est pas une prévision pour tous les comptes.
D’après les tarifs officiels consultés le 13 novembre 2026, l’écriture d’un cache de cinq minutes coûte 1,25 fois le prix d’une entrée classique ; celle d’un cache d’une heure coûte deux fois ce prix. Une lecture de cache standard revient à 0,1 fois l’entrée normale, voire moins selon le modèle. Les sorties restent facturées séparément. [2]
Le gain vient donc des lectures répétées. Mettre en cache un texte pour ne plus jamais l’utiliser ressemble à un abonnement annuel de piscine acheté pour un seul plongeon.
4. Et si vous utilisez uniquement Claude Code ?
Le courriel précise que Claude Code gère automatiquement son cache et n’entre pas dans cette estimation. Un utilisateur de Claude Code uniquement n’a généralement pas besoin de modifier ses paramètres manuellement à cause de ce message.
L’avertissement concerne surtout les applications, scripts, outils internes et automatisations qui appellent directement Claude API. Un abonnement de conversation n’est pas la même chose qu’une facturation à l’usage de l’API.
5. Comment mesurer la différence ?
Commencez par vérifier que vous payez effectivement des appels directs à l’API. Repérez ensuite les consignes longues et répétées, puis placez-les avant les éléments variables. Le mode automatique s’active à l’aide de "cache_control": {"type": "ephemeral"} au niveau supérieur de la requête. Si la fin varie toujours, un point de cache explicite à la fin du contenu stable peut être préférable. [1]
Observez cache_read_input_tokens pour les lectures réutilisées, cache_creation_input_tokens pour les écritures et input_tokens pour les autres entrées. Comparez surtout la facture globale. La durée habituelle est de cinq minutes ; une heure est possible à un coût d’écriture supérieur. [1][2]
6. En définitive
Claude ne remet pas en cause votre mémoire. Il signale peut-être que votre application paie plusieurs fois pour relire le même mode d’emploi. Avant de courir après 45 %, vérifiez quels textes sont réellement répétés et combien vous économisez sur la facture.
Sources
- Vérification le 13 novembre 2026. Le chiffre de 45 % reste une estimation, pas une réduction garantie.
Références (2)
- Anthropic : Prompt caching platform.claude.com
- Anthropic : Tarifs platform.claude.com
