Skip to Content
ModelleClaudePrompt-Caching

Claude Prompt-Caching

Diese Seite beschreibt, wie Sie Prompt-Caching für Claude aktivieren und Treffer prüfen. Modell-IDs und Endpunktadressen finden Sie im Überblick zur Claude-Reihe.

Kurz gesagtBei Claude muss cache_control explizit gesetzt werden; keiner der beiden Endpunkte cacht automatisch.

Stellen Sie lange, unveränderliche Inhalte (System-Prompt, Dokumente, Tool-Definitionen) an den Anfang der Anfrage und setzen Sie cache_control am letzten festen Inhaltsblock. Folgeanfragen mit exakt identischem Präfix treffen dann den Cache.

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() # Ein längeres, unveränderliches Dokument for question in ["Worum geht es in Kapitel 3?", "Fasse die Kernpunkte des gesamten Textes zusammen."]: message = client.messages.create( model="anthropic/claude-sonnet-4.6", max_tokens=1024, system=[ {"type": "text", "text": "Beantworte die Fragen anhand des folgenden Dokuments."}, {"type": "text", "text": LONG_DOC, "cache_control": {"type": "ephemeral"}}, ], messages=[{"role": "user", "content": question}], ) u = message.usage print("Geschrieben:", u.cache_creation_input_tokens, "Gelesen:", u.cache_read_input_tokens)
PunktBeschreibung
GültigkeitStandardmäßig 5 Minuten, bei jedem Treffer neu gestartet; "cache_control": {"type": "ephemeral", "ttl": "1h"} ergibt 1 Stunde
Treffer prüfen (nativer Endpunkt)Bei der ersten Anfrage ist usage.cache_creation_input_tokens größer als 0; bei einem Treffer ist usage.cache_read_input_tokens größer als 0
Treffer prüfen (OpenAI-kompatibler Endpunkt)Bei einem Treffer ist usage.prompt_tokens_details.cached_tokens größer als 0
MindestlängeZu kurze Inhalte werden nicht gecacht; beide Felder sind dann 0. Die minimale cachebare Länge je Modell finden Sie in der offiziellen Dokumentation von Anthropic 
AbrechnungSchreiben und Lesen werden jeweils zum Preis für Cache-Schreiben bzw. Cache-Lesen abgerechnet; siehe Modellseite 

Allgemeines zum Caching: Prompt-Caching.

Weitere Fehler: Häufige Fehler.

Zuletzt aktualisiert am