Gérer plusieurs agents avec la vue agent
Lancez et gérez plusieurs sessions Claude Code à partir d'un seul écran. La vue agent affiche ce que chaque session fait et lesquelles ont besoin de votre intervention.
La vue agent, ouverte avec claude agents, est un seul écran pour toutes vos sessions en arrière-plan : ce qui s'exécute, ce qui a besoin de votre intervention, et ce qui est terminé. Lancez de nouvelles sessions, observez leur état en un coup d'œil au lieu de faire défiler les transcriptions, et intervenez uniquement quand l'une d'elles a besoin de vous. Les sessions continuent de s'exécuter en arrière-plan sans terminal attaché.
Utilisez la vue agent quand vous avez plusieurs tâches indépendantes sur lesquelles Claude peut travailler simultanément, comme corriger un bug, examiner une pull request, ou enquêter sur un journal. Quand vous voulez résoudre un problème ensemble, attachez-vous à une session et utilisez Claude Code de manière interactive comme d'habitude. Les sessions dans la vue agent s'exécutent indépendamment et ne rapportent qu'à vous. Pour comparer avec les sous-agents, les équipes d'agents et les worktrees, consultez Exécuter les agents en parallèle.
La vue agent est un aperçu de recherche et nécessite Claude Code v2.1.139 ou ultérieur. Vérifiez votre version avec claude --version. L'interface et les raccourcis clavier peuvent changer à mesure que la fonctionnalité évolue, et les administrateurs peuvent désactiver la vue agent pour une organisation avec le paramètre géré disableAgentView.
Cette page couvre :
- Démarrage rapide
- Surveiller les sessions avec la vue agent, y compris les icônes d'état, l'aperçu et la réponse, l'attachement, l'organisation et les raccourcis clavier
- Lancer de nouveaux agents à partir de la vue agent, depuis l'intérieur d'une session, ou depuis le shell
- Gérer les sessions depuis le shell
- Comment les sessions en arrière-plan sont hébergées par le processus superviseur
Démarrage rapide
Cette procédure pas à pas ouvre la vue agent, lance une session, répond depuis le panneau d'aperçu, et s'attache pour la conversation complète.
Ouvrir la vue agent
Depuis votre shell, exécutez :
claude agents
La vue agent s'ouvre avec une entrée en bas et un tableau qui se remplit au fur et à mesure que les sessions commencent. Appuyez sur Esc à tout moment pour quitter. Vos sessions continuent de s'exécuter.
Lancer une session
Tapez une invite dans l'entrée et appuyez sur Entrée. Une nouvelle session démarre et apparaît sous forme de ligne indiquant si elle fonctionne, attend votre intervention, ou est terminée. Répétez pour exécuter autant de sessions en parallèle que vous le souhaitez.
Aperçu et réponse
Sélectionnez une ligne avec les touches fléchées et appuyez sur Espace pour voir ce que la session fait ou ce qu'elle a besoin de vous. Tapez une réponse et appuyez sur Entrée pour l'envoyer sans quitter la vue agent.
Attacher et détacher
Appuyez sur Entrée ou → sur une ligne pour vous attacher quand vous voulez la conversation complète. La session prend le contrôle du terminal exactement comme si vous aviez exécuté claude. Appuyez sur ← sur une invite vide pour vous détacher et revenir au tableau.
Pour amener une session interactive existante dans la vue agent, exécutez /bg à l'intérieur, ou appuyez sur ← sur une invite vide pour mettre la session en arrière-plan et ouvrir la vue agent en une seule étape. La session continue de s'exécuter en arrière-plan et apparaît sous forme de ligne. Pour démarrer une nouvelle session en arrière-plan directement depuis le shell, exécutez claude --bg "<prompt>".
Vous pouvez utiliser claude agents comme point d'entrée principal au lieu de claude : lancez chaque tâche à partir de la vue agent, attachez-vous quand vous voulez la conversation complète, et appuyez sur ← pour revenir au tableau.
Surveiller les sessions avec la vue agent
Exécutez claude agents pour ouvrir la vue agent. Elle prend le contrôle du terminal complet et répertorie chaque session groupée par état, avec les sessions épinglées et celles qui ont besoin de vous en haut. Chaque ligne affiche le nom de la session, l'activité actuelle, et depuis combien de temps elle a changé pour la dernière fois.
La liste est globale à votre machine et inclut chaque session en arrière-plan quel que soit le projet ou la worktree sur laquelle elle travaille. Les sessions interactives que vous avez ouvertes dans d'autres terminaux n'apparaissent pas jusqu'à ce que vous les mettiez en arrière-plan, et les sous-agents s'exécutant à l'intérieur d'une session ne sont pas répertoriés comme des lignes séparées.
Épinglées
✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m
Prêtes pour examen
∙ jump physics github.com/anthropics/example/pull/2048 2h
Nécessite une intervention
✻ power-up design needs input: double jump or wall climb? 1m
En cours
✽ collision detection Edit src/physics/CollisionSystem.ts 2m
✢ playtest level 3 run 12 · all checkpoints cleared in 4m
Terminées
✻ title screen result: menu, options, and credits done 9m
∙ sound effects result: 14 SFX exported to assets/audio 4h
… 6 more
L'icône vous indique l'état de la session :
| Icône | État | Ce que cela signifie |
|---|---|---|
| Animée | En cours | Claude exécute activement des outils ou génère une réponse |
| Jaune | Nécessite une intervention | Claude attend votre intervention, généralement une décision de permission ou une réponse |
| Estompée | Inactif | La session attend une intervention mais n'est pas bloquée sur une question spécifique |
| Verte | Terminée | La tâche s'est terminée avec succès |
| Rouge | Échouée | La tâche s'est terminée avec une erreur |
| Grise | Arrêtée | La session a été arrêtée avec Ctrl+X ou claude stop |
La forme de l'icône vous indique si le processus sous-jacent s'exécute toujours. Un ✻, ou un ✽ animé pendant que Claude travaille, signifie que la session est active et vous pouvez lui répondre immédiatement. Un ∙ signifie que le processus a quitté, mais vous pouvez toujours apercevoir, répondre, ou vous attacher : Claude redémarre la session à partir de là où elle s'était arrêtée. Un ✢ est une session /loop dormant entre les itérations, la ligne affichant son nombre d'exécutions et un compte à rebours jusqu'à la prochaine itération.
Les sessions en arrière-plan n'ont besoin d'aucun terminal ouvert pour continuer à fonctionner. Un processus superviseur séparé les exécute, vous pouvez donc fermer la vue agent, fermer votre shell, ou démarrer une nouvelle session interactive et votre travail lancé continue.
Les sessions persistent sur le disque : fermer votre terminal ou une mise à jour automatique ne les perd pas, et rouvrir claude agents les affiche toutes. Si votre machine se met en veille ou s'éteint, les sessions en cours s'arrêtent ; redémarrez-les avec claude respawn --all.
Le résumé d'une ligne dans chaque ligne est généré par votre modèle de classe Haiku configuré afin que la ligne puisse vous dire ce que la session fait, ce qu'elle a besoin, ou ce qu'elle a produit sans ouvrir la transcription. Chaque résumé est une courte demande de classe Haiku via votre fournisseur normal, facturée et traitée selon les mêmes conditions d'utilisation des données que la session elle-même.
Quand une session ouvre une pull request, la ligne affiche le lien PR et un indicateur d'état pour ses vérifications CI. Pour la plupart des tâches, cette ligne est comment vous collectez le travail : examinez et fusionnez la pull request quand ses vérifications réussissent.
Aperçu et réponse
Appuyez sur Espace sur une ligne sélectionnée pour ouvrir le panneau d'aperçu. Il affiche ce que la session a besoin de vous, sa sortie la plus récente, et toutes les pull requests qu'elle a ouvertes. La plupart du temps, c'est suffisant, et vous n'avez jamais besoin d'ouvrir la transcription complète.
Tapez une réponse dans le panneau d'aperçu et appuyez sur Entrée pour l'envoyer à cette session. Quand la session pose une question à choix multiples, le panneau d'aperçu affiche les options et vous pouvez appuyer sur une touche numérique pour en choisir une. Pour les autres sessions bloquées, appuyez sur Tab pour remplir l'entrée avec une réponse suggérée que vous pouvez modifier avant d'envoyer. Préfixez une réponse avec ! pour envoyer une commande Bash à la place.
Utilisez ↑ et ↓ pour apercevoir les sessions adjacentes sans fermer le panneau, ou → pour vous attacher.
S'attacher à une session
Appuyez sur Entrée ou → sur une ligne sélectionnée pour vous attacher, ou appuyez sur Alt+1 à Alt+9 pour vous attacher directement à la Nième session du groupe ciblé. La vue agent est remplacée par la session interactive complète, exactement comme si vous aviez exécuté claude dans ce répertoire. Quand vous vous attachez, Claude affiche un court récapitulatif de ce qui s'est passé pendant que vous étiez absent.
Pendant que vous êtes attaché, la session se comporte comme n'importe quelle autre session Claude Code : chaque commande, raccourci clavier, et fonctionnalité fonctionne.
Appuyez sur ← sur une invite vide pour vous détacher et revenir à la vue agent. Si une boîte de dialogue a le focus et ne répond pas à ←, appuyez sur Ctrl+Z pour vous détacher immédiatement.
Se détacher n'arrête jamais une session en arrière-plan : ←, Ctrl+C, Ctrl+D, Ctrl+Z, et /exit la laissent toutes s'exécuter. Pour terminer une session depuis l'intérieur, exécutez /stop.
Une fois que vous avez utilisé la vue agent, appuyer sur ← sur une invite vide fonctionne à partir de n'importe quelle session Claude Code, pas seulement celles auxquelles vous vous êtes attaché. Elle ouvre la vue agent avec votre session actuelle pré-sélectionnée, vous pouvez donc basculer entre les sessions sans quitter le terminal.
Organiser la liste
La vue agent groupe les sessions par état, avec les sessions qui ont besoin d'une intervention au-dessus des sessions qui fonctionnent ou sont terminées. Appuyez sur Ctrl+S pour basculer vers un groupement par répertoire à la place. Votre choix est enregistré entre les exécutions. Dans un groupe, épinglez une session en haut avec Ctrl+T, réorganisez avec Shift+↑ et Shift+↓, ou appuyez sur Entrée sur un en-tête de groupe pour le réduire. Pour supprimer une session, appuyez sur Ctrl+X pour l'arrêter et Ctrl+X à nouveau dans les deux secondes pour la supprimer. Appuyer sur Ctrl+X sur un en-tête de groupe supprime chaque session de ce groupe après confirmation.
Les sessions terminées plus anciennes se replient dans une ligne « … N more » pour garder la liste courte. Les échecs et les sessions avec une pull request ouverte restent toujours visibles.
Filtrer la liste
Tapez dans l'entrée de lancement pour filtrer au lieu de lancer :
| Filtre | Affiche |
|---|---|
a:<name> |
Sessions exécutant l'agent nommé |
s:<state> |
Sessions dans l'état donné, comme s:blocked pour les sessions qui ont besoin de vous |
#<number> ou une URL PR |
La session travaillant sur cette pull request |
Raccourcis clavier
Appuyez sur ? dans la vue agent pour voir chaque raccourci. Les plus courants :
| Raccourci | Action |
|---|---|
↑ / ↓ |
Se déplacer entre les lignes |
Entrée |
S'attacher à la session sélectionnée, ou lancer si du texte est dans l'entrée |
Espace |
Ouvrir ou fermer le panneau d'aperçu pour la session sélectionnée |
Shift+Entrée |
Lancer et s'attacher immédiatement |
→ |
S'attacher à la session sélectionnée |
Alt+1..Alt+9 |
S'attacher à la Nième session du groupe ciblé |
Tab |
Parcourir tous les sous-agents, ou appliquer la suggestion en surbrillance |
Ctrl+S |
Basculer le groupement entre l'état et le répertoire |
Ctrl+T |
Épingler ou dépingler la session sélectionnée |
Ctrl+R |
Renommer la session sélectionnée |
Ctrl+G |
Ouvrir l'invite de lancement dans votre $EDITOR |
Ctrl+X |
Arrêter la session ; appuyez à nouveau dans les deux secondes pour la supprimer |
Shift+↑ / Shift+↓ |
Réorganiser la session sélectionnée |
Esc |
Fermer le panneau d'aperçu, effacer l'entrée, ou quitter |
Ctrl+C |
Effacer l'entrée ; appuyez deux fois pour quitter |
? |
Afficher tous les raccourcis |
Lancer de nouveaux agents
Vous pouvez lancer de nouvelles sessions en arrière-plan à partir de la vue agent, envoyer une session interactive existante en arrière-plan, ou en démarrer une directement depuis le shell.
À partir de la vue agent
Tapez une invite dans l'entrée en bas de la vue agent et appuyez sur Entrée pour démarrer une nouvelle session en arrière-plan. La session est nommée automatiquement à partir de l'invite. Vous pouvez la renommer plus tard avec Ctrl+R. Collez une image dans l'invite pour inclure une capture d'écran ou un diagramme avec la tâche.
Préfixez ou mentionnez des parties de l'invite pour contrôler comment la session démarre :
| Entrée | Effet |
|---|---|
<agent-name> <prompt> |
Si le premier mot correspond à un nom de sous-agent personnalisé, ce sous-agent s'exécute comme l'agent principal de la session avec la configuration de son frontmatter |
@<agent-name> |
Mentionnez un sous-agent personnalisé n'importe où dans l'invite pour l'exécuter comme l'agent principal |
@<repo> |
Mentionnez un référentiel sous le répertoire à partir duquel vous avez ouvert la vue agent pour exécuter la session là |
/<skill> |
Suggérez des skills à lancer comme l'invite |
#<number> ou une URL de pull request |
Si une session travaille déjà sur cette PR, sélectionnez-la au lieu de lancer |
Shift+Entrée |
Lancer et s'attacher immédiatement à la nouvelle session |
Tapez / pour lancer un skill. Empaqueter une tâche récurrente comme un skill vous permet de démarrer le même workflow plusieurs fois à partir de la vue agent sans retaper l'invite. Appuyez sur Tab sur une entrée vide pour parcourir chaque sous-agent dispatchable, ou pour appliquer la suggestion en surbrillance quand les suggestions s'affichent.
Lancer vers un répertoire spécifique
Une nouvelle session s'exécute dans le répertoire à partir duquel vous avez ouvert la vue agent. Pour cibler un répertoire différent :
- Ouvrez
claude agentsdans ce répertoire. - Ouvrez
claude agentsdans un répertoire parent qui contient plusieurs référentiels et mentionnez-en un avec@<repo>dans l'invite pour exécuter la session là. - Depuis le shell,
cddans le répertoire et exécutezclaude --bg "<prompt>".
Quand la vue agent est groupée par répertoire, le répertoire de la ligne en surbrillance devient la cible de lancement, vous pouvez donc faire défiler jusqu'à un groupe et lancer dedans sans retaper le chemin.
Isoler les modifications de fichiers dans une worktree
Les sessions lancées à partir de la vue agent partagent votre répertoire de travail par défaut, donc deux agents modifiant les mêmes fichiers peuvent entrer en conflit. Pour éviter cela, Claude Code bloque une session lancée à partir de la vue agent d'écrire des fichiers jusqu'à ce qu'elle se déplace dans une git worktree isolée. Claude gère cela automatiquement quand il a besoin de modifier des fichiers. La worktree est créée sous .claude/worktrees/ à l'intérieur du répertoire du projet et supprimée quand vous supprimez la session. Supprimer une session supprime aussi sa worktree, donc fusionnez ou poussez les modifications que vous voulez conserver avant de supprimer.
Pour faire en sorte qu'un sous-agent s'exécute toujours dans sa propre worktree quel que soit le mode de démarrage, définissez isolation: worktree dans son frontmatter.
À partir d'une session
Exécutez /background ou son alias /bg pour détacher la conversation actuelle et la laisser s'exécuter. Passez une invite comme /bg run the test suite and fix any failures pour envoyer une instruction supplémentaire avant de détacher.
À partir du shell
Passez --bg pour démarrer une session qui va directement en arrière-plan :
claude --bg "investigate the flaky SettingsChangeDetector test"
Pour exécuter un sous-agent spécifique comme l'agent principal de la session, combinez --bg avec --agent :
claude --agent code-reviewer --bg "address review comments on PR 1234"
Après avoir mis en arrière-plan, Claude affiche l'ID court de la session et les commandes pour la gérer :
backgrounded · 7c5dcf5d
claude agents list sessions
claude attach 7c5dcf5d open in this terminal
claude logs 7c5dcf5d show recent output
claude stop 7c5dcf5d stop this session
Gérer les sessions depuis le shell
Chaque session en arrière-plan a un ID court que vous pouvez utiliser depuis le shell. Ces commandes sont utiles pour les scripts ou quand vous ne voulez pas ouvrir la vue agent.
| Commande | Objectif |
|---|---|
claude agents |
Ouvrir la vue agent |
claude attach <id> |
S'attacher à une session dans ce terminal |
claude logs <id> |
Afficher la sortie récente de la session |
claude stop <id> |
Arrêter une session. Accepte aussi claude kill |
claude respawn <id> |
Redémarrer une session arrêtée avec sa conversation intacte |
claude respawn --all |
Redémarrer chaque session arrêtée |
claude rm <id> |
Supprimer une session de la liste |
Comment les sessions en arrière-plan sont hébergées
Les sessions en arrière-plan sont hébergées par un processus superviseur par utilisateur, séparé de votre terminal et de la vue agent. Il démarre automatiquement la première fois que vous mettez une session en arrière-plan ou ouvrez la vue agent, et vous ne le gérez pas directement. Le superviseur et ses sessions s'authentifient avec les mêmes identifiants que vos sessions interactives et ne font aucune connexion réseau supplémentaire au-delà de l'API du modèle.
Chaque session en arrière-plan est son propre processus Claude Code, parent du superviseur plutôt que de votre terminal. Une session qui fonctionne activement, attend votre intervention, ou a un terminal attaché garde son processus en cours d'exécution. Une fois qu'une session se termine et reste non attachée pendant environ une heure, le superviseur arrête son processus pour libérer des ressources. La transcription et l'état restent sur le disque, et la prochaine fois que vous vous attachez, apercevez, ou répondez, le superviseur démarre un processus frais à partir de là où il s'était arrêté. Quand chaque session s'est terminée et qu'aucun terminal n'est connecté, le superviseur lui-même quitte et redémarre la prochaine fois que vous mettez une session en arrière-plan ou ouvrez la vue agent.
Le superviseur regarde le binaire Claude Code installé sur le disque et redémarre dans la nouvelle version après que le mise à jour automatique régulière le remplace. C'est une montre de fichier local, pas une vérification réseau. Les sessions en arrière-plan sont des processus détachés, donc elles continuent de s'exécuter pendant le redémarrage et le nouveau superviseur se reconnecte à elles.
L'état de la session est stocké sous votre répertoire de configuration Claude Code. Si vous définissez CLAUDE_CONFIG_DIR, le superviseur utilise ce répertoire à la place de ~/.claude et s'exécute comme une instance séparée avec ses propres sessions.
| Chemin | Contenu |
|---|---|
~/.claude/daemon.log |
Journal du superviseur |
~/.claude/daemon/roster.json |
Liste des sessions en arrière-plan en cours d'exécution, utilisée pour se reconnecter après un redémarrage |
~/.claude/jobs/<id>/state.json |
État par session affiché dans la vue agent |
Pour désactiver complètement les agents en arrière-plan et la vue agent, définissez le paramètre disableAgentView setting à true ou définissez la variable d'environnement CLAUDE_CODE_DISABLE_AGENT_VIEW. Les administrateurs peuvent appliquer cela via les paramètres gérés.
Dépannage
La vue agent s'ouvre sans sessions
La vue agent est vide jusqu'à ce que vous lanciez votre première session. Tapez une invite dans l'entrée en bas et appuyez sur Entrée.
Les sessions s'affichent comme arrêtées après le réveil de votre machine
Les sessions en arrière-plan ne survivent pas à la mise en veille ou à l'arrêt. Attachez-vous, apercevez, ou répondez à n'importe quelle session arrêtée et elle redémarre à partir de là où elle s'était arrêtée. Pour les redémarrer toutes à la fois, exécutez claude respawn --all.
Une session est lente à répondre après l'attachement
Une fois qu'une session s'est terminée et reste non attachée pendant environ une heure, le superviseur arrête son processus pour libérer des ressources. S'attacher démarre un processus frais à partir de là où il s'était arrêté, ce qui prend un moment. Les sessions qui fonctionnent ou attendent votre intervention ne sont jamais arrêtées de cette façon.
.claude/worktrees/ se remplit
Les worktrees sont supprimées quand vous supprimez la session qui les a créées. Si une session s'est terminée sans nettoyer, listez les entrées restantes avec git worktree list dans le répertoire du projet et supprimez chacune avec git worktree remove <path>. Voir Nettoyer les worktrees.
Limitations
La vue agent est un aperçu de recherche. Les limitations actuelles à connaître :
- Les limites de débit s'appliquent : les sessions en arrière-plan réduisent votre utilisation d'abonnement de la même manière que les sessions interactives, donc exécuter dix agents en parallèle utilise le quota dix fois plus vite.
- Les sessions sont locales : les sessions en arrière-plan s'exécutent sur votre machine et s'arrêtent si elle se met en veille ou s'éteint.
- Les worktrees sont supprimées avec la session : fusionnez ou poussez les modifications avant de supprimer une session qui a modifié des fichiers dans sa propre worktree.
Prochaines étapes
Maintenant que vous comprenez la vue agent, explorez ces fonctionnalités connexes :
- Exécuter les agents en parallèle : comparez la vue agent avec les sous-agents, les équipes d'agents, et les worktrees
- Sous-agents : définissez des configurations d'agent réutilisables avec des invites personnalisées, des outils, et l'isolation
- Équipes d'agents : coordonnez plusieurs sessions qui se messagent mutuellement
- Claude Code sur le web : exécutez les sessions dans un environnement cloud géré au lieu de localement