Erste Schritte mit Claude Managed Agents
Erstelle deinen ersten autonomen Agenten.
Dieser Leitfaden führt dich durch das Erstellen eines Agenten, das Einrichten einer Umgebung, das Starten einer Session und das Streaming von Agentenantworten.
Claude Code
Lass Claude Code deinen Agenten für dich einrichten
/claude-api managed-agents-onboardKernkonzepte
| Konzept | Beschreibung |
|---|---|
| Agent | Das Modell, der System-Prompt, Tools, MCP-Server und Skills |
| Umgebung | 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) |
Bevor du beginnst
Erstelle ein Claude Console-Konto
Registriere dich für ein Claude Console-Konto oder melde dich bei deinem bestehenden Konto an.
Wähle aus, wie du dich authentifizierst
Für die lokale Entwicklung wird die Anmeldung über die CLI empfohlen.
CLIAPI-Schlüssel
Installiere die CLI
brew install anthropics/tap/antFür Linux-Umgebungen lädst du das Release-Binary direkt herunter.
VERSION=2.12.1 OS=$(uname -s | tr '[:upper:]' '[:lower:]') case $(uname -m) in x86_64) ARCH=amd64 ;; aarch64) ARCH=arm64 ;; esac curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \ | sudo tar -xz -C /usr/local/bin antAlle Releases findest du auf der GitHub-Releases-Seite.
Du kannst die CLI auch aus dem Quellcode mit
go installinstallieren, was Go 1.26.10 oder höher erfordert.go install github.com/anthropics/anthropic-cli/v2/cmd/ant@latestgo installlegt die Binärdatei in$(go env GOPATH)/binab. Füge dieses Verzeichnis zu deinemPATHhinzu, falls es dort noch nicht enthalten ist:export PATH="$PATH:$(go env GOPATH)/bin"Melde dich an
ant auth loginSobald die Anmeldung abgeschlossen ist, übernehmen die SDKs und die CLI deine Anmeldedaten automatisch.
Erstelle einen API-Key
Erstelle einen API-Key in der Claude Console.
Setze die Umgebungsvariable
Die SDKs und die CLI lesen deinen Key aus
ANTHROPIC_API_KEY:export ANTHROPIC_API_KEY="your-api-key-here"
Um die CLI-Beispiele auszuführen, installiere die CLI:
brew install anthropics/tap/antFür Linux-Umgebungen lädst du das Release-Binary direkt herunter.
VERSION=2.12.1
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
case $(uname -m) in
x86_64) ARCH=amd64 ;;
aarch64) ARCH=arm64 ;;
esac
curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
| sudo tar -xz -C /usr/local/bin antAlle Releases findest du auf der GitHub-Releases-Seite.
Du kannst die CLI auch aus dem Quellcode mit go install installieren, was Go 1.26.10 oder höher erfordert.
go install github.com/anthropics/anthropic-cli/v2/cmd/ant@latestgo install legt die Binärdatei in $(go env GOPATH)/bin ab. Füge dieses Verzeichnis zu deinem PATH hinzu, falls es dort noch nicht enthalten ist:
export PATH="$PATH:$(go env GOPATH)/bin"Das SDK installieren
pip install anthropicDeine erste Session erstellen
Einen Agenten erstellen
Erstelle einen Agenten, der das Modell, den „system prompt“ (System-Prompt) und die verfügbaren Tools definiert.
CLIant apply coding-assistant.mdcoding-assistant.md--- name: Coding Assistant model: claude-opus-5-5 tools: - type: agent_toolset_20260401 configs: - name: web_search enabled: false - name: web_fetch enabled: false --- You are a helpful coding assistant. Write clean, well-documented code.ant applygibt die ID des Agenten aus und speichert sie inclaude-lock.json. Du wirst sie in jeder Session referenzieren, die du erstellst.Der Tool-Typ
agent_toolset_20260401aktiviert die vorgefertigten Agenten-Tools (Bash, Dateioperationen, Websuche und mehr). Dieses Beispiel deaktiviert Websuche und Web-Fetch, da die Aufgabe in diesem Leitfaden, das Schreiben eines kurzen Python-Skripts, ohne das Web auskommt. Gib einem Agenten nur die Tools, die er benötigt. Unter Tools findest du die vollständige Liste und die Konfigurationsoptionen pro Tool.Eine Umgebung erstellen
Eine Umgebung definiert die Sandbox, in der dein Agent läuft. Diese hier verwendet
limitedNetzwerkzugriff mit erlaubten Paketmanagern, sodass Code, der in der Sandbox läuft, öffentliche Paket-Registries und Code-Hosts erreichen kann. BeilimitedNetworking gilt dieallowed_hosts-Liste auch für Websuche und Web-Fetch, obwohl sie außerhalb der Sandbox laufen. Wenn keine Hosts aufgelistet sind, wie in dieser Umgebung, liefern diese Tools keine Seiten oder Suchergebnisse. Wenn dein eigener Agent diese Tools verwendet, füge die benötigten Hosts zu dieser Liste hinzu.CLIant apply environment.yamlenvironment.yaml# yaml-language-server: $schema=https://platform.claude.com/schemas/ant/beta/environment.json name: quickstart-env config: type: cloud networking: type: limited allow_package_managers: trueant applyspeichert auch die ID der Umgebung inclaude-lock.json. Um den Agenten und die Umgebung mit einem einzigen Befehl zu erstellen, übergib beide Dateien:ant apply coding-assistant.md environment.yaml.Eine Session starten
Erstelle eine Session, die deinen Agenten und deine Umgebung referenziert.
Pythonsession = client.beta.sessions.create( agent=agent.id, environment_id=environment.id, title="Quickstart session", ) print(f"Session ID: {session.id}")Eine Nachricht senden und die Antwort streamen
Öffne einen Stream, sende ein User-Event und verarbeite dann die Events, sobald sie eintreffen:
Pythonwith client.beta.sessions.events.stream(session.id) as stream: # Sende die Benutzernachricht, nachdem der Stream geöffnet wurde client.beta.sessions.events.send( session.id, events=[ { "type": "user.message", "content": [ { "type": "text", "text": "Create a Python script that generates the first 20 Fibonacci numbers and saves them to fibonacci.txt", }, ], }, ], ) # Verarbeite Streaming-Events for event in stream: match event.type: case "agent.message": for block in event.content: if block.type == "text": print(block.text, end="") case "agent.tool_use": print(f"\n[Using tool: {event.name}]") case "session.status_idle": print("\n\nAgent finished.") breakDer Agent schreibt ein Python-Skript, führt es in der Sandbox aus und überprüft, ob die Ausgabedatei erstellt wurde. Deine Ausgabe sieht ungefähr so aus:
I'll create a Python script that generates the first 20 Fibonacci numbers and saves them to a file. [Using tool: write] [Using tool: bash] The script ran successfully. Let me verify the output file. [Using tool: bash] fibonacci.txt contains the first 20 Fibonacci numbers (0 through 4181). Agent finished.
Was passiert
Wenn du ein User-Event sendest, führt Claude Managed Agents Folgendes aus:
- Stellt eine Sandbox bereit: Deine Umgebungskonfiguration bestimmt, wie sie aufgebaut wird.
- Führt die Agentenschleife aus: Claude bestimmt anhand deiner Nachricht, welche Tools verwendet werden.
- Führt Tools aus: Dateischreibvorgänge, Bash-Befehle und andere Tool-Aufrufe laufen innerhalb der Sandbox.
- Streamt Events: Du erhältst Echtzeit-Updates, während der Agent arbeitet.
- Wechselt in den Leerlauf: Der Agent sendet ein
session.status_idle-Event, wenn er nichts mehr zu tun hat.
Eine vollständige App erstellen
Jeder dieser Schnellstarts kombiniert Claude Managed Agents mit einem beliebten Chat-Framework zu einer vollständigen, lauffähigen Anwendung. In jedem davon rendert das Framework die Chat-Oberfläche, während eine verwaltete Session die Agentenschleife serverseitig ausführt: Die Session hält das Transkript, führt Tools in einer Sandbox aus und streamt Events, die das Frontend rendert.
Ein Recherche-Analyst in einem Browser-Chat, der mit dem Chat SDK von Vercel erstellt wurde. Jede Unterhaltung ist eine persistente Session, die ihre Antwort streamt, während ein Live-Feed die Tool-Aufrufe anzeigt. Durch Austauschen des Chat-SDK-Adapters wird derselbe Handler nach Slack, Teams, Discord oder WhatsApp verlagert.
Ein Tabellenkalkulations-Analyst in einem Chat, der aus assistant-ui-Primitiven aufgebaut ist. Sessions bilden die Thread-Liste, ein Reducer wandelt das Event-Log der Session in Nachrichten und Tool-Karten um, und jeder Bash-Befehl rendert vor seiner Ausführung eine Inline-Abfrage zum Erlauben/Ablehnen.
Ein persönlicher Finanzassistent in einem CopilotKit-Chat. Der AG-UI-Adapter für Claude Managed Agents ordnet jeden Chat-Thread einer verwalteten Session zu und streamt Antworten Token für Token, und benutzerdefinierte Tools rendern interaktive Diagramme inline in der Unterhaltung.
Nächste Schritte
Erstelle wiederverwendbare, versionierte Agentenkonfigurationen
Passe Networking- und Sandbox-Einstellungen an
Aktiviere bestimmte Tools für deinen Agenten
Verarbeite Events und steuere den Agenten, während er läuft
Führe deinen Agenten nach einem wiederkehrenden Cron-Zeitplan aus
Destilliere einen Dokumentenkorpus einmalig zu einem Wissens-Wiki und beantworte daraus wiederholte Fragen zu einem Bruchteil der Kosten
War diese Seite hilfreich?