--- title: Tool-Nutzung mit Prompt-Caching url: https://platform.claude.com/docs/de/agents-and-tools/tool-use/tool-use-with-prompt-caching description: Cache Tool-Definitionen über mehrere Turns hinweg und verstehe, was deinen Cache invalidiert. --- Diese Seite behandelt „prompt caching“ (Prompt-Caching) für Tool-Definitionen: wo du `cache_control`-Breakpoints platzierst, wie `defer_loading` deinen Cache erhält und was ihn invalidiert. Für allgemeines Prompt-Caching siehe [Prompt-Caching](https://platform.claude.com/docs/de/build-with-claude/prompt-caching). ## cache\_control auf Tool-Definitionen Platziere `cache_control: {"type": "ephemeral"}` auf dem letzten Tool in deinem `tools`-Array. Dadurch wird das gesamte Präfix der Tool-Definitionen gecacht, vom ersten Tool bis zum markierten Breakpoint: ```json { "tools": [ { "name": "get_weather", "description": "Get the current weather in a given location", "input_schema": { "type": "object", "properties": { "location": { "type": "string" } }, "required": ["location"] } }, { "name": "get_time", "description": "Get the current time in a given time zone", "input_schema": { "type": "object", "properties": { "timezone": { "type": "string" } }, "required": ["timezone"] }, "cache_control": { "type": "ephemeral" } } ] } ``` Bei `mcp_toolset` landet der `cache_control`-Breakpoint auf dem letzten Tool im Set. Du kontrollierst die Tool-Reihenfolge innerhalb eines MCP-Toolsets nicht, platziere den Breakpoint daher auf dem `mcp_toolset`-Eintrag selbst, und die API wendet ihn auf das letzte expandierte Tool an. Die Toolset-Einträge für [Computer Use](https://platform.claude.com/docs/de/agents-and-tools/tool-use/computer-use-tool) und [Browser Use](https://platform.claude.com/docs/de/agents-and-tools/tool-use/browser-use-tool) folgen derselben Regel: Platziere `cache_control` auf dem Toolset-Eintrag selbst, und der Breakpoint landet nach der Definition des Toolsets. Innerhalb des `configs`-Eintrags eines Mitglieds wird es nicht akzeptiert, da die Mitglieder des Toolsets als eine einzige Definition geladen werden. Innerhalb einer [Batch-Aktion](https://platform.claude.com/docs/de/agents-and-tools/tool-use/computer-use-tool#batch-actions) wird ein `cache_control`-Marker auf einem beliebigen der `tool_use`- oder `tool_result`-Blöcke der Mitglieder des Turns akzeptiert und wirkt am Ende dieses Batches, sodass mehrere Marker in einem Batch als ein einziger Breakpoint fungieren. Jeder Marker zählt dennoch zum Limit der Anfrage von [vier Breakpoints](https://platform.claude.com/docs/de/build-with-claude/prompt-caching#when-to-use-multiple-breakpoints), verwende also einen pro Turn. ## defer\_loading und Cache-Erhaltung Verzögert geladene Tools sind nicht im System-Prompt-Präfix enthalten. Wenn das Modell ein verzögert geladenes Tool über die [Tool-Suche](https://platform.claude.com/docs/de/agents-and-tools/tool-use/tool-search-tool) entdeckt, wird die Definition inline als `tool_reference`-Block an den Gesprächsverlauf angehängt. Das Präfix bleibt unberührt, sodass das Prompt-Caching erhalten bleibt. Das bedeutet, dass das dynamische Hinzufügen von Tools über die Tool-Suche deinen Cache nicht bricht. Du kannst ein Gespräch mit einem kleinen Satz immer geladener Tools (gecacht) beginnen, das Modell bei Bedarf zusätzliche Tools entdecken lassen und über jeden Turn hinweg denselben Cache-Treffer beibehalten. `defer_loading` wirkt außerdem unabhängig von der Grammatikkonstruktion für den [Strict Mode](https://platform.claude.com/docs/de/agents-and-tools/tool-use/strict-tool-use). Die Grammatik wird aus dem vollständigen Toolset aufgebaut, unabhängig davon, welche Tools verzögert geladen werden, sodass sowohl Prompt-Caching als auch Grammatik-Caching erhalten bleiben, wenn Tools dynamisch geladen werden. ## Was deinen Cache invalidiert Der Cache folgt einer Präfix-Hierarchie (`tools` → `system` → `messages`), sodass eine Änderung auf einer Ebene diese Ebene und alles danach invalidiert: | Änderung | Invalidiert | | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Ändern von Tool-Definitionen | Gesamten Cache (tools, system, messages) | | Ein-/Ausschalten von Websuche oder Zitaten | System- und Messages-Caches | | Ändern von `tool_choice` | Messages-Cache | | Ändern von `disable_parallel_tool_use` | Messages-Cache | | Umschalten zwischen vorhandenen/fehlenden Bildern | Messages-Cache | | Ändern von Thinking-Parametern | Messages-Cache immer; Tool- und System-Caches ebenfalls bei Modellen, die die Thinking-Konfiguration vor ihnen rendern ([Details](https://platform.claude.com/docs/de/build-with-claude/thinking#thinking-and-prompt-caching)) | | Ändern von `output_config.effort` | Wie bei Thinking-Parametern; das explizite Setzen des Modellstandards ist gleichbedeutend mit dem Weglassen | Wenn du `tool_choice` mitten im Gespräch variieren musst, erwäge, Cache-Breakpoints vor dem Variationspunkt zu platzieren. ## Server-Tool-Ergebnisse werden automatisch gecacht Wenn in deiner Anfrage Prompt-Caching aktiviert ist und Claude ein [Server-Tool](https://platform.claude.com/docs/de/agents-and-tools/tool-use/server-tools) wie Websuche, Web-Fetch oder Code-Ausführung verwendet, platziert die API automatisch einen Cache-Breakpoint auf dem Server-Tool-Ergebnis, bevor die nächste Iteration der agentischen Schleife ausgeführt wird. Dadurch können spätere Iterationen innerhalb derselben Anfrage das wachsende Präfix aus dem Cache lesen, anstatt es erneut zu verarbeiten. Dieser automatische Breakpoint verwendet immer die Standard-TTL von 5 Minuten, unabhängig von jeder TTL, die du auf deinen eigenen `cache_control`-Markern setzt. In der `usage` der Antwort erscheinen diese Schreibvorgänge unter `cache_creation.ephemeral_5m_input_tokens`, sodass du möglicherweise 5-Minuten-Cache-Schreibvorgänge siehst, selbst wenn jedes von dir gesetzte `cache_control` eine TTL von 1 Stunde verwendet. Dieses Verhalten gilt nur, wenn deine Anfrage bereits mindestens einen `cache_control`-Marker enthält. Anfragen ohne Prompt-Caching erhalten den automatischen Breakpoint nicht. ## Interaktionstabelle pro Tool | Tool | Caching-Überlegungen | | ---------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [Websuche](https://platform.claude.com/docs/de/agents-and-tools/tool-use/web-search-tool) | Aktivieren oder Deaktivieren invalidiert die System- und Messages-Caches | | [Web-Fetch](https://platform.claude.com/docs/de/agents-and-tools/tool-use/web-fetch-tool) | Aktivieren oder Deaktivieren invalidiert die System- und Messages-Caches | | [Code-Ausführung](https://platform.claude.com/docs/de/agents-and-tools/tool-use/code-execution-tool) | Der Container-Zustand ist unabhängig vom Prompt-Cache | | [Tool-Suche](https://platform.claude.com/docs/de/agents-and-tools/tool-use/tool-search-tool) | Entdeckte Tools werden als `tool_reference`-Blöcke geladen, wodurch der Präfix-Cache erhalten bleibt | | [Computer Use](https://platform.claude.com/docs/de/agents-and-tools/tool-use/computer-use-tool) | Das Vorhandensein von Screenshots beeinflusst den Messages-Cache; `cache_control` gehört auf den Toolset-Eintrag (siehe [cache\_control auf Tool-Definitionen](https://platform.claude.com/docs/de/agents-and-tools/tool-use/tool-use-with-prompt-caching#cache-control-on-tool-definitions)) | | [Browser Use](https://platform.claude.com/docs/de/agents-and-tools/tool-use/browser-use-tool) | Das Vorhandensein von Screenshots beeinflusst den Messages-Cache; `cache_control` gehört auf den Toolset-Eintrag (siehe [cache\_control auf Tool-Definitionen](https://platform.claude.com/docs/de/agents-and-tools/tool-use/tool-use-with-prompt-caching#cache-control-on-tool-definitions)) | | [Texteditor](https://platform.claude.com/docs/de/agents-and-tools/tool-use/text-editor-tool) | Standard-Client-Tool, keine besondere Caching-Interaktion | | [Bash](https://platform.claude.com/docs/de/agents-and-tools/tool-use/bash-tool) | Standard-Client-Tool, keine besondere Caching-Interaktion | | [Memory](https://platform.claude.com/docs/de/agents-and-tools/tool-use/memory-tool) | Standard-Client-Tool, keine besondere Caching-Interaktion | ## Nächste Schritte Lerne das vollständige Prompt-Caching-Modell kennen, einschließlich TTLs und Preisen. Lade Tools bei Bedarf, ohne deinen Cache zu brechen. Durchsuche alle verfügbaren Tools und ihre Parameter.