Mise en cache des prompts de Claude
Cette page explique comment activer la mise en cache des prompts pour Claude et vérifier les accès au cache. Les ID de modèle et les adresses d’endpoint figurent dans la présentation de la famille Claude.
L'essentielLe cache de Claude doit être déclaré explicitement avec cache_control : aucun des deux endpoints ne met en cache automatiquement.
Placez le contenu long et fixe (prompt système, documents, définitions d’outils) au début de la requête, et posez cache_control sur le dernier bloc de contenu fixe. Les requêtes suivantes dont le préfixe est strictement identique accèdent au cache.
API native Anthropic
claude_cache.py
import os
import anthropic
client = anthropic.Anthropic(base_url="https://api.ofox.io/anthropic", api_key=os.environ["OFOX_API_KEY"])
LONG_DOC = open("manual.txt", encoding="utf-8").read() # un document fixe assez long
for question in ["De quoi parle le chapitre 3 ?", "Résume les points clés du document."]:
message = client.messages.create(
model="anthropic/claude-sonnet-4.6",
max_tokens=1024,
system=[
{"type": "text", "text": "Réponds aux questions à partir du document ci-dessous."},
{"type": "text", "text": LONG_DOC, "cache_control": {"type": "ephemeral"}},
],
messages=[{"role": "user", "content": question}],
)
u = message.usage
print("Écrit :", u.cache_creation_input_tokens, "Lu :", u.cache_read_input_tokens)Les explications générales sur le cache figurent dans Mise en cache des prompts.
Les autres erreurs sont décrites dans Erreurs courantes.
Dernière mise à jour le