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. Eine konzeptionelle Einführung in die Tool-Nutzung findest du unter Tool-Nutzung mit Claude. Anleitungen zur Implementierung der Tool-Nutzung in deiner Anwendung findest du unter 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 jeweiligen Tool-Seite. 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:

• Funktionsbasiert: web_search_20260209 und web_fetch_20260209 fügen gegenüber ihren Vorgängern dynamische Inhaltsfilterung hinzu; web_fetch_20260309 fügt eine Cache-Bypass-Option hinzu; web_search_20260318 und web_fetch_20260318 fügen eine Steuerung für die Einbeziehung von Antworten 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 Funktion benötigst.
• Modellbasiert: text_editor_20250728 ist für Claude-4-Modelle und text_editor_20250124 für frühere Modelle. Welche Version du verwendest, hängt vom Modell ab, das du ansprichst.
• Variante, keine 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, 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-Execution-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.

Wenn du "direct" aus dem Array weglässt (zum Beispiel "allowed_callers": ["code_execution_20260120"]), wird Claude angeleitet, 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-Schlüssel berechnet wird. Sie erscheinen überhaupt nicht im System-Prompt-Präfix. Wenn die Tool-Suche ein verzögertes Tool entdeckt und eine tool_reference dafür zurückgibt, wird die vollständige Definition des Tools an dieser Stelle inline im Konversationskörper erweitert, nicht im Präfix.

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

Wie du defer_loading mit cache_control-Breakpoints kombinierst, erfährst du in den Hinweisen zum Prompt-Caching beim Tool-Search-Tool.