---
title: Überblick über Claude Managed Agents
url: https://platform.claude.com/docs/de/managed-agents/overview
description: Vorgefertigtes, konfigurierbares Agent-Harness, das in verwalteter Infrastruktur läuft. Am besten geeignet für lang laufende Aufgaben und asynchrone Arbeit.
featureMetadata:
topic:
title: Managed Agents
url: https://platform.claude.com/docs/en/managed-agents/overview
status: beta
betaHeader: managed-agents-2026-04-01
---
Anthropic bietet zwei Möglichkeiten, mit Claude zu entwickeln, die jeweils für unterschiedliche Anwendungsfälle geeignet sind:
| | Messages API | Claude Managed Agents |
| -------------------------- | -------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| **Was es ist** | Direkter Zugriff auf das Prompting des Modells | Vorgefertigtes, konfigurierbares Agent-Harness, das in verwalteter Infrastruktur läuft |
| **Am besten geeignet für** | Benutzerdefinierte Agent-Schleifen und feingranulare Kontrolle | Lang laufende Aufgaben und asynchrone Arbeit |
Claude Managed Agents stellt das Harness und die Infrastruktur bereit, um Claude als autonomen Agenten auszuführen. Anstatt deine eigene Agent-Schleife, Tool-Ausführung und Laufzeitumgebung zu bauen, erhältst du eine vollständig verwaltete Umgebung, in der Claude Dateien lesen, Befehle ausführen, im Web browsen und Code sicher ausführen kann. Das Harness unterstützt integriertes „prompt caching“ (Prompt-Caching), Compaction und weitere Performance-Optimierungen für hochwertige, effiziente Agent-Ausgaben. Wenn du stattdessen deine eigene Agent-Schleife mit direktem Modellzugriff bauen möchtest, siehe [Verwendung der Messages API](https://platform.claude.com/docs/de/build-with-claude/working-with-messages).
Claude Managed Agents ist auch auf Claude Platform auf AWS verfügbar, mit einigen Unterschieden bei der Funktionsverfügbarkeit und dem Session-Verhalten. Siehe [Claude Managed Agents](https://platform.claude.com/docs/de/build-with-claude/claude-platform-on-aws#claude-managed-agents) im Leitfaden zu Claude Platform auf AWS.
Erstelle deine erste Agent-Session
Erstelle eine Session und sende dein erstes Event
Event-Typen, Ratenlimits, CLI-Flags und weitere Nachschlagetabellen
## Kernkonzepte
Claude Managed Agents basiert auf vier Konzepten:
| Konzept | Beschreibung |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Agent** | Das Modell, der System-Prompt, Tools, MCP-Server und Skills |
| **Environment** | Konfiguration dafür, wo Sessions ausgeführt werden: eine von Anthropic verwaltete Cloud-Sandbox oder eine selbst gehostete Sandbox auf deiner eigenen Infrastruktur |
| **Session** | Eine laufende Agent-Instanz innerhalb eines Environments, die eine bestimmte Aufgabe ausführt und Ausgaben erzeugt |
| **Events** | Nachrichten, die zwischen deiner Anwendung und dem Agenten ausgetauscht werden (Benutzer-Turns, Tool-Ergebnisse, Statusaktualisierungen) |
## So funktioniert es
Definiere das Modell, den System-Prompt, Tools, MCP-Server und Skills. Erstelle den Agenten einmal und referenziere ihn über Sessions hinweg per ID.
[Konfiguriere, wo der Agent läuft](https://platform.claude.com/docs/de/managed-agents/choosing-an-environment): eine Cloud-Sandbox oder eine [selbst gehostete Sandbox](https://platform.claude.com/docs/de/managed-agents/self-hosted-sandboxes) auf deiner eigenen Infrastruktur.
Starte eine Session, die auf deine Agent- und Umgebungskonfiguration verweist.
Sende Benutzernachrichten als Events. Claude führt autonom Tools aus und streamt die Ergebnisse über „server-sent events“ (vom Server gesendete Ereignisse), oder SSE, zurück. Der Event-Verlauf wird serverseitig gespeichert und kann vollständig abgerufen werden.
Sende zusätzliche Benutzer-Events, um den Agenten während der Ausführung zu lenken, oder unterbrich ihn, um die Richtung zu ändern.
## Wann du Claude Managed Agents verwenden solltest
Claude Managed Agents eignet sich am besten für Workloads, die Folgendes benötigen:
* **Lang laufende Ausführung:** Aufgaben, die über Minuten oder Stunden mit mehreren Tool-Aufrufen laufen
* **Cloud-Infrastruktur:** Sichere Sandboxes mit vorinstallierten Paketen und Netzwerkzugriff
* **Selbst gehostete Ausführung:** Sandboxes auf von dir kontrollierter Infrastruktur für Compliance- oder Datenresidenz-Anforderungen
* **Minimale Infrastruktur:** Keine Notwendigkeit, deine eigene Agent-Schleife, Sandbox oder Tool-Ausführungsschicht zu bauen
* **Zustandsbehaftete Sessions:** Persistente Dateisysteme und Gesprächsverlauf über mehrere Interaktionen hinweg
* **Geplante Ausführung:** Wiederkehrende Agent-Läufe nach einem Cron-Zeitplan über [geplante Deployments](https://platform.claude.com/docs/de/managed-agents/scheduled-deployments)
## Unterstützte Tools
Claude Managed Agents gibt Claude Zugriff auf eine Reihe integrierter Tools:
* **Bash:** Shell-Befehle in der Sandbox ausführen
* **Dateioperationen:** Dateien in der Sandbox lesen, schreiben, bearbeiten sowie mit glob und grep durchsuchen
* **Websuche und Fetch:** Das Web durchsuchen und Inhalte von URLs abrufen, optional eingeschränkt auf eine Allowlist oder Blocklist von Domains
* **MCP-Server:** Verbindung zu externen Tool-Anbietern herstellen
Siehe [Tools](https://platform.claude.com/docs/de/managed-agents/tools) für die vollständige Liste und die Konfigurationsoptionen.
## Beta-Zugang
Claude Managed Agents befindet sich in der Beta-Phase. Alle Managed-Agents-Endpunkte erfordern den Beta-Header `managed-agents-2026-04-01`. Das SDK setzt den Beta-Header automatisch. Verhaltensweisen können zwischen Releases verfeinert werden, um die Ausgaben zu verbessern.
Um loszulegen, benötigst du:
1. Einen [Claude API-Key](https://platform.claude.com/settings/keys)
2. Den Beta-Header `managed-agents-2026-04-01` bei allen Anfragen
3. Zugriff auf Claude Managed Agents (standardmäßig für alle API-Konten aktiviert)
Innerhalb der Beta befinden sich [MCP-Tunnel](https://platform.claude.com/docs/de/agents-and-tools/mcp-tunnels/overview) und [Dreaming](https://platform.claude.com/docs/de/managed-agents/dreams) in einer eingeschränkteren Research Preview. [Beantrage Zugriff](https://claude.com/form/claude-managed-agents), um sie zu aktivieren.
Claude Managed Agents ist von Grund auf zustandsbehaftet: Sessions sind lang laufend, werden nach Pausen sauber fortgesetzt und speichern Gesprächsverlauf, Sandbox-Zustand und Ausgaben serverseitig. Aus diesem Grund kommt Managed Agents derzeit nicht für [Zero Data Retention](https://platform.claude.com/docs/de/manage-claude/api-and-data-retention#zero-data-retention-zdr-scope) oder eine Abdeckung durch ein HIPAA Business Associate Agreement (BAA) in Frage. Du behältst die Kontrolle über diese Daten: Du kannst jederzeit über die API [Sessions löschen](https://platform.claude.com/docs/de/managed-agents/session-operations#deleting-a-session) und separat alle [Dateien](https://platform.claude.com/docs/de/build-with-claude/files#delete-a-file) löschen, die du hochgeladen hast. Zur Berechtigung über alle Funktionen hinweg siehe [API und Datenaufbewahrung](https://platform.claude.com/docs/de/manage-claude/api-and-data-retention#feature-eligibility).
Siehe [Ratenlimits](https://platform.claude.com/docs/de/managed-agents/reference#rate-limits) und [Branding-Richtlinien](https://platform.claude.com/docs/de/managed-agents/reference#branding-guidelines) in der Referenz.