6 6
7> 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.7> 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.
8 8
9La 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é.9La 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. Chaque session en arrière-plan est une conversation Claude Code complète qui continue de s'exécuter sans terminal attaché, vous pouvez donc l'ouvrir, répondre et partir quand vous le souhaitez.
10 10
11Utilisez 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](/fr/agents).11<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-light.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=7a186c96ed47d6700d084d77e786be65" className="dark:hidden" alt="Vue agent dans un terminal : l'en-tête affiche Claude Code v2.1.140, le modèle, le répertoire de travail et un résumé du nombre. Les sessions sont regroupées sous Nécessite une intervention, En cours d'exécution et Terminé, avec une entrée de lancement en bas et un pied de page avec des indices de clavier." width="1772" height="780" data-path="images/agent-view-light.png" />
12
13<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-dark.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=a5bed7434bae368faea3a8f023b52aa2" className="hidden dark:block" alt="Vue agent dans un terminal : l'en-tête affiche Claude Code v2.1.140, le modèle, le répertoire de travail et un résumé du nombre. Les sessions sont regroupées sous Nécessite une intervention, En cours d'exécution et Terminé, avec une entrée de lancement en bas et un pied de page avec des indices de clavier." width="1772" height="780" data-path="images/agent-view-dark.png" />
14
15Utilisez la vue agent quand vous avez plusieurs tâches indépendantes sur lesquelles Claude peut travailler sans que vous regardiez chaque étape. Lancez une correction de bug, un examen de pull request et une enquête sur un test instable sous forme de trois lignes, continuez à travailler dans une autre fenêtre et vérifiez quand une ligne indique qu'elle a besoin de vous ou qu'elle a un résultat.
16
17Quand vous voulez travailler plus directement dans la session d'un agent, attachez-vous à la ligne pour entrer dans la conversation complète.
18
19Pour comparer la vue agent avec les sous-agents, les équipes d'agents et les worktrees, consultez [Exécuter les agents en parallèle](/fr/agents).
12 20
13<Note>21<Note>
14 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`](#how-background-sessions-are-hosted).22 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.
15</Note>23</Note>
16 24
17Cette page couvre :25Cette page couvre :
18 26
19* [Démarrage rapide](#quick-start)27* [Démarrage rapide](#quick-start) : donnez à Claude une tâche à accomplir en arrière-plan, vérifiez-la et intervenez quand c'est nécessaire
20* [Surveiller les sessions avec la vue agent](#monitor-sessions-with-agent-view), y compris les icônes d'état, l'aperçu et la réponse, l'attachement, l'organisation et les raccourcis clavier28* [Surveiller les sessions avec la vue agent](#monitor-sessions-with-agent-view), y compris les icônes d'état, l'aperçu et la réponse, l'attachement, l'organisation et les raccourcis clavier
21* [Lancer de nouveaux agents](#dispatch-new-agents) à partir de la vue agent, depuis l'intérieur d'une session, ou depuis le shell29* [Lancer de nouveaux agents](#dispatch-new-agents) à partir de la vue agent, depuis l'intérieur d'une session, ou depuis votre shell
22* [Gérer les sessions depuis le shell](#manage-sessions-from-the-shell)30* [Gérer les sessions depuis le shell](#manage-sessions-from-the-shell)
23* [Comment les sessions en arrière-plan sont hébergées](#how-background-sessions-are-hosted) par le processus superviseur31* [Comment les sessions en arrière-plan sont hébergées](#how-background-sessions-are-hosted) par le processus superviseur
24 32
25## Démarrage rapide33## Démarrage rapide
26 34
27Cette 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.35Cette procédure pas à pas couvre la boucle principale de la vue agent : dispatcher une tâche, regarder sa ligne se mettre à jour au fur et à mesure que Claude travaille, jeter un coup d'œil pour vérifier et répondre, et s'attacher pour la conversation complète. La session que vous dispatcher continue de s'exécuter après que vous fermiez la vue agent, vous pouvez donc partir et y revenir.
28 36
29<Steps>37<Steps>
30 <Step title="Ouvrir la vue agent">38 <Step title="Ouvrir la vue agent">
34 claude agents42 claude agents
35 ```43 ```
36 44
37 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.45 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 revenir à votre shell. Vos sessions continuent de s'exécuter pendant que vous êtes absent et réapparaissent la prochaine fois que vous ouvrez la vue agent.
38 </Step>46 </Step>
39 47
40 <Step title="Lancer une session">48 <Step title="Dispatcher une session">
41 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 plusieurs sessions en parallèle. Chacune utilise votre quota d'abonnement indépendamment, consultez donc [Limitations](#limitations) avant de lancer plusieurs sessions à la fois.49 Tapez une invite décrivant une tâche et appuyez sur `Entrée`. Une nouvelle session en arrière-plan démarre sur cette tâche et apparaît sous forme de ligne indiquant si elle fonctionne, attend votre intervention, ou est terminée. La nouvelle session utilise le modèle affiché dans l'en-tête de la vue agent et le même [mode de permission](#permission-mode-and-settings) que vous obtiendriez en exécutant `claude` dans ce répertoire.
50
51 Chaque invite que vous entrez ici démarre sa propre nouvelle session. Taper une autre invite et appuyer sur `Entrée` lance une deuxième session aux côtés de la première plutôt que d'envoyer un suivi à celle-ci. Vous pouvez en exécuter plusieurs en parallèle de cette façon.
52
53 Chaque session utilise votre quota d'abonnement indépendamment, consultez donc [Limitations](#limitations) avant de dispatcher plusieurs à la fois.
42 </Step>54 </Step>
43 55
44 <Step title="Aperçu et réponse">56 <Step title="Jeter un coup d'œil et répondre">
45 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.57 Sélectionnez une ligne avec les touches fléchées et appuyez sur `Espace` pour ouvrir le panneau d'aperçu. Il affiche la sortie la plus récente de la session, ou la question sur laquelle elle attend, plutôt que la transcription complète. Tapez une réponse et appuyez sur `Entrée` pour l'envoyer sans quitter la vue agent.
46 </Step>58 </Step>
47 59
48 <Step title="Attacher et détacher">60 <Step title="S'attacher et se détacher">
49 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.61 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.
50 </Step>62 </Step>
51</Steps>
52 63
53Pour 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>"`.64 <Step title="Amener une session existante">
65 Pour déplacer une session que vous avez déjà ouverte dans la vue agent, exécutez `/bg` à l'intérieur, ou appuyez sur `←` sur une invite vide pour la mettre en arrière-plan et ouvrir la vue agent en une seule étape. La session continue de s'exécuter et apparaît sous forme de ligne aux côtés de celles que vous avez dispatchées.
66 </Step>
67</Steps>
54 68
55Vous 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.69Vous pouvez utiliser `claude agents` comme point d'entrée principal au lieu de `claude` : dispatcher chaque tâche à partir de la vue agent, vous attacher quand vous voulez la conversation complète, et appuyer sur `←` pour revenir au tableau.
56 70
57## Surveiller les sessions avec la vue agent71## Surveiller les sessions avec la vue agent
58 72
59Exé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.73Exé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.
60 74
61La liste couvre chaque session en arrière-plan sous votre [répertoire de configuration](#how-background-sessions-are-hosted), quel que soit le projet ou la worktree sur laquelle elle travaille, donc une session démarrée dans un référentiel et une autre démarrée dans une worktree différente apparaissent ensemble. Les sessions interactives que vous avez ouvertes dans d'autres terminaux n'apparaissent pas jusqu'à ce que vous les [mettiez en arrière-plan](#from-inside-a-session), et les [sous-agents](/fr/sub-agents) s'exécutant à l'intérieur d'une session ne sont pas répertoriés comme des lignes séparées.75La liste affiche chaque session en arrière-plan que vous avez démarrée, dans tous vos projets. Une session travaillant dans un référentiel et une autre dans une worktree différente apparaissent toutes les deux ici, quel que soit le répertoire à partir duquel vous avez ouvert la vue agent. Les sessions interactives que vous avez ouvertes dans d'autres terminaux n'apparaissent pas jusqu'à ce que vous les [mettiez en arrière-plan](#from-inside-a-session). Les [sous-agents](/fr/sub-agents) et les [coéquipiers](/fr/agent-teams) qu'une session génère ne sont pas répertoriés comme des lignes séparées.
62 76
63```text theme={null}77```text theme={null}
64Épinglées78Épinglées
65 ✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m79 ✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m
66 80
67Prêtes pour examen81Prêtes pour examen
68 ∙ jump physics github.com/anthropics/example/pull/2048 ● 2h82 ∙ jump physics github.com/example/game/pull/2048 ● 2h
69 83
70Nécessite une intervention84Nécessite une intervention
71 ✻ power-up design needs input: double jump or wall climb? 1m85 ✻ power-up design needs input: double jump or wall climb? 1m
80 … 6 more94 … 6 more
81```95```
82 96
83L'icône de chaque ligne porte deux signaux. L'indicateur vous indique l'état de la session, et la forme de l'icône vous indique si le processus sous-jacent s'exécute toujours. Les états sont :97### Lire l'état de la session
98
99Chaque ligne commence par une icône dont la couleur et l'animation montrent l'état de la session :
84 100
85| Indicateur | État | Ce que cela signifie |101| État | L'icône s'affiche comme | Ce que cela signifie |
86| :--------- | :------------------------- | :--------------------------------------------------------------------------------------- |102| :------------------------- | :---------------------- | :-------------------------------------------------------------------------------- |
87| Animé | En cours | Claude exécute activement des outils ou génère une réponse |103| En cours | Animée | Claude exécute activement des outils ou génère une réponse |
88| Jaune | Nécessite une intervention | Claude attend votre intervention, généralement une décision de permission ou une réponse |104| Nécessite une intervention | Jaune | Claude attend une question spécifique ou une décision de permission de votre part |
89| Estompé | Inactif | La session attend une intervention mais n'est pas bloquée sur une question spécifique |105| Inactif | Estompé | La session n'a rien à faire et est prête pour votre prochain message |
90| Vert | Terminée | La tâche s'est terminée avec succès |106| Terminée | Vert | La tâche s'est terminée avec succès |
91| Rouge | Échouée | La tâche s'est terminée avec une erreur |107| Échouée | Rouge | La tâche s'est terminée avec une erreur |
92| Gris | Arrêtée | La session a été arrêtée avec `Ctrl+X` ou `claude stop` |108| Arrêtée | Gris | La session a été arrêtée avec `Ctrl+X` ou `claude stop` |
93 109
94La 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`](/fr/commands) dormant entre les itérations, la ligne affichant son nombre d'exécutions et un compte à rebours jusqu'à la prochaine itération.110Séparément, la forme de l'icône indique si le processus sous-jacent s'exécute :
95 111
96Les sessions en arrière-plan n'ont besoin d'aucun terminal ouvert pour continuer à fonctionner. Un [processus superviseur](#how-background-sessions-are-hosted) 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.112| Forme | Ce que cela signifie |
113| :--------------- | :------------------------------------------------------------------------------------------------------------------------------------------ |
114| `✻` ou `✽` animé | Le processus de la session est actif et répond immédiatement |
115| `∙` | Le processus a quitté. Vous pouvez toujours apercevoir, répondre, ou vous attacher, et Claude redémarre à partir de là où il s'était arrêté |
116| `✢` | Une session [`/loop`](/fr/scheduled-tasks) dormant entre les itérations. La ligne affiche son nombre d'exécutions et un compte à rebours |
97 117
98Les 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`.118Les sessions en arrière-plan n'ont besoin d'aucun terminal ouvert pour continuer à fonctionner. Un [processus superviseur](#the-supervisor-process) 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.
99 119
100Le résumé d'une ligne dans chaque ligne est généré par votre [modèle de classe Haiku](/fr/model-config) 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. Pendant qu'une session fonctionne activement, le résumé s'actualise au maximum une fois toutes les 15 secondes, plus une fois quand chaque tour se termine. Chaque actualisation 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](/fr/data-usage) que la session elle-même.120L'état de la session persiste sur le disque via les mises à jour automatiques et les redémarrages du superviseur. Si votre machine se met en veille ou s'éteint, les sessions en cours s'arrêtent ; redémarrez-les avec `claude respawn --all`.
121
122### Résumés des lignes
123
124Le résumé d'une ligne dans chaque ligne est généré par un [modèle de classe Haiku](/fr/model-config) 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. Pendant qu'une session fonctionne activement, le résumé s'actualise au maximum une fois toutes les 15 secondes, plus une fois quand chaque tour se termine.
125
126Chaque actualisation 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](/fr/data-usage) que la session elle-même.
127
128### Statut de la pull request
101 129
102Quand une session ouvre une pull request, un point d'état apparaît au bord droit de la ligne, lié à la pull request dans les terminaux qui supportent les hyperliens. Quand la session a ouvert plus d'une pull request, le nombre apparaît avant le point et la couleur reflète celle qui a le plus besoin d'attention.130Quand une session ouvre une pull request, un point d'état apparaît au bord droit de la ligne, lié à la pull request dans les terminaux qui supportent les hyperliens. Quand la session a ouvert plus d'une pull request, le nombre apparaît avant le point et la couleur reflète celle qui a le plus besoin d'attention.
103 131
120 148
121### S'attacher à une session149### S'attacher à une session
122 150
123Appuyez 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.151Appuyez sur `Entrée` ou `→` sur une ligne sélectionnée pour vous attacher. 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.
124 152
125Pendant que vous êtes attaché, la session se comporte comme n'importe quelle autre session Claude Code : chaque [commande](/fr/commands), raccourci clavier, et fonctionnalité fonctionne.153Pendant que vous êtes attaché, la session se comporte comme n'importe quelle autre session Claude Code : chaque [commande](/fr/commands), raccourci clavier, et fonctionnalité fonctionne.
126 154
132 160
133### Organiser la liste161### Organiser la liste
134 162
135La 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.163La vue agent groupe les sessions afin que celles qui ont besoin d'une intervention soient en haut, avec `Prêtes pour examen` et `Nécessite une intervention` au-dessus de `En cours` et `Terminées`. Ces noms de groupe ne correspondent pas un-à-un aux [états](#read-session-state) ci-dessus : une session se déplace vers `Prêtes pour examen` quand elle a une pull request ouverte, et `Terminées` collecte les sessions terminées, échouées et arrêtées ensemble. Appuyez sur `Ctrl+S` pour grouper par répertoire à la place. Votre choix persiste entre les exécutions.
164
165Dans un groupe :
136 166
137Les 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.167* Appuyez sur `Ctrl+T` pour épingler une session en haut
168* Appuyez sur `Shift+↑` ou `Shift+↓` pour réorganiser les sessions
169* Appuyez sur `Ctrl+R` pour renommer une session
170* Appuyez sur `Entrée` sur un en-tête de groupe pour le réduire
138 171
139### Filtrer la liste172Pour supprimer une session de la liste, 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.
173
174La suppression supprime la session de la vue agent et nettoie sa [worktree](#how-file-edits-are-isolated), y compris toutes les modifications non validées qu'elle contient, donc poussez ou validez le travail que vous voulez conserver avant de supprimer. La transcription de la conversation reste sur le disque et reste disponible via `claude --resume`.
175
176Les 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.
177
178### Filtrer les sessions
140 179
141Tapez dans l'entrée de lancement pour filtrer au lieu de lancer :180Tapez dans l'entrée de lancement pour filtrer au lieu de lancer :
142 181
143| Filtre | Affiche |182| Filtre | Affiche |
144| :------------------------ | :------------------------------------------------------------------------------------- |183| :------------------------ | :----------------------------------------------------------------------------------------------------------- |
145| `a:<name>` | Sessions exécutant l'agent nommé |184| `a:<name>` | Sessions exécutant l'agent nommé |
146| `s:<state>` | Sessions dans l'état donné, comme `s:blocked` pour les sessions qui ont besoin de vous |185| `s:<state>` | Sessions dans l'état donné, comme `s:working`. Accepte également `s:blocked` pour tout ce qui attend de vous |
147| `#<number>` ou une URL PR | La session travaillant sur cette pull request |186| `#<number>` ou une URL PR | La session travaillant sur cette pull request |
148 187
149### Raccourcis clavier188### Raccourcis clavier
150 189
151Appuyez sur `?` dans la vue agent pour voir chaque raccourci. Les plus courants :190Appuyez sur `?` dans la vue agent pour voir chaque raccourci en contexte. Le tableau ci-dessous les résume.
152 191
153| Raccourci | Action |192| Raccourci | Action |
154| :-------------------- | :------------------------------------------------------------------------------ |193| :-------------------- | :------------------------------------------------------------------------------------------------- |
155| `↑` / `↓` | Se déplacer entre les lignes |194| `↑` / `↓` | Se déplacer entre les lignes |
156| `Entrée` | S'attacher à la session sélectionnée, ou lancer si du texte est dans l'entrée |195| `Entrée` | S'attacher à la session sélectionnée, ou lancer si du texte est dans l'entrée |
157| `Espace` | Ouvrir ou fermer le panneau d'aperçu pour la session sélectionnée |196| `Espace` | Ouvrir ou fermer le panneau d'aperçu pour la session sélectionnée |
158| `Shift+Entrée` | Lancer et s'attacher immédiatement |197| `Shift+Entrée` | Lancer et s'attacher immédiatement |
159| `→` | S'attacher à la session sélectionnée |198| `→` | S'attacher à la session sélectionnée |
160| `Alt+1`..`Alt+9` | S'attacher à la Nième session du groupe ciblé |199| `Alt+1`..`Alt+9` | S'attacher à la session 1–9 dans le groupe actuel |
161| `Tab` | Parcourir tous les sous-agents, ou appliquer la suggestion en surbrillance |200| `Tab` | Sur une entrée vide, parcourir tous les sous-agents. Sinon appliquer la suggestion en surbrillance |
162| `Ctrl+S` | Basculer le groupement entre l'état et le répertoire |201| `Ctrl+S` | Basculer le groupement entre l'état et le répertoire |
163| `Ctrl+T` | Épingler ou dépingler la session sélectionnée |202| `Ctrl+T` | Épingler ou dépingler la session sélectionnée |
164| `Ctrl+R` | Renommer la session sélectionnée |203| `Ctrl+R` | Renommer la session sélectionnée |
175 214
176### À partir de la vue agent215### À partir de la vue agent
177 216
178Tapez 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.217Tapez 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 ; renommez-la plus tard avec `Ctrl+R`.
218
219Collez une image dans l'invite pour inclure une capture d'écran ou un diagramme avec la tâche.
179 220
180Préfixez ou mentionnez des parties de l'invite pour contrôler comment la session démarre :221Préfixez ou mentionnez des parties de l'invite pour contrôler comment la session démarre :
181 222
188| `#<number>` ou une URL de pull request | Si une session travaille déjà sur cette PR, sélectionnez-la au lieu de lancer |229| `#<number>` ou une URL de pull request | Si une session travaille déjà sur cette PR, sélectionnez-la au lieu de lancer |
189| `Shift+Entrée` | Lancer et s'attacher immédiatement à la nouvelle session |230| `Shift+Entrée` | Lancer et s'attacher immédiatement à la nouvelle session |
190 231
191Tapez `/` pour lancer un [skill](/fr/skills). 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.232Empaqueter une tâche récurrente comme un [skill](/fr/skills) vous permet de démarrer le même workflow à partir de la vue agent à plusieurs reprises sans retaper l'invite.
192 233
193Quand le même `@name` correspond à la fois à un sous-agent et à un référentiel frère, le sous-agent prend la priorité. La forme du premier mot sans `@` s'applique également à n'importe quel nom de sous-agent, donc une invite qui commence par un mot correspondant à l'un de vos noms de sous-agent lance ce sous-agent. Utilisez la forme `@` quand vous voulez être explicite.234Quand le même `@name` correspond à la fois à un sous-agent et à un référentiel frère, le sous-agent prend la priorité. La correspondance du premier mot sans `@` s'applique également, donc une invite qui commence par l'un de vos noms de sous-agent lance ce sous-agent plutôt que de traiter le mot comme du texte brut. Utilisez la forme `@` quand vous voulez être explicite, ou commencez l'invite par un mot différent pour éviter la correspondance.
194 235
195#### Lancer vers un répertoire spécifique236#### Lancer vers un répertoire spécifique
196 237
204 245
205### À partir d'une session246### À partir d'une session
206 247
207Exé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.248Exécutez `/background` ou son alias `/bg` pour déplacer la conversation actuelle dans une session en arrière-plan. Passez une invite comme `/bg run the test suite and fix any failures` pour donner une instruction supplémentaire d'abord.
249
250Mettre en arrière-plan à partir d'une session interactive démarre un processus nouveau qui reprend à partir de la conversation enregistrée, donc l'exécution de sous-agents, de [moniteurs](/fr/tools-reference#monitor-tool), et de commandes en arrière-plan ne se transfèrent pas à celui-ci. Claude vous demande de confirmer avant de mettre en arrière-plan quand l'un d'eux s'exécute. Une fois en arrière-plan, la session peut démarrer de nouveaux sous-agents, moniteurs, et commandes en arrière-plan, et ceux-ci continuent de s'exécuter lors des détachements et réattachements ultérieurs.
208 251
209### À partir du shell252### À partir du shell
210 253
232 275
233### Comment les modifications de fichiers sont isolées276### Comment les modifications de fichiers sont isolées
234 277
235Chaque session en arrière-plan, qu'elle soit démarrée à partir de la vue agent, `/bg`, ou `claude --bg`, démarre dans votre répertoire de travail mais est bloquée d'écrire des fichiers là. Quand la session a besoin de modifier des fichiers, Claude la déplace automatiquement dans une [git worktree](/fr/worktrees) isolée sous `.claude/worktrees/`, afin que les sessions parallèles puissent lire le même checkout mais chacune écrit dans la sienne. Le blocage ne s'applique pas quand la session est déjà à l'intérieur d'une worktree, quand le répertoire de travail n'est pas un référentiel git, ou aux écritures en dehors du répertoire de travail.278Chaque session en arrière-plan, qu'elle soit démarrée à partir de la vue agent, `/bg`, ou `claude --bg`, démarre dans votre répertoire de travail. Avant de modifier des fichiers, Claude déplace la session dans une [git worktree](/fr/worktrees) isolée sous `.claude/worktrees/`, afin que les sessions parallèles puissent lire le même checkout mais chacune écrit dans la sienne. Claude ignore cela quand la session est déjà sous `.claude/worktrees/`, quand le répertoire de travail n'est pas un référentiel git, ou pour les écritures en dehors du répertoire de travail.
279
280En dehors d'un référentiel git, les sessions écrivent dans le répertoire de travail directement et ne sont pas isolées les unes des autres, donc évitez de lancer des sessions parallèles qui modifient les mêmes fichiers.
236 281
237La worktree est supprimée quand vous supprimez la session, donc fusionnez ou poussez les modifications que vous voulez conserver avant de supprimer. Pour trouver le chemin de la worktree d'une session, jetez un œil à la session ou attachez-vous et vérifiez son répertoire de travail.282La worktree est supprimée quand vous supprimez la session, donc fusionnez ou poussez les modifications que vous voulez conserver avant de supprimer. Pour trouver le chemin de la worktree d'une session, jetez un œil à la session ou attachez-vous et vérifiez son répertoire de travail.
238 283
239Pour 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`](/fr/sub-agents#supported-frontmatter-fields) dans son frontmatter.284Pour 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`](/fr/sub-agents#supported-frontmatter-fields) dans son frontmatter.
240 285
286### Définir le modèle
287
288Le nom du modèle affiché dans l'en-tête de la vue agent est la valeur par défaut du lancement. Les nouvelles sessions que vous démarrez à partir de l'entrée utilisent ce modèle, qui est le même paramètre que [`/model`](/fr/model-config) contrôle dans n'importe quelle session.
289
290Chaque session en arrière-plan peut s'exécuter sur un modèle différent. Pour le remplacer pour une session :
291
292* Depuis le shell, passez `--model` avec `claude --bg`.
293* Attachez-vous à une session en cours d'exécution et exécutez `/model` là. Le changement persiste si la session est relancée.
294* Lancez un [sous-agent](/fr/sub-agents) dont le frontmatter définit un champ `model`.
295
241### Mode de permission et paramètres296### Mode de permission et paramètres
242 297
243Une session lancée lit ses [paramètres](/fr/settings) et son [mode de permission](/fr/permissions) à partir du répertoire dans lequel elle s'exécute, de la même manière que si vous aviez démarré `claude` là. Lancer à partir de l'entrée de la vue agent ne transmet pas un mode de permission, donc la session utilise le `defaultMode` à partir des paramètres de ce répertoire ou le `permissionMode` à partir du [frontmatter du sous-agent](/fr/sub-agents#supported-frontmatter-fields) lancé.298Une session lancée lit ses [paramètres](/fr/settings) et son [mode de permission](/fr/permissions) à partir du répertoire dans lequel elle s'exécute, de la même manière que si vous aviez démarré `claude` là. Lancer à partir de l'entrée de la vue agent ne transmet pas un mode de permission, donc la session utilise le `defaultMode` à partir des paramètres de ce répertoire ou le `permissionMode` à partir du [frontmatter du sous-agent lancé](/fr/sub-agents#supported-frontmatter-fields).
244 299
245Pour définir le mode à partir du shell, passez `--permission-mode` avec `claude --bg`. Utiliser `bypassPermissions` ou `auto` de cette manière est refusé jusqu'à ce que vous ayez accepté ce mode en exécutant `claude` avec lui une fois de manière interactive, puisque ces modes permettent à une session que vous ne regardez pas d'agir sans approbation.300Pour définir le mode à partir du shell, passez `--permission-mode` avec `claude --bg`. Utiliser `bypassPermissions` ou `auto` de cette manière est refusé jusqu'à ce que vous ayez accepté ce mode en exécutant `claude` avec lui une fois de manière interactive, puisque ces modes permettent à une session que vous ne regardez pas d'agir sans approbation.
246 301
247## Gérer les sessions depuis le shell302## Gérer les sessions depuis le shell
248 303
249Chaque 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.304Chaque session en arrière-plan a un ID court que vous pouvez utiliser depuis le shell. L'ID est affiché quand vous démarrez une session avec `claude --bg`, et l'ID de chaque session est son nom de répertoire sous `~/.claude/jobs/`. Ces commandes sont utiles pour les scripts ou quand vous ne voulez pas ouvrir la vue agent.
250 305
251| Commande | Objectif |306| Commande | Objectif |
252| :--------------------- | :---------------------------------------------------------- |307| :--------------------- | :-------------------------------------------------------------------------------------------------- |
253| `claude agents` | Ouvrir la vue agent |308| `claude agents` | Ouvrir la vue agent |
254| `claude attach <id>` | S'attacher à une session dans ce terminal |309| `claude attach <id>` | S'attacher à une session dans ce terminal |
255| `claude logs <id>` | Afficher la sortie récente de la session |310| `claude logs <id>` | Afficher la sortie récente de la session |
256| `claude stop <id>` | Arrêter une session. Accepte aussi `claude kill` |311| `claude stop <id>` | Arrêter une session. Accepte aussi `claude kill` |
257| `claude respawn <id>` | Redémarrer une session arrêtée avec sa conversation intacte |312| `claude respawn <id>` | Redémarrer une session arrêtée avec sa conversation intacte |
258| `claude respawn --all` | Redémarrer chaque session arrêtée |313| `claude respawn --all` | Redémarrer chaque session arrêtée |
259| `claude rm <id>` | Supprimer une session de la liste |314| `claude rm <id>` | Supprimer une session de la liste. Nettoie sa worktree s'il n'y a pas de modifications non validées |
260 315
261## Comment les sessions en arrière-plan sont hébergées316## Comment les sessions en arrière-plan sont hébergées
262 317
263Les 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.318Chaque session listée dans la vue agent est considérée comme une session en arrière-plan, que vous y soyez actuellement attaché ou non. En contraste, une session démarrée en exécutant `claude` directement est liée à ce terminal et se termine quand il se ferme, sauf si vous [l'envoyez en arrière-plan](#from-inside-a-session).
319
320### Le processus superviseur
321
322Les 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. Le superviseur 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.
323
324Le 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.
325
326Chaque session en arrière-plan est son propre processus Claude Code, géré par le superviseur plutôt que lié à votre terminal. Une session qui fonctionne activement, attend votre entrée, ou a un terminal attaché garde son processus en cours d'exécution.
264 327
265Chaque 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.328Une 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 en avez besoin.
266 329
267Le superviseur regarde le binaire Claude Code installé sur le disque et redémarre dans la nouvelle version après que le [mise à jour automatique](/fr/setup#auto-updates) 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.330Le superviseur regarde le binaire Claude Code installé sur le disque et redémarre dans la nouvelle version après que l'[auto-updater](/fr/setup#auto-updates) régulier 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.
331
332### Où l'état est stocké
268 333
269L'état de la session est stocké sous votre répertoire de configuration Claude Code. Si vous définissez [`CLAUDE_CONFIG_DIR`](/fr/env-vars), le superviseur utilise ce répertoire à la place de `~/.claude` et s'exécute comme une instance séparée avec ses propres sessions.334L'état de la session est stocké sous votre répertoire de configuration Claude Code. Si vous définissez [`CLAUDE_CONFIG_DIR`](/fr/env-vars), le superviseur utilise ce répertoire à la place de `~/.claude` et s'exécute comme une instance séparée avec ses propres sessions.
270 335
274| `~/.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 |339| `~/.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 |
275| `~/.claude/jobs/<id>/state.json` | État par session affiché dans la vue agent |340| `~/.claude/jobs/<id>/state.json` | État par session affiché dans la vue agent |
276 341
342### Désactiver la vue agent
343
277Pour désactiver complètement les agents en arrière-plan et la vue agent, définissez le paramètre `disableAgentView` [setting](/fr/settings) à `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](/fr/permissions#managed-settings).344Pour désactiver complètement les agents en arrière-plan et la vue agent, définissez le paramètre `disableAgentView` [setting](/fr/settings) à `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](/fr/permissions#managed-settings).
278 345
279## Dépannage346## Dépannage
280 347
348### `claude agents` affiche les sous-agents au lieu d'ouvrir la vue agent
349
350Si `claude agents` affiche un nombre suivi de vos sous-agents configurés puis se ferme, la vue agent n'est pas disponible dans votre environnement. Les versions antérieures n'ouvraient pas la vue agent dans tous les environnements, notamment lors de la connexion via Bedrock, Vertex AI ou Foundry. Exécutez `claude update` pour installer la dernière version.
351
352Si la vue agent ne s'ouvre toujours pas après la mise à jour, vérifiez si elle a été [désactivée](#turn-off-agent-view) par un paramètre ou une variable d'environnement.
353
281### La vue agent s'ouvre sans sessions354### La vue agent s'ouvre sans sessions
282 355
283La 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`.356La 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`.
284 357
358### Impossible d'ouvrir les agents car des tâches en arrière-plan s'exécutent
359
360Si appuyer sur `←` pour mettre la session actuelle en arrière-plan affiche `Cannot open agents — N background task(s) running`, la session a du travail en cours comme un sous-agent, un workflow ou une commande shell en arrière-plan, et le raccourci n'abandonnera pas silencieusement. Exécutez `/tasks` pour voir ce qui s'exécute, puis `/bg` pour confirmer l'abandon. Voir [Depuis l'intérieur d'une session](#from-inside-a-session) pour savoir ce qui se transfère et ce qui ne se transfère pas quand vous mettez en arrière-plan.
361
362### Invite rejetée comme trop courte
363
364L'entrée de dispatch attend une description de tâche, pas une ouverture conversationnelle. Une invite plus courte que quatre caractères est rejetée avec un indice `Too short` pour qu'une frappe accidentelle ne démarre pas une session. Décrivez ce que vous voulez que la session fasse, par exemple `investigate the flaky checkout test`.
365
285### Les sessions s'affichent comme arrêtées après le réveil de votre machine366### Les sessions s'affichent comme arrêtées après le réveil de votre machine
286 367
287Les 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`.368Les 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`.
296 377
297## Limitations378## Limitations
298 379
299La vue agent est un aperçu de recherche. Les limitations actuelles à connaître :380La vue agent est en aperçu de recherche avec les limitations suivantes :
300 381
301* **Les limites de débit s'appliquent** : les sessions en arrière-plan consomment 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 environ dix fois plus vite qu'en exécuter un seul.382* **Les limites de débit s'appliquent** : les sessions en arrière-plan consomment 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 environ dix fois plus vite qu'en exécuter un seul.
302* **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.383* **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.
303* **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.384* **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.
304 385
305## Prochaines étapes386## Ressources connexes
306 387
307Maintenant que vous comprenez la vue agent, explorez ces fonctionnalités connexes :388Pour d'autres façons d'exécuter Claude en parallèle, consultez :
308 389
309* [Exécuter les agents en parallèle](/fr/agents) : comparez la vue agent avec les sous-agents, les équipes d'agents, et les worktrees390* [Exécuter les agents en parallèle](/fr/agents) : comparez la vue agent avec les sous-agents, les équipes d'agents, et les worktrees
310* [Sous-agents](/fr/sub-agents) : définissez des configurations d'agent réutilisables avec des invites personnalisées, des outils, et l'isolation
311* [Équipes d'agents](/fr/agent-teams) : coordonnez plusieurs sessions qui se messagent mutuellement391* [Équipes d'agents](/fr/agent-teams) : coordonnez plusieurs sessions qui se messagent mutuellement
312* [Claude Code sur le web](/fr/claude-code-on-the-web) : exécutez les sessions dans un environnement cloud géré au lieu de localement392* [Claude Code sur le web](/fr/claude-code-on-the-web) : exécutez les sessions dans un environnement cloud géré au lieu de localement
