API-Tutorial · 2026-08-22

Tools mitten in der Konversation hinzufügen und entfernen
Ohne den Prompt Cache zu invalidieren

Mit Anthropics Mid-Conversation Tool Changes (Beta) kann Claude bei langen Aufgaben Tool-Sets dynamisch austauschen – veröffentlicht am 24.07. zusammen mit Opus 5, gleichzeitig unterstützt für Opus 4.8 / Fable 5 / Mythos 5.

Aktualisiert 2026-09-19

#mid-conversation-tool-changes#Beta-Header#Prompt Cache#tool_use

Highlights

2026-07-24

Veröffentlichungsdatum

Eine von zwei Betas, die mit Claude Opus 5 erschienen sind – in der offiziellen Ankündigung nachprüfbar.

4

Unterstützte Modelle

Opus 5, Opus 4.8, Fable 5, Mythos 5. Vorerst keine weiteren.

tool_addition

Kernmechanismus (+ Entfernen)

tool_addition-/tool_removal-Blöcke fügen Tools mitten in der Konversation hinzu oder entfernen sie, ohne dass die Sitzung neu gestartet werden muss.

Bleibt warm

Auswirkung auf den Prompt Cache

Das Designziel ist gerade, dass das Hinzufügen/Entfernen von Tools das gecachte Präfix nicht invalidiert – der Schlüssel zu den Kosten bei langen Aufgaben.

Was dieses Feature löst

Der alte Schmerzpunkt von Long-Horizon-Agents: Zum Aufgabenstart hängen Sie 50 Tools an und zahlen dann in jeder Runde Tokens dafür, während sie die Aufmerksamkeit verwässern; oder Sie brauchen auf halber Strecke ein neues Tool und müssen die Sitzung neu starten und verlieren den gesamten Kontext. Mid-Conversation Tool Changes ermöglicht es, Tool-Sets über tool_addition-/tool_removal-Blöcke im laufenden Betrieb zu laden und zu entladen – Kontext und Prompt Cache bleiben erhalten.

Verbreitung im Ökosystem

Der Opus-5-Migrationsleitfaden von OpenRouter und die Dokumentation des Vercel AI SDK behandeln beide die Beta; Agent-Frameworks wie openclaw haben Ende Juli nachgezogen. Bei Relay-Gateway-Setups gibt es eine bekannte Falle: Manche Gateways verwerfen den Beta-Header oder entfernen tool_addition-Blöcke – das Symptom ist: „Das Modell tut so, als sähe es das neue Tool nicht.“ Wenn das bei Ihnen auftritt, prüfen Sie zuerst die Weiterleitungskette.

Zeitleiste

2026-04-07

Eine ähnliche, aber andere Beta: Mid-Conversation System Messages (nicht verwechseln – der Header ist ein anderer).

2026-07-24

Mid-Conversation Tool Changes erscheint mit Opus 5, Header mid-conversation-tool-changes-2026-07-01.

2026-08

Wichtige SDKs und Gateways schließen die Anpassung ab; Probleme bei der Relay-Weiterleitung sind in mehreren GitHub-Issues dokumentiert.

Bestätigt vs. leicht zu verwechseln

Bestätigt

Der Name des Beta-Headers, die vier unterstützten Modelle, der Mechanismus aus tool_addition/tool_removal und die Nicht-Invalidierung des Prompt Cache – alles in der offiziellen Ankündigung und in den Dokumentationen der wichtigsten SDKs nachprüfbar.

Leicht zu verwechseln

Verwechseln Sie dies nicht mit der Beta „Mid-Conversation System“ vom 04-07 (Einfügen von System-Nachrichten mitten in der Konversation): Es sind zwei unabhängige Betas mit unterschiedlichen Headern, die unterschiedliche Probleme lösen. Stellen Sie bei Weiterleitungsketten sicher, dass beide Header durchgereicht werden.

