Tool-Referenz

Diese Seite ist eine Referenz für die von Anthropic bereitgestellten Tools und die optionalen Eigenschaften, die du für jede Tool-Definition festlegen kannst. Für eine konzeptionelle Einführung in die Tool-Nutzung siehe Tool-Nutzung mit Claude. Für Anleitungen zur Implementierung der Tool-Nutzung in deiner Anwendung siehe Tools definieren.



Von Anthropic bereitgestellte Tools

Anthropic stellt zwei Arten von Tools bereit: Server-Tools, die auf der Infrastruktur von Anthropic ausgeführt werden, und Client-Tools, bei denen Anthropic das Schema definiert, deine Anwendung aber die Ausführung übernimmt. Beide Arten erscheinen im tools-Array deiner Anfrage neben allen benutzerdefinierten Tools.

Informationen zur Modellkompatibilität findest du auf der Seite des jeweiligen Tools. Die unterstützten Modelle variieren je nach Tool und Tool-Version.



Tool-Versionierung

Die meisten von Anthropic bereitgestellten Tools tragen ein _YYYYMMDD-Suffix im type-String. Eine neue Version wird veröffentlicht, wenn sich das Verhalten, das Schema oder die Modellunterstützung des Tools ändert. Ältere Versionen bleiben verfügbar, damit bestehende Integrationen weiterhin funktionieren.

Wenn ein Tool mehrere aktive Versionen hat, variiert die Beziehung zwischen ihnen:

• Fähigkeitsbasiert: web_search_20260209 und web_fetch_20260209 fügen gegenüber ihren Vorgängern dynamische Inhaltsfilterung hinzu; web_fetch_20260309 fügt eine Option zur Cache-Umgehung hinzu; web_search_20260318 und web_fetch_20260318 fügen eine Steuerung der Antwort-Einbeziehung hinzu. code_execution_20260120 fügt programmatische Tool-Aufrufe aus der Sandbox heraus hinzu; code_execution_20260521 gibt das Zeitlimit pro Zelle in der Tool-Beschreibung an. In jedem Fall sind sowohl die neue als auch die alte Version aktuell; welche du verwendest, hängt davon ab, ob du die neue Fähigkeit benötigst.
• Modellbasiert: text_editor_20250728 ist für Claude 4 und spätere Modelle und text_editor_20250124 ist für frühere Modelle. Die Version, die du verwendest, hängt vom Modell ab, das du ansprichst.
• Variante, nicht Version: tool_search_tool_regex_20251119 und tool_search_tool_bm25_20251119 sind zwei Suchalgorithmen, die zusammen veröffentlicht wurden. Keiner ersetzt den anderen.
• Legacy: code_execution_20250522 unterstützt nur Python. code_execution_20250825 fügt Bash und Dateioperationen hinzu.

Der Typ mcp_toolset ist nicht datumsversioniert; die Versionierung erfolgt stattdessen über den anthropic-beta-Header.



Eigenschaften von Tool-Definitionen

Jedes Tool im tools-Array, einschließlich benutzerdefinierter Tools, akzeptiert optionale Eigenschaften, die steuern, wie das Tool geladen wird, wer es aufrufen kann und wie seine Eingaben validiert werden. Diese Eigenschaften lassen sich kombinieren: Du kannst defer_loading und cache_control und strict für dasselbe Tool festlegen.



allowed_callers-Werte

allowed_callers ist ein Array, das jede Kombination der folgenden Werte akzeptiert:

Sowohl "code_execution_20260120" als auch "code_execution_20260521" werden in allowed_callers akzeptiert und sind austauschbar: Eine Anfrage, die eine der beiden Code-Ausführungs-Tool-Versionen verwendet, erfüllt Tools, die einen der beiden Aufrufer auflisten. Antwortblöcke kennzeichnen den Aufrufer immer als code_execution_20260120, unabhängig davon, welche Version die Anfrage deklariert hat.

Das Weglassen von "direct" aus dem Array (zum Beispiel "allowed_callers": ["code_execution_20260120"]) leitet Claude an, das Tool nur aus der Code-Ausführung heraus aufzurufen. Der tool_use-Block der Antwort enthält ein caller-Feld, das angibt, welcher Aufrufer das Tool aufgerufen hat. Siehe Programmatische Tool-Aufrufe für die vollständige Behandlung, einschließlich der caller-Antwortstruktur und des Fehlerverhaltens.



defer_loading und Prompt-Caching

Tools mit defer_loading: true werden aus dem gerenderten Tools-Abschnitt entfernt, bevor der Cache-Key berechnet wird. Sie erscheinen überhaupt nicht im System-Prompt-Präfix. Wenn die Tool-Suche ein zurückgestelltes Tool entdeckt und eine tool_reference dafür zurückgibt, wird die vollständige Definition des Tools an dieser Stelle im Konversationsverlauf inline expandiert, nicht im Präfix.

Das bedeutet, dass defer_loading: true deinen Prompt-Cache erhält. Du kannst zurückgestellte Tools zu einer Anfrage hinzufügen, ohne einen bestehenden Cache-Eintrag zu invalidieren, und der Cache bleibt über den Turn, in dem das Tool entdeckt wird, und den Turn, in dem es aufgerufen wird, hinweg gültig.

Wie du defer_loading mit cache_control-Breakpoints kombinierst, erfährst du in der Anleitung zum Prompt-Caching des Tool-Such-Tools.