SpyBara
Go Premium

agent-view.md 2026-05-10 23:03 UTC to 2026-05-11 23:00 UTC

293 added, 0 removed.

2026
Sun 31 06:39 Sat 30 06:23 Fri 29 06:38 Thu 28 06:37 Wed 27 06:42 Tue 26 06:33 Sun 24 06:25 Sat 23 06:18 Fri 22 06:33 Thu 21 06:36 Wed 20 06:35 Tue 19 06:34 Mon 18 23:59 Sun 17 01:01 Fri 15 22:58 Thu 14 17:02 Wed 13 23:01 Tue 12 22:57 Mon 11 23:00 Sun 10 23:03 Sat 9 04:57 Fri 8 22:00 Thu 7 22:59 Tue 5 23:00 Mon 4 22:58 Sat 2 18:14 Fri 1 18:19

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.

Cette page couvre :

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.

1

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.

2

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.

3

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.

4

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 agents dans ce répertoire.
  • Ouvrez claude agents dans 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, cd dans le répertoire et exécutez claude --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