Tool-Nutzung mit Claude
Claude ist in der Lage, mit Tools und Funktionen zu interagieren, wodurch Sie Claudes Fähigkeiten erweitern können, um eine breitere Palette von Aufgaben zu erfüllen.
Hier ist ein Beispiel, wie Sie Claude Tools über die Messages API zur Verfügung stellen können:
Wie Tool-Nutzung funktioniert
Claude unterstützt zwei Arten von Tools:
-
Client-Tools: Tools, die auf Ihren Systemen ausgeführt werden, dazu gehören:
- Benutzerdefinierte Tools, die Sie erstellen und implementieren
- Von Anthropic definierte Tools wie Computer-Nutzung und Text-Editor, die eine Client-Implementierung erfordern
-
Server-Tools: Tools, die auf Anthropics Servern ausgeführt werden, wie das Web-Suche Tool. Diese Tools müssen in der API-Anfrage spezifiziert werden, erfordern aber keine Implementierung Ihrerseits.
Von Anthropic definierte Tools verwenden versionierte Typen (z.B. web_search_20250305
, text_editor_20250124
), um die Kompatibilität zwischen Modellversionen zu gewährleisten.
Client-Tools
Integrieren Sie Client-Tools mit Claude in diesen Schritten:
Stellen Sie Claude Tools und eine Benutzeraufforderung zur Verfügung
- Definieren Sie Client-Tools mit Namen, Beschreibungen und Eingabeschemata in Ihrer API-Anfrage.
- Fügen Sie eine Benutzeraufforderung hinzu, die diese Tools benötigen könnte, z.B. “Wie ist das Wetter in San Francisco?”
Claude entscheidet, ein Tool zu verwenden
- Claude bewertet, ob Tools bei der Benutzeranfrage helfen können.
- Falls ja, erstellt Claude eine ordnungsgemäß formatierte Tool-Nutzungsanfrage.
- Bei Client-Tools hat die API-Antwort einen
stop_reason
vontool_use
, der Claudes Absicht signalisiert.
Führen Sie das Tool aus und geben Sie Ergebnisse zurück
- Extrahieren Sie den Tool-Namen und die Eingabe aus Claudes Anfrage
- Führen Sie den Tool-Code auf Ihrem System aus
- Geben Sie die Ergebnisse in einer neuen
user
-Nachricht zurück, die einentool_result
-Inhaltsblock enthält
Claude verwendet das Tool-Ergebnis, um eine Antwort zu formulieren
- Claude analysiert die Tool-Ergebnisse, um seine endgültige Antwort auf die ursprüngliche Benutzeraufforderung zu erstellen.
Hinweis: Die Schritte 3 und 4 sind optional. Für einige Workflows könnte Claudes Tool-Nutzungsanfrage (Schritt 2) alles sein, was Sie brauchen, ohne Ergebnisse an Claude zurückzusenden.
Server-Tools
Server-Tools folgen einem anderen Workflow:
Stellen Sie Claude Tools und eine Benutzeraufforderung zur Verfügung
- Server-Tools, wie Web-Suche, haben ihre eigenen Parameter.
- Fügen Sie eine Benutzeraufforderung hinzu, die diese Tools benötigen könnte, z.B. “Suche nach den neuesten Nachrichten über KI.”
Claude führt das Server-Tool aus
- Claude bewertet, ob ein Server-Tool bei der Benutzeranfrage helfen kann.
- Falls ja, führt Claude das Tool aus, und die Ergebnisse werden automatisch in Claudes Antwort eingebaut.
Claude verwendet das Server-Tool-Ergebnis, um eine Antwort zu formulieren
- Claude analysiert die Server-Tool-Ergebnisse, um seine endgültige Antwort auf die ursprüngliche Benutzeraufforderung zu erstellen.
- Keine zusätzliche Benutzerinteraktion ist für die Server-Tool-Ausführung erforderlich.
Tool-Nutzungsbeispiele
Hier sind einige Code-Beispiele, die verschiedene Tool-Nutzungsmuster und -techniken demonstrieren. Der Kürze halber sind die Tools einfache Tools, und die Tool-Beschreibungen sind kürzer als ideal wäre, um die beste Leistung zu gewährleisten.
Preisgestaltung
Tool use requests are priced based on:
- The total number of input tokens sent to the model (including in the
tools
parameter) - The number of output tokens generated
- For server-side tools, additional usage-based pricing (e.g., web search charges per search performed)
Client-side tools are priced the same as any other Claude API request, while server-side tools may incur additional charges based on their specific usage.
The additional tokens from tool use come from:
- The
tools
parameter in API requests (tool names, descriptions, and schemas) tool_use
content blocks in API requests and responsestool_result
content blocks in API requests
When you use tools
, we also automatically include a special system prompt for the model which enables tool use. The number of tool use tokens required for each model are listed below (excluding the additional tokens listed above). Note that the table assumes at least 1 tool is provided. If no tools
are provided, then a tool choice of none
uses 0 additional system prompt tokens.
Model | Tool choice | Tool use system prompt token count |
---|---|---|
Claude Opus 4 | auto , none any , tool | 346 tokens 313 tokens |
Claude Sonnet 4 | auto , none any , tool | 346 tokens 313 tokens |
Claude Sonnet 3.7 | auto , none any , tool | 346 tokens 313 tokens |
Claude Sonnet 3.5 (Oct) | auto , none any , tool | 346 tokens 313 tokens |
Claude Sonnet 3.5 (June) | auto , none any , tool | 294 tokens 261 tokens |
Claude Haiku 3.5 | auto , none any , tool | 264 tokens 340 tokens |
Claude Opus 3 | auto , none any , tool | 530 tokens 281 tokens |
Claude Sonnet 3 | auto , none any , tool | 159 tokens 235 tokens |
Claude Haiku 3 | auto , none any , tool | 264 tokens 340 tokens |
These token counts are added to your normal input and output tokens to calculate the total cost of a request.
Siehe unsere Modellübersichtstabelle für aktuelle Preise pro Modell.
Wenn Sie eine Tool-Nutzungsaufforderung senden, gibt die Antwort, genau wie bei jeder anderen API-Anfrage, sowohl Eingabe- als auch Ausgabe-Token-Anzahlen als Teil der gemeldeten usage
-Metriken aus.
Nächste Schritte
Erkunden Sie unser Repository mit sofort implementierbaren Tool-Nutzungs-Code-Beispielen in unseren Kochbüchern:
Rechner-Tool
Lernen Sie, wie Sie ein einfaches Rechner-Tool mit Claude für präzise numerische Berechnungen integrieren.
Kundenservice-Agent
Erstellen Sie einen reaktionsschnellen Kundenservice-Bot, der Client-Tools nutzt, um den Support zu verbessern.
JSON-Extraktor
Sehen Sie, wie Claude und Tool-Nutzung strukturierte Daten aus unstrukturiertem Text extrahieren können.