--- title: Tools url: https://platform.claude.com/docs/de/managed-agents/tools description: Konfiguriere die Tools, die deinem Agenten zur Verfügung stehen. featureMetadata: topic: title: Managed Agents url: https://platform.claude.com/docs/en/managed-agents/overview status: beta betaHeader: managed-agents-2026-04-01 --- Claude Managed Agents bietet eine Reihe integrierter Tools, die Claude innerhalb einer [Session](https://platform.claude.com/docs/de/managed-agents/sessions) autonom verwenden kann. Du steuerst, welche Tools verfügbar sind, indem du sie in der Agentenkonfiguration angibst. Claude Managed Agents unterstützt außerdem „custom tools" (benutzerdefinierte Tools), also von dir selbst definierte Tools. Deine Anwendung führt diese Tools separat aus und gibt die Ergebnisse an Claude zurück, das sie verwendet, um die Aufgabe fortzusetzen. Um dem Agenten Tools von einem MCP-Server bereitzustellen, verwende stattdessen den [MCP-Connector](https://platform.claude.com/docs/de/managed-agents/mcp-connector). ## Verfügbare Tools Das Agent-Toolset umfasst die folgenden Tools. Alle sind standardmäßig aktiviert, wenn du das Toolset in die Agentenkonfiguration aufnimmst. | Tool | Name | Beschreibung | | ---------- | ------------ | ------------------------------------------------ | | Bash | `bash` | Führt Bash-Befehle in einer Shell-Session aus | | Read | `read` | Liest eine Datei aus dem Sandbox-Dateisystem | | Write | `write` | Schreibt eine Datei in das Sandbox-Dateisystem | | Edit | `edit` | Führt eine String-Ersetzung in einer Datei durch | | Glob | `glob` | Schneller Dateimusterabgleich mit Glob-Mustern | | Grep | `grep` | Textsuche mit Regex-Mustern | | Web fetch | `web_fetch` | Ruft Inhalte von einer URL ab | | Web search | `web_search` | Durchsucht das Web nach Informationen | Wenn eine Tool-Ausgabe 100.000 Zeichen (etwa 25.000 Token) überschreitet, wird sie automatisch in eine Datei in der [Sandbox](https://platform.claude.com/docs/de/managed-agents/environments) geschrieben. Das Modell erhält eine gekürzte Vorschau mit dem Dateipfad und kann den vollständigen Inhalt von dort lesen. ## Das Toolset konfigurieren Aktiviere das vollständige Toolset mit `agent_toolset_20260401`, wenn du einen Agenten erstellst. Verwende das Array `configs` (csharp, go: `Configs`), um bestimmte Tools zu deaktivieren oder ihre Einstellungen zu überschreiben. Jeder Eintrag wird durch seinen `name` (csharp, go: `Name`) identifiziert, der einen Wert aus der Spalte „Name“ in [Verfügbare Tools](https://platform.claude.com/docs/de/managed-agents/tools#available-tools) annimmt. Ein Eintrag akzeptiert außerdem ein optionales Feld `type` (csharp, go: `Type`) mit demselben Wert. Jeder Konfigurationseintrag kann außerdem eine `permission_policy` (java, php: `permissionPolicy`; csharp, go: `PermissionPolicy`) festlegen. Die Richtlinie steuert, ob die Aufrufe des Tools ohne Bestätigung ausgeführt werden, eine Bestätigung erfordern oder vom Server einzeln bewertet werden. Unter [Berechtigungsrichtlinien](https://platform.claude.com/docs/de/managed-agents/permission-policies) findest du die verfügbaren Richtlinientypen. Das folgende Beispiel aktiviert das Toolset und deaktiviert `web_fetch`: ```bash cURL agent=$(curl -fsSL https://api.anthropic.com/v1/agents \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "anthropic-beta: managed-agents-2026-04-01" \ -H "content-type: application/json" \ -d '{ "name": "Coding Assistant", "model": "claude-opus-5-5", "tools": [ { "type": "agent_toolset_20260401", "configs": [ {"name": "web_fetch", "enabled": false} ] } ] }' ) ``` ```bash CLI ant apply agent.md ``` ```markdown --- name: Coding Assistant model: claude-opus-5-5 tools: - type: agent_toolset_20260401 configs: - name: web_fetch enabled: false --- ``` ```python Python agent = client.beta.agents.create( name="Coding Assistant", model="claude-opus-5-5", tools=[ { "type": "agent_toolset_20260401", "configs": [ {"name": "web_fetch", "enabled": False}, ], }, ], ) ``` ```typescript TypeScript const agent = await client.beta.agents.create({ name: "Coding Assistant", model: "claude-opus-5-5", tools: [ { type: "agent_toolset_20260401", configs: [{ name: "web_fetch", enabled: false }] } ] }); ``` ```csharp C# using Anthropic.Models.Beta.Agents; var agent = await client.Beta.Agents.Create(new() { Name = "Coding Assistant", Model = BetaManagedAgentsModel.ClaudeOpus5_5, Tools = [ new BetaManagedAgentsAgentToolset20260401Params { Type = "agent_toolset_20260401", Configs = [ new BetaManagedAgentsWebFetchToolConfigParams { Enabled = false }, ], }, ], }); ``` ```go Go agent, err := client.Beta.Agents.New(ctx, anthropic.BetaAgentNewParams{ Name: "Coding Assistant", Model: anthropic.BetaManagedAgentsModelConfigParams{ ID: anthropic.BetaManagedAgentsModelClaudeOpus5_5, }, Tools: []anthropic.BetaAgentNewParamsToolUnion{{ OfAgentToolset20260401: &anthropic.BetaManagedAgentsAgentToolset20260401Params{ Type: anthropic.BetaManagedAgentsAgentToolset20260401ParamsTypeAgentToolset20260401, Configs: []anthropic.BetaManagedAgentsAgentToolConfigParamsUnion{{ OfWebFetch: &anthropic.BetaManagedAgentsWebFetchToolConfigParams{ Enabled: anthropic.Bool(false), }, }}, }, }}, }) if err != nil { panic(err) } _ = agent ``` ```java Java import com.anthropic.models.beta.agents.*; var agent = client.beta().agents().create(AgentCreateParams.builder() .name("Coding Assistant") .model(BetaManagedAgentsModel.CLAUDE_OPUS_5_5) .addTool(BetaManagedAgentsAgentToolset20260401Params.builder() .type(BetaManagedAgentsAgentToolset20260401Params.Type.AGENT_TOOLSET_20260401) .addConfig(BetaManagedAgentsWebFetchToolConfigParams.builder() .enabled(false) .build()) .build()) .build()); ``` ```php PHP use Anthropic\Beta\Agents\BetaManagedAgentsAgentToolset20260401Params; use Anthropic\Beta\Agents\BetaManagedAgentsWebFetchToolConfigParams; $agent = $client->beta->agents->create( name: 'Coding Assistant', model: 'claude-opus-5-5', tools: [ BetaManagedAgentsAgentToolset20260401Params::with( type: 'agent_toolset_20260401', configs: [ BetaManagedAgentsWebFetchToolConfigParams::with(enabled: false), ], ), ], ); ``` ```ruby Ruby agent = client.beta.agents.create( name: "Coding Assistant", model: "claude-opus-5-5", tools: [ { type: :agent_toolset_20260401, configs: [ {name: :web_fetch, enabled: false} ] } ] ) ``` ### Bestimmte Tools deaktivieren Um ein Tool zu deaktivieren, setze `enabled: false` in seinem `configs`-Eintrag: ```json { "type": "agent_toolset_20260401", "configs": [ { "name": "web_fetch", "enabled": false }, { "name": "web_search", "enabled": false } ] } ``` ### Nur bestimmte Tools aktivieren Das Objekt `default_config` legt die Grundeinstellung für jedes Tool im Set fest, und toolspezifische `configs`-Einträge überschreiben sie. Um mit allen Tools deaktiviert zu beginnen und nur die benötigten zu aktivieren, setze `default_config.enabled` auf `false`: ```json { "type": "agent_toolset_20260401", "default_config": { "enabled": false }, "configs": [ { "name": "bash", "enabled": true }, { "name": "read", "enabled": true }, { "name": "write", "enabled": true } ] } ``` ### Websuche und Web-Fetch einschränken Die Einträge `web_search` und `web_fetch` akzeptieren außerdem Domainlisten, eine Obergrenze für abgerufene Inhalte und einen Suchstandort. Siehe [Domains für Websuche und Web-Fetch einschränken](https://platform.claude.com/docs/de/managed-agents/tools-web-restrictions). ### Typen von Konfigurationseinträgen in den SDKs Die SDKs für Python, TypeScript, Go, Java, C#, Ruby und PHP typisieren jeden `configs` (csharp, go: `Configs`)-Eintrag pro Tool. Der Typ ist eine Union mit einem Member pro integriertem Tool, unterschieden durch `type` (csharp, go: `Type`). In Go, Java, C# und PHP erstellst du Einträge aus typisierten Werten statt aus einfachen Dictionaries oder Hashes. In diesen SDKs ist der Elementtyp von `configs` (csharp, go: `Configs`) die Union selbst, also erstelle jeden Eintrag aus seinem toolspezifischen Member-Typ. Du kannst `type` (csharp, go: `Type`) weglassen, wenn du einen Eintrag erstellst, da der Server ihn aus `name` (csharp, go: `Name`) ableitet. Antworten enthalten ihn immer. Diese Typisierung ändert nicht das JSON, zu dem ein Eintrag serialisiert wird. Eine Anfrage, deren Einträge nur `name`, `enabled` und `permission_policy` setzen, ist mit oder ohne `type` gültig. ## Benutzerdefinierte Tools Benutzerdefinierte Tools entsprechen den [benutzerdefinierten Client-Tools](https://platform.claude.com/docs/de/agents-and-tools/tool-use/how-tool-use-works#user-defined-tools-client-executed) in der Messages API. Du legst fest, welche Operationen verfügbar sind und was sie zurückgeben, und Claude bestimmt, wann und wie sie aufgerufen werden. Claude führt ein benutzerdefiniertes Tool nicht selbst aus. Es gibt eine strukturierte Anfrage aus, dein Code führt die Operation aus, und du gibst das Ergebnis an die Session zurück. Das folgende Beispiel erstellt einen Agenten mit dem integrierten Toolset und einem benutzerdefinierten Tool, `get_weather`: ```bash cURL agent=$(curl -fsSL https://api.anthropic.com/v1/agents \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "anthropic-beta: managed-agents-2026-04-01" \ -H "content-type: application/json" \ -d '{ "name": "Weather Agent", "model": "claude-opus-5-5", "tools": [ { "type": "agent_toolset_20260401" }, { "type": "custom", "name": "get_weather", "description": "Get current weather for a location", "input_schema": { "type": "object", "properties": { "location": {"type": "string", "description": "City name"} }, "required": ["location"] } } ] }' ) ``` ```bash CLI ant apply agent.md ``` ```markdown --- name: Weather Agent model: claude-opus-5-5 tools: - type: agent_toolset_20260401 - type: custom name: get_weather description: Get current weather for a location input_schema: type: object properties: location: type: string description: City name required: - location --- ``` ```python Python agent = client.beta.agents.create( name="Weather Agent", model="claude-opus-5-5", tools=[ { "type": "agent_toolset_20260401", }, { "type": "custom", "name": "get_weather", "description": "Get current weather for a location", "input_schema": { "type": "object", "properties": { "location": {"type": "string", "description": "City name"}, }, "required": ["location"], }, }, ], ) ``` ```typescript TypeScript const agent = await client.beta.agents.create({ name: "Weather Agent", model: "claude-opus-5-5", tools: [ { type: "agent_toolset_20260401" }, { type: "custom", name: "get_weather", description: "Get current weather for a location", input_schema: { type: "object", properties: { location: { type: "string", description: "City name" } }, required: ["location"] } } ] }); ``` ```csharp C# using System.Text.Json; using Anthropic.Models.Beta.Agents; var agent = await client.Beta.Agents.Create(new() { Name = "Weather Agent", Model = BetaManagedAgentsModel.ClaudeOpus5_5, Tools = [ new BetaManagedAgentsAgentToolset20260401Params { Type = "agent_toolset_20260401", }, new BetaManagedAgentsCustomToolParams { Type = "custom", Name = "get_weather", Description = "Get current weather for a location", InputSchema = new() { Properties = new Dictionary { ["location"] = JsonSerializer.SerializeToElement( new { type = "string", description = "City name" } ), }, Required = ["location"], }, }, ], }); ``` ```go Go agent, err := client.Beta.Agents.New(ctx, anthropic.BetaAgentNewParams{ Name: "Weather Agent", Model: anthropic.BetaManagedAgentsModelConfigParams{ ID: anthropic.BetaManagedAgentsModelClaudeOpus5_5, }, Tools: []anthropic.BetaAgentNewParamsToolUnion{{ OfAgentToolset20260401: &anthropic.BetaManagedAgentsAgentToolset20260401Params{ Type: anthropic.BetaManagedAgentsAgentToolset20260401ParamsTypeAgentToolset20260401, }, }, { OfCustom: &anthropic.BetaManagedAgentsCustomToolParams{ Type: anthropic.BetaManagedAgentsCustomToolParamsTypeCustom, Name: "get_weather", Description: "Get current weather for a location", InputSchema: anthropic.BetaManagedAgentsCustomToolInputSchemaParam{ Properties: map[string]any{ "location": map[string]any{ "type": "string", "description": "City name", }, }, Required: []string{"location"}, }, }, }}, }) if err != nil { panic(err) } _ = agent ``` ```java Java import com.anthropic.models.beta.agents.*; import java.util.Map; var agent = client.beta().agents().create(AgentCreateParams.builder() .name("Weather Agent") .model(BetaManagedAgentsModel.CLAUDE_OPUS_5_5) .addTool(BetaManagedAgentsAgentToolset20260401Params.builder() .type(BetaManagedAgentsAgentToolset20260401Params.Type.AGENT_TOOLSET_20260401) .build()) .addTool(BetaManagedAgentsCustomToolParams.builder() .type(BetaManagedAgentsCustomToolParams.Type.CUSTOM) .name("get_weather") .description("Get current weather for a location") .inputSchema(BetaManagedAgentsCustomToolInputSchema.builder() .properties(BetaManagedAgentsCustomToolInputSchema.Properties.builder() .putAdditionalProperty("location", JsonValue.from(Map.of( "type", "string", "description", "City name"))) .build()) .addRequired("location") .build()) .build()) .build()); ``` ```php PHP use Anthropic\Beta\Agents\BetaManagedAgentsAgentToolset20260401Params; use Anthropic\Beta\Agents\BetaManagedAgentsCustomToolInputSchema; use Anthropic\Beta\Agents\BetaManagedAgentsCustomToolParams; $agent = $client->beta->agents->create( name: 'Weather Agent', model: 'claude-opus-5-5', tools: [ BetaManagedAgentsAgentToolset20260401Params::with( type: 'agent_toolset_20260401', ), BetaManagedAgentsCustomToolParams::with( type: 'custom', name: 'get_weather', description: 'Get current weather for a location', inputSchema: BetaManagedAgentsCustomToolInputSchema::with( properties: ['location' => ['type' => 'string', 'description' => 'City name']], required: ['location'], ), ), ], ); ``` ```ruby Ruby agent = client.beta.agents.create( name: "Weather Agent", model: "claude-opus-5-5", tools: [ {type: :agent_toolset_20260401}, { type: :custom, name: "get_weather", description: "Get current weather for a location", input_schema: { type: :object, properties: {location: {type: "string", description: "City name"}}, required: ["location"] } } ] ) ``` Der Name eines benutzerdefinierten Tools darf nicht mit `mcp__` oder `ant__` beginnen oder mit dem Namen eines integrierten Agenten-Tools übereinstimmen. Eine Anfrage, die gegen diese Regel verstößt, gibt einen 400-Fehler zurück. Ein Agent, der bereits ein benutzerdefiniertes Tool hat, dessen Name mit `ant__` beginnt, akzeptiert ein Update nur, wenn das Update `tools` (csharp, go: `Tools`) ohne diesen Namen sendet. Benenne das Tool also in deinem nächsten Update um oder entferne es. Eine neue Session wird mit einem 400-Fehler abgelehnt, wenn sich ein solches Tool auf ihrem Agenten befindet (nach allen [Überschreibungen](https://platform.claude.com/docs/de/managed-agents/sessions#override-agent-configuration-for-a-session)), auf einem Agenten in der `predefined_agents` (java, php: `predefinedAgents`; csharp, go: `PredefinedAgents`)-Liste von `subagents` (csharp, go: `Subagents`) oder auf einem Agenten in der `predefined_agents` (java, php: `predefinedAgents`; csharp, go: `PredefinedAgents`)-Liste von `workflows` (csharp, go: `Workflows`). Bereits bestehende Sessions sind nicht betroffen. Der Agent ruft seine benutzerdefinierten Tools während einer Session auf. Wie du die Aufrufe empfängst und Ergebnisse zurückgibst, erfährst du unter [Session-Event-Stream](https://platform.claude.com/docs/de/managed-agents/events-and-streaming#handling-custom-tool-calls). Für Sessions, die in einer selbst gehosteten Sandbox laufen, kann der Environment-Worker [benutzerdefinierte Tools aus der Sandbox bereitstellen](https://platform.claude.com/docs/de/managed-agents/self-hosted-sandboxes-custom-tools). Dazu können Tools gehören, die einen MCP-Server innerhalb deines Netzwerks kapseln. ### Best Practices für Definitionen benutzerdefinierter Tools * **Stelle äußerst detaillierte Beschreibungen bereit.** Dies ist mit Abstand der wichtigste Faktor für die Tool-Leistung. Je mehr Kontext du Claude über deine Tools gibst, desto besser kann es bestimmen, wann und wie sie verwendet werden. Strebe drei bis vier Sätze pro Tool-Beschreibung an, mehr, wenn das Tool komplex ist. Deine Beschreibungen sollten Folgendes abdecken: * Was das Tool tut * Wann es verwendet werden soll und wann nicht * Was jeder Parameter bedeutet und wie er das Verhalten des Tools beeinflusst * Alle wichtigen Einschränkungen oder Vorbehalte * **Fasse zusammengehörige Operationen in weniger Tools zusammen.** Gruppiere Aktionen wie `create_pr`, `review_pr` und `merge_pr` in einem einzigen Tool mit einem `action`-Parameter. Weniger, dafür leistungsfähigere Tools verringern Mehrdeutigkeiten bei der Auswahl und machen deine Tool-Oberfläche für Claude leichter navigierbar. * **Verwende aussagekräftige Namespaces in Tool-Namen.** Wenn sich deine Tools über mehrere Dienste oder Ressourcen erstrecken, stelle den Namen die Ressource voran (zum Beispiel `db_query` oder `storage_read`). So bleibt die Tool-Auswahl eindeutig, während deine Bibliothek wächst. * **Gestalte Tool-Antworten so, dass sie nur aussagekräftige Informationen zurückgeben.** Gib semantische, stabile Bezeichner zurück (zum Beispiel Slugs oder UUIDs) statt undurchsichtiger interner Referenzen. Füge nur die Felder ein, die Claude benötigt, um seinen nächsten Schritt zu bestimmen. Aufgeblähte Antworten verschwenden Kontext und erschweren es Claude, das Wesentliche herauszufiltern. ## Nächste Schritte Steuere, welche Websites die Web-Tools erreichen können, begrenze abgerufene Inhalte und lokalisiere Suchergebnisse. Verbinde MCP-Server mit deinen Agenten, um auf externe Tools und Datenquellen zuzugreifen. Steuere, wann Agenten- und MCP-Tools ausgeführt werden. Sende Events, streame Antworten und unterbrich oder lenke deine Session während der Ausführung um.