Claude API Message Threads ermöglichen es der Messages API, ein kurzlebiges Gespräch auf dem Server zu halten. So sendet jeder Folgebeitrag nur die neuen Nachrichten, statt den gesamten Verlauf erneut zu übertragen. Die Anfang November 2026 als öffentliche Beta angekündigte Funktion verringert bei langen Agentenläufen die Anfragegröße und die Zeit bis zum ersten Token, während Ihre abgerechnete Token-Nutzung genau gleich bleibt.
Wenn Sie einen Programmierassistenten oder eine mehrstufige Tool-Schleife entwickelt haben, kennen Sie das Problem bei Beitrag 40. Jedes Mal, wenn das Modell einen Befehl ausführt oder einen Screenshot untersucht, packt Ihr Client alle bisherigen Prompts, Antworten und Tool-Ergebnisse zusammen und sendet das gesamte Paket erneut über das Netzwerk. Message Threads ist Anthropics Lösung für diesen Engpass bei Übertragung und Validierung – mit einigen strengen Regeln zu Ablauf nach fünf Minuten, prompt caching und Datenaufbewahrung, die Sie vor der Aktivierung bei der Entwicklung berücksichtigen müssen.
Was sind Claude API Message Threads?
Message Threads sind ein serverseitiger Gesprächscache für die Claude Messages API, der in der Beta mit dem Header message-threads-2026-08-12 aktiviert wird. Statt jeden API-Aufruf als Neustart zu behandeln, der Ihren vollständigen Chatverlauf benötigt, hält der Server das Gespräch zwischen den Beiträgen im Speicher. Ihr Client überträgt dadurch nur, was sich seit der letzten Antwort geändert hat.
Laut Anthropics Versionshinweisen und Dokumentation vom 2. November 2026 ist dies von Sitzungsthreads in Claude Managed Agents getrennt. Die Funktion arbeitet direkt mit /v1/messages für jedes Modell in der Beta und ist über die direkte Claude API, Claude Platform on AWS, Claude Models on Google Cloud (von Anthropic verwaltet) und Claude in Microsoft Foundry verfügbar.
Zwischen den Beiträgen hält Anthropic den Thread im Serverspeicher, verschlüsselt mit einem serververwalteten Schlüssel, und schreibt ihn niemals auf einen dauerhaften Datenträger.
Was spart Message Threads – und was nicht?
Message Threads reduziert bei langen Gesprächen die Größe des Netzwerk-Uploads und die Zeit bis zum ersten Token (TTFT), verringert aber weder Ihre abgerechnete Token-Zahl noch ändert es Ihre Ratenlimits.
Wenn eine Agentensitzung auf Hunderttausende Tokens anwächst – häufig, wenn eine Programmierschleife große Dateien liest oder ein Computer-Use-Agent Screenshots hin und her überträgt –, verursacht das erneute Senden und Validieren dieser Nutzlast bei jedem Beitrag eine merkliche Verzögerung, noch bevor das Modell mit der Generierung beginnt. Anthropic zufolge ist Message Threads für die meisten Claude Code Nutzer standardmäßig aktiviert; bei Anfragen mit 500k bis 1M Tokens sinkt die mediane TTFT um etwa 35%.
Ihre Rechnung ändert sich dadurch nicht. Obwohl Ihre HTTP-Anfrage nur die neueste Nutzernachricht oder Tool-Ausgabe enthält, liest Claude bei jedem Beitrag weiterhin das gesamte Gespräch. Es gelten die regulären Token-Preise: Im November 2026 kostet Claude Opus 5.5 laut Preisliste $4 pro Million Eingabetokens ($0.20 im Cache) und $20 pro Million Ausgabetokens, während Sonnet 5.5 $2 für Eingabe ($0.10 im Cache) und $10 für Ausgabe kostet (siehe unseren KI-API-Preisvergleich und unseren Vergleich Claude Opus 5.5 vs. Sonnet 5.5 zur Einordnung dieser Preisstufen).
| Was sich mit Message Threads ändert | Was gleich bleibt |
|---|---|
| Kleinere HTTP-Nutzlasten bei Folgebeiträgen | Tokens des gesamten Gesprächs werden bei jedem Beitrag gelesen und abgerechnet |
| Kürzere Zeit bis zum ersten Token (laut Anthropic ~35% niedrigere mediane TTFT bei Anfragen mit 500k–1M Tokens in Claude Code) | Reguläre API-Token-Preise und bestehende Ratenlimits |
system und tools werden einmal beim Erstellen des Threads gesendet |
Ihre App bleibt die maßgebliche Quelle für den Nachrichtenverlauf |
Wie erstellen und führen Sie einen Thread fort?
Sie beginnen einen Thread mit einer normalen /v1/messages-Anfrage samt "thread": {"type": "create"} und dem Beta-Header message-threads-2026-08-12. Beim nächsten Beitrag führen Sie ihn fort, indem Sie die Antwort-id als previous_message_id übergeben. Wenn Sie Anthropics SDKs nutzen, verwaltet der Helfer client.beta.messages.thread(...) das Erstellen und Fortführen und fügt den Beta-Header automatisch hinzu.
Beim ersten create-Aufruf senden Sie Ihr gesamtes Gespräch bis zu diesem Zeitpunkt zusammen mit system und tools:
{
"model": "claude-sonnet-5-5",
"max_tokens": 2048,
"system": "You are a careful repository refactoring assistant.",
"tools": [
{
"name": "run_tests",
"description": "Run the project test suite",
"input_schema": { "type": "object", "properties": {} }
}
],
"thread": {
"type": "create"
},
"messages": [
{ "role": "user", "content": "Check why the auth test is failing." }
]
}
Die API gibt eine normale Nachricht mit einer id zurück (zum Beispiel msg_01XYZ...), die das gespeicherte Gespräch einschließlich Claudes Antwort repräsentiert. Beim nächsten Beitrag senden Sie nur die neuen Nachrichten – etwa ein tool_result oder den nächsten Nutzerprompt – und verweisen auf diese id:
{
"model": "claude-sonnet-5-5",
"max_tokens": 2048,
"thread": {
"type": "continue",
"previous_message_id": "msg_01XYZ..."
},
"messages": [
{
"role": "user",
"content": [
{
"type": "tool_result",
"tool_use_id": "toolu_01ABC...",
"content": "FAIL src/auth.test.ts: expected 200, got 401"
}
]
}
]
}
Regeln, die ohne Blick in die Dokumentation zum Problem werden
Anthropic verlangt während der gesamten Lebensdauer eines Threads strikte Konsistenz:
- Felder nur beim Erstellen: Bei jeder
continue-Anfrage müssen Siesystemundtoolsweglassen. Erneutes Senden führt zu einem400-Fehler. - Feste Felder: Ihre Angaben für
model,tool_choice,thinking,mcp_servers(außer dem Authentifizierungstoken jedes Servers),context_management,output_config, Container-Skills,cache_controlauf oberster Ebene und die genaue Menge deranthropic-beta-Headerwerte müssen dem ursprünglichencreate-Aufruf entsprechen. Jede Änderung löst einen400-Fehlerthread_fingerprint_mismatchaus. - Felder pro Beitrag: Sie können
max_tokens,stop_sequences,stream,metadataundservice_tierweiterhin von Beitrag zu Beitrag ändern. - Verlauf nur zum Anhängen: Jede Antwort-
idkann nur einmal fortgeführt werden, und Sie müssen immer von der neuesten Antwort-idaus fortfahren. Wenn Sie eine frühere Nachricht bearbeiten oder das Gespräch verzweigen müssen, müssen Sie mitcreateeinen neuen Thread beginnen.
Wie lange besteht ein Message Thread?
Ein Message Thread läuft 5 Minuten nach seiner letzten Anfrage ab und wird spätestens 1 Stunde nach seiner letzten Nutzung dauerhaft aus dem Serverspeicher gelöscht. Jede erfolgreich gespeicherte Antwort setzt den 5-Minuten-Timer zurück.
Da Threads als Best-Effort-Cache im flüchtigen Speicher gehalten werden, teilt Ihnen die API-Antwort nie vorab mit, ob ein bestimmter Beitrag erfolgreich gespeichert wurde. Das erfahren Sie erst beim nächsten continue-Aufruf. Ist das 5-Minuten-Fenster abgelaufen oder hat der Server den Thread vorzeitig entfernt, gibt die API einen 404-Fehler zurück.
Wenn Ihr Client einen 404 erhält, ist die Wiederherstellung einfach: Senden Sie den vollständigen Gesprächsverlauf (zusammen mit system und tools) in einer neuen "thread": {"type": "create"}-Anfrage erneut. Ihre Anwendung muss die maßgebliche Quelle bleiben und eine eigene vollständige Kopie jeder Nachricht und jedes Tool-Ergebnisses vorhalten.
Wie arbeiten Message Threads mit prompt caching zusammen?
Message Threads und prompt caching lösen unterschiedliche Teile des Problems langer Kontexte, und prompt caching wird beim Aktivieren von Threads nicht automatisch eingeschaltet. Message Threads verringert die über das Netzwerk hochgeladenen und validierten Bytes; prompt caching senkt Ihre Kosten für wiederholte Eingabetokens (beispielsweise von $2 auf $0.10 pro Million Eingabetokens bei Sonnet 5.5, wie in unserem KI-API-Preisvergleich aufgeschlüsselt).
Wenn Sie sowohl eine schnellere TTFT als auch niedrigere Kosten für Eingabetokens möchten, müssen Sie beides aktivieren. Um jeden Beitrag innerhalb eines Threads zwischenzuspeichern, fügen Sie der ersten create-Anfrage cache_control auf oberster Ebene hinzu und senden dasselbe cache_control auf oberster Ebene bei jeder continue-Anfrage erneut (bedenken Sie, dass cache_control auf oberster Ebene zu den festen Feldern gehört, die im Thread übereinstimmen müssen). Anthropic erlaubt maximal 4 cache_control-Breakpoints, wenn thread gesetzt ist.
Wer sollte Message Threads aktivieren?
Teams mit langfristigen Programmierschleifen, Computer-Use-Workflows oder dokumentenintensiven Agenten mit mehreren Beiträgen profitieren am deutlichsten. Teams mit strengen Compliance-Anforderungen oder Batch-Pipelines müssen möglicherweise darauf verzichten. Wenn Sie noch nicht wissen, wie sich Tool-Schleifen von gewöhnlichen Chatbots unterscheiden, erklärt unser Leitfaden Was ist ein KI-Agent? die Grundlagen.
Wo Message Threads am besten passt:
- Programmieragenten: Schleifen, die Dateien lesen, Compiler ausführen und über Dutzende schnelle Beiträge innerhalb des aktiven 5-Minuten-Fensters iterieren. (Anthropic hat die Funktion für die meisten Claude Code Nutzer bereits standardmäßig aktiviert.)
- Computer-Use-Agenten: Workflows, bei denen jeder Beitrag einen neuen Desktop- oder Browser-Screenshot anhängt; bleiben frühere Screenshots auf dem Server, müssen nicht bei jedem Schritt Megabytes an Base64-Bilddaten erneut hochgeladen werden.
- Dokumenten- und bildintensive Chats: Interaktive Sitzungen, in denen Nutzer große PDFs oder Bildsammlungen hochladen und rasch Folgefragen stellen. Selbst wenn Ihr Agent externe Medienpipelines orchestriert – etwa Skripte erstellt und Renderings in einem Tool wie AI Studio startet –, hält ein serverseitiger Thread mit umfangreichem Planungskontext und Referenzbildern die Koordinationsschleife schnell.
Wo die Funktion im November 2026 blockiert oder nicht unterstützt wird:
- Organisationen mit Zero Data Retention (ZDR) und HIPAA: Message Threads sind nicht für ZDR geeignet, und Organisationen mit aktivierter HIPAA-Bereitschaft können sie nicht nutzen.
- Nicht unterstützte API-Funktionen: Sie können
threadnicht mit Message Batches, Token-Zählanfragen, diethreadenthalten, bedarfsgesteuerter Kompaktierung, den meisten Strategien zur Kontextbearbeitung (außerclear_thinking_20251015mitkeep: "all") oder in Organisationen mit aktivierten Inference Hooks verwenden.
Was ich tatsächlich tun würde
Wenn Sie ein Agenten-Harness auf Basis der Claude Messages API betreiben, würde ich Message Threads überall dort aktivieren, wo eine einzelne Aufgabe regelmäßig 100k Tokens überschreitet und zwischen den Beiträgen weniger als fünf Minuten liegen – sofern Ihre Compliance-Vorgaben dies erlauben. Dieser Rollout-Checkliste würde ich folgen:
- Lassen Sie Ihren lokalen Gesprächsspeicher unverändert. Behandeln Sie serverseitige Threads ausschließlich als Übertragungsbeschleuniger, niemals als Ihre Datenbank. Speichern Sie jeden Nutzerbeitrag, jede Assistentenantwort und jedes Tool-Ergebnis wie bisher lokal.
- Ergänzen Sie
continueum einen automatischen404-Fallback. Wenn eincontinue-Aufruf404zurückgibt (ob nach 5 Minuten Inaktivität oder einer Best-Effort-Entfernung), fangen Sie den Fehler ab und senden Sie sofort den gesamten lokalen Verlauf mit"thread": {"type": "create"},systemundtoolserneut. - Kombinieren Sie es mit
cache_controlauf oberster Ebene. Aktivieren Sie Message Threads nie in der Erwartung einer niedrigeren Rechnung. Setzen Siecache_controlauf oberster Ebene sowohl beicreate- als auch beicontinue-Aufrufen, damit Sie neben der TTFT-Beschleunigung den Rabatt von 90%+ auf zwischengespeicherte Eingaben erhalten. Nutzen Sie unseren KI-API-Preisvergleich, um die Kosten für Eingaben mit und ohne Cache bei 500k Tokens zu berechnen. - Legen Sie Ihre Thread-Konfiguration beim Erstellen fest. Prüfen Sie Ihre Agentenschleife darauf, dass sie
tools,system,thinkingoderanthropic-beta-Header während einer Aufgabe nicht dynamisch verändert, sonst treten400-Fehlerthread_fingerprint_mismatchauf. - Prüfen Sie zuerst die ZDR- und HIPAA-Einstellungen. Wenn Ihr Workspace auf Zero Data Retention oder HIPAA-Bereitschaft angewiesen ist, lassen Sie Message Threads deaktiviert – die Beta ist für beides nicht geeignet.
Häufig gestellte Fragen
Senkt Message Threads meine Claude API Token-Kosten?
Nein. Obwohl jede folgende HTTP-Anfrage nur die neuen Nachrichten enthält, liest Claude bei jedem Beitrag weiterhin den gesamten Gesprächsverlauf. Ihnen werden die vollständigen Ein- und Ausgabetokens zu den regulären Claude-Preisen berechnet, und bestehende Ratenlimits gelten weiterhin. Um Ihre Eingabe-Token-Kosten bei wiederholtem Kontext zu senken, kombinieren Sie Message Threads mit prompt caching.
Brauche ich weiterhin prompt caching, wenn ich Message Threads nutze?
Ja. Message Threads hält das Gespräch lediglich im Serverspeicher, damit Sie frühere Nachrichten nicht erneut über das Netzwerk hochladen und validieren müssen. Es aktiviert prompt caching nicht automatisch. Um für jeden Beitrag Cache-Preise für Eingaben zu erhalten, senden Sie cache_control auf oberster Ebene bei der ersten create-Anfrage und jeder folgenden continue-Anfrage (insgesamt bis zu 4 Breakpoints).
Was passiert nach 5 Minuten Inaktivität?
Ein Message Thread läuft 5 Minuten nach seiner letzten Anfrage ab (und wird spätestens 1 Stunde nach seiner letzten Nutzung aus dem Speicher gelöscht). Senden Sie nach Ablauf des Threads eine continue-Anfrage, gibt die API den Statuscode 404 zurück. Ihr Client sollte diesen 404 abfangen und das gesamte Gespräch mit "thread": {"type": "create"} erneut senden, um einen neuen Thread zu beginnen.
Ist Message Threads auf AWS, Azure und Google Cloud verfügbar?
Ja. Laut Anthropics Versionshinweisen vom 2. November 2026 ist die öffentliche Beta (message-threads-2026-08-12) über die direkte Claude API, Claude Platform on AWS, Claude Models on Google Cloud (von Anthropic verwaltet) und Claude in Microsoft Foundry verfügbar.
Nutzt Claude Code bereits Message Threads?
Ja. Laut Anthropic sind Message Threads für die meisten Claude Code Nutzer standardmäßig aktiviert; bei Anfragen zwischen 500k und 1M Tokens sinkt die mediane Zeit bis zum ersten Token um etwa 35%.
Funktionsdetails zuletzt geprüft am 3. November 2026. Nächste Prüfung: 3. Dezember 2026.
Quellen
- Anthropic, Claude Platform Versionshinweise (2. November 2026), geprüft am 3. November 2026
- Anthropic, Lange Agentenläufe mit Message Threads beschleunigen, geprüft am 3. November 2026
- Anthropic Dokumentation, Message Threads (
message-threads-2026-08-12), geprüft am 3. November 2026 - LoTook, KI-API-Preisvergleich, geprüft am 3. November 2026



