Claude Platform Docs

Se connecter à une session Managed Agents depuis votre terminal

Attachez la CLI ant à une session Claude Managed Agents pour suivre sa transcription en direct, envoyer des messages, autoriser ou refuser des appels d'outils, ou ouvrir la visionneuse de session dans votre navigateur.

ant beta:sessions connect attache votre terminal à une session Claude Managed Agents existante. Elle charge le « transcript » (transcription) de la session et la suit en direct pendant que l'agent travaille. Vous pouvez également intervenir : envoyer un message, interrompre l'agent, ou autoriser ou refuser un « tool call » (appel d'outil) en attente d'approbation. Avec --web, elle ouvre plutôt la session dans le « session viewer » (visionneuse de session) de la Claude Console, dans votre navigateur.

La commande nécessite la version 1.32.0 ou ultérieure de la CLI. Pour installer ou mettre à jour la CLI et vous authentifier, consultez le démarrage rapide de la CLI.

Se connecter à une session

Transmettez l'ID d'une session de votre espace de travail. Vous pouvez le copier depuis la réponse de création, depuis ant beta:sessions list ou depuis la Console.

CLI
ant beta:sessions connect sesn_011CZkZAtmR3yMPDzynEDxu7

Sans --web, la commande nécessite un terminal interactif. Dans les scripts, utilisez plutôt ant beta:sessions:events stream et ant beta:sessions:events send. Consultez Scripts et automatisation avec la CLI.

Appuyez sur Ctrl+C pour vous détacher. La session continue de s'exécuter, et une nouvelle connexion charge son historique complet.

Suivre et piloter la session

La vue du terminal affiche la conversation en direct : les messages et les appels d'outils, avec la durée et le résultat de chaque appel. Une barre d'état indique si la session est en cours d'exécution, inactive ou en attente de votre approbation. Dans les sessions multiagents, la vue suit le fil principal de la session, qui inclut les messages que le coordinateur échange avec les agents auxquels il délègue.

ToucheAction
EntréeEnvoie votre saisie sous forme d'événement user.message. Alt+Entrée ou Ctrl+J commence une nouvelle ligne.
ÉchapInterrompt l'agent pendant son exécution (user.interrupt).
Ctrl+OAffiche ou masque les détails : entrées et résultats des outils, utilisation des tokens et événements d'état. --verbose (-v) démarre avec les détails affichés.
Page Up, Page DownFait défiler la transcription. Le défilement vers le haut met le suivi en pause ; Fin le reprend.
Ctrl+CDétache le terminal. Ctrl+D sur une ligne de saisie vide le détache également.

Lorsqu'un appel d'outil attend votre approbation, la ligne de saisie devient Allow tool call? Cela se produit avec une politique always_ask, ou avec auto lorsque le serveur ne parvient à aucune décision. Choisissez Yes, No ou No, and tell the agent why. La CLI envoie votre choix sous forme d'événement user.tool_confirmation, avec la raison que vous saisissez éventuellement comme deny_message.

Si la session est terminated ou supprimée, la vue est en lecture seule.

Ouvrir la visionneuse de session dans votre navigateur

CLI
ant beta:sessions connect sesn_011CZkZAtmR3yMPDzynEDxu7 --web

--web sert la visionneuse de session de la Console depuis un serveur local sur 127.0.0.1, affiche son URL et l'ouvre dans votre navigateur. Ajoutez --no-browser pour ne pas ouvrir le navigateur. Vous pouvez également envoyer des messages, interrompre l'agent, et autoriser ou refuser un appel d'outil depuis le navigateur. Contrairement à la vue du terminal, la visionneuse du navigateur suit chaque fil d'une session multiagent.

L'URL ne peut être ouverte qu'une seule fois, dans les deux minutes suivant son affichage. Le rechargement de cet onglet fonctionne, mais pour ouvrir la visionneuse ailleurs, exécutez à nouveau la commande. Vos identifiants ne quittent jamais la CLI : la page envoie des requêtes uniquement au processus ant local, qui effectue les requêtes API. Le serveur s'exécute jusqu'à ce que vous appuyiez sur Ctrl+C.

Was this page helpful?