Managed AgentsErste Schritte

Claude Managed Agents – Überblick

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 Modell-Prompting	Vorgefertigtes, konfigurierbares Agent-Harness, das in verwalteter Infrastruktur läuft
Am besten geeignet für	Benutzerdefinierte Agent-Loops und feingranulare Kontrolle	Lang laufende Aufgaben und asynchrone Arbeit
Mehr erfahren	Messages API-Dokumentation	Claude Managed Agents-Dokumentation

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, Kompaktierung und weitere Performance-Optimierungen für hochwertige, effiziente Agent-Ausgaben.

Claude Managed Agents ist auch auf Claude Platform on AWS verfügbar, mit einigen Unterschieden bei der Feature-Verfügbarkeit und dem Session-Verhalten. Siehe Claude Managed Agents im Leitfaden zu Claude Platform on AWS.

Schnellstart

Erstelle deine erste Agent-Session

Session starten

Erstelle eine Session und sende dein erstes Event

Referenz

Event-Typen, Ratenlimits, CLI-Flags und weitere Nachschlagetabellen

Kernkonzepte

Claude Managed Agents basiert auf vier Konzepten:

Konzept	Beschreibung
Agent	Das Modell, der System-Prompt, die 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 einer Environment, die eine bestimmte Aufgabe ausführt und Ausgaben generiert
Events	Nachrichten, die zwischen deiner Anwendung und dem Agent ausgetauscht werden (User-Turns, Tool-Ergebnisse, Status-Updates)

So funktioniert es

Agent erstellen
Definiere das Modell, den System-Prompt, die Tools, MCP-Server und Skills. Erstelle den Agenten einmal und referenziere ihn über seine ID in allen Sessions.
Umgebung erstellen
Konfiguriere, wo der Agent läuft: in einer Cloud-Sandbox oder einer selbst gehosteten Sandbox auf deiner eigenen Infrastruktur.
Session starten
Starte eine Session, die deine Agent- und Umgebungskonfiguration referenziert.
Events senden und Antworten streamen
Sende Nutzernachrichten als Events. Claude führt Tools autonom aus und streamt 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 Nutzer-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 Infrastruktur, die du kontrollierst, 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 Konversationsverlauf ü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: Führe Shell-Befehle in der Sandbox aus
Dateioperationen: Lese, schreibe, bearbeite, glob und grep Dateien in der Sandbox
Websuche und -abruf: Durchsuche das Web und rufe Inhalte von URLs ab
MCP-Server: Verbinde dich mit externen Tool-Anbietern

Siehe Tools für die vollständige Liste und Konfigurationsoptionen.

Beta-Zugang

Claude Managed Agents befindet sich derzeit in der Beta. 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:

Einen Claude API-Key
Den Beta-Header managed-agents-2026-04-01 bei 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. Fordere Zugang an, um sie zu aktivieren.

Claude Managed Agents ist von Grund auf zustandsbehaftet konzipiert: Sessions laufen lange, werden nach Pausen sauber fortgesetzt und speichern Konversationsverlauf, Sandbox-Zustand und Ausgaben serverseitig. Aus diesem Grund ist Managed Agents derzeit nicht für Zero Data Retention oder eine HIPAA Business Associate Agreement (BAA)-Abdeckung qualifiziert. Du behältst die Kontrolle über diese Daten: Du kannst Sessions löschen und separat alle Dateien, die du hochgeladen hast, jederzeit über die API löschen. Zur Eignung aller Features siehe API und Datenaufbewahrung.

Siehe Ratenlimits und Branding-Richtlinien in der Referenz.

Was this page helpful?

Managed AgentsErste Schritte

Claude Managed Agents – Überblick

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 Modell-Prompting	Vorgefertigtes, konfigurierbares Agent-Harness, das in verwalteter Infrastruktur läuft
Am besten geeignet für	Benutzerdefinierte Agent-Loops und feingranulare Kontrolle	Lang laufende Aufgaben und asynchrone Arbeit
Mehr erfahren	Messages API-Dokumentation	Claude Managed Agents-Dokumentation

Schnellstart

Erstelle deine erste Agent-Session

Session starten

Erstelle eine Session und sende dein erstes Event

Referenz

Event-Typen, Ratenlimits, CLI-Flags und weitere Nachschlagetabellen

Kernkonzepte

Claude Managed Agents basiert auf vier Konzepten:

Konzept	Beschreibung
Agent	Das Modell, der System-Prompt, die 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 einer Environment, die eine bestimmte Aufgabe ausführt und Ausgaben generiert
Events	Nachrichten, die zwischen deiner Anwendung und dem Agent ausgetauscht werden (User-Turns, Tool-Ergebnisse, Status-Updates)

So funktioniert es

Agent erstellen
Definiere das Modell, den System-Prompt, die Tools, MCP-Server und Skills. Erstelle den Agenten einmal und referenziere ihn über seine ID in allen Sessions.
Umgebung erstellen
Konfiguriere, wo der Agent läuft: in einer Cloud-Sandbox oder einer selbst gehosteten Sandbox auf deiner eigenen Infrastruktur.
Session starten
Starte eine Session, die deine Agent- und Umgebungskonfiguration referenziert.
Events senden und Antworten streamen
Sende Nutzernachrichten als Events. Claude führt Tools autonom aus und streamt 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 Nutzer-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 Infrastruktur, die du kontrollierst, 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 Konversationsverlauf ü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: Führe Shell-Befehle in der Sandbox aus
Dateioperationen: Lese, schreibe, bearbeite, glob und grep Dateien in der Sandbox
Websuche und -abruf: Durchsuche das Web und rufe Inhalte von URLs ab
MCP-Server: Verbinde dich mit externen Tool-Anbietern

Siehe Tools für die vollständige Liste und Konfigurationsoptionen.

Beta-Zugang

Um loszulegen, benötigst du:

Einen Claude API-Key
Den Beta-Header managed-agents-2026-04-01 bei 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. Fordere Zugang an, um sie zu aktivieren.

Siehe Ratenlimits und Branding-Richtlinien in der Referenz.

Was this page helpful?

Kernkonzepte

So funktioniert es

Wann du Claude Managed Agents verwenden solltest

Unterstützte Tools

Beta-Zugang

Kernkonzepte

So funktioniert es

Wann du Claude Managed Agents verwenden solltest

Unterstützte Tools

Beta-Zugang

Kernkonzepte

So funktioniert es

Wann du Claude Managed Agents verwenden solltest

Unterstützte Tools

Beta-Zugang

Kernkonzepte

So funktioniert es

Wann du Claude Managed Agents verwenden solltest

Unterstützte Tools

Beta-Zugang