Überblick über Claude Managed Agents
Vorgefertigtes, konfigurierbares Agent-Harness, das in verwalteter Infrastruktur läuft. Am besten geeignet für lang laufende Aufgaben und asynchrone Arbeit.
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.
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
Einen Agenten erstellen
Definiere das Modell, den System-Prompt, Tools, MCP-Server und Skills. Erstelle den Agenten einmal und referenziere ihn über Sessions hinweg per ID.
Eine Umgebung erstellen
Konfiguriere, wo der Agent läuft: in einer Cloud-Sandbox oder in einer selbst gehosteten Sandbox auf deiner eigenen Infrastruktur.
Eine Session starten
Starte eine Session, die auf deine Agent- und Umgebungskonfiguration verweist.
Events senden und Antworten streamen
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.
Steuern oder unterbrechen
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
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 für die vollständige Liste und die Konfigurationsoptionen.
Beta-Zugang
Um loszulegen, benötigst du:
- Einen Claude API-Key
- Den Beta-Header
managed-agents-2026-04-01bei allen Anfragen - Zugriff auf Claude Managed Agents (standardmäßig für alle API-Konten aktiviert)
Innerhalb der Beta befinden sich MCP-Tunnel und Dreaming in einer eingeschränkteren Research Preview. Beantrage Zugriff, 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 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 und separat alle Dateien löschen, die du hochgeladen hast. Zur Berechtigung über alle Funktionen hinweg siehe API und Datenaufbewahrung.
Siehe Ratenlimits und Branding-Richtlinien in der Referenz.
Was this page helpful?