Tool-Nutzung mit Claude

Tool-Nutzung ermöglicht es Claude, Funktionen aufzurufen, die du definierst oder die Anthropic bereitstellt. Claude bestimmt anhand der Anfrage des Nutzers und der Beschreibung des Tools, wann ein Tool aufgerufen werden soll. Anschließend gibt es einen strukturierten Aufruf zurück, den deine Anwendung ausführt (Client-Tools) oder den Anthropic ausführt (Server-Tools).

Hier ist ein minimales Beispiel mit einem Server-Tool, dem Web-Search-Tool, das Anthropic für dich ausführt:

client = anthropic.Anthropic()
response = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    tools=[{"type": "web_search_20260209", "name": "web_search"}],
    messages=[{"role": "user", "content": "What's the latest on the Mars rover?"}],
)
print(response.content)

Claude führt die Suche auf der Infrastruktur von Anthropic aus und gibt die zitierten Ergebnisse in derselben Antwort zurück. Damit Claude eine von dir definierte Funktion aufruft, übergib ein Tool mit einem input_schema und führe dann den Aufruf aus, wenn Claude einen tool_use-Block zurückgibt. Tools definieren und Tool-Aufrufe verarbeiten behandeln diesen Roundtrip.



Wie Tool-Nutzung funktioniert

Tools unterscheiden sich hauptsächlich darin, wo der Code ausgeführt wird. Client-Tools (einschließlich benutzerdefinierter Tools und Tools mit von Anthropic definierten Schemas wie bash und text_editor) laufen in deiner Anwendung. Claude antwortet mit stop_reason: "tool_use" und einem oder mehreren tool_use-Blöcken. Dein Code führt die Operation aus und sendet ein tool_result zurück. Server-Tools (wie web_search, web_fetch, code_execution und tool_search) laufen auf der Infrastruktur von Anthropic: Du siehst die Ergebnisse direkt, ohne die Ausführung selbst zu handhaben – es sei denn, Claude ruft das Tool in derselben Gruppe paralleler Tool-Aufrufe wie eines deiner Client-Tools auf (siehe Stop-Gründe und Fallback).

Das vollständige konzeptionelle Modell einschließlich der agentischen Schleife und wann welcher Ansatz zu wählen ist, findest du unter Wie Tool-Nutzung funktioniert.

Für die Verbindung zu „Model Context Protocol"-Servern (MCP-Servern) siehe den MCP-Connector. Für den Aufbau deines eigenen MCP-Clients siehe den Model Context Protocol-Leitfaden zum Erstellen eines MCP-Clients.



Wann Claude Tools verwendet

Mit dem Standardwert {"type": "auto"} für tool_choice bestimmt Claude bei jedem Turn, ob ein Tool aufgerufen oder direkt geantwortet werden soll. Es ruft ein Tool auf, wenn die Anfrage der beschriebenen Fähigkeit dieses Tools entspricht und die Antwort noch nicht im Kontext vorhanden ist. Es antwortet direkt bei stabilem Wissen, kreativen Aufgaben und konversationellen Turns.

Diese Grenze lässt sich über deinen System-Prompt steuern. Wenn Claude keine Tools aufruft, obwohl du es erwartest, erhöht eine leichte Anweisung wie "Use the tools to investigate before responding." die Tool-Nutzung. Eine stärkere Form wie "Always call a tool first before responding." geht noch weiter. Umgekehrt hält "Use your judgment about whether to call a tool or respond directly." das Auslöseverhalten konservativ.

Um einen Tool-Aufruf zu erzwingen, anstatt dich auf Prompting zu verlassen, setze tool_choice.

Die Seite jedes Server-Tools beschreibt dessen eigene Auslösegrenze ausführlicher.



Ein Tool auswählen

Für type-Strings, Versionen und Beta-Header siehe Tool-Referenz.



Deine eigenen Tools

Für Tools, die du definierst, schreibst du das Schema und deine Anwendung führt jeden Aufruf aus.



Client-Tools mit Anthropic-Schema

Anthropic veröffentlicht das Schema und trainiert Claude darauf. Deine Anwendung führt dennoch jeden Aufruf aus und gibt das tool_result zurück.



Server-Tools

Server-Tools laufen auf der Infrastruktur von Anthropic, ohne Handler-Code in deiner Anwendung. Siehe Server-Tools für die Mechanismen, die sie gemeinsam haben.



Preise

Anfragen zur Tool-Nutzung werden basierend auf folgenden Faktoren berechnet:

1. Die Gesamtzahl der an das Modell gesendeten Input-Token (einschließlich des tools-Parameters)
2. Die Anzahl der generierten Output-Token
3. Bei serverseitigen Tools zusätzliche nutzungsbasierte Kosten (z. B. Gebühren für die Websuche pro durchgeführter Suche)

Clientseitige Tools werden genauso berechnet wie jede andere Claude-API-Anfrage, während serverseitige Tools je nach ihrer spezifischen Nutzung zusätzliche Kosten verursachen können.

Die zusätzlichen Token aus der Tool-Nutzung stammen aus:

• Dem tools-Parameter in API-Anfragen (Tool-Namen, Beschreibungen und Schemas)
• tool_use-Inhaltsblöcken in API-Anfragen und -Antworten
• tool_result-Inhaltsblöcken in API-Anfragen

Wenn du tools verwendest, fügt die API automatisch einen speziellen System-Prompt für das Modell hinzu, der die Tool-Nutzung ermöglicht. Die Anzahl der für die Tool-Nutzung erforderlichen Token ist für jedes Modell unten aufgeführt (ohne die oben genannten zusätzlichen Token). Beachte, dass die Tabelle davon ausgeht, dass mindestens 1 Tool bereitgestellt wird. Wenn keine tools bereitgestellt werden, verwendet eine Tool-Auswahl von none 0 zusätzliche System-Prompt-Token.

Diese Token-Anzahlen werden zu deinen normalen Input- und Output-Token addiert, um die Gesamtkosten einer Anfrage zu berechnen.

Siehe die Tabelle in der Modellübersicht für aktuelle Preise pro Modell.

Wenn du einen Tool-Nutzungs-Prompt sendest, enthält die Antwort wie bei jeder anderen API-Anfrage sowohl die Anzahl der Input- als auch der Output-Token in den gemeldeten usage-Metriken.

Einige Server-Tools fügen nutzungsbasierte Gebühren zusätzlich zu den Token hinzu: siehe Web-Search-Tool und Code-Execution-Tool für deren Tarife.



Nächste Schritte