Facturation de la mémoire Claude : quel est le coût réel ?
La mémoire de Claude n'est pas facturée en tant que telle, mais chaque fait mémorisé est renvoyé en input tokens. Votre facture dépend du volume réinjecté et du prompt caching.
Les fonctionnalités de mémoire de Claude entraînent-elles des frais supplémentaires ?
Les fonctionnalités de mémoire de Claude n’ont pas de coût propre. Les tarifs publiés par Anthropic sont calculés par million de tokens d’entrée et par million de tokens de sortie, avec des tarifs supplémentaires pour le prompt caching. Aucun de ces tarifs ne correspond à des memory tokens. Le stockage de la mémoire elle-même est gratuit sur l’API Claude (application programming interface), car le memory tool s’exécute côté client et le fichier est stocké sur un espace dont vous êtes propriétaire.
La mémoire peut tout de même augmenter votre facture, car un fait mémorisé ne modifie une réponse que s’il figure dans la requête que Claude lit. Mémoriser signifie renvoyer le contenu. Ce texte arrive sous forme de tokens d’entrée et est facturé au tarif normal des tokens d’entrée du modèle. Deux éléments déterminent le coût : le nombre de tokens du texte mémorisé que vous renvoyez à chaque tour, et la possibilité de servir ce texte depuis le prompt cache.
Avec un abonnement Pro ou Max, vous ne payez pas du tout par token. La mémoire consomme donc votre quota d’utilisation, pas votre argent. Le mécanisme reste identique. Seule l’unité change. Ce quota est limité. Il est donc utile de savoir combien coûte Claude Pro et à partir de quand ses limites vous bloquent avant de décider quelle quantité de mémoire chaque tour doit transporter. Claude Enterprise fonctionne encore différemment : chaque token y est facturé aux tarifs de l’API en plus du prix des sièges, de sorte qu’un bloc de mémoire trop volumineux redevient une dépense plutôt qu’une consommation de quota. Si l’élagage de la mémoire ramène confortablement votre utilisation sous le plafond d’un forfait moins cher, passer de Max à Pro est l’étape suivante à envisager. Le changement prend effet à la fin de la période déjà payée. Si la comparaison que vous envisagez porte réellement sur plusieurs fournisseurs plutôt que sur les forfaits d’Anthropic, comparer les forfaits de Claude et de ChatGPT aux tarifs actuels est le bon point de départ.
Ce que signifie « mémoire » dans chaque interface Claude
Trois produits distincts utilisent ce terme. Les confondre explique en grande partie pourquoi cette question prête à confusion.
L’outil de mémoire de l’API Claude. Vous ajoutez une entrée au tableau tools et implémentez les opérations sur les fichiers dans votre propre code.
{"type": "memory_20250818", "name": "memory"}En octobre 2026, cet outil ne nécessite plus d’en-tête bêta avec l’API Messages et fonctionne avec tous les modèles Claude 4 et ultérieurs. Il s’exécute côté client : Claude demande une opération telle que view /memories, votre gestionnaire l’exécute sur le stockage que vous contrôlez, puis vous renvoyez le résultat dans un bloc tool_result. Anthropic ne stocke jamais le fichier ; vous n’avez donc aucuns frais de stockage à répercuter. Vous payez plutôt l’aller-retour. La définition de l’outil est envoyée dans chaque requête, et le contenu du fichier renvoyé reste dans la conversation à partir de ce moment.
Anthropic publie la partie fixe de cette surcharge. Avec Claude Opus 5 et un choix d’outil auto, l’invite système d’utilisation des outils contient 286 tokens, comme indiqué en octobre 2026. Ce coût est facturé une fois par requête dès qu’un outil est présent, qu’il s’agisse de la mémoire ou d’un autre outil.
Claude Code. Deux mécanismes sont chargés au début de chaque session. Les fichiers CLAUDE.md contiennent les instructions que vous rédigez. La mémoire automatique contient les notes que Claude rédige pour lui-même, sous ~/.claude/projects/<project>/memory/. Seules les 200 premières lignes ou les 25KB de MEMORY.md sont chargées, selon la première limite atteinte. Les fichiers de sujets situés à côté sont lus à la demande et non au démarrage. Tout ce qui est chargé au démarrage fait partie du préfixe transmis dans chaque requête ultérieure de la session. Comment Claude Code récupère la mémoire entre les sessions décrit l’ordre de chargement, fichier par fichier.
Claude sur le Web. Sur claude.ai, la mémoire est un ensemble d’entrées que Claude rédige et met à jour au fil de vos conversations, avec un espace mémoire distinct pour chaque projet. Settings > Memory affiche les éléments stockés. Le bouton à cet endroit permet de sélectionner Pause memory ou Reset memory. Cette interface est facturée par abonnement ; la mémoire consomme donc les limites d’utilisation.
Pourquoi le texte mémorisé est facturé comme des tokens d’entrée
L’API Messages est sans état. Elle ne conserve rien entre les appels. Votre client envoie donc toute la conversation à chaque tour, et le modèle la relit entièrement. La mémoire ne fait pas exception à cette règle. Elle constitue un bloc de texte supplémentaire dans la même requête.
La répartition est visible dans l’objet usage de chaque réponse.
"usage": {
"input_tokens": 412,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 18240,
"output_tokens": 236
}input_tokens compte uniquement les tokens qui n’ont été ni lus depuis le cache ni utilisés pour le créer. En pratique, il s’agit des tokens situés après le dernier point de cache. Le nombre total de tokens d’entrée de la requête correspond à cache_read_input_tokens plus cache_creation_input_tokens plus input_tokens. Un fichier mémoire ouvert par Claude trois tours plus tôt est inclus dans ce total à chaque tour suivant. Il est comptabilisé dans cache_read_input_tokens tant que le préfixe est mis en cache, puis dans input_tokens lorsque ce n’est plus le cas. Le texte est identique, mais le prix peut être très différent. Les tokens d’entrée et de sortie ont des prix différents, et la mémoire est toujours comptabilisée du côté des tokens d’entrée.
Où voir ces chiffres dans votre propre utilisation
Ne reprenez pas un chiffre trouvé dans un article de blog, y compris celui-ci. Mesurez votre propre bloc de mémoire. Le comptage des tokens est gratuit et dispose de sa propre limite de débit : la mesure ne coûte donc rien.
curl https://api.anthropic.com/v1/messages/count_tokens \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "content-type: application/json" \
-H "anthropic-version: 2023-06-01" \
-d '{
"model": "claude-opus-5",
"system": "You are a scientist",
"messages": [{"role": "user", "content": "Hello, Claude"}]
}'La réponse est un nombre, par exemple { "input_tokens": 14 }. Exécutez la commande une fois en collant votre texte de mémoire dans le champ system, puis une fois sans ce texte. La différence correspond au coût de cette mémoire à chaque tour. Deux précautions s’appliquent. Le comptage est une estimation, et les tokens supplémentaires qu’Anthropic ajoute pour ses propres optimisations système ne vous sont pas facturés. Faites également le comptage avec le modèle que vous utiliserez réellement, car Claude 4.7 et les versions ultérieures utilisent un tokenizer plus récent qui produit environ 30 pour cent de tokens supplémentaires pour un même texte.
Dans Claude Code, la même question trouve sa réponse sans utiliser curl.
/contextaffiche ce qui est actuellement chargé, y compris les fichiers de mémoire. Vous pouvez donc voir leur part de la fenêtre avant même de saisir quoi que ce soit./memoryrépertorie vos fichiers CLAUDE.md et ouvre le dossier de mémoire automatique./usageaffiche notamment les totaux de la session, les lectures du cache et les écritures dans le cache.- La ligne d’état peut afficher en continu l’utilisation de la fenêtre de contexte. Vous voyez ainsi sa croissance au moment où elle se produit.
Le bloc de session /usage ressemble à ceci :
Total cost: $0.55
Total duration (API): 6m 20s
Total duration (wall): 6h 33m 10s
Total code changes: 0 lines added, 0 lines removed
Usage by model:
claude-sonnet-4-6: 1.2k input, 5.3k output, 940.0k cache read, 50.0k cache write ($0.55)Lisez attentivement la dernière ligne. La valeur de lecture du cache, 940.0k, correspond à la conversation complète, mémoire comprise, qui est renvoyée à chaque tour au tarif du cache. La valeur d’entrée, 1.2k, correspond uniquement à la partie nouvelle. Claude Code calcule localement ce montant en dollars à partir des tarifs publics, sauf si un administrateur a défini des tarifs négociés via le paramètre géré modelPricing. Il s’agit donc d’une estimation qui peut différer de votre facture. La page Usage de la Claude Console fait foi.
Effectuez ensuite directement la comparaison. Posez la même question initiale dans deux nouvelles sessions, l’une en fonctionnement normal et l’autre avec la mémoire automatique désactivée.
CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 claudeExécutez /context dans chacune des sessions et comparez la ligne des fichiers de mémoire. L’écart correspond au coût de votre mémoire accumulée au début de chaque session, avant toute opération. Une analyse complète de la répartition de l’utilisation des tokens de Claude Code constitue une bonne lecture complémentaire à ces deux chiffres.
Quel est le coût de la relecture de la mémoire par million de tokens ?
Le prompt caching explique pourquoi un même bloc de mémoire peut coûter dix fois plus cher lors d’un tour que lors d’un autre. Anthropic publie les tarifs du cache sous forme de multiples du prix d’entrée de base de chaque modèle. La relation reste donc valable même lorsque les prix en dollars évoluent.
Les données de ce graphique
[
{
"label": "Base input",
"price_multiple": 1
},
{
"label": "5 minute cache write",
"price_multiple": 1.25
},
{
"label": "1 hour cache write",
"price_multiple": 2
},
{
"label": "Cache read",
"price_multiple": 0.1
}
]La lecture du cache coûte 0.1 fois le prix d’entrée de base sur la plupart des modèles. Les modèles les plus récents proposent une lecture moins chère : 0.05 fois le prix de base sur Claude Opus 5.5 et Claude Sonnet 5.5, et 0.025 fois le prix de base sur Claude Fable 5.1 et Claude Mythos 5.1. L’écriture d’une entrée avec une durée de vie de 5 minutes coûte 1.25 fois le prix de base, et une durée de vie de 1 heure coûte 2 fois le prix de base. La page tarifaire d’Anthropic indique clairement le seuil de rentabilité : le caching devient rentable après une lecture du cache avec une durée de 5 minutes, ou après deux lectures du cache avec une durée de 1 heure. Cette indication repose sur une lecture standard à 0.1x. Le guide du prompt caching ne donne lui-même aucun seuil de rentabilité, mais les tarifs de lecture moins élevés ne modifient pas ces nombres, car c’est le surcoût d’écriture que les lectures doivent compenser. Le seuil de rentabilité du prompt caching fournit le calcul à effectuer avant de décider où placer la mémoire.
Ces multiples permettent de convertir le nombre de relectures en calcul. Le bloc suivant applique les multiples publiés ci-dessus. Il ne mesure pas une charge réelle. Il chiffre un bloc de mémoire de trois façons sur une session de 100 tours, sous forme d’un nombre équivalent de tokens facturés au tarif d’entrée de base.
Les données de ce graphique
[
{
"label": "4,000 tokens, never cached",
"base_rate_equivalent_tokens": "400,000"
},
{
"label": "4,000 tokens, 1 write and 99 reads",
"base_rate_equivalent_tokens": "44,600"
},
{
"label": "1,000 tokens, 1 write and 99 reads",
"base_rate_equivalent_tokens": "11,150"
}
]Un bloc de mémoire de 4,000 tokens qui n’utilise jamais le cache au cours des 100 tours est facturé comme 400,000 tokens au tarif de base. Le même bloc, après une écriture dans le cache de 5 minutes suivie de 99 lectures du cache, est facturé comme 44,600. Réduisez-le à un quart de sa taille tout en conservant le caching, et il est facturé comme 11,150. La fonctionnalité ne change pas entre ces 3 lignes. Seul le comportement lors des relectures change. Les lignes utilisent une lecture standard à 0.1x. Sur Claude Opus 5.5 ou Claude Sonnet 5.5, où une lecture coûte 0.05x, le bloc mis en cache de 4,000 tokens tombe à 24,800. Sur Claude Fable 5.1, il tombe à 14,900. Ces valeurs restent des nombres de tokens, pas des montants. Convertir un nombre de tokens en montant sur votre facture mensuelle consiste à effectuer une multiplication par le tarif de votre modèle par million de tokens. Ce tarif dépend du modèle utilisé. Si l’agent doit fonctionner sur Claude Fable 5, commencez par ses tarifs publiés par million de tokens et les tâches auxquelles il convient. Si le fournisseur reste à déterminer, au-delà du seul choix du modèle, le coût des mêmes tâches avec l’API de Claude et avec ChatGPT montre pourquoi le résultat de cette multiplication diffère. Un agent qui utilise beaucoup de mémoire dépend fortement de la partie consacrée aux tokens d’entrée.
La deuxième ligne suppose que chacune des 99 requêtes suivantes arrive alors qu’une entrée du cache est encore valide. C’est cette hypothèse qui fausse le plus souvent les factures réelles.
Pourquoi la même question coûte-t-elle plus cher après une interruption ?
Une entrée de cache a une durée de vie. L’horloge démarre à la requête qui l’écrit ou la lit. La valeur par défaut est de 5 minutes. L’option de 1 heure coûte le double de l’écriture indiquée plus haut. Dans Claude Code, la durée de vie est d’une heure avec un abonnement. Elle repasse à 5 minutes lorsque vous utilisez des crédits de consommation. Avec une clé API ou un fournisseur cloud, elle est de 5 minutes par défaut. Le paramètre ENABLE_PROMPT_CACHING_1H=1 conserve une durée de vie d’une heure avec les crédits de consommation. Depuis Claude Code v2.1.242, le paramètre promptCacheTtl défini sur 1h fait de même pour la conversation principale.
Une question d’une ligne saisie dans une session laissée ouverte pendant la pause déjeuner coûte donc cher, car l’entrée de cache a expiré pendant votre absence. Tout le préfixe, mémoire comprise, est de nouveau traité au tarif d’entrée de base, puis réécrit dans le cache. C’est la durée de l’interruption qui détermine ce coût.
Vous pouvez le vérifier au lieu de vous fier à cette explication. Avec un forfait Pro, Max, Team ou Enterprise, le détail /usage signale tout comportement responsable d’au moins 10 pour cent de la consommation récente. Le contexte long et les cache misses y apparaissent tous deux explicitement. Depuis Claude Code v2.1.251, le bloc de session dans /usage ajoute également une ligne Prompt cache (main) indiquant la part des entrées servies depuis le cache, le nombre de cache misses et l’état actuel du cache. Avec l’API, surveillez cache_creation_input_tokens : cette valeur remonte à la taille complète de votre préfixe lors de la première requête après une période d’inactivité.
Ce qui invalide discrètement le cache
Le préfixe mis en cache est ordonné : outils, puis système, puis messages. Une modification à un niveau invalide ce niveau et tous ceux qui le suivent. Modifier une définition d’outil supprime l’intégralité du cache. Modifier le prompt système supprime le cache du système et des messages.
C’est le piège pour quiconque conserve la mémoire dans le prompt système et le réécrit à mesure que l’agent apprend. Chaque réécriture supprime la copie en cache de tout ce qui suit. La requête suivante doit donc réécrire l’ensemble du contenu. Placez le contenu stable au début et ne le modifiez pas. Placez le contenu volatile vers la fin de la liste des messages, où son invalidation coûte peu.
Il existe un second problème, plus discret. Chaque modèle possède un préfixe minimal pouvant être mis en cache : 512 tokens sur Claude Opus 5, 1,024 sur Claude Sonnet 5 et 4,096 sur Claude Haiku 4.5, selon les informations publiées en octobre 2026. La documentation d’Anthropic précise ce qui se passe en dessous de ce seuil : « Toute requête visant à mettre en cache moins de tokens que ce nombre est traitée sans mise en cache, et aucune erreur n’est renvoyée. » Un petit fichier mémoire marqué avec cache_control ne sert donc absolument à rien, sans aucun message. Le symptôme observable est que cache_creation_input_tokens reste à 0 alors que votre prompt contient clairement un breakpoint.
Élaguez la mémoire qui n’est plus utile
Chaque ligne de mémoire consomme des tokens à chaque tour où elle est chargée. Pour chaque ligne, demandez-vous donc si elle a récemment modifié une réponse. Claude Code rend ces limites concrètes. Essayez de conserver un fichier CLAUDE.md de moins de 200 lignes, car les fichiers plus longs consomment davantage de contexte et sont moins bien suivis par Claude. MEMORY.md est limité aux 200 premières lignes ou à 25KB lors du chargement. Tout ce qui dépasse cette limite est supprimé au démarrage de la session suivante. Un index trop volumineux consomme donc des tokens sans rien apporter.
Deux habitudes permettent de conserver un fichier court. Déplacez les détails de l’index vers des fichiers thématiques, que Claude lit à la demande plutôt qu’au démarrage. Déplacez les instructions de workflow de CLAUDE.md vers des skills, qui ne sont chargés que lorsqu’ils sont invoqués. Pour les fichiers de mémoire qui commencent déjà par un frontmatter, Claude Code enregistre l’heure d’écriture dans un champ modified sous la forme d’un timestamp ISO 8601, à partir de la version 2.1.214. Ce timestamp permet d’identifier rapidement un fait devenu obsolète. Élaguer la mémoire obsolète décrit plus en détail le processus de révision.
Quand la récupération est préférable au chargement de tout le contenu dans le contexte
L’outil de mémoire sert à récupérer les informations au moment où elles sont nécessaires. Au lieu de tout charger au début, l’agent enregistre ce qu’il apprend et ne relit un fichier que lorsqu’une tâche en a besoin. Le calcul change, car la lecture d’un fichier ne coûte ses tokens qu’une seule fois, puis le fichier reste dans le préfixe mis en cache, tandis qu’un bloc chargé en permanence est facturé à chaque tour.
Une règle simple découle des deux graphiques ci-dessus. Le texte utilisé presque à chaque tour doit rester dans le préfixe stable mis en cache. Le texte utilisé un tour sur vingt doit être placé derrière un appel view. Le seuil de rentabilité dépend du nombre de relectures, et non d’un quelconque tarif appliqué par Anthropic.
Avec l’API, vous pouvez également laisser la plateforme réduire la conversation. La modification du contexte supprime les anciens résultats d’outils lorsque la conversation dépasse un seuil que vous définissez. Cette fonction est encore en bêta ; les requêtes qui l’utilisent doivent donc inclure l’en-tête bêta context-management-2025-06-27.
{
"edits": [
{
"type": "clear_tool_uses_20250919",
"trigger": {"type": "input_tokens", "value": 30000},
"keep": {"type": "tool_uses", "value": 3},
"clear_at_least": {"type": "input_tokens", "value": 5000}
}
]
}Les valeurs par défaut sont un seuil de 100,000 tokens d’entrée et 3 utilisations d’outils conservées. Examinez le fonctionnement de la mise en cache avant de l’activer : la suppression du contenu invalide le préfixe mis en cache à l’endroit de la suppression, ce qui entraîne l’écriture d’un nouveau cache lors de la requête suivante. C’est le rôle de clear_at_least. Ce paramètre retarde la suppression jusqu’à ce que l’économie soit suffisamment importante pour justifier cette écriture. La réponse indique précisément ce qui s’est produit avec context_management, cleared_tool_uses et cleared_input_tokens. Le compromis est donc mesurable, et non théorique. Gérer la fenêtre de contexte dans Claude Code applique le même principe à une session de développement.
Ce qui fait l’objet d’une ligne tarifaire distincte
La mémoire n’a pas de coût propre, mais certaines fonctionnalités en ont réellement un. Il est utile de savoir lesquelles. Voici les tarifs publiés de l’API Claude en octobre 2026. Certaines opérations sont entièrement gratuites, mais l’API Claude ne propose pas de niveau gratuit, seulement un petit crédit à l’inscription. Tout ce qui suit correspond donc à des dépenses réelles dès votre première requête.
- Recherche web : 10 $ pour 1 000 recherches, auxquels s’ajoute le coût habituel des tokens que la recherche ajoute au contexte.
- Exécution de code : 1 550 heures gratuites par organisation et par mois, puis 0,05 $ par heure et par conteneur. Elle est gratuite lorsque la même requête inclut une recherche web ou une récupération web avec la version d’outil
20260209ou ultérieure. - Agents gérés Claude : exécution de session à 0,08 $ par heure de session, en plus des frais habituels liés aux tokens.
- Récupération web : aucun coût supplémentaire, uniquement le coût en tokens du contenu récupéré.
La mémoire n’apparaît sur aucune de ces lignes. Elle est incluse dans le nombre de tokens d’entrée, qui est précisément l’endroit où vous pouvez la mesurer et où l’élagage et la mise en cache peuvent la réduire. Si vous budgétez un agent qui s’exécute sans supervision sur un serveur privé virtuel (VPS), les contrôles de coûts d’un agent IA sur un VPS sont la prochaine mesure à mettre en place. Sans élagage, un agent dont le fichier de mémoire s’agrandit devient plus coûteux chaque semaine, sans qu’aucun indicateur ne le signale.
FAQ
Les fonctionnalités de mémoire de Claude entraînent-elles des frais supplémentaires ?
Non. La grille tarifaire d’Anthropic indique des tarifs par million de tokens d’entrée, par million de tokens de sortie et pour les multiples de prompt caching, sans ligne dédiée à la mémoire. Dans l’API Claude, l’outil de mémoire est côté client : les fichiers sont donc stockés sur une infrastructure que vous payez déjà. La mémoire ajoute des tokens d’entrée, facturés au tarif normal du modèle pour chaque tour qui les inclut.
Désactiver la mémoire rend-il Claude moins cher ?
Cela réduit le nombre de tokens de chaque requête, donc le coût de chaque requête. L’économie globale dépend de ce qui se passe ensuite. Si Claude doit relire trois fichiers et vous poser deux questions pour reconstituer les informations déjà présentes dans la mémoire, ces tokens coûtent plus cher que la mémoire elle-même. Mesurez la différence au lieu de l’estimer : exécutez /context dans une session où la mémoire automatique est activée, puis dans une session démarrée avec CLAUDE_CODE_DISABLE_AUTO_MEMORY=1, et comparez le nombre total de tokens utilisés pour la même tâche.
Pourquoi ma consommation a-t-elle augmenté alors que je n’ai rien modifié ?
La cause la plus fréquente est un cache miss après une pause. Les entrées du cache restent disponibles pendant 5 minutes par défaut, ou pendant une heure avec le paramètre étendu. La première requête après une interruption retraite donc tout votre préfixe au tarif de base des tokens d’entrée, puis l’écrit à nouveau. La deuxième cause la plus fréquente est une modification du préfixe : modifier une définition d’outil invalide tout le cache, tandis que modifier le system prompt invalide le cache du système et des messages. Dans un abonnement, la rubrique /usage indique ce comportement lorsqu’il représente au moins 10 pour cent de la consommation récente.
La mémoire doit-elle se trouver dans le system prompt ou derrière un appel d’outil ?
Placez-la dans le system prompt lorsqu’elle est utilisée à presque chaque tour. Elle reste alors dans le préfixe mis en cache et coûte le tarif de lecture du cache. Placez-la derrière un appel view lorsque seules certaines tâches en ont besoin. Un fichier lu une seule fois coûte alors ses tokens une seule fois, au lieu de les coûter à chaque tour. Le nombre déterminant est votre nombre de relectures, que l’objet usage fournit directement.
Les fonctionnalités de mémoire sont-elles décomptées des limites d’utilisation de l’abonnement ?
Oui, indirectement, car les limites d’un abonnement dépendent des tokens transportés par chaque requête. La documentation d’aide d’Anthropic indique que les conversations plus longues qui déclenchent la gestion automatique du contexte consomment davantage votre limite d’utilisation. La mémoire allonge légèrement chaque requête, et une session longue répète cette longueur à chaque tour. Comment fonctionnent réellement les limites d’utilisation de Claude explique ce qui est réinitialisé et à quel moment.