Claude Platform Docs
MessagesTool-Infrastruktur

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.

TooltypeAusführungBeta-Header
Web-Search-Toolweb_search_20260318
web_search_20260209
web_search_20250305
ServerKeiner
Web-Fetch-Toolweb_fetch_20260318
web_fetch_20260309
web_fetch_20260209
web_fetch_20250910
ServerKeiner
Code-Execution-Toolcode_execution_20260521
code_execution_20260120
code_execution_20250825
ServerKeiner
Advisor-Tooladvisor_20260301Serveradvisor-tool-2026-03-01
Tool-Search-Tooltool_search_tool_regex_20251119
tool_search_tool_bm25_20251119
ServerKeiner
MCP-Connectormcp_toolsetServermcp-client-2025-11-20
Memory-Toolmemory_20250818ClientKeiner
Bash-Toolbash_20250124ClientKeiner
Text-Editor-Tooltext_editor_20250728
text_editor_20250124
ClientKeiner
Computer-Use-Toolcomputer_toolset_20260801
computer_20251124
computer_20250124
ClientKeiner
computer-use-2025-11-24
computer-use-2025-01-24
Browser-Use-Toolbrowser_toolset_20260801ClientKeiner

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_20260209 und web_fetch_20260209 ergänzen ihre Vorgänger um dynamische Inhaltsfilterung; web_fetch_20260309 fügt eine Option zum Umgehen des Caches hinzu; web_search_20260318 und web_fetch_20260318 fügen eine Steuerung für die Einbeziehung in die Antwort hinzu. code_execution_20260120 fügt programmatisches Tool-Calling 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 Funktionalität benötigst.
  • Nach Modell unterschieden: text_editor_20250728 ist für Claude 4 und neuere Modelle gedacht, text_editor_20250124 für ältere Modelle. Welche Version du verwendest, hängt vom Zielmodell ab.
  • Variante, nicht Version: tool_search_tool_regex_20251119 und tool_search_tool_bm25_20251119 sind zwei Suchalgorithmen, die gemeinsam veröffentlicht wurden. Keiner ersetzt den anderen.
  • Veraltet: code_execution_20250522 unterstützt nur Python. code_execution_20250825 fügt Bash und Dateioperationen hinzu.
  • Nachfolger: computer_toolset_20260801 ist der stabile Nachfolger der Beta-Versionen computer_20251124 und computer_20250124, die auf den für sie unter Frühere Tool-Versionen aufgeführten Modellen verfügbar sind. browser_toolset_20260801 ist 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 enabled und defer_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_result zurü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: true oder input_examples.
  • defer_loading auf dem Eintrag oder aktivierte Member mit unterschiedlichen defer_loading-Werten (setze es für jeden Member in configs, 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 der input jedes Mitglieds als ein vollständiges input_json_delta an.
  • Ein tool_choice vom Typ tool, das das Toolset oder ein Mitglied benennt (verwende auto, any oder none).
  • Zwei Einträge desselben Toolsets oder ein anderes Tool, das den Namen dieses Toolsets trägt: ein Tool namens computer neben computer_toolset_20260801 oder ein Tool namens browser neben browser_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.

EigenschaftZweckVerfügbar fürAusführliche Anleitung
cache_controlEinen Prompt-Cache-Breakpoint bei dieser Tool-Definition setzenAlle Tools (bei computer_toolset_20260801 und browser_toolset_20260801 auf dem Toolset-Eintrag selbst setzen, nicht innerhalb der Member-configs)Prompt-Caching
strictSchemavalidierung für Tool-Namen und Eingaben garantierenAlle Tools außer mcp_toolset, computer_toolset_20260801 und browser_toolset_20260801Strikte Tool-Nutzung
defer_loadingDas Tool aus dem anfänglichen System-Prompt ausschließen; es bei Bedarf laden, wenn die Tool-Suche eine tool_reference dafür zurückgibtAlle 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_callersEinschränken, welche Aufrufer das Tool aufrufen könnenAlle Tools außer mcp_toolset (bei computer_toolset_20260801 und browser_toolset_20260801 wird nur ["direct"] akzeptiert; siehe Client-Toolsets)Programmatisches Tool-Calling
input_examplesBeispiel-Eingabeobjekte bereitstellen, um Claude zu zeigen, wie das Tool aufgerufen wirdBenutzerdefinierte 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_streamingFeingranulares Eingabe-Streaming aktivieren (true) oder das standardmäßige gepufferte Streaming beibehalten (false) für dieses ToolNur benutzerdefinierte ToolsFeingranulares Tool-Streaming

allowed_callers-Werte

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

WertBedeutung
"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?