Diese Beta nutzen oder nicht

Gut geeignet

Long-Horizon-Agents, deren Tool-Sets sich je nach Phase ändern und deren Kosten empfindlich auf den Prompt Cache reagieren – typische Fälle: mehrstufige Migrationen, modulweises Refactoring.

Lieber weglassen

Szenarien mit festem Tool-Set und kurzen Sitzungen. Ein weiterer Beta-Header bedeutet eine weitere Schicht an Unsicherheit in der Übertragungskette – drängen Sie ihn nicht auf einfache Aufgaben.

So nutzen Sie es

Fügen Sie den Request-Header anthropic-beta: mid-conversation-tool-changes-2026-07-01 hinzu; mitten im Gespräch hängen Sie neue Tools mit tool_addition-Blöcken an und entladen sie mit tool_removal-Blöcken wieder. Das Modell muss lediglich eines von Opus 5 / 4.8 / Fable 5 / Mythos 5 sein. Wenn Sie über ein Gateway arbeiten, prüfen Sie, dass sowohl der Header als auch die neuen Blöcke weitergeleitet werden.

Bei QCode

Die Claude-Routen von QCode reichen den anthropic-beta-Header durch, und alle vier unterstützten Modelle sind zum offiziellen Preis mal unserem Servicesatz erhältlich. Die Integration ist identisch mit dem direkten Zugriff: derselbe Key, derselbe Endpunkt, der Header wird wie gewohnt mitgesendet.

FAQ

Was ist der Beta-Header?

anthropic-beta: mid-conversation-tool-changes-2026-07-01. Nehmen Sie ihn in den Request-Header auf, um die Funktion zu aktivieren.

Welche Modelle unterstützen die Funktion?

Opus 5, Opus 4.8, Fable 5, Mythos 5. Vorerst keine weiteren Modelle.

Wird dadurch der Prompt-Cache ungültig?

Nein – genau das ist das Designziel der Funktion: Das Hinzufügen oder Entfernen von Tools macht das gecachte Präfix nicht ungültig. Sinkt Ihre Cache-Trefferquote plötzlich, prüfen Sie zuerst, ob ein Relay in der Kette den Request-Body umgeschrieben hat.

Ist das dasselbe wie mid-conversation system?

Nein. Das ist eine eigene Beta vom 04-07 (Einfügen von System-Nachrichten mitten im Gespräch) mit dem Header mid-conversation-system-2026-04-07 und löst ein anderes Problem.

Was tun, wenn das Modell hinter einem Gateway neue Tools nicht sieht?

Ein klassisches Symptom des bekannten Stolpersteins: Manche Gateways verwerfen den Beta-Header oder entfernen tool_addition-Blöcke. Reproduzieren Sie das Problem zuerst mit einem direkten curl und prüfen Sie dann die Weiterleitungskette Hop für Hop.

Lassen sich Beta-Funktionen in der Produktion nutzen?

Offizielle Betas sind in der Regel stabil genug für die Produktion, doch validieren Sie zunächst auf unkritischen Pfaden und beachten Sie im Changelog Hinweise zum Abschluss der Beta-Phase oder zu Breaking Changes.

Quellen

Offizielle Ankündigung von Anthropic (2026-07-24, Claude Opus 5), Opus-5-Migrationsleitfaden von OpenRouter, Dokumentation des Vercel AI SDK, GitHub-Issues von openclaw.

Bei langen Aufgaben beginnt das Sparen beim Cache

QCode reicht den anthropic-beta-Header durch – alle vier unterstützten Modelle sind mit demselben Key aufrufbar.

Erst testen, dann entscheiden

Unsicher bei der Tarifwahl? Beginnen Sie mit Starter ($8.57/Monat) und wechseln Sie auf einen höheren Tarif, wenn Sie zufrieden sind — der ungenutzte Wert des alten Tarifs geht auf Ihr Guthaben zurück.