---
title: Tool-Referenz
url: https://platform.claude.com/docs/de/agents-and-tools/tool-use/tool-reference
description: 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](https://platform.claude.com/docs/de/agents-and-tools/tool-use/overview). Anleitungen zur Implementierung der Tool-Nutzung in deiner Anwendung findest du unter [Tools definieren](https://platform.claude.com/docs/de/agents-and-tools/tool-use/define-tools).

## 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](https://platform.claude.com/docs/de/api/beta-headers) |
| ----- | ----- | ----- | ----- |
| [Web-Search-Tool](https://platform.claude.com/docs/de/agents-and-tools/tool-use/web-search-tool) | `web_search_20260318`<br />`web_search_20260209`<br />`web_search_20250305` | Server | Keiner |
| [Web-Fetch-Tool](https://platform.claude.com/docs/de/agents-and-tools/tool-use/web-fetch-tool) | `web_fetch_20260318`<br />`web_fetch_20260309`<br />`web_fetch_20260209`<br />`web_fetch_20250910` | Server | Keiner |
| [Code-Execution-Tool](https://platform.claude.com/docs/de/agents-and-tools/tool-use/code-execution-tool) | `code_execution_20260521`<br />`code_execution_20260120`<br />`code_execution_20250825` | Server | Keiner |
| [Advisor-Tool](https://platform.claude.com/docs/de/agents-and-tools/tool-use/advisor-tool) | `advisor_20260301` | Server | `advisor-tool-2026-03-01` |
| [Tool-Search-Tool](https://platform.claude.com/docs/de/agents-and-tools/tool-use/tool-search-tool) | `tool_search_tool_regex_20251119`<br />`tool_search_tool_bm25_20251119` | Server | Keiner |
| [MCP-Connector](https://platform.claude.com/docs/de/agents-and-tools/mcp-connector) | `mcp_toolset` | Server | `mcp-client-2025-11-20` |
| [Memory-Tool](https://platform.claude.com/docs/de/agents-and-tools/tool-use/memory-tool) | `memory_20250818` | Client | Keiner |
| [Bash-Tool](https://platform.claude.com/docs/de/agents-and-tools/tool-use/bash-tool) | `bash_20250124` | Client | Keiner |
| [Text-Editor-Tool](https://platform.claude.com/docs/de/agents-and-tools/tool-use/text-editor-tool) | `text_editor_20250728`<br />`text_editor_20250124` | Client | Keiner |
| [Computer-Use-Tool](https://platform.claude.com/docs/de/agents-and-tools/tool-use/computer-use-tool) | `computer_toolset_20260801`<br />`computer_20251124`<br />`computer_20250124` | Client | Keiner<br />`computer-use-2025-11-24`<br />`computer-use-2025-01-24` |
| [Browser-Use-Tool](https://platform.claude.com/docs/de/agents-and-tools/tool-use/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](https://platform.claude.com/docs/de/models/overview#using-the-models-api).

<Note>
  Die `type`-Werte der Tool-Suche akzeptieren auch undatierte Aliase: `tool_search_tool_regex` und `tool_search_tool_bm25`. Diese werden auf die neueste datierte Version aufgelöst.
</Note>

### 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](https://platform.claude.com/docs/de/agents-and-tools/tool-use/programmatic-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](https://platform.claude.com/docs/de/agents-and-tools/tool-use/computer-use-tool#earlier-tool-versions) aufgeführten Modellen verfügbar sind. `browser_toolset_20260801` ist die erste Version des Browser-Use-Tools. Beide sind [Client-Toolsets](https://platform.claude.com/docs/de/agents-and-tools/tool-use/tool-reference#client-toolsets).

Der Typ `mcp_toolset` ist nicht datumsversioniert; die Versionierung erfolgt stattdessen über den `anthropic-beta`-Header.

### Client-Toolsets

Das [Computer-Use-Tool](https://platform.claude.com/docs/de/agents-and-tools/tool-use/computer-use-tool) und das [Browser-Use-Tool](https://platform.claude.com/docs/de/agents-and-tools/tool-use/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](https://platform.claude.com/docs/de/managed-agents/tools) verfügbar, das sein eigenes integriertes Agent-Toolset, MCP-Toolsets und benutzerdefinierte Tools bereitstellt.

```json
{
  "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](https://platform.claude.com/docs/de/agents-and-tools/tool-use/tool-search-tool#deferred-tool-loading) wird das Toolset als eine Definition geladen und erweitert. Wenn alle aktivierten Member verzögert geladen werden, kann nur ein [Tool-Such-Tool](https://platform.claude.com/docs/de/agents-and-tools/tool-use/tool-search-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](https://platform.claude.com/docs/de/agents-and-tools/tool-use/tool-use-with-prompt-caching#cache-control-on-tool-definitions).

**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](https://platform.claude.com/docs/de/agents-and-tools/tool-use/computer-use-tool#batch-actions), [Browser Use](https://platform.claude.com/docs/de/agents-and-tools/tool-use/browser-use-tool#batch-actions)). 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](https://platform.claude.com/docs/de/agents-and-tools/tool-use/programmatic-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.

| 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](https://platform.claude.com/docs/de/build-with-claude/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](https://platform.claude.com/docs/de/agents-and-tools/tool-use/strict-tool-use) |
| `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](https://platform.claude.com/docs/de/agents-and-tools/mcp-connector#mcp-toolset-configuration)). Bei den Computer-Use- und Browser-Use-Toolsets pro Member innerhalb von `configs` setzen; siehe [Client-Toolsets](https://platform.claude.com/docs/de/agents-and-tools/tool-use/tool-reference#client-toolsets). | [Tool-Such-Tool](https://platform.claude.com/docs/de/agents-and-tools/tool-use/tool-search-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](https://platform.claude.com/docs/de/agents-and-tools/tool-use/tool-reference#client-toolsets)) | [Programmatisches Tool-Calling](https://platform.claude.com/docs/de/agents-and-tools/tool-use/programmatic-tool-calling#the-allowed-callers-field) |
| `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](https://platform.claude.com/docs/de/agents-and-tools/tool-use/define-tools#providing-tool-use-examples) |
| `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](https://platform.claude.com/docs/de/agents-and-tools/tool-use/fine-grained-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](https://platform.claude.com/docs/de/agents-and-tools/tool-use/programmatic-tool-calling#the-allowed-callers-field) 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](https://platform.claude.com/docs/de/agents-and-tools/tool-use/tool-use-with-prompt-caching#defer-loading-and-cache-preservation).
