Tool-Referenz
Verzeichnis der von Anthropic bereitgestellten Server-Tools, Client-Tools und Client-Toolsets sowie Referenz für optionale Eigenschaften von Tool-Definitionen.
Diese Seite ist eine Referenz für die Tools, die Anthropic bereitstellt, und die optionalen Eigenschaften, die du für jede Tool-Definition festlegen kannst. Eine konzeptionelle Einführung in die „tool use“ (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.
| Tool | type | Ausführung | Beta-Header |
|---|---|---|---|
| Web-Search-Tool | web_search_20260318web_search_20260209web_search_20250305 | Server | Keiner |
| Web-Fetch-Tool | web_fetch_20260318web_fetch_20260309web_fetch_20260209web_fetch_20250910 | Server | Keiner |
| Code-Execution-Tool | code_execution_20260521code_execution_20260120code_execution_20250825 | Server | Keiner |
| Advisor-Tool | advisor_20260301 | Server | advisor-tool-2026-03-01 |
| Tool-Search-Tool | tool_search_tool_regex_20251119tool_search_tool_bm25_20251119 | Server | Keiner |
| MCP-Connector | mcp_toolset | Server | mcp-client-2025-11-20 |
| Memory-Tool | memory_20250818 | Client | Keiner |
| Bash-Tool | bash_20250124 | Client | Keiner |
| Text-Editor-Tool | text_editor_20250728text_editor_20250124 | Client | Keiner |
| Computer-Use-Tool | computer_toolset_20260801computer_20251124computer_20250124 | Client | Keinercomputer-use-2025-11-24computer-use-2025-01-24 |
| Browser-Use-Tool | browser_toolset_20260801 | Client | Keiner |
Informationen zur Modellkompatibilität findest du auf der Seite des jeweiligen Tools. Die unterstützten Modelle variieren je nach Tool und Tool-Version. Wie du in deinem Code prüfst, ob ein Modell Websuche oder Code-Ausführung akzeptiert, erfährst du unter Die Models API verwenden.
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:
- Nach Funktionalität unterschieden:
web_search_20260209undweb_fetch_20260209ergänzen ihre Vorgänger um dynamische Inhaltsfilterung;web_fetch_20260309fügt eine Option zum Umgehen des Caches hinzu;web_search_20260318undweb_fetch_20260318fügen eine Steuerung für die Einbeziehung in die Antwort hinzu.code_execution_20260120fügt programmatisches Tool-Calling aus der Sandbox heraus hinzu;code_execution_20260521gibt 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 Funktionalität benötigst. - Nach Modell unterschieden:
text_editor_20250728ist für Claude 4 und neuere Modelle gedacht,text_editor_20250124für ältere Modelle. Welche Version du verwendest, hängt vom Zielmodell ab. - Variante, nicht Version:
tool_search_tool_regex_20251119undtool_search_tool_bm25_20251119sind zwei Suchalgorithmen, die gemeinsam veröffentlicht wurden. Keiner ersetzt den anderen. - Veraltet:
code_execution_20250522unterstützt nur Python.code_execution_20250825fügt Bash und Dateioperationen hinzu. - Nachfolger:
computer_toolset_20260801ist der stabile Nachfolger der Beta-Versionencomputer_20251124undcomputer_20250124, die auf den für sie unter Frühere Tool-Versionen aufgeführten Modellen verfügbar sind.browser_toolset_20260801ist die erste Version des Browser-Use-Tools. Beide sind Client-Toolsets.
Der Typ mcp_toolset ist nicht datumsversioniert; die Versionierung erfolgt stattdessen über den anthropic-beta-Header.
Client-Toolsets
Das Computer-Use-Tool und das Browser-Use-Tool sind von Anthropic definierte Client-Toolsets: Ein Eintrag in tools deklariert einen festen Satz von Member-Tools, deren Namen, Beschreibungen und Eingabeschemas Anthropic definiert, und deine Anwendung führt jeden Aufruf aus. Der Eintrag nimmt keinen name entgegen, da der datierte type die Member-Namen festlegt. configs, cache_control und allowed_callers (das nur ["direct"] akzeptiert) sind optional.
Client-Toolsets sind Tools der Messages API. Sie sind derzeit nicht als Agent-Tools in Claude Managed Agents verfügbar, das sein eigenes integriertes Agent-Toolset, MCP-Toolsets und benutzerdefinierte Tools bereitstellt.
{
"type": "browser_toolset_20260801",
"configs": {
"javascript_exec": { "enabled": true }
},
"cache_control": { "type": "ephemeral" }
}configs passt einzelne Mitglieder an:
- Schlüssel sind Mitgliedsnamen, und jeder Wert akzeptiert nur
enabledunddefer_loading. - Ein Mitglied, das du weglässt, behält seine Standardwerte. Ein fehlender Wert,
{}und ein erneut angegebener Standardwert sind gleichwertig. - Ein unbekannter Mitgliedsname oder jedes andere Feld im Wert eines Mitglieds wird abgelehnt, ebenso wie ein
configs, das jedes Mitglied deaktiviert (lass stattdessen den Eintrag weg). - Ein deaktivierter Member wird aus den Tools entfernt, die Claude erhält. Wenn Claude ihn dennoch benennt, gib ein Fehler-
tool_resultzurück.
Setze defer_loading für jeden Member, niemals auf dem Eintrag, und gib jedem aktivierten Member denselben Wert: Bei der Tool-Suche wird das Toolset als eine Definition geladen und erweitert. Wenn alle aktivierten Member verzögert geladen werden, kann nur ein Tool-Such-Tool, das selbst nicht verzögert ist, das Toolset hervorbringen; deklariere daher eines in derselben Anfrage. Setze kein cache_control auf einen Toolset-Eintrag, dessen Member verzögert werden; setze den Breakpoint stattdessen auf ein nicht verzögertes Tool, da verzögerte Definitionen nicht Teil des gecachten Präfixes sind.
cache_control gehört nur auf den Eintrag; um zu erfahren, wo der Breakpoint landet, einschließlich Markierungen innerhalb einer Batch-Aktion, siehe Tool-Nutzung mit Prompt-Caching.
Member-Tool-Aufrufe verarbeiten. Claude ruft einen Member mit einem tool_use-Block auf, dessen name der Member-Name und dessen toolset_name computer oder browser ist; input enthält die Parameter dieses Members und kein action-Feld. Verteile die Aufrufe anhand des Paares aus toolset_name und name, da ein benutzerdefiniertes Tool den Namen eines Members teilen könnte und die beiden Toolsets Namen wie screenshot gemeinsam haben. Nur Member-Ergebnisse geben toolset_name zurück. Mehrere Member-Aufrufe in einem Zug bilden eine Batch-Aktion, die du der Reihe nach ausführst (Computer Use, Browser Use). Neue Member kommen nur mit einem neuen datierten type hinzu.
Auf Toolset-Einträgen nicht unterstützt. Die API lehnt jeden der folgenden Punkte mit einem invalid_request_error ab:
strict: trueoderinput_examples.defer_loadingauf dem Eintrag oder aktivierte Member mit unterschiedlichendefer_loading-Werten (setze es für jeden Member inconfigs, alle auf denselben Wert).- Ein Code-Execution-Aufrufer in
allowed_callers(kein programmatisches Tool-Calling). - Der Beta-Header
fine-grained-tool-streaming-2025-05-14. Wenn du streamst, kommt derinputjedes Mitglieds als ein vollständigesinput_json_deltaan. - Ein
tool_choicevom Typtool, das das Toolset oder ein Mitglied benennt (verwendeauto,anyodernone). - Zwei Einträge desselben Toolsets oder ein anderes Tool, das den Namen dieses Toolsets trägt: ein Tool namens
computernebencomputer_toolset_20260801oder ein Tool namensbrowsernebenbrowser_toolset_20260801. Die beiden Toolsets können gemeinsam deklariert werden.
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. Du kannst diese Eigenschaften kombinieren, mit zwei Ausnahmen: Ein Tool mit defer_loading: true kann nicht zusätzlich cache_control tragen, und ein benutzerdefiniertes Tool mit strict: true kann keinen Code-Execution-Aufrufer in allowed_callers auflisten.
| Eigenschaft | Zweck | Verfügbar für | Ausführliche Anleitung |
|---|---|---|---|
cache_control | Einen Prompt-Cache-Breakpoint bei dieser Tool-Definition setzen | Alle Tools (bei computer_toolset_20260801 und browser_toolset_20260801 auf dem Toolset-Eintrag selbst setzen, nicht innerhalb der Member-configs) | Prompt-Caching |
strict | Schemavalidierung für Tool-Namen und Eingaben garantieren | Alle Tools außer mcp_toolset, computer_toolset_20260801 und browser_toolset_20260801 | Strikte Tool-Nutzung |
defer_loading | Das Tool aus dem anfänglichen System-Prompt ausschließen; es bei Bedarf laden, wenn die Tool-Suche eine tool_reference dafür zurückgibt | Alle Tools (für mcp_toolset siehe MCP-Toolset-Konfiguration). Bei den Computer-Use- und Browser-Use-Toolsets pro Member innerhalb von configs setzen; siehe Client-Toolsets. | Tool-Such-Tool |
allowed_callers | Einschränken, welche Aufrufer das Tool aufrufen können | Alle Tools außer mcp_toolset (bei computer_toolset_20260801 und browser_toolset_20260801 wird nur ["direct"] akzeptiert; siehe Client-Toolsets) | Programmatisches Tool-Calling |
input_examples | Beispiel-Eingabeobjekte bereitstellen, um Claude zu zeigen, wie das Tool aufgerufen wird | Benutzerdefinierte Tools und Client-Tools mit Anthropic-Schema, außer computer_toolset_20260801 und browser_toolset_20260801. Nicht für Server-Tools verfügbar. | Tools definieren |
eager_input_streaming | Feingranulares Eingabe-Streaming aktivieren (true) oder das standardmäßige gepufferte Streaming beibehalten (false) für dieses Tool | Nur benutzerdefinierte Tools | Feingranulares Tool-Streaming |
allowed_callers-Werte
allowed_callers ist ein Array, das jede Kombination der folgenden Werte akzeptiert:
| Wert | Bedeutung |
|---|---|
"direct" | Das Modell kann dieses Tool direkt in einem tool_use-Block aufrufen. Dies ist der Standard, wenn allowed_callers weggelassen wird. |
"code_execution_20260120" | Code, der innerhalb einer code_execution_20260120- oder späteren Sandbox läuft, kann dieses Tool aufrufen. |
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.
Das Weglassen von "direct" aus dem Array (zum Beispiel "allowed_callers": ["code_execution_20260120"]) leitet Claude dazu 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 Programmatisches Tool-Calling für die vollständige Behandlung, einschließlich der Form der caller-Antwort und des Fehlerverhaltens.
defer_loading und Prompt-Caching
defer_loading: true erhält deinen Prompt-Cache: Die Tool-Suche kann ein verzögert geladenes Tool während eines Gesprächs laden, ohne einen bestehenden Cache-Eintrag ungültig zu machen. Setze cache_control-Breakpoints auf nicht verzögerte Tools. Wie verzögert geladene Tools den Cache gültig halten, erfährst du unter defer_loading und Cache-Erhaltung.
War diese Seite hilfreich?