Claude Platform Docs

Von deinem Terminal aus eine Verbindung zu einer Managed-Agents-Sitzung herstellen

Verbinde die ant CLI mit einer Claude-Managed-Agents-Sitzung, um ihr Transkript live zu verfolgen, Nachrichten zu senden, Tool-Aufrufe zu erlauben oder abzulehnen oder den Sitzungs-Viewer in deinem Browser zu öffnen.

ant beta:sessions connect verbindet dein Terminal mit einer bestehenden Claude-Managed-Agents-Sitzung. Der Befehl lädt das Transkript der Sitzung und verfolgt es live, während der Agent arbeitet. Du kannst auch eingreifen: eine Nachricht senden, den Agenten unterbrechen oder einen Tool-Aufruf, der auf Genehmigung wartet, erlauben oder ablehnen. Mit --web öffnet er die Sitzung stattdessen im Sitzungs-Viewer der Claude Console in deinem Browser.

Der Befehl erfordert Version 1.32.0 oder höher der CLI. Informationen zum Installieren oder Aktualisieren der CLI und zur Authentifizierung findest du im CLI-Schnellstart.

Mit einer Sitzung verbinden

Übergib die ID einer Sitzung in deinem Workspace. Du kannst sie aus der Create-Antwort, aus ant beta:sessions list oder aus der Console kopieren.

CLI
ant beta:sessions connect sesn_011CZkZAtmR3yMPDzynEDxu7

Ohne --web benötigt der Befehl ein interaktives Terminal. Verwende in Skripten stattdessen ant beta:sessions:events stream und ant beta:sessions:events send. Siehe CLI-Skripting und -Automatisierung.

Drücke Ctrl+C, um die Verbindung zu trennen. Die Sitzung läuft weiter, und bei einer erneuten Verbindung wird ihr vollständiger Verlauf geladen.

Die Sitzung verfolgen und steuern

Die Terminalansicht zeigt die Konversation live: Nachrichten und Tool-Aufrufe, jeweils mit Dauer und Ergebnis des Aufrufs. Eine Statusleiste zeigt an, ob die Sitzung läuft, inaktiv ist oder auf deine Genehmigung wartet. In Multiagent-Sitzungen folgt die Ansicht dem primären Thread der Sitzung, der die Nachrichten enthält, die der Koordinator mit den Agenten austauscht, an die er Aufgaben delegiert.

TasteAktion
EnterSendet deine Eingabe als user.message-Event. Alt+Enter oder Ctrl+J beginnt eine neue Zeile.
EscUnterbricht den Agenten, während er läuft (user.interrupt).
Ctrl+OBlendet Details ein oder aus: Tool-Eingaben und -Ergebnisse, Token-Nutzung und Status-Events. --verbose (-v) startet mit eingeblendeten Details.
Page Up, Page DownScrollt durch das Transkript. Hochscrollen pausiert das Verfolgen; End setzt es fort.
Ctrl+CTrennt die Verbindung. Ctrl+D in einer leeren Eingabezeile trennt die Verbindung ebenfalls.

Wenn ein Tool-Aufruf auf deine Genehmigung wartet, ändert sich die Eingabezeile zu Allow tool call? Dies geschieht unter einer always_ask-Richtlinie oder unter auto, wenn der Server zu keiner Entscheidung kommt. Wähle Yes, No oder No, and tell the agent why. Die CLI sendet deine Auswahl als user.tool_confirmation-Event, wobei ein von dir eingegebener Grund als dessen deny_message übermittelt wird.

Wenn die Sitzung terminated oder gelöscht ist, ist die Ansicht schreibgeschützt.

Den Sitzungs-Viewer in deinem Browser öffnen

CLI
ant beta:sessions connect sesn_011CZkZAtmR3yMPDzynEDxu7 --web

--web stellt den Sitzungs-Viewer der Console über einen lokalen Server auf 127.0.0.1 bereit, gibt dessen URL aus und öffnet sie in deinem Browser. Füge --no-browser hinzu, um das Öffnen des Browsers zu überspringen. Du kannst auch aus dem Browser heraus Nachrichten senden, den Agenten unterbrechen und einen Tool-Aufruf erlauben oder ablehnen. Anders als die Terminalansicht folgt der Browser-Viewer jedem Thread einer Multiagent-Sitzung.

Die URL kann einmal geöffnet werden, und zwar innerhalb von zwei Minuten nach ihrer Ausgabe. Das Neuladen dieses Tabs funktioniert, aber um den Viewer an einer anderen Stelle zu öffnen, führe den Befehl erneut aus. Deine Anmeldedaten verlassen niemals die CLI: Die Seite sendet Anfragen nur an den lokalen ant-Prozess, der die API-Anfragen stellt. Der Server läuft, bis du Ctrl+C drückst.

Was this page helpful?