Tool-Nutzung mit Claude

Tool-Nutzung ermöglicht es Claude, Funktionen aufzurufen, die Sie definieren oder die Anthropic bereitstellt. Claude entscheidet basierend auf der Anfrage des Benutzers und der Beschreibung des Tools, wann ein Tool aufgerufen werden soll, und gibt dann einen strukturierten Aufruf zurück, den Ihre Anwendung (Client-Tools) oder Anthropic (Server-Tools) ausführt.

Hier ist das einfachste Beispiel mit einem Server-Tool, bei dem Anthropic die Ausführung übernimmt:

import anthropic

client = anthropic.Anthropic()
response = client.messages.create(
    model="claude-opus-4-7",
    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)

Wie Tool-Nutzung funktioniert

Tools unterscheiden sich hauptsächlich dadurch, wo der Code ausgeführt wird. Client-Tools (einschließlich benutzerdefinierter Tools und Anthropic-Schema-Tools wie bash und text_editor) werden in Ihrer Anwendung ausgeführt: Claude antwortet mit stop_reason: "tool_use" und einem oder mehreren tool_use-Blöcken, Ihr Code führt die Operation aus, und Sie senden ein tool_result zurück. Server-Tools (web_search, code_execution, web_fetch, tool_search) werden auf der Infrastruktur von Anthropic ausgeführt: Sie sehen die Ergebnisse direkt, ohne die Ausführung zu handhaben.

Für das vollständige konzeptionelle Modell einschließlich der agentengesteuerten Schleife und wann Sie jeden Ansatz wählen sollten, siehe Wie Tool-Nutzung funktioniert.

Für die Verbindung mit MCP-Servern siehe den MCP-Connector. Für die Erstellung Ihres eigenen MCP-Clients siehe modelcontextprotocol.io.

Tool-Zugriff ist einer der höchsten Hebel, den Sie einem Agenten geben können. Bei Benchmarks wie LAB-Bench FigQA (wissenschaftliche Figureninterpretation) und SWE-bench (reale Softwareentwicklung) führt das Hinzufügen selbst grundlegender Tools zu überproportionalen Fähigkeitssteigerungen, die oft menschliche Experten-Baselines übertreffen.

Tool-Nutzungsbeispiele

Für eine vollständige praktische Anleitung siehe das Tutorial. Für Referenzbeispiele einzelner Konzepte siehe Tools definieren und Tool-Aufrufe handhaben.

Preisgestaltung

Tool use requests are priced based on:

1. The total number of input tokens sent to the model (including in the tools parameter)
2. The number of output tokens generated
3. 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 responses
• tool_result content blocks in API requests

When you use tools, the API also automatically includes 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.

These token counts are added to your normal input and output tokens to calculate the total cost of a request.

Siehe die Modellübersichtstabelle für aktuelle Preise pro Modell.

Wenn Sie eine Tool-Nutzungs-Eingabeaufforderung senden, gibt die Antwort wie bei jeder anderen API-Anfrage sowohl Eingabe- als auch Ausgabe-Token-Zählungen als Teil der gemeldeten usage-Metriken aus.

Nächste Schritte

Wählen Sie Ihren Weg