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. 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.

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.

Utilisez 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.

Quand vous voulez travailler plus directement dans la session d'un agent, attachez-vous à la ligne pour entrer dans la conversation complète.

Pour comparer la vue agent avec les sous-agents, les équipes d'agents et les worktrees, consultez Exécuter les agents en parallèle. La vue agent exécute les sessions sur votre machine et vous lancez chacune d'elles ; pour que Claude démarre et suive les sessions parallèles dans le cloud à partir d'une seule conversation, consultez Projets.

Démarrage rapide

Cette 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.

Ouvrir la vue agent

Depuis votre shell, exécutez :

claude agents

Si vous n'avez pas encore accepté la boîte de dialogue de confiance de l'espace de travail pour le répertoire, Claude Code l'affiche avant que la vue agent ne s'ouvre, la même boîte de dialogue que claude affiche. Acceptez pour enregistrer la confiance pour l'espace de travail et continuer. Si vous refusez, Claude Code se ferme sans ouvrir la vue agent.

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 pour revenir à votre shell ; si vous avez ouvert la vue agent en mettant une session en arrière-plan avec ←, Esc revient à cette conversation à la place. Vos sessions continuent de s'exécuter pendant que vous êtes absent et réapparaissent la prochaine fois que vous ouvrez la vue agent.

Dispatcher une session

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. Le mode de permission dans lequel elle démarre dépend de la façon dont vous avez ouvert la vue agent.

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.

Chaque session utilise votre quota d'abonnement indépendamment, consultez donc Limitations avant de dispatcher plusieurs à la fois.

Jeter un coup d'œil et répondre

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.

S'attacher et se 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 en tant que session Claude Code interactive complète. Appuyez sur ← sur une invite vide pour vous détacher et revenir au tableau.

Amener une session existante

Cette étape nécessite une session en cours d'exécution. Si vous avez suivi les étapes précédentes, vous n'en avez pas ouverte dans ce terminal, ouvrez donc une session claude régulière dans un autre terminal et envoyez-lui d'abord un message.

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. Dans une session nouvelle sans messages encore, /bg vous demande d'envoyer d'abord un message, tandis que ← fonctionne immédiatement. 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.

Vous 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.

À l'intérieur d'une session claude régulière, l'indice ← du pied de page de l'invite compte les agents en arrière-plan qui attendent votre intervention, comme ← 2 agents, et revient à ← for agents quand aucun n'a besoin d'entrée. Les comptages supérieurs à 99 s'affichent comme 99+. Le comptage se rafraîchit environ toutes les dix secondes lorsque le terminal est actif et immédiatement quand le focus revient. Il change brièvement de couleur quand il se déplace et quand un agent se termine, et quand une session en arrière-plan se termine alors qu'aucune n'a besoin de votre intervention, elle affiche brièvement le nombre complété, comme ← 2 done. Les deux flashs sont désactivés quand le paramètre prefersReducedMotion est activé, et l'indice est masqué en mode lecteur d'écran.

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 vous attendent en haut. Chaque ligne affiche le nom de la session, l'activité actuelle et son ancienneté, comptée à partir de la création de la session ; l'ancienneté d'une session terminée se fige à la durée d'exécution.

Le nom est teinté de la couleur définie par /color dans cette session, y compris lorsque vous mettez une session en arrière-plan avec ← ou /background.

Par défaut, la 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 un worktree différent apparaissent toutes les deux ici, quel que soit le répertoire à partir duquel vous avez ouvert la vue agent. Pour réduire la liste à un projet, passez --cwd :

claude agents --cwd ~/projects/my-app

Cela affiche uniquement les sessions démarrées sous ce répertoire. Elle répertorie toujours une session qui a déménagé dans un worktree sous ~/projects/my-app/.claude/worktrees/.

Les sessions interactives que vous avez ouvertes dans d'autres terminaux n'apparaissent que lorsque vous les mettez en arrière-plan. Les sous-agents et les coéquipiers qu'une session génère ne sont pas répertoriés comme des lignes distinctes.

Pinned
  ✽ clawd walk cycle          Drawing the walk-cycle sprite frames          3m

Ready for review
  ∙ jump physics              Opened PR with collision fix                 #2048  2h

Needs input
  ✻ power-up design           double jump or wall climb?                    1m

Working
  ✽ collision detection       Adding swept-AABB checks to CollisionSystem   2m
  ✢ playtest level 3          run 12 · all checkpoints cleared           in 4m

Completed
  ✻ title screen              result: menu, options, and credits done       9m
  ∙ sound effects             result: 14 SFX exported to assets/audio       4h
  … 6 more

Lire l'état de la session

Chaque ligne commence par une icône dont la couleur et l'animation indiquent l'état de la session :

État	L'icône s'affiche comme	Ce que cela signifie
Working	Animée	Claude exécute activement des outils ou génère une réponse
Needs input	Jaune	Claude attend quelque chose que seul vous pouvez fournir : une réponse à une question, une décision d'autorisation, ou une autre invite que seul vous pouvez répondre, comme une invite sandbox pour autoriser un hôte réseau ou la demande d'entrée d'un serveur MCP. Une commande qui nécessite un terminal attaché, comme `/install-github-app` ou la liste des paramètres `/mcp`, maintient également une session sans surveillance ici
Idle	Estompée	La session n'a rien à faire et est prête pour votre prochaine invite
Completed	Verte	La tâche s'est terminée avec succès
Failed	Rouge	La tâche s'est terminée avec une erreur
Stopped	Grise	Vous avez arrêté la session avec `Ctrl+X` ou `claude stop`, son processus a été terminé de l'extérieur de Claude Code, ou elle s'est terminée alors que le service en arrière-plan était désactivé

Séparément, la forme de l'icône indique si le processus sous-jacent est en cours d'exécution :

Forme	Ce que cela signifie
`✻` ou `✽` animée	Le processus de session est actif et répond immédiatement
`∙`	Le processus a quitté. Vous pouvez toujours jeter un coup d'œil à la ligne, et lorsque vous répondez ou attachez, Claude redémarre à partir de là où il s'était arrêté
`✢`	Une session `/loop` en sommeil entre les itérations. La ligne affiche son nombre d'exécutions et un compte à rebours

L'étiquette #N ou !N qui peut apparaître au bord droit d'une ligne est un lien vers la demande de tirage ou demande de fusion de la session, et non une partie de l'icône d'état.

Le titre de l'onglet du terminal affiche le nombre d'entrées en attente pendant que la vue agent est ouverte : 2 awaiting input · claude agents lorsque les sessions ont besoin d'entrée, ou claude agents lorsqu'aucune n'en a besoin.

Pour lire l'état de la session à partir d'un script ou d'un autre programme, utilisez claude agents --json plutôt que les fichiers sous ~/.claude/jobs/.

Pendant que la vue agent est ouverte, Claude Code envoie également une notification via votre canal de notification de terminal configuré lorsqu'une session en arrière-plan local commence à avoir besoin de votre entrée, se termine ou échoue. Les sessions qui s'exécutent selon un calendrier, comme les sessions /loop, ne notifient que lorsqu'elles ont besoin de votre entrée. Les notifications utilisent le même paramètre preferredNotifChannel que le reste de Claude Code et déclenchent le hook Notification avec le type agent_needs_input ou agent_completed.

Les sessions en arrière-plan n'ont besoin d'aucun terminal ouvert pour continuer à fonctionner. Un processus superviseur distinct les exécute, vous pouvez donc fermer la vue agent, fermer votre shell ou démarrer une nouvelle session interactive et votre travail envoyé continue.

L'état de la session persiste sur le disque via les mises à jour automatiques et les redémarrages du superviseur. Les sessions sont également préservées lorsque votre machine se met en veille. Leurs processus reprennent au réveil et le superviseur se reconnecte à eux au lieu de traiter l'écart de temps comme inactif. L'arrêt arrête toujours les sessions en cours d'exécution ; voir Sessions affichées comme échouées ou arrêtées après l'arrêt pour savoir comment les récupérer.

Une session qui était en pleine réponse lorsque la machine s'est mise en veille peut revenir sans réponse. Lorsque vous ouvrez une session qui a cessé de répondre, le superviseur redémarre son processus et la session continue la réponse interrompue à partir de là où elle s'était arrêtée.

Résumés de lignes

Le résumé d'une ligne est généré par un modèle de classe Haiku afin que la ligne puisse vous dire ce que la session fait, ce dont elle a besoin ou ce qu'elle a produit sans ouvrir la transcription. Pendant qu'une session travaille activement, le texte de la ligne se met à jour au maximum une fois toutes les 15 secondes à partir de la sortie récente de la session sans envoyer de demande de modèle, et le modèle écrit un résumé frais à la fin de chaque tour.

Une ligne de travail affiche ce que la session dit qu'elle fait, et une ligne bloquée affiche la question qu'elle pose. Pendant un long tour, le modèle réécrit également le résumé toutes les quelques minutes afin qu'une ligne occupée ne continue pas à afficher un résumé obsolète. Le texte du résumé remplit la largeur restante de la ligne ; ouvrez le panneau d'aperçu pour lire une phrase que le bord du terminal coupe.

Lorsque la liste est groupée par répertoire, le résumé s'ouvre avec l'état de la session en tant que mot coloré, comme Needs input · double jump or wall climb?. Dans le groupement d'état par défaut, l'en-tête du groupe nomme déjà l'état, la ligne affiche donc uniquement le résumé.

Le résumé de fin de tour et chaque réécriture à mi-tour sont 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. Les mises à jour de 15 secondes entre les réécritures de modèle réutilisent la sortie de la session elle-même et n'envoient pas de demande. Sur un fournisseur tiers ou une passerelle sans modèle de classe Haiku configuré, la demande utilise le modèle principal de la session à la place ; définissez ANTHROPIC_DEFAULT_HAIKU_MODEL pour en choisir un.

État de la demande de tirage

Lorsqu'une session ouvre une demande de tirage, Claude Code ajoute une étiquette au bord droit de la ligne, liée à la demande de tirage :

Claude Code écrit l'étiquette comme #1234 pour une demande de tirage et comme !1234 pour une demande de fusion GitLab.
Claude Code émet le lien même lorsqu'il ne peut pas détecter la prise en charge des hyperliens, par exemple sur SSH ou tmux. Définissez FORCE_HYPERLINK=0 pour afficher l'étiquette en tant que texte brut.
Après avoir envoyé un suivi à la session, Claude Code conserve l'étiquette tandis que la ligne revient à la progression en direct.

Une session qui travaille sur une demande de tirage existante y est liée de la même manière. Claude Code trouve la demande de tirage différemment selon la commande que Claude exécute :

Lorsque Claude modifie, commente, ferme ou marque une demande de tirage comme prête avec gh, Claude Code lie la demande de tirage que la sortie de la commande elle-même nomme. Une commande gh dont la sortie capturée ne nomme aucune demande de tirage ne crée pas de lien ; gh pr merge est le cas courant, car il imprime son résultat uniquement sur un terminal interactif.
Lorsque Claude extrait une demande de tirage avec gh pr checkout ou pousse vers une branche, Claude Code recherche la branche avec gh pr view et lie sa demande de tirage ouverte.
La demande de tirage n'a pas besoin d'exister encore lorsque Claude pousse : Claude Code réessaie la recherche de branche après jusqu'à cinq commandes git, gh, glab ou curl ultérieures exécutées dans le même répertoire, afin qu'une demande de tirage créée après le push, y compris celle que Claude crée via l'API REST GitHub, se lie lorsqu'une nouvelle tentative la trouve.

Lorsqu'une session est liée à plus d'une demande de tirage, l'étiquette affiche un nombre à la place, comme 3 PRs, colorée par la demande de tirage ouverte qui a le plus besoin d'attention. Ouvrez le panneau d'aperçu pour les voir toutes.

Le numéro de la demande de tirage est coloré selon son état :

Couleur	État de la demande de tirage
Jaune	En attente de vérifications ou d'examen, ou les vérifications ont échoué
Vert	Les vérifications ont réussi et aucun examen ne bloque
Violet	Fusionné
Gris	Brouillon ou fermé

Pour une tâche qui se termine par une demande de tirage, vérifiez cette étiquette pour le résultat : examinez et fusionnez la demande de tirage lorsque son numéro devient vert.

Aperçu et réponse

Appuyez sur Space sur une ligne sélectionnée pour ouvrir le panneau d'aperçu. Il s'ouvre avec la phrase que la ligne tronque au bord du terminal, et quelle phrase c'est dépend de l'état de la session :

Une session qui vous attend : la question exacte qu'elle pose, au-dessus de l'entrée de réponse
Une session terminée : son résultat
Une session de travail : sa phrase d'état complète

Toutes les demandes de tirage liées à la session sont répertoriées ensuite. Pour une session qui vous attend, une ligne comme waiting 3m en dessous d'elles montre depuis combien de temps elle attend, et c'est la seule fois affichée dans le panneau. L'ancienneté au bord droit de la ligne est un nombre différent : elle compte à partir du moment où la session a démarré.

La plupart du temps, le panneau d'aperçu suffit et vous n'avez pas besoin d'ouvrir la transcription complète.

Tapez une réponse dans le panneau d'aperçu et appuyez sur Enter pour l'envoyer à cette session. Lorsque la session pose une question avec des choix prédéfinis, le panneau d'aperçu les affiche sous forme de liste numérotée et vous pouvez appuyer sur une touche numérique pour en choisir une. Une invite de permission s'affiche sous forme de texte décrivant ce que la session souhaite exécuter, sans options numérotées. Tapez une réponse pour y répondre, ou attachez-vous pour répondre avec l'invite standard. 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.

Lorsqu'un hook PermissionRequest ou PreToolUse retourne une sortie que Claude Code ne peut pas valider pour l'appel que la session demande, la ligne affiche l'événement du hook et hook output invalid: avec l'erreur de validation avant le texte de la demande en attente. Pour un hook qui échoue d'une autre manière, la ligne dit que le hook a échoué. La session attend toujours la même demande.

Une réponse qui ne peut pas être livrée, parce que le service en arrière-plan est inaccessible ou que l'envoi échoue, est enregistrée et envoyée à la session comme sa prochaine invite lorsque son processus redémarre, et le message d'erreur dit que la réponse a été enregistrée. Une réponse préfixée avec ! n'est pas enregistrée, car le texte enregistré atteindrait la session en tant qu'invite simple plutôt que d'exécuter en tant que commande Bash.

Avec la dictée vocale activée, maintenez ou appuyez sur votre touche push-to-talk pendant que l'entrée de réponse est concentrée pour dicter une réponse au lieu de la taper. La même chose fonctionne dans l'entrée de dispatch en bas de la vue agent.

Utilisez ↑ et ↓ pour jeter un coup d'œil aux sessions adjacentes sans fermer le panneau, ou → pour vous attacher.

Attacher à une session

Appuyez sur Enter ou → sur une ligne sélectionnée pour vous attacher. La vue agent est remplacée par la session interactive complète. Lorsque vous vous attachez, Claude publie 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 : les commandes, les raccourcis clavier et les fonctionnalités fonctionnent tous, à l'exception des cas ci-dessous.

Pendant que vous êtes attaché, /install-github-app et la liste des paramètres /mcp fonctionnent normalement, car un humain au terminal peut compléter leurs dialogues. Lorsque personne n'est attaché, ces commandes ne peuvent pas ouvrir leurs dialogues, la session apparaît donc sous Needs input dans la vue agent avec une ligne comme open this session to manage MCP servers, et la réponse de la transcription dit la même chose. Attachez-vous et exécutez à nouveau la commande pour continuer ; la ligne needs-input s'efface lorsque vous vous attachez. /mcp reconnect <server>, /mcp enable et /mcp disable fonctionnent sans s'attacher de toute façon.

Les sessions attachées s'affichent toujours en mode plein écran, quel que soit votre paramètre tui, car une session en arrière-plan n'a pas de défilement de terminal pour ajouter. Faites défiler avec PgUp, PgDn ou la molette de la souris, et appuyez sur Ctrl+O pour le mode transcription. Le défilement natif de votre terminal et le mode copie tmux affichent uniquement la fenêtre d'affichage actuelle, comme lorsque vous exécutez n'importe quelle application plein écran.

Appuyez sur ← sur une invite vide, ou exécutez /exit, pour vous détacher et revenir à la vue agent, que vous ayez ouvert la session à partir de la vue agent ou avec claude attach <id> à partir de votre shell.

← se détache également pendant que la superposition /btw est ouverte. Nécessite Claude Code v2.1.257 ou ultérieur. Une question latérale qui répond toujours continue de s'exécuter pendant que vous êtes absent. La prochaine fois que vous vous attachez, la superposition se rouvre avec elle, ou avec sa réponse.

Sur Windows, si vous appuyez sur ← dans environ une demi-seconde après vous être attaché, Claude Code affiche Ambiguous ←, press again to detach, car dans cette fenêtre le terminal peut redélivrer une pression d'avant votre attachement. Appuyez sur ← à nouveau pour vous détacher.

Ctrl+Z se détache également mais revient à où vous avez commencé à la place : la vue agent si vous vous êtes attaché à partir de là, ou votre shell si vous avez exécuté claude attach. Utilisez Ctrl+Z lorsqu'un dialogue a le focus et ne répond pas à ←.

Ctrl+C conserve son comportement d'interruption standard pendant l'attachement : il annule une réponse en cours d'exécution ou une commande shell ! plutôt que de se détacher. Appuyer sur Ctrl+C deux fois sur une invite vide se détache, comme dans n'importe quelle session.

Le détachement n'arrête jamais une session en arrière-plan : ←, Ctrl+Z, /exit et double Ctrl+C ou double Ctrl+D la laissent tous en cours d'exécution. Pour terminer une session de l'intérieur, exécutez /stop.

Basculer les sessions sans quitter le terminal

Dans une session s'exécutant au premier plan, une que vous avez démarrée dans le terminal plutôt que de vous y attacher à partir de la vue agent, appuyer sur ← sur une invite vide la met en arrière-plan et ouvre la vue agent avec cette ligne sélectionnée, afin que vous puissiez basculer les sessions sans quitter le terminal. Le même appui unique détache une session attachée.

Si vous appuyez sur ← juste après avoir supprimé le dernier texte de l'invite ou vous être déplacé dans l'historique des invites, Claude Code vous demande de confirmer : le premier appui affiche Press ← again to open agents, ou Press ← again to go back to agents dans une session attachée, et le deuxième appui bascule.

Lorsque ← met une session au premier plan en arrière-plan, la vue agent affiche Your conversation moved to the background au-dessus de la liste, avec la ligne de cette session déjà sélectionnée. À partir de là :

Appuyez sur Enter pour rouvrir la conversation.
Appuyez sur Esc pour annuler le basculement et revenir à la conversation. Si Esc affiche Still starting — try again in a moment, la session en arrière-plan n'est pas encore prête, appuyez donc sur Esc à nouveau dans un moment.
Appuyez sur Ctrl+C deux fois pour quitter vers votre shell.

Lorsque Claude Code ne peut pas rouvrir la conversation, il quitte et imprime une commande claude --resume qui la reprend.

La liste des tâches de Claude se déplace vers la session en arrière-plan avec la conversation, afin que la liste de contrôle soit intacte lorsque vous reveniez à cette ligne.

La ligne sur laquelle vous avez appuyé sur ← conserve également un nom gras et non estompé après avoir déplacé la sélection avec les touches fléchées ou la souris, afin que vous puissiez dire de quelle session vous venez.

Si un outil s'exécute lorsque vous appuyez sur ←, Claude Code attend environ dix secondes qu'il se termine avant de mettre en arrière-plan, et Claude continue la réponse dans la session en arrière-plan. Appuyez sur ← à nouveau pour mettre en arrière-plan immédiatement au lieu d'attendre. Lorsque le travail en vol ne peut pas être transféré à la session en arrière-plan, Claude Code affiche d'abord le dialogue Background this session?, comme avec /background.

La limite de dix secondes ne s'applique pas pendant que les sous-agents au premier plan que Claude a démarrés dans la conversation s'exécutent toujours. Claude Code continue d'attendre afin que leur travail soit transféré, et affiche un avis Still backgrounding after the current tool pendant qu'il attend. Appuyez sur ← à nouveau pour mettre en arrière-plan sans attendre, ce qui redémarre ces sous-agents à partir du début. Claude Code n'attend pas les sous-agents qu'un flux de travail dynamique exécute. Lorsqu'un flux de travail a des sous-agents en cours d'exécution, Claude Code affiche le dialogue Background this session? à la place.

Claude Code ne met pas la session en arrière-plan pendant que vous avez du texte non envoyé dans l'entrée d'invite, car le texte reste dans la boîte d'entrée de votre terminal et ne se déplacerait pas vers la session en arrière-plan. Si vous tapez dans l'entrée pendant que Claude Code attend de mettre la session en arrière-plan, il annule le basculement avec Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.

Appuyer sur ← crée la ligne de la session même lorsque la conversation n'a pas encore de messages, afin que → revienne toujours à elle.

Vous pouvez désactiver ce raccourci avec le paramètre leftArrowOpensAgents dans /config.

Organiser la liste

La vue agent groupe les sessions afin que celles qui ont besoin d'entrée soient en haut, avec Ready for review et Needs input au-dessus de Working et Completed. Ces noms de groupe ne correspondent pas un-à-un aux états ci-dessus : une session se déplace vers Ready for review lorsqu'elle a une demande de tirage ouverte, et Completed 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.

Dans un groupe :

Appuyez sur Ctrl+T pour épingler une session en haut et garder son processus en cours d'exécution pendant l'inactivité
Appuyez sur Shift+↑ ou Shift+↓ pour réorganiser les sessions
Appuyez sur Ctrl+R pour renommer une session
Appuyez sur Enter sur un en-tête de groupe pour le réduire

Pour 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.

Le deuxième appui supprime la session même lorsque la tentative d'arrêt échoue, par exemple parce que le service en arrière-plan ne répond pas : la confirmation reste active pendant deux secondes supplémentaires, et la suppression termine le processus de la session lui-même. Appuyez sur Esc pour rejeter la confirmation sans supprimer.

Sauf dans les cas conservés couverts dans Ce que la suppression d'une session supprime, la suppression supprime la session de la liste, et un worktree que Claude a créé pour elle est supprimé, conservé ou laissé en place selon la façon dont vous supprimez et ce que le worktree contient. La transcription de la conversation reste toujours sur votre machine locale, disponible via claude --resume.

Pour ramener une session sur Claude Code v2.1.212 ou ultérieur, tapez /resume dans l'entrée de dispatch. Un sélecteur s'ouvre avec les sessions passées du référentiel à partir duquel vous avez ouvert la vue agent, les plus récentes en premier, y compris les sessions que vous avez supprimées de la liste ; les sessions qui ont déjà une ligne ne sont pas répertoriées. ↑/↓ déplacent la sélection, Enter reprend la session sélectionnée en tant que session en arrière-plan afin qu'elle se réjoigne la liste en tant que ligne, et Esc ferme le sélecteur.

Le sélecteur s'ouvre uniquement pour un /resume nu. Une reprise ciblée, scoped ou restreinte ne peut pas être servie par le sélecteur, la vue agent affiche donc l'indice attach to a session to run it à la place lorsque :

/resume nomme un id ou un terme de recherche
la vue est scoped avec --cwd
la vue a été démarrée avec --safe-mode
la vue a été ouverte avec un drapeau comme --permission-mode ou --settings

Les sessions terminées qui ne rentrent pas à l'écran se replient dans une ligne … N more. Les défaillances et les sessions avec une demande de tirage ouverte restent toujours visibles. Le groupe Completed remplit l'espace vertical laissé après les groupes en direct, et sur un terminal court, l'en-tête se compacte en une seule ligne de résumé afin que les sessions qui travaillent ou ont besoin d'entrée restent visibles.

Filtrer les sessions

Tapez dans l'entrée de dispatch pour filtrer au lieu de dispatcher :

Filtre	Affiche
`a:<name>`	Sessions exécutant l'agent nommé
`s:<state>`	Sessions dans l'état donné, comme `s:working`. Accepte également `s:blocked` pour tout ce qui vous attend
`#<number>` ou une URL de demande de tirage ou de fusion	La session travaillant sur cette demande de tirage ou de fusion
N'importe quelle autre URL	La session dont la première invite contenait cette URL

Raccourcis clavier

Appuyez sur ? dans la vue agent pour voir chaque raccourci en contexte. Le tableau ci-dessous les résume.

Raccourci	Action
`↑` / `↓`	Se déplacer entre les lignes
`Enter`	Attacher à la session sélectionnée, ou dispatcher s'il y a du texte dans l'entrée
`Space`	Ouvrir ou fermer le panneau d'aperçu pour la session sélectionnée
`Shift+Enter`	Insérer une nouvelle ligne dans l'entrée de dispatch, comme dans l'invite principale
`Ctrl+Enter`	Dispatcher et attacher immédiatement, dans les terminaux où la superposition `?` répertorie `ctrl+enter to start and open`
`→`	Attacher à la session sélectionnée
`Alt+1`..`Alt+9`	Attacher à la session 1–9 dans le répertoire de la session concentrée
`Tab`	Sur une entrée vide, parcourir tous les sous-agents. Sinon 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 dispatch dans votre `$VISUAL` ou `$EDITOR`
`Ctrl+J`	Insérer une nouvelle ligne dans l'entrée de dispatch
`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. Lorsque vous avez ouvert la vue agent en mettant votre session en arrière-plan avec `←`, le `Esc` final revient à cette conversation au lieu de quitter. Avec le mode éditeur vim activé, appuyer sur `Esc` dans l'entrée bascule du mode INSERT au mode NORMAL et conserve votre texte, comme dans l'invite principale
`Ctrl+C`	Effacer l'entrée ; appuyez deux fois pour quitter
`?`	Afficher tous les raccourcis

Ctrl+S, Ctrl+T et Ctrl+G suivent votre keybindings.json. Reliez ou déliez Ctrl+S et Ctrl+T avec les actions agents:switchView et agents:togglePin dans le contexte Agents, et Ctrl+G via la liaison chat:externalEditor du contexte Chat. Les autres raccourcis du tableau ne peuvent pas être reliés.

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 ; renommez-la plus tard avec Ctrl+R.

Le nom automatique est un court libellé écrit par un modèle de classe Haiku. Un nom que la session obtient plus tard apparaît également sur sa ligne, y compris le titre généré que la session obtient quand vous acceptez un plan dans cette session.

Collez une image dans l'invite pour inclure une capture d'écran ou un diagramme avec la tâche.

Le texte collé plus long que 800 caractères ou plus de trois lignes s'effondre en un espace réservé [Pasted text #N] pour que l'entrée reste sur une ligne ; le texte complet est envoyé quand vous lancez. Pour examiner ou modifier le texte effondré avant de lancer, collez le même texte à nouveau et l'espace réservé se développe dans l'entrée.

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 pour exécuter la session là. Voir Lancer vers un répertoire spécifique pour savoir quels référentiels sont listés
`/<command>`	Suggérez des skills et des commandes à lancer comme l'invite
`! <command>`	Exécutez une commande shell comme une tâche en arrière-plan au lieu de démarrer une session Claude. La tâche apparaît comme une ligne à laquelle vous pouvez vous attacher, regarder et vous détacher
`#<number>` ou une URL de pull request ou merge request	Si une session travaille déjà sur cette pull request ou merge request, Claude Code sélectionne sa ligne au lieu de lancer une nouvelle session

Un petit ensemble de commandes s'exécutent dans la vue agent elle-même au lieu de lancer :

/exit et /quit ferment la vue agent
/logout vous déconnecte
/model définit le modèle de lancement
/login ouvre la boîte de dialogue de connexion pour que vous puissiez vous connecter à nouveau sans vous attacher à une session
Un /resume nu, ou son alias /continue, ouvre un sélecteur des sessions passées du référentiel pour en ramener une comme une session en arrière-plan. Nécessite Claude Code v2.1.212 ou ultérieur

Les skills, vos propres commandes, et les built-ins qui développent les invites comme /init sont envoyés à une nouvelle session en arrière-plan comme leur première invite. Les autres commandes built-in affichent plutôt un indice attach to a session to run it. Tout ce que vous avez tapé reste dans l'entrée à côté de l'indice pour que vous puissiez le modifier.

Empaqueter une tâche récurrente comme un skill vous permet de démarrer le même workflow à partir de la vue agent à plusieurs reprises sans retaper l'invite.

Quand 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.

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, utilisez l'un de ceux-ci :

Ouvrez claude agents dans ce répertoire.
Ouvrez claude agents dans un répertoire parent et mentionnez un référentiel enfant avec @<repo> dans l'invite. Taper @ liste ces cibles :
- Les référentiels Git un niveau en dessous du répertoire de lancement
- Les git worktrees enregistrés du référentiel à partir duquel vous avez lancé qui vivent à l'intérieur de son arborescence de répertoires, comme ceux que Claude crée sous .claude/worktrees/, étiquetés avec leur branche extraite. Les worktrees ajoutés en dehors du référentiel, comme avec git worktree add ../feature, ne sont pas listés
- Tout répertoire qui a déjà une session dans la liste
Un répertoire dont le nom contient un espace n'est pas listé.
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 lancement envoie l'invite au répertoire de la ligne sélectionnée, vous pouvez donc sélectionner un groupe et lancer dedans sans retaper le chemin.

À partir d'une session

Deux commandes déplacent le travail de la session dans laquelle vous êtes vers l'arrière-plan : /background envoie la conversation actuelle là et libère votre terminal, et /fork envoie une copie tandis que vous continuez à travailler où vous êtes.

Envoyer la session en arrière-plan

Exé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. Si Claude répond quand vous exécutez /bg, la réponse continue dans la session en arrière-plan.

Quitter une session qui a encore du travail en arrière-plan en cours d'exécution, comme des sous-agents, des commandes shell en arrière-plan, des workflows, ou des monitors, affiche une boîte de dialogue Background work is running au lieu de quitter immédiatement. Choisissez Move to background and exit pour mettre la session en arrière-plan de la même manière que /background le fait et revenir à votre shell. L'option n'est pas affichée quand la vue agent est désactivée.

Si une session en arrière-plan sur la liste a déjà le nom de la conversation, Claude Code numérote le nom de la nouvelle ligne, comme my-session (2), et laisse le nom de la ligne existante seul. Pour renommer la nouvelle ligne, sélectionnez-la dans la vue agent et appuyez sur Ctrl+R.

Copier la session avec /fork

Exécutez /fork pour copier la conversation actuelle dans une nouvelle session en arrière-plan tandis que l'original continue de s'exécuter. La copie commence avec tout ce qui se trouve dans la conversation jusqu'à ce point ; voir les puces ci-dessous pour savoir où la copie s'exécute. Elle porte également le modèle, le mode de permission, le niveau d'effort, et tous les répertoires ou les autorisations « ne pas demander à nouveau » que vous avez ajoutés pendant la session. La copie apparaît comme sa propre ligne dans la vue agent.

Après le fork, les deux conversations sont indépendantes : rien de ce que la copie fait n'entre dans la conversation originale de son propre chef, bien que dans les sessions où la messagerie inter-sessions est activée, Claude de l'une ou l'autre session peut explicitement envoyer un message à l'autre.

Copier la session nécessite Claude Code v2.1.212 ou ultérieur ; sur v2.1.161 à v2.1.211, /fork démarre un sous-agent forké à la place, qui est maintenant /subtask. Quand la vue agent est désactivée, /fork conserve le comportement du sous-agent forké et /subtask n'est pas disponible.

Passez une invite comme /fork open a draft pull request with the work so far et la copie commence à travailler dessus immédiatement. Sans une invite, la copie attend sa première instruction : sélectionnez sa ligne dans claude agents et appuyez sur Espace pour en envoyer une, ou exécutez claude attach <id>. La ligne sélectionnée affiche space to send it a prompt tandis qu'elle attend.

La confirmation /fork est une ligne montrant l'état de la copie, comme session running, le nom de sa ligne de vue agent, et son ID de session pour claude attach. Cliquez sur le nom pour basculer dans la copie : cette session se déplace en arrière-plan, de la même manière qu'appuyer sur ←, et la vue agent ouvre la session de la copie.

Sauf quand la copie édite sur place, Claude Code lui ordonne de créer sa propre worktree avant de faire des modifications de code. En dehors d'un référentiel git, seule une copie déplacée hors d'une worktree créée par hook reçoit l'instruction ; sans hook WorktreeCreate, la copie édite sur place. Une copie déplacée hors de votre worktree est également informée de ne jamais éditer, exécuter des commandes dans, ou entrer dans cette worktree, quel que soit le paramètre d'isolation.

L'endroit où la copie démarre dépend de l'endroit où la session actuelle s'exécute :

Comme toute session lancée, la copie se déplace dans sa propre worktree avant d'éditer des fichiers. Dans ce cas, la confirmation ne mentionne pas où la copie s'exécute.
Quand votre session s'est déplacée dans sa worktree liée après son démarrage, la copie démarre là où la session était avant le déplacement et, sauf si elle édite sur place, fait ses modifications de code dans sa propre worktree là. Quand votre worktree est extraite sur une branche, cette instruction dit également à une copie dont la tâche s'appuie sur votre travail de baser sa nouvelle branche sur la vôtre, puisque votre branche reste extraite dans votre worktree. La confirmation se termine par runs in the origin tree.
Quand vous avez lancé la session à l'intérieur d'une worktree liée d'un référentiel qui a un arbre de travail principal, la copie démarre dans cet arbre de travail principal, avec la même règle de worktree-de-la-sienne mais sans instruction de branche. La confirmation se termine par runs in the origin tree ici aussi.
Une session lancée à l'intérieur d'une worktree d'une disposition de référentiel nu n'a pas d'arbre de travail principal auquel revenir, donc la copie reste où elle est, et la confirmation se termine par edits this checkout. La même note apparaît quand l'isolation de worktree est désactivée dans une session qui n'est pas à l'intérieur d'une worktree liée, parce que la copie édite alors les fichiers que vous avez ouverts.

Les sessions démarrées avec des drapeaux de lancement que la copie n'hériterait pas, comme une invite système remplacée ou une liste d'autorisation --tools, ne peuvent pas être forkées ; Claude Code le dit au lieu de faire une copie partielle. Une session lancée à partir de la vue agent se forke normalement : la copie est lancée avec la même définition d'agent et les instructions ajoutées que la session dont elle provient.

Ce qui se transfère quand vous mettez en arrière-plan

Mettre en arrière-plan démarre un processus nouveau qui reprend à partir de la conversation enregistrée, et le travail en cours se transfère à celui-ci : les commandes shell en arrière-plan en cours d'exécution, les sous-agents mis en arrière-plan, les workflows dynamiques, les tâches planifiées que vous avez créées avec /loop, et les réponses automatiques de Claude aux commentaires d'artefacts se transfèrent tous et continuent de s'exécuter là. Un sous-agent se déplace avec tout ce qu'il a démarré, donc il se transfère uniquement quand tout ce travail peut se transférer aussi. Pour arrêter le travail en cours au lieu de le transférer, définissez la variable d'environnement CLAUDE_DISABLE_ADOPT=1 ; Claude Code vous demande alors de confirmer avant de mettre en arrière-plan.

Quand un workflow dynamique a encore des sous-agents en cours d'exécution, Claude Code demande avant de mettre en arrière-plan avec la boîte de dialogue Background this session?, qui dit combien de sous-agents redémarreraient. Choisissez Stay pour les laisser terminer d'abord. Si vous confirmez, Claude Code rejoue l'exécution dans la session en arrière-plan : les sous-agents qui s'exécutaient encore recommencent depuis le début, donc les tokens qu'ils ont utilisés jusqu'à présent sont dépensés à nouveau. Voir Reprendre après une pause pour savoir quels sous-agents terminés retournent leurs résultats enregistrés et lesquels s'exécutent à nouveau.

Claude Code arrête le travail qui ne peut pas se transférer, comme un monitor en cours d'exécution, et arrête un sous-agent mis en arrière-plan qui possède un monitor avec lui. Quand un tel travail s'exécute, Claude Code affiche la boîte de dialogue Background this session? pour que vous puissiez confirmer avant qu'il soit arrêté.

Une fois en arrière-plan, la session peut démarrer de nouveaux sous-agents, monitors, et commandes en arrière-plan, et ceux-ci continuent de s'exécuter lors des détachements et réattachements ultérieurs.

Les drapeaux de configuration de la session de lancement d'origine se reportent à la session mise en arrière-plan, donc ses serveurs MCP, paramètres et modèle de secours restent en vigueur :

--mcp-config et --strict-mcp-config
--settings
--add-dir
--plugin-dir
--fallback-model
--allow-dangerously-skip-permissions

Les répertoires que vous avez ajoutés pendant la session avec /add-dir se reportent également. Reporter --allow-dangerously-skip-permissions maintient bypassPermissions accessible dans la session mise en arrière-plan, mais cela ne confère rien de nouveau : le mode nécessite toujours l'acceptation interactive unique décrite dans Mode de permission, modèle et effort.

À partir du shell

Passez --bg ou sa forme longue --background pour démarrer une session qui va directement en arrière-plan :

claude --bg "investigate the flaky SettingsChangeDetector test"

L'invite est l'argument positionnel, pas une valeur -p. Claude Code rejette --bg combiné avec -p ou --print avant que toute session soit créée, car --print ne démarre jamais la session interactive à laquelle claude agents s'attache.

Pour exécuter un sous-agent spécifique que vous avez défini, comme un code-reviewer, comme l'agent principal de la session, combinez --bg avec --agent :

claude --agent code-reviewer --bg "address review comments on PR 1234"

Si le nom ne correspond à aucun de vos sous-agents, le lancement échoue : Claude Code affiche un avertissement no agent named et signale toujours la session comme mise en arrière-plan, mais la session se termine immédiatement avec une erreur --agent '<name>' not found.

Quand la session mise en arrière-plan reprend ou redémarre plus tard, Claude Code restaure l'agent et ses restrictions d'outils ; pour son invite système, voir Drapeaux d'invite système dans les conversations reprises. Il recherche d'abord l'agent dans le répertoire de la session lui-même, à condition que vous ayez approuvé cet espace de travail, donc un agent limité au projet charge toujours quand la session est reprise à partir d'un autre répertoire. Si l'agent n'existe plus, la session continue avec les outils par défaut et sa transcription s'ouvre avec un avertissement nommant l'agent.

Pour continuer une conversation existante en arrière-plan, passez son ID de session complet avec --resume :

claude --resume 1f0e2c9a-6d0b-4c11-9f39-2a77c1d4e8b5 --bg "pick up where you left off and finish the migration"

Sur Claude Code v2.1.257 ou ultérieur, Claude Code continue soit cette session sous le même ID, soit démarre une copie sous un nouvel ID et affiche une ligne note: expliquant pourquoi il n'a pas pu continuer sur place. Quand la session continue sur place, claude agents affiche une ligne pour elle.

Quand vous combinez --bg avec --continue, un --resume nu, ou --resume avec un nom ou un chemin de fichier, Claude Code démarre toujours une telle copie. Ajoutez --fork-session pour démarrer une copie à dessein, sans la note.

Passez --name pour définir le nom d'affichage de la session dans la vue agent au lieu du nom généré automatiquement :

claude --bg --name "flaky-test-fix" "investigate the flaky SettingsChangeDetector test"

Après avoir mis en arrière-plan, Claude affiche l'ID court de la session et les commandes pour la gérer. Quand le service qui héberge les sessions en arrière-plan n'est pas déjà en cours d'exécution, --bg peut d'abord afficher Starting background service… au-dessus de cette sortie. Quand vous passez --name, le nom apparaît après l'ID court :

backgrounded · 7c5dcf5d · flaky-test-fix
  claude agents             list sessions
  claude attach 7c5dcf5d    open in this terminal
  claude logs 7c5dcf5d      show recent output
  claude stop 7c5dcf5d      stop this session

Exécuter une commande shell

Pour exécuter une commande shell comme une tâche en arrière-plan au lieu d'une session Claude, passez --exec. L'exemple suivant exécute pytest -x comme une tâche en arrière-plan :

claude --bg --exec 'pytest -x'

À partir de la vue agent, lancez le même type de tâche en tapant ! comme premier caractère de l'entrée de lancement : le ! s'affiche comme un préfixe, tout ce qui suit est la commande, et Entrée démarre la tâche.

La commande s'exécute comme une tâche sauvegardée par PTY et apparaît comme une ligne dans la vue agent, avec la ligne de sortie la plus récente comme son statut. Une tâche shell exécute la commande à la place de Claude, donc aucun modèle n'est invoqué et la sortie n'est pas envoyée à aucune session.

Pour voir la sortie, attachez-vous à la ligne, appuyez sur Espace pour jeter un œil sans vous attacher, ou exécutez claude logs <id> depuis votre shell. La sortie capturée reste en mémoire et n'est pas écrite sur le disque. La ligne et sa sortie se nettoient automatiquement environ cinq minutes après la sortie de la commande, donc lisez-la avant si vous avez besoin du résultat.

Comment les modifications de fichiers sont isolées

Chaque 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 isolée sous .claude/worktrees/, afin que les sessions parallèles puissent lire le même checkout mais chacune écrit dans la sienne. Une fois que la session est dans sa worktree, Claude Code applique l'isolation de worktree pour la session et pour tous les sous-agents qu'elle lance.

Claude ignore la worktree quand :

La session est déjà à l'intérieur d'une git worktree liée, que Claude l'ait créée sous .claude/worktrees/ ou que vous l'ayez créée avec git worktree add ailleurs
Le fichier que Claude édite est à l'intérieur d'une git worktree liée, comme une que la session ou son sous-agent a créée avec git worktree add
Le répertoire de travail n'est pas un référentiel git et aucun hook WorktreeCreate n'est configuré
L'écriture est en dehors du répertoire de travail

Pour désactiver l'isolation de worktree pour un référentiel où les git worktrees ne sont pas pratiques, définissez worktree.bgIsolation sur "none". Les sessions en arrière-plan modifient alors votre copie de travail directement sans d'abord se déplacer dans une worktree. Ajoutez le paramètre au fichier .claude/settings.json du projet :

{
  "worktree": {
    "bgIsolation": "none"
  }
}

En 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. Si vous utilisez un système de contrôle de version différent, configurez un hook WorktreeCreate et Claude isole les modifications de la même manière qu'il le fait pour git.

Quand le hook échoue dans un répertoire qui n'est pas un référentiel git, Claude ignore l'isolation pour ce répertoire et édite le répertoire de travail sur place. À l'intérieur d'un référentiel git, Claude Code bloque les écritures au checkout partagé jusqu'à ce que Claude déplace la session dans une worktree.

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.

Un sous-agent que la session en arrière-plan lance hérite du répertoire de travail de la session, donc ses modifications de fichiers se retrouvent dans la worktree de la session plutôt que dans votre copie de travail. Pour donner à un sous-agent sa propre worktree séparée à la place, définissez isolation: worktree dans son frontmatter ou passez isolation: "worktree" lors de son lancement.

Quand une session en arrière-plan a fait des modifications de code dans une worktree que Claude a entrée, Claude Code ordonne à Claude de préserver le travail avant de terminer, afin qu'il survive si vous supprimez la session et sa worktree :

Valider et pousser : Claude valide sans demander, et pousse la branche quand le référentiel a un remote.
Demande de tirage en brouillon : Claude en ouvre une quand la tâche l'appelle, et l'étiquette #N apparaît sur la ligne.
Jamais : pousser vers main ou master, forcer les poussées, et fusionner.
Vos instructions git prennent la priorité : si la tâche, CLAUDE.md, ou la mémoire dit que vous gérez vous-même la validation ou la poussée, Claude vous laisse git.

Une session éditant un checkout qu'elle n'a pas isolée elle-même demande toujours avant de valider ou de changer de branche. Cela s'applique quand l'isolation est définie sur "none", quand le déplacement de la worktree a échoué, ou quand la session a démarré à l'intérieur d'une worktree qui existait déjà.

Quelle que soit la tâche, Claude termine le travail avec un rapport disant ce qu'il a fait et où le travail est : un chemin, une branche, une demande de tirage, ou la réponse elle-même.

Ce que supprimer une session supprime

Supprimez une session avec Ctrl+X deux fois dans la vue agent ou avec claude rm. Sauf dans les cas conservés ci-dessous, la session quitte la liste. Sa transcription reste sur votre machine via claude --resume, et la suppression survit aux redémarrages du superviseur.

Ce qui arrive à une worktree que Claude a créée pour la session :

La vue agent la supprime, y compris les modifications non validées, donc validez ce que vous voulez conserver d'abord.
claude rm la conserve, ainsi que la ligne de session, quand elle a des modifications non validées.
Ni la vue agent ni claude rm ne supprime une worktree qu'une autre session en cours d'exécution utilise ou a verrouillée, et supprimer à nouveau ne change pas cela. Claude Code conserve la worktree et la session, et nomme le répertoire conservé et la raison ; dans la vue agent, la ligne de la session affiche not deleted. Fermez l'autre session, puis supprimez à nouveau.
Quand vous supprimez une session dont la worktree a des commits que Claude Code ne peut pas confirmer sont enregistrés ailleurs, Claude Code conserve la worktree et la session, et le message nomme la branche de la worktree et combien de commits ne sont pas poussés. Le message offre également les deux façons d'avancer : pousser les commits, ou supprimer à nouveau pour les abandonner.

Les commits sur un remote ne bloquent pas la suppression. Ni les commits sur la copie locale de la branche par défaut de votre remote origin, tant que cette branche est extraite dans votre checkout principal, le répertoire du référentiel lui-même plutôt qu'une worktree.

Après ce refus, vous choisissez :
- Pour conserver les commits, les pousser, ou les fusionner dans cette branche par défaut, puis supprimer la session à nouveau.
- Pour les abandonner, supprimer la session à nouveau sans pousser : appuyez sur Ctrl+X deux fois sur sa ligne dans la vue agent, ou exécutez la commande claude rm <id> --discard-unpushed que le refus a affichée. Cela supprime la session et la worktree avec sa branche, abandonnant les commits non poussés et toutes les modifications non validées.
Quand vous supprimez à nouveau, Claude Code abandonne uniquement ce que le refus a montré : si la worktree a gagné un commit depuis, Claude Code la conserve à nouveau et affiche l'état mis à jour.

Quand les enregistrements d'une autre session terminée nomment également la worktree, elle reste quand vous supprimez à nouveau ; poussez les commits, puis supprimez à nouveau.
Une worktree que git ne reconnaît plus, par exemple après git worktree prune, ne bloque pas la suppression. Claude Code supprime la session et laisse le répertoire sur le disque.
Quand git ou votre hook WorktreeRemove échoue à supprimer la worktree, Claude Code conserve la worktree et la session, et le message nomme la cause. Pour un hook, le message dit comment il s'est terminé, comme exited 1, et cite le début de son stderr. Le message vous dit également lequel de ceux-ci faire ensuite :
- Supprimer la session à nouveau pour supprimer le répertoire de toute façon, en appuyant sur Ctrl+X deux fois sur sa ligne dans la vue agent ou en exécutant la commande claude rm <id> --force-remove-worktree <worktree-id> que le refus de claude rm a affichée. Claude Code n'offre cela que quand il peut confirmer que le répertoire est l'une des worktrees liées du référentiel sous .claude/worktrees/ sans modifications non validées aux fichiers suivis, sans référentiel imbriqué à l'intérieur, et sans enregistrement d'une autre session le nommant. La branche de la worktree reste dans le référentiel.
- Corriger ce qui se met en travers, comme valider ou remiser les modifications non validées, fermer ce qui utilise le répertoire, ou corriger le hook, puis supprimer la session à nouveau.
- Supprimer le répertoire vous-même, puis supprimer la session à nouveau.

Une worktree que vous avez créée vous-même et dans laquelle vous avez démarré la session est laissée en place de toute façon.

Une session dont le répertoire de worktree n'appartient à aucun référentiel git, parce que le référentiel a été supprimé ou un hook WorktreeCreate a créé le répertoire ailleurs, peut toujours être supprimée. Tandis que les fichiers restent dans le répertoire :

La vue agent demande le même double-appui Ctrl+X avant de les abandonner. Pour un répertoire créé par hook, il exécute votre hook WorktreeRemove à la place, et sans un, il refuse la suppression et conserve la session.
claude rm conserve la session et la worktree, et nomme la raison.

Chaque chemin conserve un répertoire que les enregistrements d'une autre session terminée nomment.

Définir le modèle

Le 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 provient du paramètre model dans vos paramètres utilisateur. Définissez-le en sélectionnant un modèle dans le sélecteur /model, ou modifiez le paramètre directement.

Pour remplacer la valeur par défaut du lancement pour l'ensemble de la session de la vue agent, passez --model lors de l'ouverture de la vue agent. Voir Mode de permission, modèle et effort.

Pour changer la valeur par défaut du lancement à partir de la vue agent, tapez /model suivi d'un nom de modèle dans l'entrée de lancement et appuyez sur Entrée. L'en-tête se met à jour pour afficher ce modèle avec un marqueur (session), et les sessions que vous lancez après utilisent ce modèle. Tapez /model default pour effacer le remplacement et revenir à la valeur par défaut du lancement. Ce remplacement dure pour le reste de l'exécution actuelle de claude agents et n'écrit pas dans votre fichier de paramètres. L'exemple suivant lance une session sur Opus et la suivante sur Sonnet :

/model opus
refactor auth
/model sonnet
run the test suite

Chaque session en arrière-plan peut s'exécuter sur un modèle différent. Pour le remplacer pour une session :

Depuis le shell, passez --model avec claude --bg.
Attachez-vous à une session en cours d'exécution et exécutez /model pour basculer : un choix du sélecteur, ou un /model <name> tapé, s'enregistre comme votre valeur par défaut pour les nouvelles sessions sauf si vous appuyez sur s dans le sélecteur pour un basculement réservé à la session. Un basculement réservé à la session persiste si la session est relancée.
Lancez un sous-agent dont le frontmatter définit un champ model.

Mode de permission, modèle et effort

Une session en arrière-plan prend ses paramètres, fournisseur, mode de permission, modèle et effort à partir de l'endroit et de la façon dont vous l'avez lancée. Les sous-sections ci-dessous couvrent chaque source, et ce qui persiste quand le superviseur redémarre la session.

Paramètres et fournisseur

Une session en arrière-plan lit ses paramètres à partir du répertoire dans lequel elle s'exécute, de la même manière que si vous aviez démarré claude là. Cela inclut les valeurs env dans les paramètres du projet, donc une variable ANTHROPIC_MODEL ou de fournisseur définie là s'applique à chaque session en arrière-plan dans ce répertoire.

Une session en arrière-plan s'exécute également avec le PATH du shell à partir duquel vous l'avez lancée, afin que les commandes qu'elle exécute trouvent les mêmes outils que votre terminal. Elle conserve également la sélection du fournisseur cloud de ce shell, comme CLAUDE_CODE_USE_BEDROCK ou CLAUDE_CODE_USE_VERTEX, ainsi que ses alias ANTHROPIC_DEFAULT_*_MODEL et tout remplacement CLAUDE_CODE_EXTRA_BODY que vous avez exporté là.

Passerelle LLM

Si vous routez Claude Code via une passerelle LLM, mettez les variables de passerelle dans un bloc env d'un fichier de paramètres plutôt que de les exporter dans votre shell, et les sessions en arrière-plan les lisent avec le reste de leurs paramètres. Définir dans un fichier de paramètres affiche le bloc et quel fichier de paramètres utiliser pour les identifiants.

Si vous exportez une passerelle ANTHROPIC_BASE_URL uniquement dans votre shell à la place, elle atteint une session en arrière-plan, avec ANTHROPIC_CUSTOM_HEADERS et les identifiants que vous avez exportés avec elle, uniquement quand le superviseur lui-même a été démarré à partir d'un shell qui a exporté la même passerelle, et uniquement dans ces cas :

Vous mettez votre propre session en arrière-plan avec ← ou /background
Vous lancez une session dans le répertoire dans lequel vous êtes
Vous réveillez une session arrêtée dans le répertoire dans lequel vous êtes en vous attachant ou en répondant à elle

Claude Code transfère une passerelle devant un fournisseur cloud. Si le shell à partir duquel vous lancez sélectionne le fournisseur et exporte son point de terminaison de passerelle avec son drapeau de contournement d'authentification, Claude Code transfère la paire point-de-terminaison-et-drapeau à la session dans les conditions qui s'appliquent à ANTHROPIC_BASE_URL, avec ANTHROPIC_CUSTOM_HEADERS. Par exemple, exportez CLAUDE_CODE_USE_VERTEX=1 avec ANTHROPIC_VERTEX_BASE_URL et CLAUDE_CODE_SKIP_VERTEX_AUTH=1, et Claude Code transfère ce point de terminaison et ce drapeau.

Claude Code applique une passerelle transférée au processus en cours d'exécution de cette session uniquement et ne l'écrit jamais sur le disque.

Mode de permission

Le mode de permission dépend de la façon dont vous avez démarré la session :

Mise en arrière-plan avec /bg ou ← : Claude Code conserve le mode de permission dans lequel la session était, donc une que vous avez basculée vers acceptEdits ou auto reste là après détachement
Lancée à partir d'une vue agent que vous avez ouverte avec ← : la configuration propre de la cible vient en premier, et le mode de permission de la session dont vous venez s'applique quand rien d'autre n'en définit un
Lancée à partir de claude agents démarrée dans un shell, ou avec claude --bg : la nouvelle session démarre de la façon qu'une nouvelle session claude dans ce répertoire le ferait, sauf si vous l'avez lancée à partir d'une vue agent que vous avez ouverte avec les valeurs par défaut du lancement. Quel mode de permission une session démarre liste l'ordre

Pour une session que vous lancez à partir d'une vue agent ouverte avec ←, Claude Code prend le mode de permission à partir du premier de ceux-ci qui s'applique :

Le permissions.defaultMode du répertoire cible. Deux règles de source s'appliquent :
- auto et bypassPermissions ne prennent effet que à partir des paramètres gérés, d'un fichier --settings, ou de ~/.claude/settings.json.
- Claude Code refuse un defaultMode à partir du .claude/settings.json ou .claude/settings.local.json du projet qui sélectionne un mode plus permissif que celui dans lequel la session dont vous venez était.
Le mode de permission de la session dont vous venez

Quand Claude Code refuse le mode d'une source comme trop permissif, la source suivante dans la liste décide. Par exemple, si vous lancez à partir d'une session en mode plan dans un répertoire dont les paramètres vérifiés demandent acceptEdits, la nouvelle session démarre en mode plan. Si vous déplacez ce defaultMode vers ~/.claude/settings.json, il s'applique indépendamment du mode de permission de la session dont vous venez.

La permissivité va plan, puis Manual et dontAsk, puis acceptEdits et auto, qui comptent chacun comme plus permissif que l'autre, puis bypassPermissions.

Valeurs par défaut du lancement

Pour définir les valeurs par défaut pour chaque session que vous lancez à partir de la vue agent, passez l'un de --permission-mode, --model, --effort, ou --agent lors de son ouverture :

claude agents --permission-mode plan --model opus --effort high

--effort ici accepte les mêmes valeurs que le drapeau --effort de haut niveau, y compris ultracode.

--agent définit le sous-agent utilisé quand une invite de lancement ne nomme pas un, soit avec @name soit comme premier mot. Il prend par défaut le paramètre agent s'il en existe un, sinon l'agent intégré fourre-tout claude. Nommer un sous-agent dans l'entrée de lancement remplace les deux.

claude agents accepte également --dangerously-skip-permissions comme raccourci pour --permission-mode bypassPermissions, et --allow-dangerously-skip-permissions pour rendre bypassPermissions disponible dans le cycle Shift+Tab de chaque session lancée sans démarrer dans ce mode. Les deux correspondent aux drapeaux CLI de haut niveau.

Passez --restricted pour démarrer chaque session que vous lancez à partir de la vue en mode restreint, comme si chacune était lancée avec le drapeau de haut niveau --restricted. Nécessite Claude Code v2.1.248 ou ultérieur.

Les valeurs par défaut actives apparaissent dans le pied de page sous l'entrée de lancement.

Claude Code refuse claude --bg --permission-mode bypassPermissions jusqu'à ce que vous ayez accepté la clause de non-responsabilité du contournement en exécutant claude --dangerously-skip-permissions une fois de manière interactive, puisque ce mode permet à une session que vous ne regardez pas d'agir sans approbation. Passer --dangerously-skip-permissions ou --permission-mode bypassPermissions à claude agents affiche la même clause de non-responsabilité quand vous ne l'avez pas acceptée avant, et accepter applique bypassPermissions aux sessions que vous lancez à partir de la vue. Passer --allow-dangerously-skip-permissions affiche la même clause de non-responsabilité aussi, et accepter rend bypassPermissions disponible dans le cycle Shift+Tab de ces sessions sans les démarrer dedans.

Ce qui persiste lors des redémarrages

Le mode de permission, le modèle et l'effort que vous avez choisis pour une session en arrière-plan, ainsi que les drapeaux de configuration qu'elle porte, persistent tous quand le superviseur arrête et redémarre ultérieurement le processus de la session. Une session que vous avez lancée avec claude --bg --dangerously-skip-permissions ou claude --bg --permission-mode bypassPermissions reste dans bypassPermissions après ce redémarrage. Un modèle ou un effort que vous avez changé en milieu de session avec /model ou /effort est conservé aussi.

Si la session a pris son effort à partir de vos paramètres plutôt que de --effort ou /effort, Claude Code relit vos paramètres à nouveau chaque fois qu'il démarre un processus pour la session. Après avoir édité l'effort enregistré dans settings.json, le changement atteint les sessions que vous mettez en arrière-plan avec ← ou /bg, et leurs redémarrages ultérieurs. L'effort enregistré est la clé effortLevel ou une entrée modelSettings.

Claude Code conserve également un nom que vous avez défini avec /rename ou Ctrl+R lors de ce redémarrage, donc vous pouvez toujours exécuter claude --resume <name> pour atteindre la session.

Une invite que vous avez remisée avec Ctrl+S tandis que vous étiez attaché est conservée avec la session aussi. Rouvrez la session après son processus a été arrêté ou redémarré, et Ctrl+S restaure le texte remisé. Le contenu collé dans la remise ne survit pas au redémarrage.

Paramètres, plugins et serveurs MCP

La vue agent accepte les mêmes drapeaux de configuration que claude pour charger les paramètres, les plugins, les serveurs MCP et les répertoires supplémentaires. La vue agent applique --settings et --plugin-dir à elle-même et transmet chaque drapeau de configuration aux sessions que vous lancez à partir de celle-ci, donc un plugin ou un serveur MCP que vous chargez de cette manière est disponible dans ces sessions.

Drapeau	Effet
`--settings <file-or-json>`	Remplacer les paramètres pour la vue agent et les sessions lancées
`--add-dir <path>`	Accorder l'accès aux fichiers à un répertoire supplémentaire
`--plugin-dir <path>`	Charger un plugin à partir d'un répertoire local
`--mcp-config <file-or-json>`	Charger les serveurs MCP à partir d'un fichier de configuration ou d'une chaîne JSON
`--strict-mcp-config`	Utiliser uniquement les serveurs MCP de `--mcp-config`, en ignorant les autres configurations MCP. Voir Contrôle exclusif avec managed-mcp.json pour ce que le drapeau fait sous un fichier MCP géré

Répétez --add-dir, --plugin-dir, ou --mcp-config une fois par valeur. claude agents ne supporte pas la forme séparée par des espaces, comme --add-dir a b c.

Vous pouvez placer --settings et --plugin-dir avant ou après agents. Gardez --add-dir et --mcp-config après agents : si vous placez l'un ou l'autre avant agents, claude agents --json échoue avec une erreur unknown option.

L'exemple suivant ouvre la vue agent avec un remplacement de paramètres et un répertoire supplémentaire :

claude agents --settings ./ci-settings.json --add-dir ../shared-lib

--settings accepte un chemin de fichier ou une chaîne JSON en ligne. Un chemin de fichier doit pointer vers un fichier existant ; Claude Code se termine avec une erreur Settings file not found s'il ne le fait pas.

Gérer les sessions depuis le shell

Chaque 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.

Commande	Objectif
`claude agents`	Ouvrir la vue agent
`claude agents --cwd <path>`	Ouvrir la vue agent limitée aux sessions démarrées sous `<path>`
`claude agents --json`	Afficher les sessions en tant que tableau JSON et quitter. Voir Afficher les sessions en tant que JSON
`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, en cours d'exécution ou arrêtée, par exemple pour utiliser un binaire Claude Code mis à jour. La session redémarrée reprend sa conversation enregistrée ; quand aucune n'est sur le disque, elle exécute à nouveau son prompt original en tant que nouvelle conversation
`claude respawn --all`	Redémarrer chaque session en cours d'exécution, par exemple pour déplacer toutes les sessions vers un binaire Claude Code mis à jour en une seule fois
`claude rm <id>`	Supprimer une session de la liste, ainsi qu'une worktree que Claude a créée pour elle quand il est sûr de la supprimer ; voir Ce que la suppression d'une session supprime. La transcription de la conversation reste sur votre machine locale et reste disponible via `claude --resume`
`claude rm <id> --discard-unpushed <commit>@<worktree-id>`	Supprimer une session dont la suppression a été refusée en raison de commits non poussés, en supprimant la worktree ainsi que sa branche et ses commits. Passez la valeur exacte que le refus a affichée ; voir Ce que la suppression d'une session supprime. Nécessite v2.1.260 ou ultérieur
`claude rm <id> --force-remove-worktree <worktree-id>`	Supprimer une session dont la suppression a été refusée parce que git ou le hook `WorktreeRemove` n'a pas pu supprimer sa worktree, en supprimant le répertoire worktree de toute façon et en laissant sa branche dans le référentiel. Passez la valeur exacte que le refus a affichée ; voir Ce que la suppression d'une session supprime. Nécessite v2.1.268 ou ultérieur
`claude daemon status`	Afficher l'état du superviseur, la version, le répertoire socket et le nombre de workers
`claude daemon stop --any`	Arrêter le processus superviseur et les sessions en arrière-plan qu'il héberge. Passez `--keep-workers` pour laisser les sessions en arrière-plan en cours d'exécution afin que le superviseur suivant se reconnecte à elles. Le prochain `claude agents` ou `claude --bg` démarre un nouveau superviseur

Afficher les sessions en tant que JSON

claude agents --json affiche les sessions actives en tant que tableau JSON et quitte : chaque session active, plus les sessions en arrière-plan qui travaillent encore ou sont bloquées même quand leur processus a quitté. Ajoutez --all pour inclure aussi les sessions en arrière-plan terminées, et --cwd <path> pour limiter la liste aux sessions démarrées sous ce répertoire.

Chaque entrée décrit une session :

Champ	Présent	Description
`cwd`, `kind`, `startedAt`	Toujours	Le répertoire de travail, `interactive` ou `background`, et l'heure de démarrage en millisecondes Unix
`id`	Sessions en arrière-plan	ID court, utilisable avec `claude attach`, `claude logs`, et `claude stop`
`state`	Sessions en arrière-plan	L'une de `working`, `blocked`, `done`, `failed`, ou `stopped`. Voir Lire l'état de la session à partir d'un script pour savoir ce que chaque valeur signifie
`pid`, `status`	Tant que le processus est actif	ID du processus et l'une de `busy`, `waiting`, ou `idle`
`waitingFor`	Quand `status` est `waiting`	Sur quoi la session est bloquée : `permission prompt` pour une approbation, `input needed` pour une question de Claude ou une demande d'entrée d'un serveur MCP, `sandbox request`, `worker request`, ou `dialog open`
`sessionId`, `name`	Quand défini	`sessionId` est l'UUID de session complet, utilisable avec `claude --resume`. Le `name` d'une session interactive est son nom d'affichage par défaut jusqu'à ce que vous nommez la session ou acceptiez un plan en elle

Lire l'état de la session à partir d'un script

claude agents --json est la façon prise en charge de lire l'état de la session de l'extérieur de Claude Code, par exemple à partir d'une barre d'état, d'un planificateur, ou d'une autre session Claude qui supervise le travail en arrière-plan. Interrogez claude agents --json --all, qui continue à lister les sessions dont le processus a quitté, et lisez le state, status, et waitingFor de chaque entrée.

`state`	Ce que cela signifie
`working`	Un tour est en cours d'exécution, ou la session est entre les étapes du travail qu'elle conduit elle-même, comme une itération `/loop` ou une attente sur CI. `status` vous indique si son processus est `busy` en ce moment
`blocked`	La session vous attend : une question qu'elle a posée, une permission ou une décision de sandbox, une erreur que seul vous pouvez effacer comme une connexion expirée, ou son premier prompt si vous l'avez démarrée sans. Quand l'attente est un prompt ouvert dans un processus actif, `waitingFor` le nomme
`done`	Le dernier tour a terminé ce que vous avez demandé et la session est prête pour votre prochain prompt, que son processus soit encore actif ou non
`failed`, `stopped`	La tâche s'est terminée avec une erreur, ou la session a été arrêtée

Une session qui a terminé son tour et attend votre prochaine instruction lit done, pas blocked. blocked signifie toujours que la session a besoin de quelque chose de votre part avant de pouvoir continuer.

Les fichiers sous ~/.claude/jobs/<id>/ ne sont pas une interface stable. Les valeurs qu'une session ou un autre programme écrit dans state, detail, tempo, ou needs sont remplacées à la prochaine mise à jour.

Si vous voulez qu'une session rapporte la progression dans ses propres termes, faites-la écrire un fichier qui lui est propre, par exemple sous $CLAUDE_JOB_DIR/tmp, au lieu de modifier state.json.

Comment les sessions en arrière-plan sont hébergées

Claude Code traite chaque session listée dans la vue agent 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.

Pour vérifier quel type de session vous utilisez, exécutez /status. La ligne Session kind affiche background job · attached ou background job · unattended dans une session en arrière-plan, selon qu'un terminal est attaché, et interactive dans toute autre session.

Le processus superviseur

Le superviseur est un service en arrière-plan qui exécute vos sessions en arrière-plan pour qu'elles continuent de fonctionner après que vous fermiez la vue agent ou votre terminal. Claude Code le démarre la première fois que vous mettez une session en arrière-plan ou ouvrez la vue agent, et vous n'avez pas besoin de le gérer vous-même.

Chaque session est son propre processus Claude Code sous le superviseur, et ce qui arrive à ce processus dépend de l'état de la session :

En cours d'exécution, en pause sur une invite de permission ou un autre dialogue, ou attaché : le processus continue de s'exécuter. Un sous-agent, un workflow ou un monitor en cours d'exécution compte comme en cours d'exécution.
Terminé ou en attente de votre prochain message, et non attaché pendant environ une heure : le superviseur arrête le processus pour libérer des ressources. Une session qui a terminé son tour en vous posant une question compte comme en attente de votre prochain message. La conversation reste sur le disque, et la prochaine fois que vous vous attachez ou répondez, la session reprend là où elle s'était arrêtée. Épinglez une session avec Ctrl+T pour garder son processus en cours d'exécution.
Arrêté de manière inattendue tandis que le superviseur est en cours d'exécution : le superviseur redémarre le processus. Terminer une session que vous avez mise en arrière-plan vous-même avec ← ou /background, par exemple avec kill, la marque comme arrêtée au lieu de la redémarrer. Pour les sessions qui se sont terminées avec un arrêt, voir Les sessions s'affichent comme échouées ou arrêtées après l'arrêt.
Après une mise à jour automatique : le superviseur redémarre lui-même sur la nouvelle version et déplace les sessions inactives en arrière-plan. Les sessions qui fonctionnent, qui attendent votre entrée, ou qui sont attachées ne sont pas interrompues.

Quand le processus d'une session s'arrête ou redémarre, les commandes shell en arrière-plan, les workflows dynamiques et les sous-agents en arrière-plan que Claude a démarrés dedans se reportent à son processus suivant ; les monitors en cours d'exécution et les commandes shell qu'un sous-agent a démarrées s'arrêtent avec le processus. Supprimer la session arrête tout ce qu'elle a reporté. Pour arrêter tout cela avec le processus à la place, définissez CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF à 1.

Le superviseur et ses sessions s'authentifient avec les mêmes identifiants stockés que vos sessions interactives. Pour savoir quels paramètres et variables shell atteignent une session, y compris PATH, voir Paramètres et fournisseur. Pour les points de terminaison de passerelle, voir Passerelle LLM.

Où l'état est stocké

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. Lisez-le via `claude agents --json` au lieu d'analyser le fichier
`~/.claude/jobs/<id>/tmp/`	Répertoire de travail par session. Les appels `Write` et `Edit` de Claude ici ne demandent pas de permission. Supprimé quand la session est supprimée

Chaque session en arrière-plan a la variable d'environnement CLAUDE_JOB_DIR définie à son répertoire ~/.claude/jobs/<id>, donc les commandes shell que la session exécute peuvent écrire des fichiers temporaires à $CLAUDE_JOB_DIR/tmp sans entrer en collision avec les sessions parallèles.

Pour inspecter cet état sans lire les fichiers directement, exécutez claude daemon status. Il rapporte si le superviseur est accessible, son ID de processus et sa version, le répertoire socket, et combien de sessions en arrière-plan sont actives.

La commande avertit également quand le superviseur en cours d'exécution est sur une version différente de celle du claude que vous avez invoqué, ce qui se produit après une mise à jour que le superviseur n'a pas encore redémarrée. L'avertissement affiche les deux versions et vous dit d'exécuter claude daemon stop --any pour récupérer la nouvelle version. Quand Claude Code est installé en tant que service du système d'exploitation, la commande suggérée est claude daemon stop sans le drapeau.

Les sessions survivent à ce décalage de version intact : une version plus ancienne de Claude Code qui met à jour le state.json d'une session préserve les champs qu'elle ne reconnaît pas et garde la session listée. La liste des sessions dans roster.json suit la même règle, donc les sessions démarrées par la version plus récente restent accessibles et continuent d'accepter l'entrée après le redémarrage du superviseur.

Désactiver 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

`claude agents` affiche les sous-agents au lieu d'ouvrir la vue agent

Si 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. Exécutez claude update pour installer la dernière version.

Si la vue agent ne s'ouvre toujours pas après la mise à jour, vérifiez si elle a été désactivée par un paramètre ou une variable d'environnement.

La vue agent s'ouvre sans sessions

Avant de dispatcher votre première session, la vue agent affiche les en-têtes de section vides avec une description sous chacun, plus une explication d'une ligne au-dessus de l'entrée, à la place de la liste des sessions. Tapez une invite dans l'entrée en bas et appuyez sur Entrée pour dispatcher votre première session.

Le backgrounding affiche une boîte de dialogue `Background this session?`

Si vous appuyez sur ← pour mettre en arrière-plan la session actuelle et que Claude Code affiche une boîte de dialogue Background this session?, la session a du travail en cours que la mise en arrière-plan arrêterait, redémarrerait ou laisserait s'exécuter sans surveillance, et Claude Code demande avant de faire l'une de ces actions :

Travail qui ne peut pas être déplacé : la session a du travail qui ne peut pas être déplacé vers la session en arrière-plan, comme un monitor en cours d'exécution. La boîte de dialogue nomme le travail que Claude Code arrêterait et, séparément, compte les tâches qui sont transférées.
Un workflow avec des sous-agents en cours d'exécution : un dynamic workflow a toujours des sous-agents en cours d'exécution. Le workflow lui-même est transféré, mais ses sous-agents en cours d'exécution redémarrent depuis le début, et la boîte de dialogue indique combien.
Réponses automatiques aux artefacts : Claude répond aux commentaires sur un artefact de sa propre initiative. Ces réponses continuent dans la session en arrière-plan, et la boîte de dialogue le dit.

Exécutez /tasks pour voir tout ce qui s'exécute, puis confirmez pour mettre en arrière-plan de toute façon ou choisissez Stay pour laisser le travail se terminer d'abord. Consultez What carries over when you background pour savoir quels types de travail sont transférés et lesquels Claude Code arrête.

Invite rejetée comme trop courte

L'entrée de dispatch s'attend à une description de tâche, pas à un ouvreur conversationnel. 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.

Les sessions s'affichent comme échouées ou arrêtées après l'arrêt

L'arrêt ou le redémarrage de votre machine arrête les sessions en arrière-plan en cours d'exécution. Une session qui attendait votre entrée reste sous Needs input quand vous revenez. Pour toute autre session en cours d'exécution, ce que la vue agent affiche dépend de la durée depuis laquelle elle a fait des progrès :

Dans les 48 heures, la session s'affiche comme échouée. Attachez-la ou répondez-lui et elle redémarre d'où elle s'était arrêtée.
Après 48 heures, par exemple après que la machine ait été éteinte pendant des jours, la session s'affiche comme arrêtée avec ended while the background service was off. Appuyez sur Entrée sur la ligne et le pied de page affiche Press enter again to resume this session (it ended while the background service was off), or ctrl+x to delete it. Appuyez sur Entrée sur la même ligne à nouveau pour reprendre sa conversation enregistrée. Une réponse ou claude attach <id> la reprend sans cette invite de pied de page.

Quand le transcript cleanup a supprimé la conversation enregistrée d'une session arrêtée, Claude Code refuse d'ouvrir la ligne : le message dit qu'il n'y a rien à reprendre. claude rm <id> supprime la ligne, sauf dans les cas conservés décrits ci-dessus, et claude respawn <id> exécute à nouveau son invite d'origine. Consultez This session's saved conversation is no longer on disk.

Le sommeil seul n'arrête pas les sessions. Les sessions sont préservées lors du sommeil et le superviseur se reconnecte à elles au réveil.

L'ouverture d'une session indique que la conversation est déjà ouverte

Deux processus ne peuvent pas écrire dans la même transcription. Quand la conversation enregistrée d'une session arrêtée est déjà ouverte dans un autre processus Claude Code actif, Claude Code refuse de démarrer le propre processus de la session. Ce que vous voyez dépend de ce qui détient la conversation :

Un terminal où vous avez repris la conversation, par exemple avec claude --resume ou /resume : la ligne affiche Open in a terminal avec un indice pour la continuer là, et l'ouverture de la ligne affiche Can't open — this session is running in another terminal. Continuez dans ce terminal, ou quittez-le et ouvrez la ligne à nouveau.
Un autre processus Claude Code non interactif, par exemple un processus de session en arrière-plan pour la même conversation qui n'a pas encore quitté : l'ouverture de la ligne affiche This conversation is already open in another running Claude session. Utilisez ce processus, ou attendez qu'il se termine et ouvrez la ligne à nouveau.

Claude Code enregistre une réponse que vous avez tapée avec la tentative refusée et l'envoie la prochaine fois que la session démarre.

L'ouverture d'une session indique qu'elle n'a pas de transcription enregistrée

Une session arrêtée qui a été backgrounded from another conversation et s'est arrêtée avant la fin de sa première réponse n'a rien à reprendre : jusqu'à ce que cette première réponse se termine, la conversation vit toujours uniquement dans la session à partir de laquelle elle a été mise en arrière-plan. claude attach refuse de l'ouvrir avec This session has no saved transcript.

Dans la vue agent, l'ouverture de cette ligne affiche Press enter again to restart this session fresh sous la liste. Appuyez sur Entrée sur la même ligne à nouveau pour redémarrer la session avec une conversation vide, ou exécutez claude respawn <id> depuis le shell.

La conversation d'origine est intacte ; reprenez-la avec claude --resume ou continuez à y travailler. Consultez la référence des erreurs pour plus de détails.

L'hôte du terminal est mort ou la session a cessé de répondre

Le supervisor exécute le terminal de chaque session en arrière-plan dans son propre processus hôte. Quand ce processus meurt ou cesse de répondre, Claude Code affiche la raison et propose un redémarrage ; dans les deux cas, la conversation est enregistrée et le redémarrage la reprend. La référence des erreurs cite les messages complets.

Claude Code ne redémarre jamais une ligne exécutant une shell command, depuis Entrée ou depuis claude attach, car cela exécuterait la commande à nouveau ; le message de la ligne et claude attach disent tous deux que la commande n'est pas exécutée à nouveau.

L'hôte du terminal est mort

Sur Linux et WSL, le superviseur vérifie chaque processus hôte toutes les quelques secondes, que vous ouvriez la session ou non, et marque la session comme échouée quand le processus a quitté mais sa connexion au superviseur ne s'est jamais fermée.

Dans la vue agent, la ligne affiche terminal host process died — press Enter to restart. Appuyez sur Entrée dessus et Claude Code redémarre la session sur un processus hôte frais.
Depuis le shell, claude attach <id> redémarre une session déjà marquée comme échouée. Sinon, il rapporte la cause et se termine, vous disant d'exécuter claude attach <id> à nouveau.

La session ne répond pas

Quand le superviseur accepte une ouverture mais qu'aucune sortie n'arrive pendant environ dix secondes, Claude Code termine la tentative et propose un redémarrage. Une session qui s'est simplement figée, par exemple lors du sommeil de la machine, n'atteint pas cette offre : le superviseur la redémarre à l'ouverture lui-même.

Dans la vue agent, le pied de page affiche Press enter again to restart this session — it isn't responding (its conversation is saved and resumes). Appuyez sur Entrée sur la même ligne à nouveau et Claude Code arrête le processus qui ne répond pas et redémarre la session ; il n'arrête rien sans ce deuxième appui.
Depuis le shell, claude attach <id> rapporte la cause et se termine, vous disant d'exécuter claude stop <id>, puis claude attach <id>.

Une session échoue avant de démarrer avec une note `possibly low memory`

Quand le processus d'une session en arrière-plan se termine avant de finir de démarrer et que l'hôte manque de mémoire, le statut de la ligne nomme la sortie et ajoute possibly low memory — free some up and retry.

La note est une hypothèse, pas une cause confirmée. Claude Code l'ajoute uniquement quand le processus s'est terminé silencieusement, sans écrire une erreur et sans être arrêté par un signal, et que l'hôte a signalé une mémoire faible à ce moment. Quand le processus a écrit une erreur avant de se terminer, la ligne affiche cette erreur à la place.

Libérez de la mémoire sur la machine, puis attachez-vous ou répondez à la ligne et le superviseur démarre un processus frais pour la session. Quand la mémoire reste faible, le superviseur arrête également les sessions inactives pour libérer des ressources de sa propre initiative, et arrête également les sessions épinglées inactives si l'arrêt des autres n'a rien libéré.

La vue agent indique que le service en arrière-plan n'a pas répondu

Si l'attachement, l'aperçu ou claude logs rapporte que le service en arrière-plan n'a pas répondu, le processus superviseur s'est probablement figé. Arrêtez-le et laissez le prochain claude agents en démarrer un frais. Pour garder vos sessions en arrière-plan en cours d'exécution lors du redémarrage, passez --keep-workers :

claude daemon stop --any --keep-workers

Le nouveau superviseur se reconnecte aux sessions en cours d'exécution. Sans --keep-workers, la commande termine également les sessions en arrière-plan. Le drapeau --any confirme que vous voulez arrêter un superviseur qui a démarré à la demande plutôt que comme service installé, ce qui est la valeur par défaut.

Un superviseur qui démarre mais ne peut pas accepter les connexions se termine et libère son verrou de sa propre initiative, donc le prochain claude agents en démarre un frais sans cet arrêt manuel. Les étapes ci-dessus s'appliquent quand un superviseur en cours d'exécution se fige.

Si la commande se termine plutôt en disant que le processus enregistré n'a pas pu être vérifié comme superviseur, vérifiez l'ID de processus rapporté : s'il s'agit d'un superviseur que vous possédez, arrêtez-le vous-même, puis supprimez ~/.claude/daemon.lock pour que le prochain claude agents démarre frais.

Sur Windows, si le superviseur ne répond pas à la demande d'arrêt, la commande affiche son ID de processus. Terminez ce processus avec taskkill /PID <pid> pour terminer la récupération. Les sessions en arrière-plan sont toujours préservées quand vous avez passé --keep-workers.

Le dispatch échoue avec `Could not resolve authentication method`

Si un dispatch en arrière-plan échoue avec Could not resolve authentication method tandis que les sessions interactives s'authentifient normalement, le worker qui a reçu le dispatch n'a pas récupéré les identifiants. Les sessions en arrière-plan obtiennent leurs identifiants du supervisor, donc cette erreur signifie qu'aucun identifiant stocké n'était disponible pour le processus superviseur lui-même. Confirmez que vous avez exécuté /login ou configuré une clé API, puis arrêtez le superviseur :

claude daemon stop --any --keep-workers

Le prochain claude agents ou claude --bg démarre un superviseur frais qui lit vos identifiants stockés. Si vous vous authentifiez avec une variable d'environnement telle que ANTHROPIC_API_KEY plutôt que /login, exécutez cette commande suivante depuis un shell où la variable est définie.

Consultez la référence des erreurs pour la liste complète des causes et des correctifs.

Les sessions en arrière-plan ne peuvent pas lire Desktop, Documents ou Downloads sur macOS

Sur macOS, l'hôte de la session en arrière-plan s'exécute en tant que processus distinct et demande l'accès aux dossiers protégés séparément de votre terminal. Si une session en arrière-plan rapporte Operation not permitted lors de la lecture de ~/Desktop, ~/Documents, ~/Downloads ou d'un autre emplacement protégé, accordez l'accès dans Paramètres système sous Confidentialité et sécurité > Fichiers et dossiers, ou activez Accès complet au disque pour l'entrée.

Avec le programme d'installation natif, l'entrée apparaît comme Claude Code et l'octroi persiste lors des mises à jour. Avec d'autres méthodes d'installation telles que Homebrew ou npm, l'entrée affiche le chemin du binaire et peut avoir besoin d'être accordée à nouveau après la mise à jour.

Les sessions en arrière-plan ne peuvent pas atteindre les hôtes du réseau local sur macOS

Sur macOS 15 et versions ultérieures, le système bloque un processus d'atteindre les appareils sur votre réseau local jusqu'à ce que vous accordiez la permission Réseau local, donc une commande ciblant une adresse LAN peut échouer avec connect: no route to host dans une session en arrière-plan même si elle fonctionne dans un terminal de premier plan. La première commande dans une session en arrière-plan qui se connecte à une adresse de réseau local déclenche l'invite de permission Réseau local macOS pour Claude Code. Accordez-la une fois et ces commandes atteignent les hôtes LAN de la même manière qu'ils le font dans un terminal de premier plan.

Une session est lente à répondre après l'attachement

Quand une session qui a terminé ou attend votre message suivant reste non attachée pendant environ une heure, le superviseur arrête son processus pour libérer des ressources. L'attachement démarre un processus frais d'où il s'était arrêté et bascule vers la session immédiatement tandis que le processus redémarre. Les sessions qui travaillent, en pause sur une invite de permission ou un autre dialogue, ou épinglées ne sont pas arrêtées de cette façon, donc épinglez une session avec Ctrl+T pour la garder réactive.

Tandis que le processus démarre, Claude Code affiche la queue de la transcription de la session formatée de la manière dont la session active la rend, avec markdown, blocs de code en surbrillance et appels d'outils en tant que lignes estompées, au-dessus d'une zone d'invite estompée avec une note Session is starting. La session active la remplace dès qu'elle est prête.

`.claude/worktrees/` se remplit

Supprimer une session dans la vue agent supprime le worktree que Claude a créé pour elle, mais certaines suppressions conservent le worktree ou laissent son répertoire sur le disque, donc les répertoires restants peuvent s'accumuler. Les répertoires que git ne reconnaît plus n'apparaissent pas dans git worktree list, donc supprimez-les à la main.

Listez les entrées restantes avec git worktree list dans le répertoire du projet et supprimez chacune avec git worktree remove <path>. Consultez Clean up worktrees.

Limitations

La vue agent est en aperçu de recherche avec les limitations suivantes :

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.
Les sessions sont locales : les sessions en arrière-plan s'exécutent sur votre machine. Elles sont préservées lors de la mise en veille mais s'arrêtent si la machine s'éteint.
Les worktrees créées par Claude sont supprimées avec la session en vue agent : validez les modifications avant de supprimer une session qui a modifié des fichiers dans sa propre worktree. Certaines suppressions conservent la worktree à la place.

Pour d'autres façons d'exécuter Claude en parallèle, et pour transmettre les résultats entre les sessions que vous exécutez, consultez :

Exécuter les agents en parallèle : comparez la vue agent avec les sous-agents, les équipes d'agents, et les worktrees
Messagerie entre sessions : faites en sorte que vos sessions se transmettent mutuellement les résultats
É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
Projects : faites en sorte que Claude coordonne les sessions cloud parallèles à partir d'une conversation et vous indique lesquelles vous sont nécessaires

Historique des versions

La vue agent a évolué rapidement pendant l'aperçu de recherche. Si vous êtes sur une version plus ancienne de Claude Code, certains comportements sur cette page peuvent différer ; en particulier, claude agents rejette les drapeaux qu'il ne supporte pas encore avec une erreur unknown option. Le tableau ci-dessous répertorie quand chaque drapeau et comportement a été ajouté.

Version	Changement
v2.1.268	Quand une suppression est refusée parce que git ou votre hook `WorktreeRemove` n'a pas pu supprimer le worktree, le message nomme la cause, y compris comment le hook s'est terminé et le début de son stderr. Pour un worktree lié sous le répertoire `.claude/worktrees/` du référentiel sans modifications non validées sur les fichiers suivis, sans référentiel imbriqué à l'intérieur, et sans enregistrement d'une autre session le nommant, supprimer la session à nouveau supprime le répertoire de toute façon, à partir de la vue agent ou avec `claude rm <id> --force-remove-worktree <worktree-id>`. Avant cette version, la ligne affichait seulement `worktree could not be removed (WorktreeRemove hook failed)` ou l'erreur de git, le stderr du hook n'allait que dans le journal de débogage, et supprimer à nouveau était refusé de la même manière.
v2.1.268	Après que le premier `←` affiche `Press ← again to open agents`, ou `Press ← again to go back to agents` dans une session attachée, la première pression qui arrive au moins une seconde plus tard bascule, même quand les pressions plus rapides entre les deux ont été ignorées. Avant cette version, chaque pression ignorée redémarrait l'attente, donc appuyer sur `←` à nouveau à un rythme régulier ne basculait pas jusqu'à ce que vous fassiez une pause de plus d'une seconde.
v2.1.260	Quand vous mettez une session en arrière-plan, le listing agent de vos autres sessions affiche la conversation une fois, comme sa session en arrière-plan, et leurs messages vers elle n'atteignent plus le terminal d'où vous l'avez déplacée. Avant cette version, ce terminal pouvait rester listé comme une deuxième session interactive sous le nom de la conversation, et une session qui avait envoyé un message à la conversation avant le déplacement continuait à livrer à ce terminal.
v2.1.260	Quand une suppression est refusée sur des commits non poussés, le message nomme la branche du worktree et combien de commits ne sont pas poussés, et supprimer la session à nouveau abandonne le worktree et ses commits. Avant cette version, le refus disait seulement `worktree has commits that are not pushed anywhere`, supprimer à nouveau était refusé de la même manière, et supprimer la session nécessitait de pousser les commits ou de supprimer le worktree à la main.
v2.1.257	`←` se détache d'une session attachée tandis que l'overlay `/btw` est ouvert, même en pleine réponse, et l'overlay se rouvre quand vous vous attachez à nouveau. Avant cette version, `←` ne se détachait pas tandis que l'overlay était ouvert.
v2.1.257	Quand vous exécutez `claude --resume <session-id> --bg`, Claude Code continue cette session sous son propre ID, ou démarre une copie sous un nouvel ID et affiche une ligne `note:` expliquant pourquoi. `--continue`, un `--resume` nu, et `--resume` avec un nom ou un chemin démarrent une copie avec la même note. Avant cette version, `--resume` avec `--bg` démarrait toujours une copie sous un nouvel ID et ne disait rien.
v2.1.257	Quand vous dispatchez une session à partir d'une vue agent que vous avez ouverte avec `←`, Claude Code la démarre dans le mode de permission que le répertoire cible configure via `permissions.defaultMode`. Quand le répertoire n'en définit pas un, le mode de permission de la session d'où vous venez s'applique. Avant cette version, la session dispatchée démarrait toujours dans le mode de permission de la session d'où vous venez, le remplaçant.
v2.1.257	`Ctrl+S`, `Ctrl+T`, et `Ctrl+G` dans la vue agent suivent votre `keybindings.json` : `Ctrl+S` et `Ctrl+T` via les actions `agents:switchView` et `agents:togglePin` du contexte `Agents`, et `Ctrl+G` via la liaison `chat:externalEditor` du contexte `Chat`. Avant cette version, la vue agent ignorait `keybindings.json` et ces touches étaient fixes.
v2.1.257	Démarrer le service en arrière-plan se rétablit de deux causes d'échec. Sur une installation npm macOS, un démarrage pendant une auto-mise à jour attend l'installation au lieu d'exécuter l'espace réservé que npm pose en bas tandis qu'il remplace le binaire. Sur Windows, un `daemon.lock` obsolète écrit avant le dernier démarrage de la machine, ou dont l'ID de processus enregistré appartient maintenant à un processus différent, est remplacé. Avant cette version, le démarrage macOS échouait avec `Error: claude native binary not installed.` pendant la fenêtre d'installation, et le verrou Windows faisait échouer chaque démarrage avec `exited before it became reachable` jusqu'à ce que vous supprimiez `~/.claude/daemon.lock`.
v2.1.257	Quand vous ouvrez ou dispatchez une session en arrière-plan tandis qu'un autre processus Claude Code télécharge une mise à jour npm, Claude Code continue d'attendre jusqu'à deux minutes tandis que l'installation s'exécute, puis échoue en disant `Claude Code is being updated by npm on this machine`. Avant cette version, l'attente s'arrêtait à dix secondes, donc l'ouverture échouait avec `Couldn't start the background service` tandis que le téléchargement était encore en cours.
v2.1.257	Une session en arrière-plan tenant un message entre sessions pour votre approbation affiche `approve message from` sur sa ligne `Needs input`, avec l'adresse de l'expéditeur et le nom que l'expéditeur prétend. Avant cette version, la ligne se déplaçait vers `Needs input` mais gardait son texte précédent, donc rien dans `claude agents` ne nommait le message en attente ou son expéditeur.
v2.1.257	Une invite stockée avec `Ctrl+S` à l'intérieur d'une session en arrière-plan ouverte est conservée avec la session, donc `Ctrl+S` la restaure après l'arrêt et le redémarrage du processus de la session. Avant cette version, le stockage vivait seulement dans le processus en cours d'exécution et était perdu quand la session restait inactive assez longtemps pour que son processus s'arrête, ou quand il était arrêté puis rouvert.
v2.1.251	Dans une session en arrière-plan qui n'a pas déménagé dans un worktree, Claude et les sous-agents qu'il génère peuvent modifier les fichiers à l'intérieur d'un worktree git lié.
v2.1.251	Claude Code transfère une passerelle de fournisseur cloud exportée dans le shell d'où vous dispatchez, comme `ANTHROPIC_VERTEX_BASE_URL` ou `ANTHROPIC_BEDROCK_BASE_URL` avec son drapeau de contournement d'authentification, vers le worker de la session dans les mêmes conditions que `ANTHROPIC_BASE_URL`. Avant cette version, si vous mettiez en arrière-plan ou dispatchiez à partir d'un shell authentifié uniquement via une telle passerelle, chaque requête que la session faisait échouait, parce que le point de terminaison et le drapeau étaient supprimés de son environnement.
v2.1.251	Quand une session en arrière-plan démarre tandis qu'un autre processus Claude Code actualise une place de marché de plugins, comme une session sœur exécutant la mise à jour automatique de la place de marché, Claude Code garde les plugins de cette place de marché disponibles. Avant cette version, une telle session pouvait démarrer sans aucune des compétences, agents, hooks et serveurs MCP de cette place de marché et rester ainsi pendant toute son exécution.
v2.1.248	`Shift+Enter` dans l'entrée de dispatch insère une nouvelle ligne, correspondant à l'invite principale, et `Ctrl+Enter` dispatch et attache immédiatement dans les terminaux où l'overlay `?` répertorie `ctrl+enter to start and open`. Avant cette version, `Shift+Enter` dispatchait et attachait.
v2.1.248	Supprimer une session réussit quand les commits du worktree sont déjà sur la copie locale de la branche par défaut de votre remote `origin` et votre checkout principal a cette branche extraite ; avant cette version, la suppression était refusée avec `has commits that are not pushed anywhere`.
v2.1.248	Une session mise en arrière-plan avec `←` ou `/background` tient le `git worktree lock` sur son worktree tandis qu'elle s'exécute ; avant cette version, mettre en arrière-plan libérait le verrou, et le nettoyage ou `git worktree remove` pouvait supprimer le worktree sous la session en cours d'exécution.
v2.1.248	Une session en arrière-plan qui n'attendait pas votre entrée et est trouvée morte plus de 48 heures après sa dernière activité, comme après que la machine ait été éteinte pendant des jours, s'affiche comme arrêtée avec `ended while the background service was off`, et `Enter` sur elle demande avant de reprendre sa conversation enregistrée. Avant cette version, une telle session réapparaissait comme un nouvel échec trié en haut de la liste, et un simple `Enter` tirait la conversation de plusieurs semaines au premier plan.
v2.1.248	Ouvrir une ligne arrêtée dont la conversation vous avez reprise dans un autre terminal est refusé avec `Can't open — this session is running in another terminal`, et la ligne affiche `Open in a terminal` au lieu d'afficher sous `Working`. Avant cette version, ouvrir la ligne démarrait un deuxième processus écrivant dans la même conversation.
v2.1.248	Une session en arrière-plan attendant une décision de permission tandis qu'un hook `PermissionRequest` ou `PreToolUse` a imprimé une réponse invalide nomme l'événement du hook et l'erreur de schéma sur sa ligne. Avant cette version, la ligne affichait seulement la requête en attente.
v2.1.248	Sur Windows, `claude agents` répond au clavier quand lancé dans un onglet de terminal qu'un programme antérieur a laissé en mode win32-input. Avant cette version, Claude Code ne décodait pas les enregistrements de clés qu'un tel onglet envoie.
v2.1.247	Sur Linux et WSL, une session dont le processus hôte du terminal est mort échoue en quelques secondes avec la raison. Une ouverture qui ne produit aucune sortie se termine après environ dix secondes avec une offre de redémarrage, et `Enter` sur la ligne redémarre la session avec sa conversation ; `claude attach <id>` rapporte la cause et quitte. Avant cette version, ouvrir une telle session affichait `opening… · esc to cancel` indéfiniment et `claude attach <id>` attendait sans rapporter une erreur.
v2.1.246	Sur une installation npm, quand le service en arrière-plan échoue à démarrer tandis que `npm install -g @anthropic-ai/claude-code` remplace le binaire, Claude Code attend jusqu'à dix secondes pour que l'installation se termine et réessaie avant de rapporter `EACCES: permission denied`.
v2.1.246	Quand le processus du service en arrière-plan meurt après avoir imprimé une erreur, Claude Code rapporte l'échec et cite la première ligne d'erreur du service.
v2.1.246	Si votre machine s'endort tandis que le service en arrière-plan démarre, Claude Code réessaie le démarrage une fois au lieu d'échouer.
v2.1.246	Claude Code attend environ deux minutes au lieu de 45 secondes pour un service en arrière-plan nouvellement démarré qui est vivant mais lent à accepter les connexions.
v2.1.246	Le service en arrière-plan démarre à partir de votre répertoire personnel, donc sur macOS et Linux un répertoire de démarrage qui a été supprimé ou déplacé ne bloque plus le démarrage.
v2.1.246	`/fork` copie la conversation complète à partir d'une session qui elle-même a démarré comme une copie et n'a pas enregistré une nouvelle invite depuis : une copie `/fork` à laquelle vous vous êtes attaché, une session réattachée après que `←` ou `/background` l'ait déplacée en arrière-plan, ou une session démarrée avec `claude --resume <id> --fork-session`. Avant cette version, si vous exécutiez `/fork` dans une telle session avant de lui envoyer une nouvelle invite, Claude Code imprimait la confirmation normale mais démarrait la copie avec une conversation vide. Déplacer une telle session en arrière-plan avec `←` ou `/background` perdait la conversation de la même manière.
v2.1.246	Quand vous ouvrez une session que vous venez de dispatcher tandis que son processus worker démarre encore, comme en appuyant sur `Enter` sur sa ligne, Claude Code attend le processus puis s'attache. Avant cette version, si vous appuyiez sur `Enter` tandis que le processus démarrait encore, Claude Code pouvait arrêter la session avec `Session <id> was stopped while the respawn was in flight`.
v2.1.246	Quand vous mettez en arrière-plan une session nommée, Claude Code la répertorie une fois, et quand vous mettez en arrière-plan la même conversation à nouveau, il numérote le nom de la nouvelle ligne, comme `my-session (2)`, la ligne existante gardant son nom. Avant cette version, le terminal sur lequel vous avez appuyé sur `←` pouvait apparaître dans `claude agents --json` comme une deuxième session sous le même nom, et si vous mettiez en arrière-plan la même conversation à nouveau, Claude Code ajoutait une autre ligne sous le nom identique.
v2.1.239	Avec le mode éditeur vim activé, appuyer sur `Esc` dans l'entrée de la vue agent bascule du mode INSERT au mode NORMAL et conserve votre texte, correspondant à l'invite principale ; en mode NORMAL avec du texte toujours dans l'entrée, appuyer sur `Esc` l'efface, et appuyer sur `Esc` sur une entrée vide quitte, comme le décrit le raccourci `Esc`. Avant cette version, `Esc` effaçait l'entrée.
v2.1.233	Pour une session liée à une demande de fusion GitLab, Claude Code écrit l'étiquette de la ligne dans la syntaxe de référence `!1234` de GitLab. Vous pouvez également coller l'URL de la demande de fusion dans l'entrée de dispatch pour sélectionner cette session. Avant cette version, l'étiquette s'affichait comme `#1234`, et une URL de demande de fusion collée correspondait à une session uniquement quand sa première invite contenait l'URL.
v2.1.227	Supprimer une session garde la session et son worktree tandis qu'une autre session Claude Code en direct s'exécute à l'intérieur de ce répertoire worktree. La vue agent affiche `not deleted` sur la ligne et la raison dans le pied de page, et `claude rm` affiche `kept <id>` avec la raison, qui nomme l'ID de processus de l'autre session. Avant cette version, supprimer la session supprimait le worktree tandis que l'autre session travaillait encore dedans.
v2.1.225	`claude agents` dans un répertoire que vous n'avez pas approuvé affiche le même dialogue de confiance d'espace de travail que `claude` affiche au démarrage, avant que la vue agent s'ouvre. Accepter enregistre la confiance pour cet espace de travail ; refuser quitte sans ouvrir la vue agent. Avant cette version, `claude agents` s'ouvrait sans demander, donc les sessions que vous avez dispatchées à partir de celui-ci s'exécutaient dans un répertoire que vous n'aviez jamais été invité à approuver. Avec la liste groupée par répertoire, survoler la souris sur une ligne la met en évidence sans changer la cible de dispatch ; sélectionner une ligne avec les touches fléchées ou un clic change toujours la cible. Avant cette version, déplacer la souris sur une session dans un autre projet changeait silencieusement le répertoire dans lequel la prochaine session dispatchée démarrait.
v2.1.221	`/status` affiche une ligne `Session kind` : `background job · attached` ou `background job · unattended` dans une session en arrière-plan, selon qu'un terminal est attaché, et `interactive` dans toute autre session. Avant cette version, `/status` ne rapportait pas le type de session. `/fork` : Claude Code instruit la copie d'isoler son travail de celui de la session originale : la copie crée son propre worktree avant de faire des modifications de code, reste en dehors du worktree de la session originale, et base une nouvelle branche sur la branche de l'original quand sa tâche s'appuie sur ce travail. Voir la section liée pour les conditions exactes. Avant cette version, la copie ne recevait aucune instruction d'isolation et pouvait finir par modifier le worktree ou extraire le checkout sur lequel la session originale travaillait encore. Avec le mode éditeur vim activé, appuyer sur `←` juste après avoir annulé l'invite jusqu'à vide avec `u` demande la même confirmation que de supprimer le texte ou de se déplacer dans l'historique des invites, et bascule uniquement à la deuxième pression ; avant cette version la pression basculait immédiatement.
v2.1.219	Avec le mode éditeur vim activé, appuyer sur `←` sur une invite vide ouvre la vue agent à partir du mode NORMAL ainsi que INSERT, et l'indice `←` du pied de page s'affiche en mode NORMAL ; avant cette version le geste et l'indice étaient INSERT uniquement, et en mode NORMAL `←` sur une invite vide ne faisait rien. Taper dans l'entrée tandis que Claude Code attend de mettre la session en arrière-plan annule le basculement avec `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.` donc un brouillon tapé n'est pas perdu.
v2.1.218	Appuyer sur `←` dans les deux secondes d'une suppression qui a vidé l'invite, ou de se déplacer dans l'historique des invites, affiche `Press ← again to open agents`, ou `Press ← again to go back to agents` dans une session attachée, et bascule uniquement à une deuxième pression au moins une seconde plus tard ; avant cette version la pression basculait immédiatement. Un `←` qui arrive à l'intérieur d'une entrée collée ou scriptée ne déclenche plus le basculement. Mettre en arrière-plan une session au premier plan avec `←` affiche `Your conversation moved to the background` au-dessus de la liste, et `Esc` à la racine de la vue agent revient à cette conversation au lieu de quitter vers le shell, avec double `Ctrl+C` restant la sortie ; si la conversation ne peut pas être rouverte, Claude Code quitte et affiche une commande `claude --resume` pour elle. Sur Windows, un `←` appuyé dans environ une demi-seconde de l'attachement affiche `Ambiguous ←, press again to detach` et se détache à la deuxième pression.
v2.1.217	L'insigne de demande de tirage sur la ligne d'une session s'affiche comme un lien hypertexte même quand Claude Code ne peut pas détecter le support de lien hypertexte du terminal, par exemple sur SSH ou tmux ; définissez `FORCE_HYPERLINK=0` pour l'afficher en texte brut. Avant cette version, l'insigne s'affichait en texte brut quand le support n'était pas détecté.
v2.1.216	`/fork` : la confirmation est une ligne, affichant l'état de la copie, le nom de sa ligne de vue agent, et son ID de session pour `claude attach`, se terminant par `runs in the origin tree` ou `edits this checkout` uniquement quand la copie s'exécute dans l'arborescence de travail principale ou modifie le checkout que vous avez ouvert. Cliquer sur le nom met cette session en arrière-plan et ouvre la vue agent dans la session de la copie. La confirmation ne restate plus le mode de permission hérité de la copie ; les versions antérieures imprimaient une confirmation multi-ligne sans nom cliquable. Needs input : `/install-github-app` et la liste des paramètres `/mcp`, exécutées tandis que personne n'est attaché, affichent la session sous `Needs input` avec une ligne nommant la commande, et s'attacher et réexécuter la commande continue ; de v2.1.208 à v2.1.215 elles étaient refusées purement et simplement dans cet état. Restauration `--agent` : reprendre ou redémarrer une session `--agent` mise en arrière-plan restaure l'invite système de l'agent et les restrictions d'outils, en cherchant d'abord le répertoire de la session pour l'agent, quand son espace de travail est approuvé ; une session dont l'agent n'existe plus continue avec les outils par défaut et l'invite système et s'ouvre avec un avertissement visible, au lieu de revenir silencieusement à l'agent par défaut. `Ctrl+X` : appuyer dessus deux fois supprime une session même quand la tentative d'arrêt échoue, au lieu qu'un arrêt échoué annule la suppression en attente, et une session supprimée dont le processus worker était mort ne réapparaît plus à la prochaine actualisation. Suppression de worktree : une session dont le répertoire worktree n'appartient à aucun référentiel git peut être supprimée ; avant cette version chaque tentative de suppression d'une telle session était refusée. Un répertoire qui a déjà disparu s'efface immédiatement. La double pression de la vue agent supprime un répertoire qui a toujours des fichiers, en exécutant votre hook `WorktreeRemove` pour un répertoire créé par hook, sauf si les enregistrements d'une autre session le nomment aussi. `claude rm` garde un tel répertoire chaque fois que des fichiers restent.
v2.1.214	Une session mise en arrière-plan avec `←` ou `/background` et laissée inactive sans rien en cours d'exécution a son processus arrêté comme toute autre session inactive, au lieu de garder son processus et le service en arrière-plan s'exécutant indéfiniment. Une session complétée peut être supprimée avec `claude rm` ou à partir de la vue agent après que le service en arrière-plan soit devenu inactif, et une session qui a entré un worktree après avoir été dispatchée à partir d'un répertoire qui n'est pas un référentiel git, comme un dossier d'espace de travail multi-repo, peut être supprimée à partir de la vue agent quand le worktree lui-même appartient à un référentiel git, parce que le nettoyage est résolu à partir du worktree au lieu du répertoire à partir duquel la session a été dispatchée ; les deux suppressions étaient refusées à chaque tentative avant. Rouvrir une session arrêtée restaure sa conversation enregistrée même quand un dossier dans le magasin de transcriptions ne peut pas être lu.
v2.1.213	`/install-github-app`, la liste des paramètres `/mcp`, et les actions d'authentification MCP fonctionnent dans une session en arrière-plan tandis qu'un terminal est attaché, et sont refusées uniquement quand personne n'est attaché, avec un message vous disant de vous attacher et de réexécuter la commande ; de v2.1.208 à v2.1.212 elles étaient refusées même avec un terminal attaché.
v2.1.212	`/fork` dans une session interactive copie la conversation dans une nouvelle session en arrière-plan qui apparaît comme sa propre ligne, nommée d'après la session d'où elle vient ou, pour un fork invité d'une session sans nom, d'après l'invite de fork, tandis que l'original continue de s'exécuter ; le comportement antérieur de fork-subagent de `/fork` s'est déplacé vers `/subtask`. Avec la vue agent désactivée, `/fork` garde le comportement de fork-subagent. Une ligne focalisée qui attend sa première invite affiche `space to send it a prompt`. `Ctrl+J` insère une nouvelle ligne dans l'entrée de dispatch sur les terminaux avec rapport de clés étendu, où la pression de touche était précédemment ignorée, et l'overlay `?` répertorie le raccourci. L'indice de pied de page `←` dans une session interactive affiche brièvement `N done` quand une session en arrière-plan se termine tandis qu'aucune n'a besoin de votre entrée. Taper un `/resume` nu dans la vue agent ouvre un sélecteur de sessions passées du référentiel à partir duquel vous avez ouvert la vue agent, y compris les sessions supprimées de la liste, et en choisir une la reprend comme une session en arrière-plan ; avant cette version `/resume` n'était pas disponible dans la vue agent et les sessions supprimées n'étaient accessibles que via `claude --resume` ou `/resume` à partir d'une session interactive. Les formes ciblées, délimitées et restreintes conservent l'indice `attach to a session to run it` que les versions antérieures affichaient pour chaque forme. Les sessions attendant une invite de sandbox network-host, une demande d'entrée MCP, ou une invite de paramètres gérés s'affichent comme `Needs input` au lieu de `Working`, dans la vue agent et dans `claude agents --json`, et une question de Claude rapporte `waitingFor: input needed` au lieu de `permission prompt`. S'attacher à une session dont le processus s'est arrêté affiche sa transcription formatée de la manière dont la session en direct la rend, au lieu de texte brut. Une session arrêtée dont la transcription est dans un endroit inattendu reprend à partir de celle-ci via une analyse de dernier recours de vos transcriptions enregistrées, et ouvrir une ligne qui n'a pas de transcription enregistrée affiche `Press enter again to restart this session fresh`, la redémarrant à nouveau à la deuxième pression ; v2.1.211 affichait le refus sans moyen de redémarrer à partir de la vue agent.
v2.1.211	Réveiller une session arrêtée en s'attachant ou en répondant à partir du répertoire dans lequel elle s'exécute transfère à nouveau la passerelle `ANTHROPIC_BASE_URL` de votre shell, dans les mêmes conditions qu'une dispatch fraîche, donc une session authentifiée via une passerelle `ANTHROPIC_AUTH_TOKEN` reprend sur la passerelle au lieu de rapporter `Not logged in`. S'attacher à une session arrêtée qui a été mise en arrière-plan à partir d'une autre conversation avant que sa première réponse ne se termine est refusé avec `This session has no saved transcript` au lieu de démarrer silencieusement une conversation vierge sous le même ID de session ; ouvrir la même ligne à partir de la vue agent affichait le refus dans le pied de page. Terminer le processus d'une session `←` ou `/background` de l'extérieur de Claude Code la marque arrêtée au lieu que le superviseur la redémarre, un arrêt déjà enregistré sur le disque est honoré sauf si une réponse que vous avez envoyée attend toujours d'être livrée, une session redémarrée après un crash est informée qu'elle a été redémarrée, et une session `←` ou `/background` redémarrée ne reprend pas une réponse interrompue plus ancienne qu'environ une heure. Une réponse de nommage de session qui répond ou refuse l'invite au lieu de l'étiqueter, comme pour une invite qui est surtout un lien, est supprimée et la ligne garde un nom tiré du texte de l'invite. Supprimer une session dont le git du worktree ne reconnaît plus réussit, laissant le répertoire worktree sur le disque et nommant son chemin, au lieu que chaque tentative soit refusée. Un refus de suppression affiche la raison sur la ligne de la session, y compris l'erreur git sous-jacente quand le worktree n'a pas pu être supprimé, au lieu que la ligne réapparaisse silencieusement.
v2.1.210	`claude attach` attend tandis que le service en arrière-plan démarre ou se reconnecte au lieu d'échouer avec une erreur `job not found` ou `still starting`, rapporte une session qui s'est terminée pendant l'attachement comme quittée, et applique un redimensionnement de terminal effectué pendant un attachement lent quand l'attachement se termine. L'indice de pied de page `←` du nombre de besoins d'entrée apparaît sur chaque fournisseur, y compris les fournisseurs tiers qui affichaient précédemment la forme `← for agents` simple. Mettre une session en arrière-plan avec `←` porte la liste de tâches de Claude à la session en arrière-plan au lieu de la supprimer. La ligne sur laquelle vous avez appuyé sur `←` garde un nom gras et non estompé après que la sélection se déplace. `claude agents --effort` accepte `ultracode` au lieu de le supprimer silencieusement.
v2.1.208	S'attacher à une session dont le processus s'est arrêté affiche le dernier écran de sa transcription tandis que le processus démarre, au lieu d'une simple note `Session is starting`. Une réponse qui ne peut pas être livrée parce que le service en arrière-plan est inaccessible ou l'envoi échoue est enregistrée et envoyée comme l'invite suivante de la session quand son processus redémarre ; avant cette version, une réponse perdue tandis que le service en arrière-plan était inaccessible était supprimée. Un processus dont le binaire lui-même a été remplacé par une mise à jour peut toujours démarrer le superviseur, à partir du lanceur `claude` installé ou de la version la plus récente sur le disque, au lieu d'échouer jusqu'au redémarrage de Claude Code. Un superviseur exécutant une version plus ancienne ne redémarre jamais une session inactive démarrée par une version plus récente sur son propre binaire plus ancien. Supprimer une session supprime son worktree même après que la session ait déplacé le worktree sur une branche différente, et garde le worktree ensemble avec la ligne de session quand le worktree a des commits qui ne sont poussés nulle part ou une autre session le revendique, au lieu de détruire les commits ou d'orpheliner le worktree. `/install-github-app` et la liste des paramètres `/mcp` et ses actions d'authentification sont refusées dans une session en arrière-plan avec un message nommant l'alternative ; en v2.1.208 uniquement, le sélecteur `/model` a été refusé de la même manière et un `/model <name>` tapé a basculé cette session uniquement au lieu de sauvegarder également votre modèle par défaut.
v2.1.207	Le panneau d'aperçu s'ouvre avec la phrase que la ligne tronque, comme la question exacte pour une session qui vous attend, et affiche combien de temps une session bloquée a attendu comme une seule ligne `waiting 3m` au lieu de préfixer le même horodatage à la phrase de statut et à la question. Coller le même texte à nouveau dans l'entrée de dispatch développe l'espace réservé `[Pasted text #N]` réduit au lieu d'en ajouter un deuxième. Une session en arrière-plan nommée en acceptant un plan affiche ce nom sur sa ligne. Une session en arrière-plan qui s'est déplacée dans un worktree conserve sa conversation quand son processus est redémarré à partir de la vue agent.
v2.1.206	Les résumés des lignes remplissent la largeur restante de la ligne et ne tronquent qu'au bord droit du terminal au lieu de 64 colonnes. Après le redémarrage du superviseur dans une nouvelle version de Claude Code, il redémarre les sessions en arrière-plan inactives restantes sur cette version en arrière-plan au lieu de quelques par minute. Supprimer une session avec `Ctrl+X` ou `claude rm` l'efface également de la liste de sessions du superviseur, de sorte que la ligne ne réapparaît plus après un redémarrage du superviseur. Une variable de remplacement de corps de requête `CLAUDE_CODE_EXTRA_BODY` exportée dans le shell de dispatching atteint les sessions en arrière-plan au lieu d'être ignorée.
v2.1.205	L'indice de pied de page `←` du nombre de besoins d'entrée dans une session `claude` régulière compte les agents en arrière-plan vous attendant, comme `← 2 agents`. Les résumés des lignes affichent le rapport d'une ligne de la session elle-même, tronqué à 64 colonnes, au lieu d'une invocation d'outil brute ou d'un nombre `done/total` ; les lignes groupées par répertoire s'ouvrent avec un mot d'état coloré. Le panneau d'aperçu s'ouvre avec la phrase de statut complète et, pour une session vous attendant, sa question exacte au-dessus de l'entrée de réponse. Les sessions qui modifient, commentent, ferment ou marquent une demande de tirage comme prête avec `gh` y sont liées, pas seulement celles qui créent ou extraient une demande de tirage, une poussée lie une demande de tirage même quand le nom de la branche locale ne correspond pas, et une demande de tirage dont la sortie de la commande de création a dépassé la limite en ligne est également liée. Un tour sans texte lisible conserve l'état précédent de la session au lieu de le basculer vers `Working`. `claude attach` attend jusqu'à environ 60 secondes une session qui redémarre, avec une ligne de statut nommant pourquoi, au lieu d'échouer.
v2.1.203	Une passerelle `ANTHROPIC_BASE_URL` exportée dans le shell de dispatching atteint les sessions dispatchées à partir de celui-ci dans ce même répertoire quand le superviseur partage cet environnement de passerelle, au lieu d'être supprimée tandis que la clé API exportée à côté d'elle était conservée. Le `PATH` du shell de dispatching est appliqué à chaque worker de session. Appuyer sur `←` tandis que les sous-agents s'exécutent les attend au lieu de les redémarrer après dix secondes. La liste vide affiche toujours les en-têtes de section avec une description sous chacun. Taper `@` dans l'entrée de dispatch répertorie également les worktrees git enregistrés du référentiel de lancement qui vivent dans son arborescence de répertoires. Un effort hérité du paramètre `effortLevel` suit les modifications ultérieures de ce paramètre au lieu d'être fixé au dispatching. L'ouverture d'une session arrêtée dont la conversation est déjà ouverte dans une autre session en cours d'exécution est refusée avec un message au lieu d'échouer la ligne. Une commande qui n'est pas disponible dans la vue agent laisse le texte tapé dans l'entrée. Un hook `WorktreeCreate` qui échoue en dehors d'un référentiel git ne bloque plus la session de modifier les fichiers.
v2.1.202	Un nom défini avec `/rename` ou `Ctrl+R` sur une session en arrière-plan persiste quand le superviseur arrête et redémarre son processus, au lieu de revenir au nom avec lequel la session a été dispatchée.
v2.1.200	Une version plus ancienne de Claude Code qui réécrit la liste de sessions dans `roster.json` préserve les champs écrits par une version plus récente, correspondant à la garantie `state.json` existante, de sorte que les sessions démarrées par la version plus récente continuent d'accepter l'entrée après le redémarrage du superviseur. Quand vous ouvrez une session qui a cessé de répondre, le superviseur redémarre son processus et la session continue la réponse interrompue à partir de là où elle s'était arrêtée. La vue agent applique un drapeau `--plugin-dir` placé après `agents` à son propre sous-agent et à l'autocomplétion des compétences dans l'entrée de dispatch ainsi qu'aux sessions dispatchées.
v2.1.199	Une session en arrière-plan dont le processus se termine avant de finir de démarrer sur un hôte à faible mémoire affiche `possibly low memory — free some up and retry` dans le statut de sa ligne au lieu de seulement la raison de sortie brute. Mettre en arrière-plan une session avec `←` ou `/background` transfère son `/color` vers la nouvelle ligne.
v2.1.198	La vue agent envoie une notification via `preferredNotifChannel` quand une session en arrière-plan a besoin d'une entrée, se termine ou échoue, et déclenche le hook `Notification` avec le type `agent_needs_input` ou `agent_completed`. `←` et `/exit` à l'intérieur de `claude attach <id>` reviennent à la vue agent au lieu de quitter vers le shell ; `Ctrl+Z` revient au shell. Une session en arrière-plan qui a isolé son travail dans un worktree valide, pousse sa propre branche isolée, jamais `main` ou `master`, et ouvre une demande de tirage en brouillon quand elle se termine au lieu de demander d'abord. `/login` s'exécute dans la vue agent et ouvre la boîte de dialogue de connexion. La boîte de dialogue de sortie `Background work is running` propose `Move to background and exit`. Le transfert de sortie couvre également les sous-agents en arrière-plan, qui reprennent à partir de leur transcription à la prochaine activation au lieu d'être signalés comme échoués. `claude --bg` combiné avec `-p` ou `--print` est rejeté avec une erreur. L'hôte de session en arrière-plan demande la permission de réseau local macOS à la première utilisation du LAN au lieu d'échouer avec `connect: no route to host`.
v2.1.196	Une seule pression sur `←` met en arrière-plan une session au premier plan ; les versions antérieures nécessitaient deux pressions, avec un indice de pied de page et une confirmation. `--dangerously-skip-permissions` passé à `claude agents` affiche la clause de non-responsabilité du contournement au lieu d'être silencieusement supprimé. Les sessions interactives que vous n'avez jamais nommées portent un nom par défaut comme `my-app-3f` dans les listes de sessions et `claude agents --json`. Les commandes shell en arrière-plan et les workflows dynamiques survivent à l'arrêt, au redémarrage ou à la mise à jour du processus de la session, y compris sur Windows ; définissez `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` pour désactiver le transfert. Une transcription mal lue comme vide au redémarrage est renommée avec un suffixe `.orphaned-` au lieu d'être supprimée.
v2.1.195	Le travail en cours se transfère aussi quand vous mettez en arrière-plan une session sur Windows ; définissez `CLAUDE_DISABLE_ADOPT=1` pour l'arrêter à la place. Le groupe `Completed` remplit l'espace vertical restant et l'en-tête se compacte sur les terminaux courts. Une version plus ancienne de Claude Code ne supprime plus les champs `state.json` plus récents des sessions ou ne cache plus ces sessions de `claude agents`. S'attacher à une session arrêtée bascule immédiatement au lieu d'afficher un écran vide pendant jusqu'à cinq secondes. Un superviseur qui ne peut pas accepter les connexions quitte et libère son verrou de lui-même.
v2.1.191	`claude --bg` avec un nom `--agent` qui ne correspond à aucun de vos sous-agents échoue le lancement : la session quitte immédiatement avec une erreur `--agent '<name>' not found` au lieu de s'exécuter avec l'agent par défaut.
v2.1.174	Les sessions en arrière-plan n'héritent plus des variables de point de terminaison de passerelle comme `ANTHROPIC_BASE_URL` du shell de lancement du superviseur ; le superviseur fournit un nouvel instantané d'identifiants aux workers préchauffés, corrigeant les erreurs `Could not resolve authentication method` spurieuses.
v2.1.172	`/model` dans l'entrée de dispatch définit un remplacement du modèle de dispatch limité à la session.
v2.1.161	Les résumés des lignes affichent un nombre `done/total` pour les éléments de travail parallèles ; le panneau d'aperçu nomme l'élément de travail parallèle le plus long en cours d'exécution.
v2.1.157	`claude agents` accepte `--agent` ; les sessions dispatchées honorent le paramètre `agent`.
v2.1.145	La dictée vocale supportée dans l'entrée de réponse du panneau d'aperçu et l'entrée de dispatch.
v2.1.143	Le paramètre `worktree.bgIsolation` ajouté ; `claude agents` accepte `--allow-dangerously-skip-permissions`.
v2.1.142	`claude agents` accepte `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`, `--settings`, `--add-dir`, `--plugin-dir`, `--mcp-config`, et `--strict-mcp-config`.
v2.1.141	`claude agents` accepte `--cwd` pour limiter la liste à un projet.
v2.1.139	La vue agent introduite comme un aperçu de recherche.

agent-view.md +519 −235

16 16

17Quand vous voulez travailler plus directement dans la session d'un agent, attachez-vous à la ligne pour entrer dans la conversation complète.17Quand vous voulez travailler plus directement dans la session d'un agent, attachez-vous à la ligne pour entrer dans la conversation complète.

18 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](/docs/fr/agents).~~19Pour comparer la vue agent avec les sous-agents, les équipes d'agents et les worktrees, consultez [Exécuter les agents en parallèle](/docs/fr/agents). La vue agent exécute les sessions sur votre machine et vous lancez chacune d'elles ; pour que Claude démarre et suive les sessions parallèles dans le cloud à partir d'une seule conversation, consultez [Projets](/docs/fr/claude-projects).

20 20

21<Note>21<Note>

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.22 La vue agent est en aperçu de recherche. L'interface et les raccourcis clavier peuvent changer à mesure que la fonctionnalité évolue.

23</Note>23</Note>

24 24

~~25Cette page couvre :~~

~~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~~

~~28* [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~~

~~29* [Lancer de nouveaux agents](#dispatch-new-agents) à partir de la vue agent, depuis l'intérieur d'une session, ou depuis votre shell~~

~~30* [Gérer les sessions depuis le shell](#manage-sessions-from-the-shell) avec `claude agents`, `claude attach` et les commandes associées~~

~~31* [Comment les sessions en arrière-plan sont hébergées](#how-background-sessions-are-hosted) par le processus superviseur~~

33<h2 id="quick-start">25<h2 id="quick-start">

34 Démarrage rapide26 Démarrage rapide

35</h2>27</h2>

44 claude agents36 claude agents

45 ```37 ```

46 38

47 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.39 Si vous n'avez pas encore accepté la [boîte de dialogue de confiance de l'espace de travail](/docs/fr/permissions#project-allow-rules-and-workspace-trust) pour le répertoire, Claude Code l'affiche avant que la vue agent ne s'ouvre, la même boîte de dialogue que `claude` affiche. Acceptez pour enregistrer la confiance pour l'espace de travail et continuer. Si vous refusez, Claude Code se ferme sans ouvrir la vue agent.

41 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` pour revenir à votre shell ; si vous avez ouvert la vue agent en mettant une session en arrière-plan avec `←`, `Esc` revient à cette conversation à la place. Vos sessions continuent de s'exécuter pendant que vous êtes absent et réapparaissent la prochaine fois que vous ouvrez la vue agent.

48 </Step>42 </Step>

49 43

50 <Step title="Dispatcher une session">44 <Step title="Dispatcher une session">

51 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-model-and-effort) que vous obtiendriez en exécutant `claude` dans ce répertoire.45 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. [Le mode de permission dans lequel elle démarre](#permission-mode-model-and-effort) dépend de la façon dont vous avez ouvert la vue agent.

52 46

53 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.47 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.

54 48

64 </Step>58 </Step>

65 59

66 <Step title="Amener une session existante">60 <Step title="Amener une session existante">

67 Cette étape nécessite une session en cours d'exécution. Si vous avez suivi les étapes précédentes, vous n'en avez pas ouverte dans ce terminal, ouvrez donc une session `claude` régulière dans un autre terminal et envoyez-lui d'abord un message. 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.61 Cette étape nécessite une session en cours d'exécution. Si vous avez suivi les étapes précédentes, vous n'en avez pas ouverte dans ce terminal, ouvrez donc une session `claude` régulière dans un autre terminal et envoyez-lui d'abord un message.

63 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. Dans une session nouvelle sans messages encore, `/bg` vous demande d'envoyer d'abord un message, tandis que `←` fonctionne immédiatement. 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.

68 </Step>64 </Step>

69</Steps>65</Steps>

70 66

71Vous 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.67Vous 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.

72 68

73À l'intérieur d'une session `claude` régulière, l'indice `←` du pied de page de l'invite compte les agents en arrière-plan qui attendent votre intervention, comme `← 2 agents`, et revient à `← for agents` quand aucun n'a besoin d'entrée. Les comptages supérieurs à 99 s'affichent comme `99+`. Le comptage se rafraîchit environ toutes les dix secondes lorsque le terminal est actif et immédiatement quand le focus revient. Il change brièvement de couleur quand il se déplace et quand un agent se termine, sauf si le paramètre [`prefersReducedMotion`](/docs/fr/settings#available-settings) est activé, et il est masqué en [mode lecteur d'écran](/docs/fr/accessibility). Sur [Amazon Bedrock, Google Cloud's Agent Platform, et Microsoft Foundry](/docs/fr/third-party-integrations), l'indice reste sous sa forme simple `← for agents` sans le comptage. Nécessite Claude Code v2.1.205 ou ultérieur.69À l'intérieur d'une session `claude` régulière, l'indice `←` du pied de page de l'invite compte les agents en arrière-plan qui attendent votre intervention, comme `← 2 agents`, et revient à `← for agents` quand aucun n'a besoin d'entrée. Les comptages supérieurs à 99 s'affichent comme `99+`. Le comptage se rafraîchit environ toutes les dix secondes lorsque le terminal est actif et immédiatement quand le focus revient. Il change brièvement de couleur quand il se déplace et quand un agent se termine, et quand une session en arrière-plan se termine alors qu'aucune n'a besoin de votre intervention, elle affiche brièvement le nombre complété, comme `← 2 done`. Les deux flashs sont désactivés quand le paramètre [`prefersReducedMotion`](/docs/fr/settings-reference#prefersreducedmotion) est activé, et l'indice est masqué en [mode lecteur d'écran](/docs/fr/accessibility).

74 70

75<h2 id="monitor-sessions-with-agent-view">71<h2 id="monitor-sessions-with-agent-view">

76 Surveiller les sessions avec la vue agent72 Surveiller les sessions avec la vue agent

77</h2>73</h2>

78 74

79Exé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 son ancienneté, comptée à partir du moment où la session a été créée ; l'ancienneté d'une session terminée se fige à la durée de l'exécution.75Exé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 vous attendent en haut. Chaque ligne affiche le nom de la session, l'activité actuelle et son ancienneté, comptée à partir de la création de la session ; l'ancienneté d'une session terminée se fige à la durée d'exécution.

80 76

81Le nom est teinté avec la couleur définie par [`/color`](/docs/fr/commands) dans cette session. À partir de la v2.1.199, la couleur se transporte quand vous [mettez une session en arrière-plan](#from-inside-a-session) avec `←` ou `/background`.77Le nom est teinté de la couleur définie par [`/color`](/docs/fr/commands) dans cette session, y compris lorsque vous [mettez une session en arrière-plan](#from-inside-a-session) avec `←` ou `/background`.

82 78

83Par défaut, la 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. Pour limiter la liste à un projet, passez `--cwd` :79Par défaut, la 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 un worktree différent apparaissent toutes les deux ici, quel que soit le répertoire à partir duquel vous avez ouvert la vue agent. Pour réduire la liste à un projet, passez `--cwd` :

84 80

85```bash theme={null}81```bash theme={null}

86claude agents --cwd ~/projects/my-app82claude agents --cwd ~/projects/my-app

87```83```

88 84

89Cela affiche uniquement les sessions démarrées sous ce répertoire. Une session qui a [déménagé dans une worktree](#how-file-edits-are-isolated) sous `~/projects/my-app/.claude/worktrees/` compte toujours comme appartenant à `~/projects/my-app`.85Cela affiche uniquement les sessions démarrées sous ce répertoire. Elle répertorie toujours une session qui a [déménagé dans un worktree](#how-file-edits-are-isolated) sous `~/projects/my-app/.claude/worktrees/`.

90 86

91Les 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](/docs/fr/sub-agents) et les [coéquipiers](/docs/fr/agent-teams) qu'une session génère ne sont pas répertoriés comme des lignes séparées.87Les sessions interactives que vous avez ouvertes dans d'autres terminaux n'apparaissent que lorsque vous les [mettez en arrière-plan](#from-inside-a-session). Les [sous-agents](/docs/fr/sub-agents) et les [coéquipiers](/docs/fr/agent-teams) qu'une session génère ne sont pas répertoriés comme des lignes distinctes.

92 88

93```text theme={null}89```text theme={null}

~~94Épinglées~~90Pinned

95 ✽ clawd walk cycle Drawing the walk-cycle sprite frames 3m91 ✽ clawd walk cycle Drawing the walk-cycle sprite frames 3m

96 92

~~97Prêtes pour examen~~93Ready for review

98 ∙ jump physics Opened PR with collision fix #2048 2h94 ∙ jump physics Opened PR with collision fix #2048 2h

99 95

100Nécessite une intervention96Needs input

101 ✻ power-up design double jump or wall climb? 1m97 ✻ power-up design double jump or wall climb? 1m

102 98

103En cours99Working

104 ✽ collision detection Adding swept-AABB checks to CollisionSystem 2m100 ✽ collision detection Adding swept-AABB checks to CollisionSystem 2m

105 ✢ playtest level 3 run 12 · all checkpoints cleared in 4m101 ✢ playtest level 3 run 12 · all checkpoints cleared in 4m

106 102

107Terminées103Completed

108 ✻ title screen result: menu, options, and credits done 9m104 ✻ title screen result: menu, options, and credits done 9m

109 ∙ sound effects result: 14 SFX exported to assets/audio 4h105 ∙ sound effects result: 14 SFX exported to assets/audio 4h

110 … 6 more106 … 6 more

114 Lire l'état de la session110 Lire l'état de la session

115</h3>111</h3>

116 112

117Chaque ligne commence par une icône dont la couleur et l'animation montrent l'état de la session :113Chaque ligne commence par une icône dont la couleur et l'animation indiquent l'état de la session :

118 114

120| :------------------------- | :---------------------- | :-------------------------------------------------------------------------------- |116| :---------- | :---------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

122| Nécessite une intervention | Jaune | Claude attend une question spécifique ou une décision de permission de votre part |118| Needs input | Jaune | Claude attend quelque chose que seul vous pouvez fournir : une réponse à une question, une décision d'autorisation, ou une autre invite que seul vous pouvez répondre, comme une invite [sandbox](/docs/fr/sandboxing) pour autoriser un hôte réseau ou la [demande d'entrée](/docs/fr/mcp#respond-to-mcp-elicitation-requests) d'un serveur MCP. Une commande qui nécessite un terminal attaché, comme `/install-github-app` ou la liste des paramètres `/mcp`, [maintient également une session sans surveillance ici](#attach-to-a-session) |

126| Arrêtée | Gris | La session a été arrêtée avec `Ctrl+X` ou `claude stop` |122| Stopped | Grise | Vous avez arrêté la session avec `Ctrl+X` ou `claude stop`, [son processus a été terminé de l'extérieur de Claude Code](#the-supervisor-process), ou [elle s'est terminée alors que le service en arrière-plan était désactivé](#sessions-show-as-failed-after-shutdown) |

127 123

128Séparément, la forme de l'icône indique si le processus sous-jacent s'exécute :124Séparément, la forme de l'icône indique si le processus sous-jacent est en cours d'exécution :

129 125

130| Forme | Ce que cela signifie |126| Forme | Ce que cela signifie |

131| :--------------- | :------------------------------------------------------------------------------------------------------------------------------------------ |127| :---------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

133| `∙` | 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é |129| `∙` | Le processus a quitté. Vous pouvez toujours jeter un coup d'œil à la ligne, et lorsque vous répondez ou attachez, Claude redémarre à partir de là où il s'était arrêté |

134| `✢` | Une session [`/loop`](/docs/fr/scheduled-tasks) dormant entre les itérations. La ligne affiche son nombre d'exécutions et un compte à rebours |130| `✢` | Une session [`/loop`](/docs/fr/scheduled-tasks) en sommeil entre les itérations. La ligne affiche son nombre d'exécutions et un compte à rebours |

131

132L'étiquette `#N` ou `!N` qui peut apparaître au bord droit d'une ligne est un lien vers la [demande de tirage ou demande de fusion](#pull-request-status) de la session, et non une partie de l'icône d'état.

135 133

136L'étiquette `#N` qui peut apparaître au bord droit d'une ligne est la [pull request que la session est liée à](#pull-request-status), pas une partie de l'icône d'état.134Le titre de l'onglet du terminal affiche le nombre d'entrées en attente pendant que la vue agent est ouverte : `2 awaiting input · claude agents` lorsque les sessions ont besoin d'entrée, ou `claude agents` lorsqu'aucune n'en a besoin.

137 135

138Le titre de l'onglet du terminal affiche le nombre d'entrées en attente pendant que la vue agent est ouverte : `2 awaiting input · claude agents` quand les sessions ont besoin d'une intervention, ou `claude agents` quand ce n'est pas le cas.136Pour lire l'état de la session à partir d'un script ou d'un autre programme, utilisez [`claude agents --json`](#read-session-state-from-a-script) plutôt que les fichiers sous `~/.claude/jobs/`.

139 137

140À partir de la v2.1.198, pendant que la vue agent est ouverte, Claude Code envoie également une notification via votre [canal de notification de terminal configuré](/docs/fr/terminal-config#get-a-terminal-bell-or-notification) quand une session en arrière-plan local commence à avoir besoin de votre intervention, se termine, ou échoue. Les sessions qui s'exécutent selon un calendrier, comme les sessions [`/loop`](/docs/fr/scheduled-tasks), ne notifient que quand elles ont besoin de votre intervention. Les notifications utilisent le même paramètre [`preferredNotifChannel`](/docs/fr/settings#available-settings) que le reste de Claude Code et déclenchent le hook [`Notification`](/docs/fr/hooks#notification) avec le type `agent_needs_input` ou `agent_completed`.138Pendant que la vue agent est ouverte, Claude Code envoie également une notification via votre [canal de notification de terminal](/docs/fr/terminal-config#get-a-terminal-bell-or-notification) configuré lorsqu'une session en arrière-plan local commence à avoir besoin de votre entrée, se termine ou échoue. Les sessions qui s'exécutent selon un calendrier, comme les sessions [`/loop`](/docs/fr/scheduled-tasks), ne notifient que lorsqu'elles ont besoin de votre entrée. Les notifications utilisent le même paramètre [`preferredNotifChannel`](/docs/fr/settings-reference#preferrednotifchannel) que le reste de Claude Code et déclenchent le hook [`Notification`](/docs/fr/hooks#notification) avec le type `agent_needs_input` ou `agent_completed`.

141 139

142Les 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.140Les sessions en arrière-plan n'ont besoin d'aucun terminal ouvert pour continuer à fonctionner. Un [processus superviseur](#the-supervisor-process) distinct les exécute, vous pouvez donc fermer la vue agent, fermer votre shell ou démarrer une nouvelle session interactive et votre travail envoyé continue.

143 141

144L'état de la session persiste sur le disque via les mises à jour automatiques et les redémarrages du superviseur. Les sessions sont également préservées quand votre machine se met en veille. Leurs processus reprennent au réveil et le superviseur se reconnecte à eux au lieu de traiter l'écart de temps comme inactif. L'arrêt arrête toujours les sessions en cours ; consultez [Les sessions s'affichent comme échouées après l'arrêt](#sessions-show-as-failed-after-shutdown) pour savoir comment les récupérer.142L'état de la session persiste sur le disque via les mises à jour automatiques et les redémarrages du superviseur. Les sessions sont également préservées lorsque votre machine se met en veille. Leurs processus reprennent au réveil et le superviseur se reconnecte à eux au lieu de traiter l'écart de temps comme inactif. L'arrêt arrête toujours les sessions en cours d'exécution ; voir [Sessions affichées comme échouées ou arrêtées après l'arrêt](#sessions-show-as-failed-after-shutdown) pour savoir comment les récupérer.

145 143

146Quand vous ouvrez une session qui a cessé de répondre, le superviseur redémarre son processus et la session continue la réponse interrompue à partir de là où elle s'était arrêtée. Une session peut se retrouver dans cet état quand la machine se met en veille pendant qu'elle est en train de répondre. Nécessite Claude Code v2.1.200 ou ultérieur.144Une session qui était en pleine réponse lorsque la machine s'est mise en veille peut revenir sans réponse. Lorsque vous ouvrez une session qui a cessé de répondre, le superviseur redémarre son processus et la session continue la réponse interrompue à partir de là où elle s'était arrêtée.

147 145

148<h3 id="row-summaries">146<h3 id="row-summaries">

149 Résumés des lignes147 Résumés de lignes

150</h3>148</h3>

151 149

152Le résumé d'une ligne dans chaque ligne est généré par un [modèle de classe Haiku](/docs/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 texte de la ligne se met à jour au maximum une fois toutes les 15 secondes à partir de la sortie récente de la session sans envoyer une demande de modèle, et le modèle écrit un résumé frais quand chaque tour se termine.150Le résumé d'une ligne est généré par un [modèle de classe Haiku](/docs/fr/model-config) afin que la ligne puisse vous dire ce que la session fait, ce dont elle a besoin ou ce qu'elle a produit sans ouvrir la transcription. Pendant qu'une session travaille activement, le texte de la ligne se met à jour au maximum une fois toutes les 15 secondes à partir de la sortie récente de la session sans envoyer de demande de modèle, et le modèle écrit un résumé frais à la fin de chaque tour.

153 151

154Une ligne de travail affiche ce que la session dit qu'elle fait, et une ligne bloquée affiche la question qu'elle pose. Pendant un long tour, le modèle réécrit également le résumé environ une fois par minute, attendant deux fois plus longtemps après chaque réécriture jusqu'à quatre minutes, donc une ligne occupée n'affiche pas continuellement un résumé obsolète. Le texte du résumé remplit la largeur restante de la ligne et ne se tronque qu'au bord droit du terminal ; ouvrez le [panneau d'aperçu](#peek-and-reply) pour lire une phrase que le bord coupe. Avant la v2.1.206, le texte était coupé à 64 colonnes quel que soit la largeur du terminal.152Une ligne de travail affiche ce que la session dit qu'elle fait, et une ligne bloquée affiche la question qu'elle pose. Pendant un long tour, le modèle réécrit également le résumé toutes les quelques minutes afin qu'une ligne occupée ne continue pas à afficher un résumé obsolète. Le texte du résumé remplit la largeur restante de la ligne ; ouvrez le [panneau d'aperçu](#peek-and-reply) pour lire une phrase que le bord du terminal coupe.

155 153

156Quand la liste est [groupée par répertoire](#organize-the-list), le résumé s'ouvre avec l'état de la session en tant que mot coloré, comme `Needs input · double jump or wall climb?`. Dans le groupement d'état par défaut, l'en-tête du groupe nomme déjà l'état, donc la ligne affiche uniquement le résumé. Avant la v2.1.205, les lignes groupées par répertoire ne portaient aucun mot d'état.154Lorsque la liste est [groupée par répertoire](#organize-the-list), le résumé s'ouvre avec l'état de la session en tant que mot coloré, comme `Needs input · double jump or wall climb?`. Dans le groupement d'état par défaut, l'en-tête du groupe nomme déjà l'état, la ligne affiche donc uniquement le résumé.

157 155

158Un tour dont la sortie entière ne contient aucune lettre ni chiffre, comme une session [`/loop`](/docs/fr/scheduled-tasks) qui imprime un seul symbole sur une itération silencieuse, conserve le résumé et l'état précédents de la ligne. Avant la v2.1.205, ce tour a été reclassé et pouvait faire basculer une session qui attendait votre intervention vers `En cours`.156Le résumé de fin de tour et chaque réécriture à mi-tour sont 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](/docs/fr/data-usage) que la session elle-même. Les mises à jour de 15 secondes entre les réécritures de modèle réutilisent la sortie de la session elle-même et n'envoient pas de demande. Sur un fournisseur tiers ou une passerelle sans modèle de classe Haiku configuré, la demande utilise le modèle principal de la session à la place ; définissez [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/docs/fr/model-config#environment-variables) pour en choisir un.

~~159~~

160Le résumé de fin de tour et chaque réécriture à mi-tour sont 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](/docs/fr/data-usage) que la session elle-même. Sur les fournisseurs tiers tels que Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, et les passerelles personnalisées, la demande revient au modèle principal de la session quand aucun modèle Haiku n'est configuré. Définissez [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/docs/fr/model-config#environment-variables) pour choisir le modèle pour ces résumés sur ces fournisseurs.

161 157

162<h3 id="pull-request-status">158<h3 id="pull-request-status">

163 Statut de la pull request159 État de la demande de tirage

164</h3>160</h3>

165 161

166Quand une session ouvre une pull request, une étiquette `#1234` apparaît au bord droit de la ligne, liée à la pull request dans les terminaux qui supportent les hyperliens. L'étiquette persiste quand vous envoyez un suivi à la session, donc la pull request reste visible pendant que la ligne revient à la progression en direct. Les sessions en arrière-plan qui ont isolé leurs modifications dans une worktree ouvrent elles-mêmes ces pull requests ; [Comment les modifications de fichiers sont isolées](#how-file-edits-are-isolated) couvre quand cela se produit et ce qu'une session ne fait jamais sans demander.162Lorsqu'une session [ouvre une demande de tirage](#how-file-edits-are-isolated), Claude Code ajoute une étiquette au bord droit de la ligne, liée à la demande de tirage :

163

164* Claude Code écrit l'étiquette comme `#1234` pour une demande de tirage et comme `!1234` pour une demande de fusion GitLab.

165* Claude Code émet le lien même lorsqu'il ne peut pas détecter la prise en charge des hyperliens, par exemple sur SSH ou tmux. Définissez [`FORCE_HYPERLINK=0`](/docs/fr/env-vars) pour afficher l'étiquette en tant que texte brut.

166* Après avoir envoyé un suivi à la session, Claude Code conserve l'étiquette tandis que la ligne revient à la progression en direct.

167 167

168Une session qui travaille sur une pull request existante y est liée de la même manière. Éditer, commenter, fermer, ou marquer une pull request comme prête avec `gh` lie la pull request que la sortie de la commande elle-même nomme, donc une commande `gh` dont la sortie capturée ne nomme aucune pull request ne crée pas de lien ; `gh pr merge` est le cas courant, car il imprime son résultat uniquement sur un terminal interactif. Vérifier une pull request avec `gh pr checkout`, ou pousser vers une branche qui a une pull request ouverte, la lie en cherchant cette branche avec `gh pr view` à la place. Avant la v2.1.205, seules les pull requests que la session a créées ou vérifiées étaient liées, et une poussée en liait une uniquement quand le nom de la branche locale correspondait.168Une session qui travaille sur une demande de tirage existante y est liée de la même manière. Claude Code trouve la demande de tirage différemment selon la commande que Claude exécute :

169 169

170Claude Code lit la pull request à partir de la sortie complète de la commande, y compris la partie enregistrée dans un fichier quand la sortie d'une commande dépasse la limite en ligne. Avant la v2.1.205, une pull request créée dans un appel Bash dont la sortie dépassait environ 30 000 caractères n'était pas liée.170* Lorsque Claude modifie, commente, ferme ou marque une demande de tirage comme prête avec `gh`, Claude Code lie la demande de tirage que la sortie de la commande elle-même nomme. Une commande `gh` dont la sortie capturée ne nomme aucune demande de tirage ne crée pas de lien ; `gh pr merge` est le cas courant, car il imprime son résultat uniquement sur un terminal interactif.

171* Lorsque Claude extrait une demande de tirage avec `gh pr checkout` ou pousse vers une branche, Claude Code recherche la branche avec `gh pr view` et lie sa demande de tirage ouverte.

172* La demande de tirage n'a pas besoin d'exister encore lorsque Claude pousse : Claude Code réessaie la recherche de branche après jusqu'à cinq commandes `git`, `gh`, `glab` ou `curl` ultérieures exécutées dans le même répertoire, afin qu'une demande de tirage créée après le push, y compris celle que Claude crée via l'API REST GitHub, se lie lorsqu'une nouvelle tentative la trouve.

171 173

172Quand une session est liée à plus d'une pull request, l'étiquette affiche un nombre à la place, comme `3 PRs`, colorée par la pull request ouverte qui a le plus besoin d'attention. Ouvrez le [panneau d'aperçu](#peek-and-reply) pour les voir toutes.174Lorsqu'une session est liée à plus d'une demande de tirage, l'étiquette affiche un nombre à la place, comme `3 PRs`, colorée par la demande de tirage ouverte qui a le plus besoin d'attention. Ouvrez le [panneau d'aperçu](#peek-and-reply) pour les voir toutes.

173 175

174Le numéro de la pull request est coloré par son statut :176Le numéro de la demande de tirage est coloré selon son état :

175 177

176| Couleur | Statut de la pull request |178| Couleur | État de la demande de tirage |

177| :------ | :----------------------------------------------------------------------- |179| :------ | :----------------------------------------------------------------------- |

178| Jaune | En attente de vérifications ou d'examen, ou les vérifications ont échoué |180| Jaune | En attente de vérifications ou d'examen, ou les vérifications ont échoué |

179| Vert | Les vérifications ont réussi et aucun examen ne bloque |181| Vert | Les vérifications ont réussi et aucun examen ne bloque |

180| Violet | Fusionnée |182| Violet | Fusionné |

181| Gris | Brouillon ou fermée |183| Gris | Brouillon ou fermé |

182 184

183Pour la plupart des tâches, cette colonne est l'endroit où vous collectez le résultat : examinez et fusionnez la pull request quand son numéro devient vert.185Pour une tâche qui se termine par une demande de tirage, vérifiez cette étiquette pour le résultat : examinez et fusionnez la demande de tirage lorsque son numéro devient vert.

184 186

185<h3 id="peek-and-reply">187<h3 id="peek-and-reply">

186 Aperçu et réponse188 Aperçu et réponse

187</h3>189</h3>

188 190

189Appuyez sur `Espace` sur une ligne sélectionnée pour ouvrir le panneau d'aperçu. Il s'ouvre avec la phrase que la ligne tronque au bord du terminal, et quelle phrase c'est dépend de l'état de la session :191Appuyez sur `Space` sur une ligne sélectionnée pour ouvrir le panneau d'aperçu. Il s'ouvre avec la phrase que la ligne tronque au bord du terminal, et quelle phrase c'est dépend de l'état de la session :

190 192

191* Une session qui attend votre intervention : la question exacte qu'elle pose, au-dessus de l'entrée de réponse193* Une session qui vous attend : la question exacte qu'elle pose, au-dessus de l'entrée de réponse

192* Une session terminée : son résultat194* Une session terminée : son résultat

193* Une session en cours : sa phrase d'état complète195* Une session de travail : sa phrase d'état complète

194 196

195Toutes les pull requests liées à la session sont répertoriées ensuite. Pour une session qui attend votre intervention, une ligne comme `waiting 3m` en dessous d'elles montre depuis combien de temps elle attend, et c'est la seule fois affichée dans le panneau. L'ancienneté au bord droit de la ligne est un nombre différent : elle compte à partir du moment où la session a démarré.197Toutes les demandes de tirage liées à la session sont répertoriées ensuite. Pour une session qui vous attend, une ligne comme `waiting 3m` en dessous d'elles montre depuis combien de temps elle attend, et c'est la seule fois affichée dans le panneau. L'ancienneté au bord droit de la ligne est un nombre différent : elle compte à partir du moment où la session a démarré.

196 198

197La plupart du temps, le panneau d'aperçu est suffisant et vous n'avez pas besoin d'ouvrir la transcription complète.199La plupart du temps, le panneau d'aperçu suffit et vous n'avez pas besoin d'ouvrir la transcription complète.

198 200

199Avant la v2.1.207, chaque aperçu s'ouvrait avec la phrase d'état et un horodatage nu, et une session bloquée avait sa question affichée en dessous d'eux préfixée avec le même horodatage une deuxième fois.201Tapez une réponse dans le panneau d'aperçu et appuyez sur `Enter` pour l'envoyer à cette session. Lorsque la session pose une question avec des choix prédéfinis, le panneau d'aperçu les affiche sous forme de liste numérotée et vous pouvez appuyer sur une touche numérique pour en choisir une. Une invite de permission s'affiche sous forme de texte décrivant ce que la session souhaite exécuter, sans options numérotées. Tapez une réponse pour y répondre, ou attachez-vous pour répondre avec l'invite standard. 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.

200 202

201Tapez 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.203Lorsqu'un hook [`PermissionRequest`](/docs/fr/hooks#permissionrequest) ou [`PreToolUse`](/docs/fr/hooks#pretooluse) retourne une sortie que Claude Code ne peut pas valider pour l'appel que la session demande, la ligne affiche l'événement du hook et `hook output invalid:` avec l'erreur de validation avant le texte de la demande en attente. Pour un hook qui échoue d'une autre manière, la ligne dit que le hook a échoué. La session attend toujours la même demande.

202 204

203Une réponse qui ne peut pas être livrée, parce que le service en arrière-plan est inaccessible ou l'envoi échoue, est enregistrée et envoyée à la session comme son prochain message quand son processus redémarre, et le message d'erreur dit que la réponse a été enregistrée. Une réponse préfixée avec `!` n'est pas enregistrée, car le texte enregistré atteindrait la session comme un message simple plutôt que de s'exécuter comme une commande Bash.205Une réponse qui ne peut pas être livrée, parce que le service en arrière-plan est inaccessible ou que l'envoi échoue, est enregistrée et envoyée à la session comme sa prochaine invite lorsque son processus redémarre, et le message d'erreur dit que la réponse a été enregistrée. Une réponse préfixée avec `!` n'est pas enregistrée, car le texte enregistré atteindrait la session en tant qu'invite simple plutôt que d'exécuter en tant que commande Bash.

204 206

205Avec la [dictée vocale](/docs/fr/voice-dictation) activée, maintenez ou appuyez sur votre touche push-to-talk pendant que l'entrée de réponse est active pour dicter une réponse au lieu de la taper. La même chose fonctionne dans l'entrée de lancement en bas de la vue agent.207Avec la [dictée vocale](/docs/fr/voice-dictation) activée, maintenez ou appuyez sur votre touche push-to-talk pendant que l'entrée de réponse est concentrée pour dicter une réponse au lieu de la taper. La même chose fonctionne dans l'entrée de dispatch en bas de la vue agent.

206 208

207Utilisez `↑` et `↓` pour apercevoir les sessions adjacentes sans fermer le panneau, ou `→` pour vous attacher.209Utilisez `↑` et `↓` pour jeter un coup d'œil aux sessions adjacentes sans fermer le panneau, ou `→` pour vous attacher.

208 210

209<h3 id="attach-to-a-session">211<h3 id="attach-to-a-session">

210 S'attacher à une session212 Attacher à une session

211</h3>213</h3>

212 214

213Appuyez 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. Quand vous vous attachez, Claude affiche un court récapitulatif de ce qui s'est passé pendant que vous étiez absent.215Appuyez sur `Enter` ou `→` sur une ligne sélectionnée pour vous attacher. La vue agent est remplacée par la session interactive complète. Lorsque vous vous attachez, Claude publie un court récapitulatif de ce qui s'est passé pendant que vous étiez absent.

216

217Pendant que vous êtes attaché, la session se comporte comme n'importe quelle autre session Claude Code : les [commandes](/docs/fr/commands), les raccourcis clavier et les fonctionnalités fonctionnent tous, à l'exception des cas ci-dessous.

218

219Pendant que vous êtes attaché, `/install-github-app` et la liste des paramètres [`/mcp`](/docs/fr/mcp) fonctionnent normalement, car un humain au terminal peut compléter leurs dialogues. Lorsque personne n'est attaché, ces commandes ne peuvent pas ouvrir leurs dialogues, la session apparaît donc sous `Needs input` dans la vue agent avec une ligne comme `open this session to manage MCP servers`, et la réponse de la transcription dit la même chose. Attachez-vous et exécutez à nouveau la commande pour continuer ; la ligne needs-input s'efface lorsque vous vous attachez. `/mcp reconnect <server>`, `/mcp enable` et `/mcp disable` fonctionnent sans s'attacher de toute façon.

220

221Les sessions attachées s'affichent toujours en [mode plein écran](/docs/fr/fullscreen), quel que soit votre paramètre `tui`, car une session en arrière-plan n'a pas de défilement de terminal pour ajouter. Faites défiler avec `PgUp`, `PgDn` ou la molette de la souris, et appuyez sur `Ctrl+O` pour le mode transcription. Le défilement natif de votre terminal et le mode copie tmux affichent uniquement la fenêtre d'affichage actuelle, comme lorsque vous exécutez n'importe quelle application plein écran.

222

223Appuyez sur `←` sur une invite vide, ou exécutez `/exit`, pour vous détacher et revenir à la vue agent, que vous ayez ouvert la session à partir de la vue agent ou avec `claude attach <id>` à partir de votre shell.

224

225`←` se détache également pendant que la [superposition `/btw`](/docs/fr/interactive-mode#side-questions-with-%2Fbtw) est ouverte. Nécessite Claude Code v2.1.257 ou ultérieur. Une question latérale qui répond toujours continue de s'exécuter pendant que vous êtes absent. La prochaine fois que vous vous attachez, la superposition se rouvre avec elle, ou avec sa réponse.

226

227Sur Windows, si vous appuyez sur `←` dans environ une demi-seconde après vous être attaché, Claude Code affiche `Ambiguous ←, press again to detach`, car dans cette fenêtre le terminal peut redélivrer une pression d'avant votre attachement. Appuyez sur `←` à nouveau pour vous détacher.

228

229`Ctrl+Z` se détache également mais revient à où vous avez commencé à la place : la vue agent si vous vous êtes attaché à partir de là, ou votre shell si vous avez exécuté `claude attach`. Utilisez `Ctrl+Z` lorsqu'un dialogue a le focus et ne répond pas à `←`.

230

231`Ctrl+C` conserve son comportement d'interruption standard pendant l'attachement : il annule une réponse en cours d'exécution ou une commande shell `!` plutôt que de se détacher. Appuyer sur `Ctrl+C` deux fois sur une invite vide se détache, comme dans n'importe quelle session.

232

233Le détachement n'arrête jamais une session en arrière-plan : `←`, `Ctrl+Z`, `/exit` et double `Ctrl+C` ou double `Ctrl+D` la laissent tous en cours d'exécution. Pour terminer une session de l'intérieur, exécutez `/stop`.

234

235<h4 id="switch-sessions-without-leaving-the-terminal">

236 Basculer les sessions sans quitter le terminal

237</h4>

214 238

215Pendant que vous êtes attaché, la session se comporte comme n'importe quelle autre session Claude Code : les [commandes](/docs/fr/commands), raccourcis clavier, et fonctionnalités fonctionnent tous, avec les exceptions ci-dessous.239Dans une session s'exécutant au premier plan, une que vous avez démarrée dans le terminal plutôt que de vous y attacher à partir de la vue agent, appuyer sur `←` sur une invite vide la met en arrière-plan et ouvre la vue agent avec cette ligne sélectionnée, afin que vous puissiez basculer les sessions sans quitter le terminal. Le même appui unique détache une session attachée.

216 240

217Une session en arrière-plan refuse `/install-github-app` et la liste des paramètres [`/mcp`](/docs/fr/mcp), y compris ses actions d'authentification, que vous soyez attaché ou que vous répondiez à partir du panneau d'aperçu. Le message vous dirige vers une session `claude` régulière, et `/mcp reconnect <server>`, `/mcp enable`, et `/mcp disable` fonctionnent toujours.241Si vous appuyez sur `←` juste après avoir supprimé le dernier texte de l'invite ou vous être déplacé dans l'historique des invites, Claude Code vous demande de confirmer : le premier appui affiche `Press ← again to open agents`, ou `Press ← again to go back to agents` dans une session attachée, et le deuxième appui bascule.

218 242

219Les sessions attachées s'affichent toujours en [mode plein écran](/docs/fr/fullscreen), quel que soit votre paramètre `tui`, car une session en arrière-plan n'a pas d'historique de terminal à ajouter. Faites défiler avec `PgUp`, `PgDn`, ou la molette de la souris, et appuyez sur `Ctrl+O` pour le mode transcription. Le défilement natif de votre terminal et le mode copie tmux affichent uniquement la fenêtre d'affichage actuelle, comme lorsque vous exécutez n'importe quelle application plein écran.243Lorsque `←` met une session au premier plan en arrière-plan, la vue agent affiche `Your conversation moved to the background` au-dessus de la liste, avec la ligne de cette session déjà sélectionnée. À partir de là :

220 244

221À partir de la v2.1.198, appuyez sur `←` sur une invite vide, ou exécutez `/exit`, pour vous détacher et revenir à la vue agent. À partir de la v2.1.198, cela fonctionne de la même manière que vous ayez ouvert la session à partir de la vue agent ou avec `claude attach <id>` à partir de votre shell.245* Appuyez sur `Enter` pour rouvrir la conversation.

246* Appuyez sur `Esc` pour annuler le basculement et revenir à la conversation. Si `Esc` affiche `Still starting — try again in a moment`, la session en arrière-plan n'est pas encore prête, appuyez donc sur `Esc` à nouveau dans un moment.

247* Appuyez sur `Ctrl+C` deux fois pour quitter vers votre shell.

222 248

223`Ctrl+Z` se détache également mais revient à l'endroit où vous avez commencé à la place : la vue agent si vous vous êtes attaché à partir de là, ou votre shell si vous avez exécuté `claude attach`. Utilisez `Ctrl+Z` quand une boîte de dialogue a le focus et ne répond pas à `←`.249Lorsque Claude Code ne peut pas rouvrir la conversation, il quitte et imprime une commande `claude --resume` qui la reprend.

224 250

225`Ctrl+C` conserve son comportement d'interruption standard pendant que vous êtes attaché : il annule une réponse en cours d'exécution ou une commande shell `!` plutôt que de vous détacher. Appuyer sur `Ctrl+C` deux fois sur une invite vide vous détache, comme dans n'importe quelle session.251La [liste des tâches de Claude](/docs/fr/interactive-mode#task-list) se déplace vers la session en arrière-plan avec la conversation, afin que la liste de contrôle soit intacte lorsque vous reveniez à cette ligne.

226 252

227Se détacher n'arrête jamais une session en arrière-plan : `←`, `Ctrl+Z`, `/exit`, et double `Ctrl+C` ou double `Ctrl+D` la laissent toutes s'exécuter. Pour terminer une session depuis l'intérieur, exécutez `/stop`.253La ligne sur laquelle vous avez appuyé sur `←` conserve également un nom gras et non estompé après avoir déplacé la sélection avec les touches fléchées ou la souris, afin que vous puissiez dire de quelle session vous venez.

228 254

229Dans une session s'exécutant au premier plan, une que vous avez démarrée dans le terminal plutôt que de vous y attacher à partir de la vue agent, appuyer sur `←` sur une invite vide la met en arrière-plan et ouvre la vue agent avec cette ligne sélectionnée, vous pouvez donc basculer entre les sessions sans quitter le terminal. La même pression unique détache une session attachée.255Si un outil s'exécute lorsque vous appuyez sur `←`, Claude Code attend environ dix secondes qu'il se termine avant de mettre en arrière-plan, et Claude continue la réponse dans la session en arrière-plan. Appuyez sur `←` à nouveau pour mettre en arrière-plan immédiatement au lieu d'attendre. Lorsque le travail en vol ne peut pas être transféré à la session en arrière-plan, Claude Code affiche d'abord le dialogue `Background this session?`, comme avec [`/background`](#from-inside-a-session).

230 256

231Si un outil s'exécute quand vous appuyez sur `←`, Claude Code attend jusqu'à environ dix secondes pour qu'il se termine avant de mettre en arrière-plan, et la réponse continue dans la session en arrière-plan. Appuyez sur `←` à nouveau pour mettre en arrière-plan immédiatement au lieu d'attendre. Quand le travail en cours ne peut pas se transférer à la session en arrière-plan, la boîte de dialogue `Background this session?` apparaît d'abord, la même que avec [`/background`](#from-inside-a-session).257La limite de dix secondes ne s'applique pas pendant que les [sous-agents au premier plan](/docs/fr/sub-agents#run-subagents-in-foreground-or-background) que Claude a démarrés dans la conversation s'exécutent toujours. Claude Code continue d'attendre afin que leur travail soit transféré, et affiche un avis `Still backgrounding after the current tool` pendant qu'il attend. Appuyez sur `←` à nouveau pour mettre en arrière-plan sans attendre, ce qui redémarre ces sous-agents à partir du début. Claude Code n'attend pas les sous-agents qu'un [flux de travail dynamique](/docs/fr/workflows) exécute. Lorsqu'un flux de travail a des sous-agents en cours d'exécution, Claude Code affiche le dialogue `Background this session?` à la place.

232 258

233La limite de dix secondes ne s'applique pas pendant que les [sous-agents](/docs/fr/sub-agents) s'exécutent. Claude Code continue d'attendre pour que leur travail se transporte, et affiche un avis `Still backgrounding after the current tool` pendant qu'il attend ; appuyez sur `←` à nouveau pour mettre en arrière-plan sans attendre, ce qui redémarre les sous-agents depuis le début. Avant la v2.1.203, l'attente s'est terminée après dix secondes et les sous-agents en cours d'exécution ont été redémarrés depuis le début sans avertissement.259Claude Code ne met pas la session en arrière-plan pendant que vous avez du texte non envoyé dans l'entrée d'invite, car le texte reste dans la boîte d'entrée de votre terminal et ne se déplacerait pas vers la session en arrière-plan. Si vous tapez dans l'entrée pendant que Claude Code attend de mettre la session en arrière-plan, il annule le basculement avec `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.`

234 260

235La ligne est créée même à partir d'une session nouvelle sans historique de conversation, donc `→` y revient. Avant la v2.1.203, la vue agent affichait un indice d'intégration en dessous de cette ligne quand elle était la seule.261Appuyer sur `←` crée la ligne de la session même lorsque la conversation n'a pas encore de messages, afin que `→` revienne toujours à elle.

236 262

237Vous pouvez désactiver ce raccourci avec le paramètre `leftArrowOpensAgents` dans `/config`.263Vous pouvez désactiver ce raccourci avec le paramètre `leftArrowOpensAgents` dans `/config`.

238 264

240 Organiser la liste266 Organiser la liste

241</h3>267</h3>

242 268

243La 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.269La vue agent groupe les sessions afin que celles qui ont besoin d'entrée soient en haut, avec `Ready for review` et `Needs input` au-dessus de `Working` et `Completed`. Ces noms de groupe ne correspondent pas un-à-un aux [états](#read-session-state) ci-dessus : une session se déplace vers `Ready for review` lorsqu'elle a une demande de tirage ouverte, et `Completed` collecte les sessions terminées, échouées et arrêtées ensemble.

244 270

245Appuyez sur `Ctrl+S` pour grouper par répertoire à la place. Votre choix persiste entre les exécutions.271Appuyez sur `Ctrl+S` pour grouper par répertoire à la place. Votre choix persiste entre les exécutions.

246 272

249* Appuyez sur `Ctrl+T` pour épingler une session en haut et [garder son processus en cours d'exécution](#the-supervisor-process) pendant l'inactivité275* Appuyez sur `Ctrl+T` pour épingler une session en haut et [garder son processus en cours d'exécution](#the-supervisor-process) pendant l'inactivité

250* Appuyez sur `Shift+↑` ou `Shift+↓` pour réorganiser les sessions276* Appuyez sur `Shift+↑` ou `Shift+↓` pour réorganiser les sessions

251* Appuyez sur `Ctrl+R` pour renommer une session277* Appuyez sur `Ctrl+R` pour renommer une session

252* Appuyez sur `Entrée` sur un en-tête de groupe pour le réduire278* Appuyez sur `Enter` sur un en-tête de groupe pour le réduire

253 279

254Pour 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.280Pour 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.

255 281

256La suppression supprime la session de la vue agent. Si Claude a [créé une worktree](#how-file-edits-are-isolated) pour la session, la suppression supprime également cette worktree, y compris toutes les modifications non validées qu'elle contient, donc poussez ou validez le travail que vous voulez conserver en premier. Une worktree que vous avez créée vous-même et dans laquelle vous avez démarré la session est laissée en place. La transcription de conversation reste sur votre machine locale et reste disponible via `claude --resume`.282Le deuxième appui supprime la session même lorsque la tentative d'arrêt échoue, par exemple parce que le [service en arrière-plan ne répond pas](#agent-view-says-the-background-service-did-not-respond) : la confirmation reste active pendant deux secondes supplémentaires, et la suppression termine le processus de la session lui-même. Appuyez sur `Esc` pour rejeter la confirmation sans supprimer.

257 283

258La suppression n'enlève jamais une worktree avec des commits qui ne sont poussés nulle part, ou une qui est revendiquée ou verrouillée par une autre session en cours d'exécution. Claude Code garde la worktree et la session, et le pied de page nomme le chemin conservé et la raison. Poussez les commits, ou fermez l'autre session, puis supprimez à nouveau.284Sauf dans les cas conservés couverts dans [Ce que la suppression d'une session supprime](#what-deleting-a-session-removes), la suppression supprime la session de la liste, et un worktree que Claude a créé pour elle est supprimé, conservé ou laissé en place selon la façon dont vous supprimez et ce que le worktree contient. La transcription de la conversation reste toujours sur votre machine locale, disponible via `claude --resume`.

259 285

260La suppression efface également la session de la [liste de sessions du superviseur](#the-supervisor-process), que vous supprimiez avec `Ctrl+X` ou avec [`claude rm`](#manage-sessions-from-the-shell) à partir du shell, donc la suppression persiste entre les redémarrages du superviseur. Avant la v2.1.206, supprimer une session pendant que le superviseur redémarrait ou était inaccessible la laissait dans cette liste, et le superviseur suivant redémarrait son processus et affichait la ligne à nouveau.286Pour ramener une session sur Claude Code v2.1.212 ou ultérieur, tapez `/resume` dans l'entrée de dispatch. Un sélecteur s'ouvre avec les sessions passées du référentiel à partir duquel vous avez ouvert la vue agent, les plus récentes en premier, y compris les sessions que vous avez supprimées de la liste ; les sessions qui ont déjà une ligne ne sont pas répertoriées. `↑`/`↓` déplacent la sélection, `Enter` reprend la session sélectionnée en tant que session en arrière-plan afin qu'elle se réjoigne la liste en tant que ligne, et `Esc` ferme le sélecteur.

261 287

262Les sessions terminées qui ne tiennent pas à l'écran se replient dans une ligne `… N more`. Les échecs et les sessions avec une pull request ouverte restent toujours visibles. Le groupe `Completed` remplit l'espace vertical restant après les groupes actifs, et sur un terminal court, l'en-tête se compacte en une seule ligne de résumé pour que les sessions qui fonctionnent ou ont besoin d'une intervention restent visibles.288Le sélecteur s'ouvre uniquement pour un `/resume` nu. Une reprise ciblée, scoped ou restreinte ne peut pas être servie par le sélecteur, la vue agent affiche donc l'indice `attach to a session to run it` à la place lorsque :

289

290* `/resume` nomme un id ou un terme de recherche

291* la vue est scoped avec `--cwd`

292* la vue a été démarrée avec [`--safe-mode`](/docs/fr/cli-reference#cli-flags)

293* la vue a été ouverte avec un drapeau comme `--permission-mode` ou `--settings`

294

295Les sessions terminées qui ne rentrent pas à l'écran se replient dans une ligne `… N more`. Les défaillances et les sessions avec une demande de tirage ouverte restent toujours visibles. Le groupe `Completed` remplit l'espace vertical laissé après les groupes en direct, et sur un terminal court, l'en-tête se compacte en une seule ligne de résumé afin que les sessions qui travaillent ou ont besoin d'entrée restent visibles.

263 296

264<h3 id="filter-sessions">297<h3 id="filter-sessions">

265 Filtrer les sessions298 Filtrer les sessions

266</h3>299</h3>

267 300

268Tapez dans l'entrée de lancement pour filtrer au lieu de lancer :301Tapez dans l'entrée de dispatch pour filtrer au lieu de dispatcher :

269 302

270| Filtre | Affiche |303| Filtre | Affiche |

271| :------------------------- | :----------------------------------------------------------------------------------------------------------- |304| :------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------- |

273| `s:<state>` | Sessions dans l'état donné, comme `s:working`. Accepte également `s:blocked` pour tout ce qui attend de vous |306| `s:<state>` | Sessions dans l'état donné, comme `s:working`. Accepte également `s:blocked` pour tout ce qui vous attend |

275| N'importe quelle autre URL | La session dont la première invite contenait cette URL |308| N'importe quelle autre URL | La session dont la première invite contenait cette URL |

276 309

277<h3 id="keyboard-shortcuts">310<h3 id="keyboard-shortcuts">

281Appuyez sur `?` dans la vue agent pour voir chaque raccourci en contexte. Le tableau ci-dessous les résume.314Appuyez sur `?` dans la vue agent pour voir chaque raccourci en contexte. Le tableau ci-dessous les résume.

282 315

283| Raccourci | Action |316| Raccourci | Action |

284| :-------------------- | :------------------------------------------------------------------------------------------------- |317| :-------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

285| `↑` / `↓` | Se déplacer entre les lignes |318| `↑` / `↓` | Se déplacer entre les lignes |

289| `→` | S'attacher à la session sélectionnée |322| `Ctrl+Enter` | Dispatcher et attacher immédiatement, dans les terminaux où la superposition `?` répertorie `ctrl+enter to start and open` |

290| `Alt+1`..`Alt+9` | S'attacher à la session 1–9 dans le répertoire de la session active |323| `→` | Attacher à la session sélectionnée |

324| `Alt+1`..`Alt+9` | Attacher à la session 1–9 dans le répertoire de la session concentrée |

291| `Tab` | Sur une entrée vide, parcourir tous les sous-agents. Sinon appliquer la suggestion en surbrillance |325| `Tab` | Sur une entrée vide, parcourir tous les sous-agents. Sinon appliquer la suggestion en surbrillance |

330| `Ctrl+J` | Insérer une nouvelle ligne dans l'entrée de dispatch |

298| `Esc` | Fermer le panneau d'aperçu, effacer l'entrée, ou quitter |333| `Esc` | Fermer le panneau d'aperçu, effacer l'entrée ou quitter. Lorsque vous avez ouvert la vue agent en mettant votre session en arrière-plan avec `←`, le `Esc` final revient à cette conversation au lieu de quitter. Avec le [mode éditeur vim](/docs/fr/interactive-mode#vim-editor-mode) activé, appuyer sur `Esc` dans l'entrée bascule du mode INSERT au mode NORMAL et conserve votre texte, comme dans l'invite principale |

300| `?` | Afficher tous les raccourcis |335| `?` | Afficher tous les raccourcis |

301 336

337`Ctrl+S`, `Ctrl+T` et `Ctrl+G` suivent votre [`keybindings.json`](/docs/fr/keybindings). Reliez ou déliez `Ctrl+S` et `Ctrl+T` avec les actions `agents:switchView` et `agents:togglePin` dans le contexte [`Agents`](/docs/fr/keybindings#agents-actions), et `Ctrl+G` via la liaison `chat:externalEditor` du contexte `Chat`. Les autres raccourcis du tableau ne peuvent pas être reliés.

338

302<h2 id="dispatch-new-agents">339<h2 id="dispatch-new-agents">

303 Lancer de nouveaux agents340 Lancer de nouveaux agents

304</h2>341</h2>

311 348

312Tapez 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`.349Tapez 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`.

313 350

314Un nom que la session obtient plus tard apparaît également sur sa ligne, y compris le nom que Claude dérive quand vous [acceptez un plan](/docs/fr/permission-modes#review-and-approve-a-plan) dans cette session. Avant la v2.1.207, une session en arrière-plan nommée en acceptant un plan affichait ce nom dans `/status` mais pas sur sa ligne de vue agent jusqu'à ce que vous la renommiez vous-même.351Le nom automatique est un court libellé écrit par un [modèle de classe Haiku](/docs/fr/model-config). Un nom que la session obtient plus tard apparaît également sur sa ligne, y compris le [titre généré](/docs/fr/sessions#name-your-sessions) que la session obtient quand vous [acceptez un plan](/docs/fr/permission-modes#review-and-approve-a-plan) dans cette session.

315 352

316Collez une image dans l'invite pour inclure une capture d'écran ou un diagramme avec la tâche.353Collez une image dans l'invite pour inclure une capture d'écran ou un diagramme avec la tâche.

317 354

318Le texte collé plus long que 800 caractères ou plus de deux lignes s'effondre en un espace réservé `[Pasted text #N]` pour que l'entrée reste sur une ligne ; le texte complet est envoyé quand vous lancez. Pour examiner ou modifier le texte effondré avant de lancer, collez le même texte à nouveau et l'espace réservé se développe dans l'entrée. Un rappel `paste again to expand` apparaît sous l'entrée pendant quelques secondes après le collage sur les terminaux d'au moins 90 colonnes de large. Avant la v2.1.207, coller le même texte à nouveau ajoutait un deuxième espace réservé au lieu de développer le premier.355Le texte collé plus long que 800 caractères ou plus de trois lignes s'effondre en un espace réservé `[Pasted text #N]` pour que l'entrée reste sur une ligne ; le texte complet est envoyé quand vous lancez. Pour examiner ou modifier le texte effondré avant de lancer, collez le même texte à nouveau et l'espace réservé se développe dans l'entrée.

319 356

320Préfixez ou mentionnez des parties de l'invite pour contrôler comment la session démarre :357Préfixez ou mentionnez des parties de l'invite pour contrôler comment la session démarre :

321 358

322| Entrée | Effet |359| Entrée | Effet |

323| :------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |360| :------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

324| `<agent-name> <prompt>` | Si le premier mot correspond à un nom de [sous-agent](/docs/fr/sub-agents) personnalisé, ce sous-agent s'exécute comme l'agent principal de la session avec la configuration de son frontmatter |361| `<agent-name> <prompt>` | Si le premier mot correspond à un nom de [sous-agent](/docs/fr/sub-agents) personnalisé, ce sous-agent s'exécute comme l'agent principal de la session avec la configuration de son frontmatter |

325| `@<agent-name>` | Mentionnez un sous-agent personnalisé n'importe où dans l'invite pour l'exécuter comme l'agent principal |362| `@<agent-name>` | Mentionnez un sous-agent personnalisé n'importe où dans l'invite pour l'exécuter comme l'agent principal |

326| `@<repo>` | Mentionnez un référentiel pour exécuter la session là. Voir [Lancer vers un répertoire spécifique](#dispatch-to-a-specific-directory) pour savoir quels référentiels sont listés |363| `@<repo>` | Mentionnez un référentiel pour exécuter la session là. Voir [Lancer vers un répertoire spécifique](#dispatch-to-a-specific-directory) pour savoir quels référentiels sont listés |

328| `! <command>` | Exécutez une commande shell comme une tâche en arrière-plan au lieu de démarrer une session Claude. La tâche apparaît comme une ligne à laquelle vous pouvez vous attacher, regarder et vous détacher |365| `! <command>` | Exécutez une commande shell comme une tâche en arrière-plan au lieu de démarrer une session Claude. La tâche apparaît comme une ligne à laquelle vous pouvez vous attacher, regarder et vous détacher |

329| `#<number>` ou une URL de pull request | Si une session travaille déjà sur cette PR, sélectionnez-la au lieu de lancer |366| `#<number>` ou une URL de pull request ou merge request | Si une session travaille déjà sur cette pull request ou merge request, Claude Code sélectionne sa ligne au lieu de lancer une nouvelle session |

330| `Shift+Entrée` | Lancer et s'attacher immédiatement à la nouvelle session |

331 367

332Un petit ensemble de commandes s'exécutent dans la vue agent elle-même au lieu de lancer :368Un petit ensemble de commandes s'exécutent dans la vue agent elle-même au lieu de lancer :

333 369

334* `/exit` et `/quit` ferment la vue agent370* `/exit` et `/quit` ferment la vue agent

335* `/logout` vous déconnecte371* `/logout` vous déconnecte

336* `/model` définit le [modèle de lancement](#set-the-model)372* `/model` définit le [modèle de lancement](#set-the-model)

337* À partir de la v2.1.198, `/login` ouvre la boîte de dialogue de connexion pour que vous puissiez vous connecter à nouveau sans vous attacher à une session373* `/login` ouvre la boîte de dialogue de connexion pour que vous puissiez vous connecter à nouveau sans vous attacher à une session

374* Un `/resume` nu, ou son alias `/continue`, ouvre un sélecteur des sessions passées du référentiel pour [en ramener une](#organize-the-list) comme une session en arrière-plan. Nécessite Claude Code v2.1.212 ou ultérieur

338 375

339Les skills, vos propres commandes, et les built-ins qui développent les invites comme `/init` sont envoyés à une nouvelle session en arrière-plan comme leur première invite. Les autres commandes built-in affichent plutôt un indice `attach to a session to run it`. Tout ce que vous avez tapé reste dans l'entrée à côté de l'indice pour que vous puissiez le modifier. Avant la v2.1.203, l'indice effaçait l'entrée et le texte tapé était perdu.376Les skills, vos propres commandes, et les built-ins qui développent les invites comme `/init` sont envoyés à une nouvelle session en arrière-plan comme leur première invite. Les autres commandes built-in affichent plutôt un indice `attach to a session to run it`. Tout ce que vous avez tapé reste dans l'entrée à côté de l'indice pour que vous puissiez le modifier.

340 377

341Empaqueter une tâche récurrente comme un [skill](/docs/fr/skills) vous permet de démarrer le même workflow à partir de la vue agent à plusieurs reprises sans retaper l'invite.378Empaqueter une tâche récurrente comme un [skill](/docs/fr/skills) vous permet de démarrer le même workflow à partir de la vue agent à plusieurs reprises sans retaper l'invite.

342 379

355 * Les [git worktrees](/docs/fr/worktrees) enregistrés du référentiel à partir duquel vous avez lancé qui vivent à l'intérieur de son arborescence de répertoires, comme ceux que Claude crée sous `.claude/worktrees/`, étiquetés avec leur branche extraite. Les worktrees ajoutés en dehors du référentiel, comme avec `git worktree add ../feature`, ne sont pas listés392 * Les [git worktrees](/docs/fr/worktrees) enregistrés du référentiel à partir duquel vous avez lancé qui vivent à l'intérieur de son arborescence de répertoires, comme ceux que Claude crée sous `.claude/worktrees/`, étiquetés avec leur branche extraite. Les worktrees ajoutés en dehors du référentiel, comme avec `git worktree add ../feature`, ne sont pas listés

356 * Tout répertoire qui a déjà une session dans la liste393 * Tout répertoire qui a déjà une session dans la liste

357 394

358 Un répertoire dont le nom contient un espace n'est pas listé. Avant la v2.1.203, les worktrees enregistrés n'étaient pas listés, donc lancer dans l'un d'eux signifiait exécuter `claude --bg` à partir du répertoire de ce worktree.395 Un répertoire dont le nom contient un espace n'est pas listé.

359* Depuis le shell, `cd` dans le répertoire et exécutez `claude --bg "<prompt>"`.396* Depuis le shell, `cd` dans le répertoire et exécutez `claude --bg "<prompt>"`.

360 397

361Quand 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.398Quand la vue agent est groupée par répertoire, le lancement envoie l'invite au répertoire de la ligne sélectionnée, vous pouvez donc sélectionner un groupe et lancer dedans sans retaper le chemin.

362 399

363<h3 id="from-inside-a-session">400<h3 id="from-inside-a-session">

364 À partir d'une session401 À partir d'une session

365</h3>402</h3>

366 403

404Deux commandes déplacent le travail de la session dans laquelle vous êtes vers l'arrière-plan : `/background` envoie la conversation actuelle là et libère votre terminal, et `/fork` envoie une copie tandis que vous continuez à travailler où vous êtes.

405

406<h4 id="send-the-session-to-the-background">

407 Envoyer la session en arrière-plan

408</h4>

409

367Exé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. Si Claude répond quand vous exécutez `/bg`, la réponse continue dans la session en arrière-plan.410Exé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. Si Claude répond quand vous exécutez `/bg`, la réponse continue dans la session en arrière-plan.

368 411

369Quitter une session interactive qui a encore du travail en arrière-plan en cours d'exécution, comme des sous-agents, des commandes shell en arrière-plan, des workflows, ou des [monitors](/docs/fr/tools-reference#monitor-tool), affiche une boîte de dialogue `Background work is running` au lieu de quitter immédiatement. À partir de la v2.1.198, la boîte de dialogue propose `Move to background and exit` aux côtés de `Exit anyway` et `Stay`. La choisir déplace la session en arrière-plan de la même manière que `/background` le fait, puis vous ramène à votre shell, donc le travail qui peut se poursuivre continue de s'exécuter et la session apparaît dans la vue agent. L'option n'est pas affichée quand la vue agent est [désactivée](#turn-off-agent-view).412Quitter une session qui a encore du travail en arrière-plan en cours d'exécution, comme des sous-agents, des commandes shell en arrière-plan, des workflows, ou des [monitors](/docs/fr/tools-reference#monitor-tool), affiche une boîte de dialogue `Background work is running` au lieu de quitter immédiatement. Choisissez `Move to background and exit` pour mettre la session en arrière-plan de la même manière que `/background` le fait et revenir à votre shell. L'option n'est pas affichée quand la vue agent est [désactivée](#turn-off-agent-view).

413

414Si une session en arrière-plan sur la liste a déjà le nom de la conversation, Claude Code numérote le nom de la nouvelle ligne, comme `my-session (2)`, et laisse le nom de la ligne existante seul. Pour renommer la nouvelle ligne, sélectionnez-la dans la vue agent et appuyez sur `Ctrl+R`.

415

416<h4 id="copy-the-session-with-/fork">

417 Copier la session avec /fork

418</h4>

419

420Exécutez `/fork` pour copier la conversation actuelle dans une nouvelle session en arrière-plan tandis que l'original continue de s'exécuter. La copie commence avec tout ce qui se trouve dans la conversation jusqu'à ce point ; voir les puces ci-dessous pour savoir où la copie s'exécute. Elle porte également le modèle, le mode de permission, le niveau d'effort, et tous les répertoires ou les autorisations « ne pas demander à nouveau » que vous avez ajoutés pendant la session. La copie apparaît comme sa propre ligne dans la vue agent.

421

422Après le fork, les deux conversations sont indépendantes : rien de ce que la copie fait n'entre dans la conversation originale de son propre chef, bien que dans les sessions où la [messagerie inter-sessions](/docs/fr/cross-session-messaging) est activée, Claude de l'une ou l'autre session peut explicitement envoyer un message à l'autre.

423

424Copier la session nécessite Claude Code v2.1.212 ou ultérieur ; sur v2.1.161 à v2.1.211, `/fork` démarre un [sous-agent forké](/docs/fr/sub-agents#fork-the-current-conversation) à la place, qui est maintenant `/subtask`. Quand la [vue agent est désactivée](#turn-off-agent-view), `/fork` conserve le comportement du sous-agent forké et `/subtask` n'est pas disponible.

425

426Passez une invite comme `/fork open a draft pull request with the work so far` et la copie commence à travailler dessus immédiatement. Sans une invite, la copie attend sa première instruction : sélectionnez sa ligne dans `claude agents` et appuyez sur `Espace` pour en envoyer une, ou exécutez `claude attach <id>`. La ligne sélectionnée affiche `space to send it a prompt` tandis qu'elle attend.

427

428La confirmation `/fork` est une ligne montrant l'état de la copie, comme `session running`, le nom de sa ligne de vue agent, et son ID de session pour `claude attach`. Cliquez sur le nom pour basculer dans la copie : cette session se déplace en arrière-plan, de la même manière qu'appuyer sur `←`, et la vue agent ouvre la session de la copie.

429

430Sauf quand la copie [édite sur place](#how-file-edits-are-isolated), Claude Code lui ordonne de créer sa propre worktree avant de faire des modifications de code. En dehors d'un référentiel git, seule une copie déplacée hors d'une worktree créée par hook reçoit l'instruction ; sans hook [`WorktreeCreate`](/docs/fr/hooks#worktreecreate), la copie édite sur place. Une copie déplacée hors de votre worktree est également informée de ne jamais éditer, exécuter des commandes dans, ou entrer dans cette worktree, quel que soit le paramètre d'isolation.

431

432L'endroit où la copie démarre dépend de l'endroit où la session actuelle s'exécute :

433

434* Comme toute session lancée, la copie [se déplace dans sa propre worktree avant d'éditer des fichiers](#how-file-edits-are-isolated). Dans ce cas, la confirmation ne mentionne pas où la copie s'exécute.

435* Quand votre session s'est déplacée dans sa [worktree](/docs/fr/worktrees) liée après son démarrage, la copie démarre là où la session était avant le déplacement et, sauf si elle [édite sur place](#how-file-edits-are-isolated), fait ses modifications de code dans sa propre worktree là. Quand votre worktree est extraite sur une branche, cette instruction dit également à une copie dont la tâche s'appuie sur votre travail de baser sa nouvelle branche sur la vôtre, puisque votre branche reste extraite dans votre worktree. La confirmation se termine par `runs in the origin tree`.

436* Quand vous avez lancé la session à l'intérieur d'une worktree liée d'un référentiel qui a un arbre de travail principal, la copie démarre dans cet arbre de travail principal, avec la même règle de worktree-de-la-sienne mais sans instruction de branche. La confirmation se termine par `runs in the origin tree` ici aussi.

437* Une session lancée à l'intérieur d'une worktree d'une disposition de référentiel nu n'a pas d'arbre de travail principal auquel revenir, donc la copie reste où elle est, et la confirmation se termine par `edits this checkout`. La même note apparaît quand l'isolation de worktree est [désactivée](#how-file-edits-are-isolated) dans une session qui n'est pas à l'intérieur d'une worktree liée, parce que la copie édite alors les fichiers que vous avez ouverts.

370 438

371Mettre en arrière-plan à partir d'une session interactive démarre un processus nouveau qui reprend à partir de la conversation enregistrée, et le travail en cours se transfère à celui-ci : les commandes shell en arrière-plan en cours d'exécution, les sous-agents mis en arrière-plan, les workflows dynamiques, et les tâches planifiées que vous avez créées avec [`/loop`](/docs/fr/scheduled-tasks) se transfèrent à la session en arrière-plan et continuent de s'exécuter là. Un sous-agent se déplace avec tout ce qu'il a démarré, donc il se transfère uniquement quand tout ce travail peut se transférer aussi, y compris sur Windows. Pour arrêter le travail en cours au lieu de le transférer, définissez la variable d'environnement [`CLAUDE_DISABLE_ADOPT=1`](/docs/fr/env-vars#variables) ; Claude Code vous demande alors de confirmer avant de mettre en arrière-plan.439Les sessions démarrées avec des drapeaux de lancement que la copie n'hériterait pas, comme une invite système remplacée ou une liste d'autorisation `--tools`, ne peuvent pas être forkées ; Claude Code le dit au lieu de faire une copie partielle. Une session lancée à partir de la vue agent se forke normalement : la copie est lancée avec la même [définition d'agent](/docs/fr/sub-agents) et les instructions ajoutées que la session dont elle provient.

372 440

373Le travail qui ne peut pas se transférer, comme un [monitor](/docs/fr/tools-reference#monitor-tool) en cours d'exécution, est arrêté. Un sous-agent mis en arrière-plan qui possède un monitor est arrêté avec lui. Quand un tel travail s'exécute, Claude Code affiche une boîte de dialogue `Background this session?` pour que vous puissiez confirmer avant qu'il soit arrêté.441<h4 id="what-carries-over-when-you-background">

442 Ce qui se transfère quand vous mettez en arrière-plan

443</h4>

444

445Mettre en arrière-plan démarre un processus nouveau qui reprend à partir de la conversation enregistrée, et le travail en cours se transfère à celui-ci : les commandes shell en arrière-plan en cours d'exécution, les sous-agents mis en arrière-plan, les workflows dynamiques, les tâches planifiées que vous avez créées avec [`/loop`](/docs/fr/scheduled-tasks), et les [réponses automatiques de Claude aux commentaires d'artefacts](/docs/fr/artifacts#let-claude-reply-to-comments-on-its-own) se transfèrent tous et continuent de s'exécuter là. Un sous-agent se déplace avec tout ce qu'il a démarré, donc il se transfère uniquement quand tout ce travail peut se transférer aussi. Pour arrêter le travail en cours au lieu de le transférer, définissez la variable d'environnement [`CLAUDE_DISABLE_ADOPT=1`](/docs/fr/env-vars#variables) ; Claude Code vous demande alors de confirmer avant de mettre en arrière-plan.

446

447Quand un [workflow dynamique](/docs/fr/workflows) a encore des sous-agents en cours d'exécution, Claude Code demande avant de mettre en arrière-plan avec la boîte de dialogue `Background this session?`, qui dit combien de sous-agents redémarreraient. Choisissez `Stay` pour les laisser terminer d'abord. Si vous confirmez, Claude Code rejoue l'exécution dans la session en arrière-plan : les sous-agents qui s'exécutaient encore recommencent depuis le début, donc les tokens qu'ils ont utilisés jusqu'à présent sont dépensés à nouveau. Voir [Reprendre après une pause](/docs/fr/workflows#resume-after-a-pause) pour savoir quels sous-agents terminés retournent leurs résultats enregistrés et lesquels s'exécutent à nouveau.

448

449Claude Code arrête le travail qui ne peut pas se transférer, comme un [monitor](/docs/fr/tools-reference#monitor-tool) en cours d'exécution, et arrête un sous-agent mis en arrière-plan qui possède un monitor avec lui. Quand un tel travail s'exécute, Claude Code affiche la boîte de dialogue `Background this session?` pour que vous puissiez confirmer avant qu'il soit arrêté.

374 450

375Une fois en arrière-plan, la session peut démarrer de nouveaux sous-agents, monitors, et commandes en arrière-plan, et ceux-ci continuent de s'exécuter lors des détachements et réattachements ultérieurs.451Une fois en arrière-plan, la session peut démarrer de nouveaux sous-agents, monitors, et commandes en arrière-plan, et ceux-ci continuent de s'exécuter lors des détachements et réattachements ultérieurs.

376 452

383* `--fallback-model`459* `--fallback-model`

384* `--allow-dangerously-skip-permissions`460* `--allow-dangerously-skip-permissions`

385 461

386Les répertoires que vous avez ajoutés pendant la session avec [`/add-dir`](/docs/fr/permissions#additional-directories-grant-file-access-not-configuration) se reportent également.462Les répertoires que vous avez ajoutés pendant la session avec [`/add-dir`](/docs/fr/permissions#additional-directories-grant-file-access-not-configuration) se reportent également. Reporter `--allow-dangerously-skip-permissions` maintient `bypassPermissions` accessible dans la session mise en arrière-plan, mais cela ne confère rien de nouveau : le mode nécessite toujours l'acceptation interactive unique décrite dans [Mode de permission, modèle et effort](#permission-mode-model-and-effort).

~~387~~

388Reporter `--allow-dangerously-skip-permissions` maintient `bypassPermissions` accessible dans la session mise en arrière-plan, mais cela ne confère rien de nouveau. Le mode nécessite toujours la même acceptation interactive unique décrite dans [Mode de permission, modèle et effort](#permission-mode-model-and-effort) avant que toute session puisse l'utiliser.

389 463

390<h3 id="from-your-shell">464<h3 id="from-your-shell">

391 À partir du shell465 À partir du shell

397claude --bg "investigate the flaky SettingsChangeDetector test"471claude --bg "investigate the flaky SettingsChangeDetector test"

398```472```

399 473

400L'invite est l'argument positionnel, pas une valeur `-p`. À partir de la v2.1.198, combiner `--bg` avec `-p` ou `--print` est rejeté avec une erreur avant que toute session soit créée, car `--print` ne démarre jamais la session interactive à laquelle `claude agents` s'attache.474L'invite est l'argument positionnel, pas une valeur `-p`. Claude Code rejette `--bg` combiné avec `-p` ou `--print` avant que toute session soit créée, car `--print` ne démarre jamais la session interactive à laquelle `claude agents` s'attache.

401 475

402Pour exécuter un sous-agent spécifique comme l'agent principal de la session, combinez `--bg` avec `--agent` :476Pour exécuter un [sous-agent](/docs/fr/sub-agents) spécifique que vous avez défini, comme un `code-reviewer`, comme l'agent principal de la session, combinez `--bg` avec `--agent` :

403 477

404```bash theme={null}478```bash theme={null}

405claude --agent code-reviewer --bg "address review comments on PR 1234"479claude --agent code-reviewer --bg "address review comments on PR 1234"

406```480```

407 481

482Si le nom ne correspond à aucun de vos sous-agents, le lancement échoue : Claude Code affiche un avertissement `no agent named` et signale toujours la session comme mise en arrière-plan, mais la session se termine immédiatement avec une erreur `--agent '<name>' not found`.

483

484Quand la session mise en arrière-plan reprend ou redémarre plus tard, Claude Code restaure l'agent et ses restrictions d'outils ; pour son invite système, voir [Drapeaux d'invite système dans les conversations reprises](/docs/fr/cli-reference#system-prompt-flags-in-resumed-conversations). Il recherche d'abord l'agent dans le répertoire de la session lui-même, à condition que vous ayez [approuvé cet espace de travail](/docs/fr/permissions#project-allow-rules-and-workspace-trust), donc un agent limité au projet charge toujours quand la session est reprise à partir d'un autre répertoire. Si l'agent n'existe plus, la session continue avec les outils par défaut et sa transcription s'ouvre avec un [avertissement nommant l'agent](/docs/fr/errors#session-agent-no-longer-available).

485

486Pour continuer une conversation existante en arrière-plan, passez son ID de session complet avec `--resume` :

487

488```bash theme={null}

489claude --resume 1f0e2c9a-6d0b-4c11-9f39-2a77c1d4e8b5 --bg "pick up where you left off and finish the migration"

490```

491

492Sur Claude Code v2.1.257 ou ultérieur, Claude Code continue soit cette session sous le même ID, soit démarre une copie sous un nouvel ID et affiche une ligne `note:` expliquant pourquoi il n'a pas pu continuer sur place. Quand la session continue sur place, `claude agents` affiche une ligne pour elle.

493

494Quand vous combinez `--bg` avec `--continue`, un `--resume` nu, ou `--resume` avec un nom ou un chemin de fichier, Claude Code démarre toujours une telle copie. Ajoutez `--fork-session` pour démarrer une copie à dessein, sans la note.

495

408Passez `--name` pour définir le nom d'affichage de la session dans la vue agent au lieu du nom généré automatiquement :496Passez `--name` pour définir le nom d'affichage de la session dans la vue agent au lieu du nom généré automatiquement :

409 497

410```bash theme={null}498```bash theme={null}

425 Exécuter une commande shell513 Exécuter une commande shell

426</h4>514</h4>

427 515

428Pour exécuter une commande shell comme une tâche en arrière-plan au lieu d'une session Claude, tapez `!` comme premier caractère de l'entrée de lancement de la vue agent. Le `!` s'affiche comme un préfixe et tout ce que vous tapez après lui est la commande. L'exemple suivant lance `pytest -x` à partir de la boîte d'entrée de la vue agent :516Pour exécuter une commande shell comme une tâche en arrière-plan au lieu d'une session Claude, passez `--exec`. L'exemple suivant exécute `pytest -x` comme une tâche en arrière-plan :

~~429~~

430```text theme={null}

431! pytest -x

432```

~~433~~

434Appuyez sur `Entrée` pour démarrer la tâche. La même tâche peut également être lancée directement depuis votre shell avec `--exec` :

435 517

436```bash theme={null}518```bash theme={null}

437claude --bg --exec 'pytest -x'519claude --bg --exec 'pytest -x'

438```520```

439 521

522À partir de la vue agent, lancez le même type de tâche en tapant `!` comme premier caractère de l'entrée de lancement : le `!` s'affiche comme un préfixe, tout ce qui suit est la commande, et `Entrée` démarre la tâche.

523

440La commande s'exécute comme une tâche sauvegardée par PTY et apparaît comme une ligne dans la vue agent, avec la ligne de sortie la plus récente comme son statut. Une tâche shell exécute la commande à la place de Claude, donc aucun modèle n'est invoqué et la sortie n'est pas envoyée à aucune session.524La commande s'exécute comme une tâche sauvegardée par PTY et apparaît comme une ligne dans la vue agent, avec la ligne de sortie la plus récente comme son statut. Une tâche shell exécute la commande à la place de Claude, donc aucun modèle n'est invoqué et la sortie n'est pas envoyée à aucune session.

441 525

442Pour voir la sortie, attachez-vous à la ligne, appuyez sur `Espace` pour jeter un œil sans vous attacher, ou exécutez `claude logs <id>` depuis votre shell. La sortie capturée reste en mémoire et n'est pas écrite sur le disque. La ligne et sa sortie se nettoient automatiquement environ cinq minutes après la sortie de la commande, donc lisez-la avant si vous avez besoin du résultat.526Pour voir la sortie, attachez-vous à la ligne, appuyez sur `Espace` pour jeter un œil sans vous attacher, ou exécutez `claude logs <id>` depuis votre shell. La sortie capturée reste en mémoire et n'est pas écrite sur le disque. La ligne et sa sortie se nettoient automatiquement environ cinq minutes après la sortie de la commande, donc lisez-la avant si vous avez besoin du résultat.

445 Comment les modifications de fichiers sont isolées529 Comment les modifications de fichiers sont isolées

446</h3>530</h3>

447 531

448Chaque 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](/docs/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.532Chaque 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](/docs/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. Une fois que la session est dans sa worktree, Claude Code [applique l'isolation de worktree](/docs/fr/worktrees#how-claude-code-enforces-isolation) pour la session et pour tous les sous-agents qu'elle lance.

449 533

450Claude ignore la worktree quand :534Claude ignore la worktree quand :

451 535

452* La session est déjà à l'intérieur d'une git worktree liée, que Claude l'ait créée sous `.claude/worktrees/` ou que vous l'ayez créée avec `git worktree add` ailleurs536* La session est déjà à l'intérieur d'une git worktree liée, que Claude l'ait créée sous `.claude/worktrees/` ou que vous l'ayez créée avec `git worktree add` ailleurs

537* Le fichier que Claude édite est à l'intérieur d'une git worktree liée, comme une que la session ou son sous-agent a créée avec `git worktree add`

453* Le répertoire de travail n'est pas un référentiel git et aucun hook [`WorktreeCreate`](/docs/fr/hooks#worktreecreate) n'est configuré538* Le répertoire de travail n'est pas un référentiel git et aucun hook [`WorktreeCreate`](/docs/fr/hooks#worktreecreate) n'est configuré

454* L'écriture est en dehors du répertoire de travail539* L'écriture est en dehors du répertoire de travail

455 540

456Pour désactiver l'isolation de worktree pour un référentiel où les git worktrees ne sont pas pratiques, définissez [`worktree.bgIsolation`](/docs/fr/settings#worktree-settings) sur `"none"`. Les sessions en arrière-plan modifient alors votre copie de travail directement sans d'abord se déplacer dans une worktree. Ajoutez le paramètre au fichier `.claude/settings.json` du projet :541Pour désactiver l'isolation de worktree pour un référentiel où les git worktrees ne sont pas pratiques, définissez [`worktree.bgIsolation`](/docs/fr/settings-reference#worktree-bgisolation) sur `"none"`. Les sessions en arrière-plan modifient alors votre copie de travail directement sans d'abord se déplacer dans une worktree. Ajoutez le paramètre au fichier `.claude/settings.json` du projet :

457 542

458```json theme={null}543```json theme={null}

459{544{

465 550

466En 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. Si vous utilisez un système de contrôle de version différent, configurez un hook [`WorktreeCreate`](/docs/fr/worktrees#non-git-version-control) et Claude isole les modifications de la même manière qu'il le fait pour git.551En 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. Si vous utilisez un système de contrôle de version différent, configurez un hook [`WorktreeCreate`](/docs/fr/worktrees#non-git-version-control) et Claude isole les modifications de la même manière qu'il le fait pour git.

467 552

468Quand le hook échoue dans un répertoire qui n'est pas un référentiel git, la session ignore l'isolation pour ce répertoire et modifie le répertoire de travail sur place. À l'intérieur d'un référentiel git, les écritures restent bloquées jusqu'à ce que la session s'isole. Avant la v2.1.203, une session en arrière-plan dans cet état ne pouvait modifier aucun fichier : chaque écriture était rejetée jusqu'à ce qu'elle s'isole, et le hook ne pouvait jamais isoler ce répertoire.553Quand le hook échoue dans un répertoire qui n'est pas un référentiel git, Claude ignore l'isolation pour ce répertoire et édite le répertoire de travail sur place. À l'intérieur d'un référentiel git, Claude Code bloque les écritures au checkout partagé jusqu'à ce que Claude déplace la session dans une worktree.

~~469~~

470Supprimer une session supprime ou conserve la worktree que Claude a créée pour elle, selon la façon dont vous la supprimez et ce que la worktree contient :

~~471~~

472* Supprimer dans la vue agent avec `Ctrl+X` deux fois supprime la worktree, y compris les modifications non validées, donc validez les modifications que vous voulez conserver d'abord.

473* Supprimer depuis le shell avec [`claude rm`](#manage-sessions-from-the-shell) conserve une worktree qui a des modifications non validées, ainsi que sa ligne de session.

474* Aucun chemin ne supprime une worktree avec des commits qui ne sont pas poussés nulle part : la worktree est [conservée avec sa session](#organize-the-list) et la sortie nomme le chemin conservé et la raison.

475* Une worktree que vous avez créée vous-même et dans laquelle vous avez démarré la session est laissée en place de toute façon.

476 554

477Pour 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.555Pour 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.

478 556

479Un [sous-agent](/docs/fr/sub-agents) que la session en arrière-plan lance hérite du répertoire de travail de la session, donc ses modifications de fichiers se retrouvent dans la worktree de la session plutôt que dans votre copie de travail. Pour donner à un sous-agent sa propre worktree séparée à la place, définissez [`isolation: worktree`](/docs/fr/sub-agents#supported-frontmatter-fields) dans son frontmatter ou passez `isolation: "worktree"` lors de son lancement.557Un [sous-agent](/docs/fr/sub-agents) que la session en arrière-plan lance hérite du répertoire de travail de la session, donc ses modifications de fichiers se retrouvent dans la worktree de la session plutôt que dans votre copie de travail. Pour donner à un sous-agent sa propre worktree séparée à la place, définissez [`isolation: worktree`](/docs/fr/sub-agents#supported-frontmatter-fields) dans son frontmatter ou passez `isolation: "worktree"` lors de son lancement.

480 558

481À partir de la v2.1.198, une session en arrière-plan qui a isolé ses modifications de code dans une worktree valide également, pousse sa propre branche, et ouvre une demande de tirage en brouillon sans s'arrêter pour demander. L'étiquette [`#N`](#pull-request-status) apparaît sur sa ligne quand la demande de tirage s'ouvre. Elle ne pousse jamais vers `main` ou `master`, ne force jamais les poussées ou les fusions, et elle ignore la demande de tirage quand vous lui avez dit de ne pas en ouvrir une ou que le référentiel n'a pas de remote.559Quand une session en arrière-plan a fait des modifications de code dans une worktree que Claude a entrée, Claude Code ordonne à Claude de préserver le travail avant de terminer, afin qu'il survive si vous supprimez la session et sa worktree :

560

561* **Valider et pousser** : Claude valide sans demander, et pousse la branche quand le référentiel a un remote.

562* **Demande de tirage en brouillon** : Claude en ouvre une quand la tâche l'appelle, et l'étiquette [`#N`](#pull-request-status) apparaît sur la ligne.

563* **Jamais** : pousser vers `main` ou `master`, forcer les poussées, et fusionner.

564* **Vos instructions git prennent la priorité** : si la tâche, `CLAUDE.md`, ou la [mémoire](/docs/fr/memory) dit que vous gérez vous-même la validation ou la poussée, Claude vous laisse git.

565

566Une session éditant un checkout qu'elle n'a pas isolée elle-même demande toujours avant de valider ou de changer de branche. Cela s'applique quand l'isolation est définie sur `"none"`, quand le déplacement de la worktree a échoué, ou quand la session a démarré à l'intérieur d'une worktree qui existait déjà.

567

568Quelle que soit la tâche, Claude termine le travail avec un rapport disant ce qu'il a fait et où le travail est : un chemin, une branche, une demande de tirage, ou la réponse elle-même.

569

570<h4 id="what-deleting-a-session-removes">

571 Ce que supprimer une session supprime

572</h4>

573

574Supprimez une session avec `Ctrl+X` deux fois dans la [vue agent](#organize-the-list) ou avec [`claude rm`](#manage-sessions-from-the-shell). Sauf dans les cas conservés ci-dessous, la session quitte la liste. Sa transcription reste sur votre machine via `claude --resume`, et la suppression survit aux redémarrages du superviseur.

575

576Ce qui arrive à une worktree que Claude a créée pour la session :

577

578* La vue agent la supprime, y compris les modifications non validées, donc validez ce que vous voulez conserver d'abord.

579* `claude rm` la conserve, ainsi que la ligne de session, quand elle a des modifications non validées.

580* Ni la vue agent ni `claude rm` ne supprime une worktree qu'une autre session en cours d'exécution utilise ou a verrouillée, et supprimer à nouveau ne change pas cela. Claude Code conserve la worktree et la session, et nomme le répertoire conservé et la raison ; dans la vue agent, la ligne de la session affiche `not deleted`. Fermez l'autre session, puis supprimez à nouveau.

581* Quand vous supprimez une session dont la worktree a des commits que Claude Code ne peut pas confirmer sont enregistrés ailleurs, Claude Code conserve la worktree et la session, et le message nomme la branche de la worktree et combien de commits ne sont pas poussés. Le message offre également les deux façons d'avancer : pousser les commits, ou supprimer à nouveau pour les abandonner.

582

583 Les commits sur un remote ne bloquent pas la suppression. Ni les commits sur la copie locale de la branche par défaut de votre remote `origin`, tant que cette branche est extraite dans votre checkout principal, le répertoire du référentiel lui-même plutôt qu'une worktree.

584

585 Après ce refus, vous choisissez :

586

587 * Pour conserver les commits, les pousser, ou les fusionner dans cette branche par défaut, puis supprimer la session à nouveau.

588 * Pour les abandonner, supprimer la session à nouveau sans pousser : appuyez sur `Ctrl+X` deux fois sur sa ligne dans la vue agent, ou exécutez la commande `claude rm <id> --discard-unpushed` que le refus a affichée. Cela supprime la session et la worktree avec sa branche, abandonnant les commits non poussés et toutes les modifications non validées.

589

590 Quand vous supprimez à nouveau, Claude Code abandonne uniquement ce que le refus a montré : si la worktree a gagné un commit depuis, Claude Code la conserve à nouveau et affiche l'état mis à jour.

591

592 Quand les enregistrements d'une autre session terminée nomment également la worktree, elle reste quand vous supprimez à nouveau ; poussez les commits, puis supprimez à nouveau.

593* Une worktree que git ne reconnaît plus, par exemple après `git worktree prune`, ne bloque pas la suppression. Claude Code supprime la session et laisse le répertoire sur le disque.

594* Quand git ou votre hook [`WorktreeRemove`](/docs/fr/hooks#worktreeremove) échoue à supprimer la worktree, Claude Code conserve la worktree et la session, et le message nomme la cause. Pour un hook, le message dit comment il s'est terminé, comme `exited 1`, et cite le début de son stderr. Le message vous dit également lequel de ceux-ci faire ensuite :

595

596 * Supprimer la session à nouveau pour supprimer le répertoire de toute façon, en appuyant sur `Ctrl+X` deux fois sur sa ligne dans la vue agent ou en exécutant la commande `claude rm <id> --force-remove-worktree <worktree-id>` que le refus de `claude rm` a affichée. Claude Code n'offre cela que quand il peut confirmer que le répertoire est l'une des worktrees liées du référentiel sous `.claude/worktrees/` sans modifications non validées aux fichiers suivis, sans référentiel imbriqué à l'intérieur, et sans enregistrement d'une autre session le nommant. La branche de la worktree reste dans le référentiel.

597 * Corriger ce qui se met en travers, comme valider ou remiser les modifications non validées, fermer ce qui utilise le répertoire, ou corriger le hook, puis supprimer la session à nouveau.

598 * Supprimer le répertoire vous-même, puis supprimer la session à nouveau.

599

600Une worktree que vous avez créée vous-même et dans laquelle vous avez démarré la session est laissée en place de toute façon.

482 601

483Une session modifiant un checkout qu'elle n'a pas isolée elle-même demande toujours avant de valider ou de changer de branche. Cela s'applique quand l'isolation est définie sur `"none"`, quand le déplacement de la worktree a échoué, ou quand la session a démarré à l'intérieur d'une worktree qui existait déjà.602Une session dont le répertoire de worktree n'appartient à aucun référentiel git, parce que le référentiel a été supprimé ou un hook [`WorktreeCreate`](/docs/fr/hooks#worktreecreate) a créé le répertoire ailleurs, peut toujours être supprimée. Tandis que les fichiers restent dans le répertoire :

603

604* La vue agent demande le même double-appui `Ctrl+X` avant de les abandonner. Pour un répertoire créé par hook, il exécute votre hook [`WorktreeRemove`](/docs/fr/hooks#worktreeremove) à la place, et sans un, il refuse la suppression et conserve la session.

605* `claude rm` conserve la session et la worktree, et nomme la raison.

606

607Chaque chemin conserve un répertoire que les enregistrements d'une autre session terminée nomment.

484 608

485<h3 id="set-the-model">609<h3 id="set-the-model">

486 Définir le modèle610 Définir le modèle

487</h3>611</h3>

488 612

489Le 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 provient du paramètre [`model`](/docs/fr/settings#available-settings) dans vos paramètres utilisateur. Définissez-le en sélectionnant un modèle dans le sélecteur [`/model`](/docs/fr/model-config), ou modifiez le paramètre directement.613Le 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 provient du paramètre [`model`](/docs/fr/settings-reference#model) dans vos paramètres utilisateur. Définissez-le en sélectionnant un modèle dans le sélecteur [`/model`](/docs/fr/model-config), ou modifiez le paramètre directement.

490 614

491Pour le remplacer pour l'ensemble de la session de la vue agent, passez `--model` lors de l'ouverture de la vue agent. Voir [Mode de permission, modèle et effort](#permission-mode-model-and-effort).615Pour remplacer la valeur par défaut du lancement pour l'ensemble de la session de la vue agent, passez `--model` lors de l'ouverture de la vue agent. Voir [Mode de permission, modèle et effort](#permission-mode-model-and-effort).

492 616

493Pour changer la valeur par défaut du lancement à partir de la vue agent, tapez `/model` suivi d'un nom de modèle dans l'entrée de lancement et appuyez sur `Entrée`. L'en-tête se met à jour pour afficher ce modèle avec un marqueur `(session)`, et les sessions que vous lancez après utilisent ce modèle. Tapez `/model default` pour effacer le remplacement et revenir à la valeur par défaut du lancement. Ce remplacement dure pour le reste de l'exécution actuelle de `claude agents` et n'écrit pas dans votre fichier de paramètres. L'exemple suivant lance une session sur Opus et la suivante sur Sonnet :617Pour changer la valeur par défaut du lancement à partir de la vue agent, tapez `/model` suivi d'un nom de modèle dans l'entrée de lancement et appuyez sur `Entrée`. L'en-tête se met à jour pour afficher ce modèle avec un marqueur `(session)`, et les sessions que vous lancez après utilisent ce modèle. Tapez `/model default` pour effacer le remplacement et revenir à la valeur par défaut du lancement. Ce remplacement dure pour le reste de l'exécution actuelle de `claude agents` et n'écrit pas dans votre fichier de paramètres. L'exemple suivant lance une session sur Opus et la suivante sur Sonnet :

494 618

509 Mode de permission, modèle et effort633 Mode de permission, modèle et effort

510</h3>634</h3>

511 635

512Une session en arrière-plan lit ses [paramètres](/docs/fr/settings) à partir du répertoire dans lequel elle s'exécute, de la même manière que si vous aviez démarré `claude` là. Cela inclut les valeurs [`env`](/docs/fr/settings#available-settings) dans les paramètres du projet, donc une variable `ANTHROPIC_MODEL` ou de fournisseur définie là s'applique aux sessions en arrière-plan dans ce répertoire.636Une session en arrière-plan prend ses paramètres, fournisseur, mode de permission, modèle et effort à partir de l'endroit et de la façon dont vous l'avez lancée. Les sous-sections ci-dessous couvrent chaque source, et ce qui persiste quand le superviseur redémarre la session.

637

638<h4 id="settings-and-provider">

639 Paramètres et fournisseur

640</h4>

641

642Une session en arrière-plan lit ses [paramètres](/docs/fr/settings) à partir du répertoire dans lequel elle s'exécute, de la même manière que si vous aviez démarré `claude` là. Cela inclut les valeurs [`env`](/docs/fr/settings-reference#env) dans les paramètres du projet, donc une variable `ANTHROPIC_MODEL` ou de fournisseur définie là s'applique à chaque session en arrière-plan dans ce répertoire.

643

644Une session en arrière-plan s'exécute également avec le `PATH` du shell à partir duquel vous l'avez lancée, afin que les commandes qu'elle exécute trouvent les mêmes outils que votre terminal. Elle conserve également la sélection du fournisseur cloud de ce shell, comme `CLAUDE_CODE_USE_BEDROCK` ou `CLAUDE_CODE_USE_VERTEX`, ainsi que ses alias `ANTHROPIC_DEFAULT_*_MODEL` et tout remplacement [`CLAUDE_CODE_EXTRA_BODY`](/docs/fr/env-vars) que vous avez exporté là.

645

646<h4 id="llm-gateway">

647 Passerelle LLM

648</h4>

649

650Si vous routez Claude Code via une [passerelle LLM](/docs/fr/llm-gateway), mettez les variables de passerelle dans un bloc `env` d'un fichier de paramètres plutôt que de les exporter dans votre shell, et les sessions en arrière-plan les lisent avec le reste de leurs paramètres. [Définir dans un fichier de paramètres](/docs/fr/llm-gateway-connect#set-in-a-settings-file) affiche le bloc et quel fichier de paramètres utiliser pour les identifiants.

513 651

514La sélection du fournisseur cloud, comme `CLAUDE_CODE_USE_BEDROCK` ou `CLAUDE_CODE_USE_VERTEX`, et les alias `ANTHROPIC_DEFAULT_*_MODEL` suivent le shell qui a lancé la session. Si vous exportez un remplacement de corps de requête [`CLAUDE_CODE_EXTRA_BODY`](/docs/fr/env-vars) dans ce shell, il atteint la session de la même manière. Avant la v2.1.206, les workers en arrière-plan ignoraient un `CLAUDE_CODE_EXTRA_BODY` exporté par le shell.652Si vous exportez une passerelle `ANTHROPIC_BASE_URL` uniquement dans votre shell à la place, elle atteint une session en arrière-plan, avec `ANTHROPIC_CUSTOM_HEADERS` et les identifiants que vous avez exportés avec elle, uniquement quand le [superviseur](#the-supervisor-process) lui-même a été démarré à partir d'un shell qui a exporté la même passerelle, et uniquement dans ces cas :

515 653

516Si vous exportez une passerelle `ANTHROPIC_BASE_URL` dans le shell de lancement, elle atteint la session aussi, avec `ANTHROPIC_CUSTOM_HEADERS`, quand le superviseur s'exécute avec le même environnement de passerelle et la session s'exécute dans le répertoire à partir duquel vous avez lancé ou est votre propre session mise en arrière-plan avec `←` ou `/background`. C'est le cas normal quand le premier shell à ouvrir la vue agent ou lancer une session en arrière-plan est le shell de passerelle. Lancer dans un répertoire différent avec `@repo` ou `--cwd` ne porte pas la passerelle du shell ; les [paramètres](/docs/fr/settings) de ce projet fournissent le point de terminaison. Voir [le processus superviseur](#the-supervisor-process) pour savoir comment les sessions en arrière-plan sourçent les paramètres du fournisseur et les identifiants.654* Vous mettez votre propre session en arrière-plan avec `←` ou `/background`

655* Vous lancez une session dans le répertoire dans lequel vous êtes

656* Vous réveillez une session arrêtée dans le répertoire dans lequel vous êtes en vous attachant ou en répondant à elle

517 657

518Le [mode de permission](/docs/fr/permissions) dépend de la façon dont vous avez démarré la session. Mettre en arrière-plan une session existante avec `/bg` ou `←` conserve le mode de permission actuel, donc une session que vous avez basculée vers `acceptEdits` ou `auto` reste dans ce mode après détachement. Lancer à partir de l'entrée de la vue agent ou exécuter `claude --bg` depuis votre shell utilise le `defaultMode` à partir des paramètres de ce répertoire, ou le `permissionMode` à partir du [frontmatter du sous-agent lancé](/docs/fr/sub-agents#supported-frontmatter-fields).658Claude Code transfère une passerelle devant un fournisseur cloud. Si le shell à partir duquel vous lancez sélectionne le fournisseur et exporte son point de terminaison de passerelle avec son drapeau de contournement d'authentification, Claude Code transfère la paire point-de-terminaison-et-drapeau à la session dans les conditions qui s'appliquent à `ANTHROPIC_BASE_URL`, avec `ANTHROPIC_CUSTOM_HEADERS`. Par exemple, exportez `CLAUDE_CODE_USE_VERTEX=1` avec `ANTHROPIC_VERTEX_BASE_URL` et `CLAUDE_CODE_SKIP_VERTEX_AUTH=1`, et Claude Code transfère ce point de terminaison et ce drapeau.

519 659

520Le mode de permission, le modèle et l'effort avec lesquels une session en arrière-plan a été démarrée, ainsi que les [drapeaux de configuration qu'elle porte](#from-inside-a-session), persistent tous quand le superviseur [arrête et redémarre](#the-supervisor-process) ultérieurement le processus de la session. Une session que vous avez lancée avec `claude --bg --dangerously-skip-permissions` ou `claude --bg --permission-mode bypassPermissions` reste dans `bypassPermissions` après ce redémarrage au lieu de revenir au `defaultMode` du répertoire, et un modèle ou un effort que vous avez changé en milieu de session avec `/model` ou `/effort` est conservé.660Claude Code applique une passerelle transférée au processus en cours d'exécution de cette session uniquement et ne l'écrit jamais sur le disque.

521 661

522Un effort que la session a pris à partir du paramètre [`effortLevel`](/docs/fr/settings#available-settings) plutôt que de `--effort` ou `/effort` n'est pas fixé au lancement : chaque processus démarré pour la session relit le paramètre à nouveau, donc modifier `effortLevel` dans `settings.json` atteint les sessions que vous mettez en arrière-plan avec `←` ou `/bg` et leurs redémarrages ultérieurs. Avant la v2.1.203, mettre en arrière-plan une session enregistrait son effort dérivé des paramètres comme si vous aviez passé `--effort`, donc les modifications ultérieures de `effortLevel` ne l'atteignaient jamais.662<h4 id="permission-mode">

663 Mode de permission

664</h4>

665

666Le [mode de permission](/docs/fr/permissions) dépend de la façon dont vous avez démarré la session :

667

668* **Mise en arrière-plan avec `/bg` ou `←`** : Claude Code conserve le mode de permission dans lequel la session était, donc une que vous avez basculée vers `acceptEdits` ou `auto` reste là après détachement

669* **Lancée à partir d'une vue agent que vous avez ouverte avec `←`** : la configuration propre de la cible vient en premier, et le mode de permission de la session dont vous venez s'applique quand rien d'autre n'en définit un

670* **Lancée à partir de `claude agents` démarrée dans un shell, ou avec `claude --bg`** : la nouvelle session démarre de la façon qu'une nouvelle session `claude` dans ce répertoire le ferait, sauf si vous l'avez lancée à partir d'une vue agent que vous avez ouverte avec les [valeurs par défaut du lancement](#dispatch-defaults). [Quel mode de permission une session démarre](/docs/fr/permission-modes#which-mode-a-session-starts-in) liste l'ordre

671

672Pour une session que vous lancez à partir d'une vue agent ouverte avec `←`, Claude Code prend le mode de permission à partir du premier de ceux-ci qui s'applique :

673

6741. Le [`permissions.defaultMode`](/docs/fr/settings-reference#permissions-defaultmode) du répertoire cible. Deux règles de source s'appliquent :

675 * `auto` et `bypassPermissions` [ne prennent effet que à partir des paramètres gérés, d'un fichier `--settings`, ou de `~/.claude/settings.json`](/docs/fr/settings-reference#permissions-defaultmode).

676 * Claude Code refuse un `defaultMode` à partir du `.claude/settings.json` ou `.claude/settings.local.json` du projet qui sélectionne un mode plus permissif que celui dans lequel la session dont vous venez était.

6772. Le mode de permission de la session dont vous venez

523 678

524Un nom que vous avez défini avec [`/rename`](/docs/fr/commands) ou `Ctrl+R` persiste également lors de ce redémarrage, donc [`claude --resume <name>`](/docs/fr/sessions#name-your-sessions) résout toujours la session. Avant la v2.1.202, le redémarrage revenait au nom avec lequel la session a été lancée et le nouveau nom cessait de résoudre.679Quand Claude Code refuse le mode d'une source comme trop permissif, la source suivante dans la liste décide. Par exemple, si vous lancez à partir d'une session en mode plan dans un répertoire dont les paramètres vérifiés demandent `acceptEdits`, la nouvelle session démarre en mode plan. Si vous déplacez ce `defaultMode` vers `~/.claude/settings.json`, il s'applique indépendamment du mode de permission de la session dont vous venez.

680

681La permissivité va plan, puis Manual et `dontAsk`, puis `acceptEdits` et auto, qui comptent chacun comme plus permissif que l'autre, puis `bypassPermissions`.

682

683<h4 id="dispatch-defaults">

684 Valeurs par défaut du lancement

685</h4>

525 686

526Pour définir les valeurs par défaut pour chaque session que vous lancez à partir de la vue agent, passez l'un de `--permission-mode`, `--model`, `--effort`, ou `--agent` lors de son ouverture :687Pour définir les valeurs par défaut pour chaque session que vous lancez à partir de la vue agent, passez l'un de `--permission-mode`, `--model`, `--effort`, ou `--agent` lors de son ouverture :

527 688

529claude agents --permission-mode plan --model opus --effort high690claude agents --permission-mode plan --model opus --effort high

530```691```

531 692

532`--agent` définit le [sous-agent](/docs/fr/sub-agents) utilisé quand une invite de lancement ne nomme pas un, soit avec `@name` soit comme premier mot. Il prend par défaut le paramètre [`agent`](/docs/fr/settings#available-settings) s'il en existe un, sinon l'agent intégré `claude` fourre-tout. Nommer un sous-agent dans l'entrée de lancement remplace les deux.693`--effort` ici accepte les mêmes valeurs que le [drapeau `--effort` de haut niveau](/docs/fr/cli-reference#cli-flags), y compris `ultracode`.

694

695`--agent` définit le [sous-agent](/docs/fr/sub-agents) utilisé quand une invite de lancement ne nomme pas un, soit avec `@name` soit comme premier mot. Il prend par défaut le paramètre [`agent`](/docs/fr/settings-reference#agent) s'il en existe un, sinon l'agent intégré fourre-tout `claude`. Nommer un sous-agent dans l'entrée de lancement remplace les deux.

533 696

534`claude agents` accepte également `--dangerously-skip-permissions` comme raccourci pour `--permission-mode bypassPermissions`, et `--allow-dangerously-skip-permissions` pour rendre `bypassPermissions` disponible dans le cycle `Shift+Tab` de chaque session lancée sans démarrer dans ce mode. Les deux correspondent aux [drapeaux CLI de haut niveau](/docs/fr/cli-reference).697`claude agents` accepte également `--dangerously-skip-permissions` comme raccourci pour `--permission-mode bypassPermissions`, et `--allow-dangerously-skip-permissions` pour rendre `bypassPermissions` disponible dans le cycle `Shift+Tab` de chaque session lancée sans démarrer dans ce mode. Les deux correspondent aux [drapeaux CLI de haut niveau](/docs/fr/cli-reference).

535 698

699Passez `--restricted` pour démarrer chaque session que vous lancez à partir de la vue en [mode restreint](/docs/fr/cli-reference#cli-flags), comme si chacune était lancée avec le drapeau de haut niveau `--restricted`. Nécessite Claude Code v2.1.248 ou ultérieur.

700

536Les valeurs par défaut actives apparaissent dans le pied de page sous l'entrée de lancement.701Les valeurs par défaut actives apparaissent dans le pied de page sous l'entrée de lancement.

537 702

538Sans ces drapeaux, la session utilise le `defaultMode` à partir des paramètres de ce répertoire ou le `permissionMode` à partir du [frontmatter du sous-agent lancé](/docs/fr/sub-agents#supported-frontmatter-fields), et le modèle affiché dans l'en-tête de la vue agent.703Claude Code refuse `claude --bg --permission-mode bypassPermissions` jusqu'à ce que vous ayez accepté la clause de non-responsabilité du contournement en exécutant `claude --dangerously-skip-permissions` une fois de manière interactive, puisque ce mode permet à une session que vous ne regardez pas d'agir sans approbation. Passer `--dangerously-skip-permissions` ou `--permission-mode bypassPermissions` à `claude agents` affiche la même clause de non-responsabilité quand vous ne l'avez pas acceptée avant, et accepter applique `bypassPermissions` aux sessions que vous lancez à partir de la vue. Passer `--allow-dangerously-skip-permissions` affiche la même clause de non-responsabilité aussi, et accepter rend `bypassPermissions` disponible dans le cycle `Shift+Tab` de ces sessions sans les démarrer dedans.

704

705<h4 id="what-persists-across-restarts">

706 Ce qui persiste lors des redémarrages

707</h4>

708

709Le mode de permission, le modèle et l'effort que vous avez choisis pour une session en arrière-plan, ainsi que les [drapeaux de configuration qu'elle porte](#what-carries-over-when-you-background), persistent tous quand le superviseur [arrête et redémarre](#the-supervisor-process) ultérieurement le processus de la session. Une session que vous avez lancée avec `claude --bg --dangerously-skip-permissions` ou `claude --bg --permission-mode bypassPermissions` reste dans `bypassPermissions` après ce redémarrage. Un modèle ou un effort que vous avez changé en milieu de session avec `/model` ou `/effort` est conservé aussi.

710

711Si la session a pris son effort à partir de vos paramètres plutôt que de `--effort` ou `/effort`, Claude Code relit vos paramètres à nouveau chaque fois qu'il démarre un processus pour la session. Après avoir édité l'effort enregistré dans `settings.json`, le changement atteint les sessions que vous mettez en arrière-plan avec `←` ou `/bg`, et leurs redémarrages ultérieurs. L'effort enregistré est la clé [`effortLevel`](/docs/fr/settings-reference#effortlevel) ou une entrée [`modelSettings`](/docs/fr/settings-reference#modelsettings).

539 712

540Utiliser `bypassPermissions` avec `claude --bg --permission-mode` est refusé jusqu'à ce que vous ayez accepté la clause de non-responsabilité du contournement en exécutant `claude --dangerously-skip-permissions` une fois de manière interactive, puisque ce mode permet à une session que vous ne regardez pas d'agir sans approbation. Passer `--dangerously-skip-permissions` ou `--permission-mode bypassPermissions` à `claude agents` affiche la même clause de non-responsabilité quand vous ne l'avez pas acceptée avant, et accepter applique `bypassPermissions` aux sessions que vous lancez à partir de la vue. Passer `--allow-dangerously-skip-permissions` affiche la même clause de non-responsabilité aussi, et accepter rend `bypassPermissions` disponible dans le cycle `Shift+Tab` de ces sessions sans les démarrer dedans.713Claude Code conserve également un nom que vous avez défini avec [`/rename`](/docs/fr/commands) ou `Ctrl+R` lors de ce redémarrage, donc vous pouvez toujours exécuter [`claude --resume <name>`](/docs/fr/sessions#name-your-sessions) pour atteindre la session.

714

715Une invite que vous avez remisée avec [`Ctrl+S`](/docs/fr/interactive-mode#general-controls) tandis que vous étiez attaché est conservée avec la session aussi. Rouvrez la session après son processus a été arrêté ou redémarré, et `Ctrl+S` restaure le texte remisé. Le contenu collé dans la remise ne survit pas au redémarrage.

541 716

542<h3 id="settings-plugins-and-mcp-servers">717<h3 id="settings-plugins-and-mcp-servers">

543 Paramètres, plugins et serveurs MCP718 Paramètres, plugins et serveurs MCP

544</h3>719</h3>

545 720

546La vue agent accepte les mêmes drapeaux de configuration que `claude` pour charger les paramètres, les plugins, les serveurs MCP et les répertoires supplémentaires. Chaque drapeau s'applique à la vue agent elle-même et est transmis à chaque session que vous lancez à partir de celle-ci, donc un plugin ou un serveur MCP que vous chargez de cette manière est disponible dans ces sessions aussi.721La vue agent accepte les mêmes drapeaux de configuration que `claude` pour charger les paramètres, les plugins, les serveurs MCP et les répertoires supplémentaires. La vue agent applique `--settings` et `--plugin-dir` à elle-même et transmet chaque drapeau de configuration aux sessions que vous lancez à partir de celle-ci, donc un plugin ou un serveur MCP que vous chargez de cette manière est disponible dans ces sessions.

547 722

548| Drapeau | Effet |723| Drapeau | Effet |

549| :----------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------ |724| :----------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

551| [`--add-dir <path>`](/docs/fr/permissions#additional-directories-grant-file-access-not-configuration) | Accorder l'accès aux fichiers à un répertoire supplémentaire |726| [`--add-dir <path>`](/docs/fr/permissions#additional-directories-grant-file-access-not-configuration) | Accorder l'accès aux fichiers à un répertoire supplémentaire |

553| [`--mcp-config <file-or-json>`](/docs/fr/mcp) | Charger les serveurs MCP à partir d'un fichier de configuration ou d'une chaîne JSON |728| [`--mcp-config <file-or-json>`](/docs/fr/mcp) | Charger les serveurs MCP à partir d'un fichier de configuration ou d'une chaîne JSON |

554| `--strict-mcp-config` | Utiliser uniquement les serveurs MCP de `--mcp-config`, en ignorant les autres configurations MCP |729| `--strict-mcp-config` | Utiliser uniquement les serveurs MCP de `--mcp-config`, en ignorant les autres configurations MCP. Voir [Contrôle exclusif avec managed-mcp.json](/docs/fr/managed-mcp#exclusive-control-with-managed-mcp-json) pour ce que le drapeau fait sous un fichier MCP géré |

730

731Répétez `--add-dir`, `--plugin-dir`, ou `--mcp-config` une fois par valeur. `claude agents` ne supporte pas la forme séparée par des espaces, comme `--add-dir a b c`.

555 732

556Répétez `--add-dir`, `--plugin-dir`, ou `--mcp-config` une fois par valeur. La forme séparée par des espaces, comme `--add-dir a b c`, n'est pas prise en charge avec `claude agents`.733Vous pouvez placer `--settings` et `--plugin-dir` avant ou après `agents`. Gardez `--add-dir` et `--mcp-config` après `agents` : si vous placez l'un ou l'autre avant `agents`, [`claude agents --json`](#manage-sessions-from-the-shell) échoue avec une erreur `unknown option`.

557 734

558L'exemple suivant ouvre la vue agent avec un remplacement de paramètres et un répertoire supplémentaire :735L'exemple suivant ouvre la vue agent avec un remplacement de paramètres et un répertoire supplémentaire :

559 736

561claude agents --settings ./ci-settings.json --add-dir ../shared-lib738claude agents --settings ./ci-settings.json --add-dir ../shared-lib

562```739```

563 740

741`--settings` accepte un chemin de fichier ou une chaîne JSON en ligne. Un chemin de fichier doit pointer vers un fichier existant ; Claude Code se termine avec une erreur `Settings file not found` s'il ne le fait pas.

742

564<h2 id="manage-sessions-from-the-shell">743<h2 id="manage-sessions-from-the-shell">

565 Gérer les sessions depuis le shell744 Gérer les sessions depuis le shell

566</h2>745</h2>

568Chaque 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.747Chaque 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.

569 748

570| Commande | Objectif |749| Commande | Objectif |

571| :--------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |750| :--------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

574| `claude agents --json` | Afficher les sessions actives en tant que tableau JSON et quitter : chaque session active, plus les sessions en arrière-plan qui travaillent encore ou sont bloquées même quand leur processus a quitté. Ajoutez `--all` pour inclure aussi les sessions en arrière-plan terminées. Chaque entrée a `cwd`, `kind`, et `startedAt`. Les entrées en arrière-plan ont aussi `id`, utilisable avec `claude attach`/`logs`/`stop`, et `state` : l'une de `working`, `blocked`, `done`, `failed`, ou `stopped`. `pid` et `status` sont présents uniquement tant que le processus est actif, plus `waitingFor` quand status est `waiting`, qui indique sur quoi la session est bloquée, comme `permission prompt` ou `input needed` ; `sessionId` et `name` apparaissent quand ils sont définis. Une entrée interactive que vous n'avez jamais nommée porte un nom par défaut construit à partir du nom du répertoire de travail plus un suffixe de deux caractères, comme `my-app-3f`. Combinez avec `--cwd <path>` pour filtrer |753| `claude agents --json` | Afficher les sessions en tant que tableau JSON et quitter. Voir [Afficher les sessions en tant que JSON](#list-sessions-as-json) |

578| `claude respawn <id>` | Redémarrer une session, en cours d'exécution ou arrêtée, avec sa conversation intacte, par exemple pour utiliser un binaire Claude Code mis à jour |757| `claude respawn <id>` | Redémarrer une session, en cours d'exécution ou arrêtée, par exemple pour utiliser un binaire Claude Code mis à jour. La session redémarrée reprend sa conversation enregistrée ; quand aucune n'est sur le disque, elle exécute à nouveau son prompt original en tant que nouvelle conversation |

579| `claude respawn --all` | Redémarrer chaque session en cours d'exécution, par exemple pour déplacer toutes les sessions vers un binaire Claude Code mis à jour en une seule fois |758| `claude respawn --all` | Redémarrer chaque session en cours d'exécution, par exemple pour déplacer toutes les sessions vers un binaire Claude Code mis à jour en une seule fois |

580| `claude rm <id>` | Supprimer une session de la liste. Supprime une worktree que Claude a créée pour la session si elle n'a pas de modifications non validées et aucun commit qui n'est pas poussé nulle part ; sinon la session est conservée aussi, et la commande affiche le chemin de la worktree et la raison afin que vous puissiez la résoudre et exécuter `claude rm` à nouveau. Laisse en place une worktree que vous avez créée vous-même. La transcription de la conversation reste sur votre machine locale et reste disponible via `claude --resume` |759| `claude rm <id>` | Supprimer une session de la liste, ainsi qu'une worktree que Claude a créée pour elle quand il est sûr de la supprimer ; voir [Ce que la suppression d'une session supprime](#what-deleting-a-session-removes). La transcription de la conversation reste sur votre machine locale et reste disponible via `claude --resume` |

760| `claude rm <id> --discard-unpushed <commit>@<worktree-id>` | Supprimer une session dont la suppression a été refusée en raison de commits non poussés, en supprimant la worktree ainsi que sa branche et ses commits. Passez la valeur exacte que le refus a affichée ; voir [Ce que la suppression d'une session supprime](#what-deleting-a-session-removes). Nécessite v2.1.260 ou ultérieur |

761| `claude rm <id> --force-remove-worktree <worktree-id>` | Supprimer une session dont la suppression a été refusée parce que git ou le hook `WorktreeRemove` n'a pas pu supprimer sa worktree, en supprimant le répertoire worktree de toute façon et en laissant sa branche dans le référentiel. Passez la valeur exacte que le refus a affichée ; voir [Ce que la suppression d'une session supprime](#what-deleting-a-session-removes). Nécessite v2.1.268 ou ultérieur |

581| `claude daemon status` | Afficher l'état du [superviseur](#the-supervisor-process), la version, le répertoire socket et le nombre de workers |762| `claude daemon status` | Afficher l'état du [superviseur](#the-supervisor-process), la version, le répertoire socket et le nombre de workers |

582| `claude daemon stop --any` | Arrêter le processus superviseur et les sessions en arrière-plan qu'il héberge. Passez `--keep-workers` pour laisser les sessions en arrière-plan en cours d'exécution afin que le superviseur suivant se reconnecte à elles. Le prochain `claude agents` ou `claude --bg` démarre un nouveau superviseur |763| `claude daemon stop --any` | Arrêter le processus superviseur et les sessions en arrière-plan qu'il héberge. Passez `--keep-workers` pour laisser les sessions en arrière-plan en cours d'exécution afin que le superviseur suivant se reconnecte à elles. Le prochain `claude agents` ou `claude --bg` démarre un nouveau superviseur |

583 764

584<h2 id="how-background-sessions-are-hosted">765<h3 id="list-sessions-as-json">

585 Comment les sessions en arrière-plan sont hébergées766 Afficher les sessions en tant que JSON

586</h2>

~~587~~

588Chaque 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).

~~589~~

590<h3 id="the-supervisor-process">

591 Le processus superviseur

592</h3>767</h3>

593 768

594Les 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.769`claude agents --json` affiche les sessions actives en tant que tableau JSON et quitte : chaque session active, plus les sessions en arrière-plan qui travaillent encore ou sont bloquées même quand leur processus a quitté. Ajoutez `--all` pour inclure aussi les sessions en arrière-plan terminées, et `--cwd <path>` pour limiter la liste aux sessions démarrées sous ce répertoire.

~~595~~

596Quand une mise à jour a remplacé ou supprimé le binaire à partir duquel un processus Claude Code en cours d'exécution a été lancé, ce processus démarre le superviseur à partir d'une autre copie installée, telle que le lanceur `claude` installé ou la version la plus récente sur le disque.

~~597~~

598Le superviseur maintient un processus worker préchauffé prêt pour qu'une dispatch depuis la vue agent ou `claude --bg` démarre sans le délai d'un lancement à froid. Quand vous dispatchez, le superviseur assigne le worker préchauffé à votre session, applique le répertoire, les paramètres et les identifiants de cette session à celui-ci, puis démarre un remplacement pour la prochaine dispatch. Si aucun worker préchauffé sain n'est disponible, le superviseur lance un processus frais à la place.

599 770

600Le superviseur et ses sessions s'authentifient avec les mêmes identifiants stockés que vos sessions interactives et ne font aucune connexion réseau supplémentaire au-delà de l'API du modèle. Les variables de sélection de fournisseur telles que `CLAUDE_CODE_USE_BEDROCK` et les alias `ANTHROPIC_DEFAULT_*_MODEL` sont lues depuis le shell qui a dispatché chaque session et sont appliquées à son worker.771Chaque entrée décrit une session :

601 772

602Le `PATH` du shell de dispatch est appliqué au worker de la même manière, donc les commandes shell que la session exécute trouvent les mêmes outils que votre terminal. Avant v2.1.203, une session en arrière-plan conservait le `PATH` du shell qui a d'abord démarré le superviseur, donc les outils ajoutés à votre `PATH` depuis pourraient manquer, le plus souvent sur Windows.773| Champ | Présent | Description |

774| :------------------------- | :------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

775| `cwd`, `kind`, `startedAt` | Toujours | Le répertoire de travail, `interactive` ou `background`, et l'heure de démarrage en millisecondes Unix |

776| `id` | Sessions en arrière-plan | ID court, utilisable avec `claude attach`, `claude logs`, et `claude stop` |

777| `state` | Sessions en arrière-plan | L'une de `working`, `blocked`, `done`, `failed`, ou `stopped`. Voir [Lire l'état de la session à partir d'un script](#read-session-state-from-a-script) pour savoir ce que chaque valeur signifie |

778| `pid`, `status` | Tant que le processus est actif | ID du processus et l'une de `busy`, `waiting`, ou `idle` |

779| `waitingFor` | Quand `status` est `waiting` | Sur quoi la session est bloquée : `permission prompt` pour une approbation, `input needed` pour une question de Claude ou une demande d'entrée d'un serveur MCP, `sandbox request`, `worker request`, ou `dialog open` |

780| `sessionId`, `name` | Quand défini | `sessionId` est l'UUID de session complet, utilisable avec [`claude --resume`](/docs/fr/sessions). Le `name` d'une session interactive est son [nom d'affichage par défaut](/docs/fr/sessions#name-your-sessions) jusqu'à ce que vous nommez la session ou acceptiez un plan en elle |

603 781

604Une session en arrière-plan n'hérite pas des variables de point de terminaison de passerelle telles que `ANTHROPIC_BASE_URL` ou les variables d'URL de base équivalentes pour Amazon Bedrock, Google Cloud's Agent Platform, et Microsoft Foundry depuis le shell qui a démarré le superviseur. Sans une passerelle exportée dans le shell à partir duquel vous dispatchez, la session utilise vos identifiants stockés et toute valeur `env` dans le bloc [settings](/docs/fr/settings) du répertoire du projet. Pour pointer chaque session dans un projet vers une [passerelle LLM](/docs/fr/llm-gateway), définissez `ANTHROPIC_BASE_URL` dans le bloc `env` du fichier `.claude/settings.json` de ce projet.782<h3 id="read-session-state-from-a-script">

~~605~~ 783 Lire l'état de la session à partir d'un script

606Si vous exportez une passerelle `ANTHROPIC_BASE_URL` dans le shell à partir duquel vous dispatchez, elle atteint le worker de cette session. `ANTHROPIC_CUSTOM_HEADERS` et l'identifiant exporté à côté sont transmis avec elle. Cela se produit quand le superviseur a été démarré à partir d'un environnement avec la même passerelle. Le superviseur capture son environnement depuis le premier shell qui ouvre la vue agent ou dispatch une session en arrière-plan, donc démarrer à partir du shell de passerelle lui donne cet environnement. La transmission s'applique également uniquement aux sessions dispatched dans le répertoire à partir duquel vous dispatchez, ou mises en arrière-plan à partir de votre propre session avec `←` ou `/background` : dispatcher dans un répertoire différent avec `@repo` ou `--cwd` ne porte pas la passerelle du shell, et le bloc `env` du `settings.json` de ce projet fournit le point de terminaison à la place. Quand l'environnement du superviseur porte une passerelle différente ou aucune, le worker conserve vos identifiants stockés contre le point de terminaison par défaut au lieu de mélanger l'identifiant d'un environnement avec le point de terminaison d'un autre. Avant v2.1.203, le `ANTHROPIC_BASE_URL` du shell de dispatch était supprimé tandis que le `ANTHROPIC_API_KEY` exporté à côté était conservé, donc la clé de la passerelle était envoyée au point de terminaison par défaut et chaque requête échouait avec un 401.784</h3>

~~607~~

608Le point de terminaison transmis s'applique uniquement à ce processus actif et n'est jamais écrit sur le disque. Quand le superviseur arrête une session inactive et la redémarre plus tard, le processus redémarré lit son point de terminaison à partir de vos paramètres à nouveau : avec un `ANTHROPIC_AUTH_TOKEN` de passerelle, il revient à vos identifiants stockés, et avec un `ANTHROPIC_API_KEY` émis par la passerelle, il peut échouer à s'authentifier jusqu'à ce que la passerelle soit définie dans les paramètres.

~~609~~

610Chaque 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. Une commande shell en arrière-plan en cours d'exécution, un sous-agent, un workflow dynamique, ou un monitor compte comme un travail actif, donc un processus de longue durée tel qu'un serveur de développement maintient la session active.

611 785

612Une 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. Une session que vous avez [épinglée](#organize-the-list) avec `Ctrl+T` est exemptée et garde son processus en cours d'exécution pendant qu'elle est inactive. La transcription et l'état restent sur le disque de toute façon, et la prochaine fois que vous vous attachez, apercevez, ou répondez à une session arrêtée, 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.786`claude agents --json` est la façon prise en charge de lire l'état de la session de l'extérieur de Claude Code, par exemple à partir d'une barre d'état, d'un planificateur, ou d'une autre session Claude qui supervise le travail en arrière-plan. Interrogez `claude agents --json --all`, qui continue à lister les sessions dont le processus a quitté, et lisez le `state`, `status`, et `waitingFor` de chaque entrée.

613 787

614Le travail en arrière-plan que la session elle-même a démarré au niveau supérieur est confié quand son processus est arrêté, redémarré ou mis à jour, y compris sur Windows. Le processus suivant démarré pour cette session reprend le travail :788| `state` | Ce que cela signifie |

789| :------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

790| `working` | Un tour est en cours d'exécution, ou la session est entre les étapes du travail qu'elle conduit elle-même, comme une itération [`/loop`](/docs/fr/scheduled-tasks) ou une attente sur CI. `status` vous indique si son processus est `busy` en ce moment |

791| `blocked` | La session vous attend : une question qu'elle a posée, une permission ou une décision de sandbox, une erreur que seul vous pouvez effacer comme une connexion expirée, ou son premier prompt si vous l'avez démarrée sans. Quand l'attente est un prompt ouvert dans un processus actif, `waitingFor` le nomme |

792| `done` | Le dernier tour a terminé ce que vous avez demandé et la session est prête pour votre prochain prompt, que son processus soit encore actif ou non |

793| `failed`, `stopped` | La tâche s'est terminée avec une erreur, ou la session a été arrêtée |

615 794

616* Une commande shell en arrière-plan qui s'est terminée entre-temps est signalée comme terminée avec sa sortie795Une session qui a terminé son tour et attend votre prochaine instruction lit `done`, pas `blocked`. `blocked` signifie toujours que la session a besoin de quelque chose de votre part avant de pouvoir continuer.

617* Un workflow dynamique reprend à partir de là où il s'était arrêté

618* Un [sous-agent en arrière-plan](/docs/fr/sub-agents#run-subagents-in-foreground-or-background) reprend à partir de sa propre transcription

619 796

620À partir de v2.1.198, la remise couvre tous les trois. Avant v2.1.198, elle couvrait uniquement les commandes shell et les workflows, donc un sous-agent en arrière-plan s'arrêtait avec le processus et était signalé comme échoué au prochain réveil.797Les fichiers sous `~/.claude/jobs/<id>/` ne sont pas une interface stable. Les valeurs qu'une session ou un autre programme écrit dans `state`, `detail`, `tempo`, ou `needs` sont remplacées à la prochaine mise à jour.

621 798

622Le travail dont l'état vit uniquement à l'intérieur du processus lui-même s'arrête avec lui au lieu d'être confié. C'est les commandes shell qu'un sous-agent a démarrées, que le sous-agent repris peut redémarrer, et les [monitors](/docs/fr/tools-reference#monitor-tool) en cours d'exécution, dont le flux d'événements ne peut pas être déplacé vers un autre processus.799Si vous voulez qu'une session rapporte la progression dans ses propres termes, faites-la écrire un fichier qui lui est propre, par exemple sous `$CLAUDE_JOB_DIR/tmp`, au lieu de modifier `state.json`.

623 800

624Supprimer la session arrête tout ce qu'elle a confié. Pour arrêter tout le travail en arrière-plan de la session avec le processus au lieu de le confier, définissez la variable d'environnement [`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/docs/fr/env-vars#variables) à `1`.801<h2 id="how-background-sessions-are-hosted">

802 Comment les sessions en arrière-plan sont hébergées

803</h2>

625 804

626Un processus redémarré trouve la conversation d'une session qui [s'est déplacée dans une worktree](#how-file-edits-are-isolated) en cours de tâche : quand la transcription n'est pas là où la session a commencé, Claude Code regarde également sous les worktrees enregistrées du référentiel. Avant v2.1.207, rouvrir cette session à partir de la vue agent après l'arrêt de son processus pouvait afficher une conversation vide avec uniquement son invite d'origine, la transcription restant intacte sur le disque ; ouvrir la session à nouveau sur v2.1.207 ou ultérieur la récupère.805Claude Code traite chaque session listée dans la vue agent 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).

627 806

628Si une session redémarrée revient en affichant uniquement son invite d'origine parce que Claude Code a mal lu sa transcription comme vide, la transcription de conversation est renommée avec un suffixe `.orphaned-` au lieu d'être supprimée, donc elle reste sur votre machine.807Pour vérifier quel type de session vous utilisez, exécutez [`/status`](/docs/fr/commands). La ligne `Session kind` affiche `background job · attached` ou `background job · unattended` dans une session en arrière-plan, selon qu'un terminal est attaché, et `interactive` dans toute autre session.

629 808

630Une ligne vide laissée après avoir appuyé sur `←` qui n'a jamais reçu d'invite est supprimée entièrement après environ cinq minutes pour que la liste se vide d'elle-même. Les sessions démarrées avec `claude --bg` et les sessions en attente d'une invite de configuration telle qu'une boîte de dialogue de confiance ne sont pas supprimées de cette façon.809<h3 id="the-supervisor-process">

810 Le processus superviseur

811</h3>

631 812

632Quand l'hôte manque de mémoire, le superviseur arrête d'abord les sessions inactives non épinglées et arrête les sessions épinglées inactives seulement si cela n'a rien libéré.813Le superviseur est un service en arrière-plan qui exécute vos sessions en arrière-plan pour qu'elles continuent de fonctionner après que vous fermiez la vue agent ou votre terminal. Claude Code le démarre la première fois que vous mettez une session en arrière-plan ou ouvrez la vue agent, et vous n'avez pas besoin de le gérer vous-même.

633 814

634Le superviseur regarde le binaire Claude Code installé sur le disque et redémarre dans la nouvelle version après que l'[auto-updater](/docs/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. Une session épinglée inactive est également redémarrée sur place dans la nouvelle version pour qu'elle récupère la mise à jour sans que vous vous réattachiez.815Chaque session est son propre processus Claude Code sous le superviseur, et ce qui arrive à ce processus dépend de l'état de la session :

635 816

636Une fois que le nouveau superviseur prend le relais, il redémarre également les sessions inactives restantes dans la nouvelle version, quelques-unes à la fois en arrière-plan, après un court délai qui permet aux terminaux attachés lors du redémarrage de se reconnecter d'abord. Une session qui fonctionne, attend votre entrée, ou a un terminal attaché n'est pas interrompue ; elle se déplace vers la nouvelle version la prochaine fois que son processus redémarre. Avant v2.1.206, le superviseur ne déplaçait que quelques sessions inactives par minute vers une nouvelle version, donc les sessions pouvaient continuer à exécuter l'ancienne pendant un certain temps après une mise à jour.817* **En cours d'exécution, en pause sur une invite de permission ou un autre dialogue, ou attaché** : le processus continue de s'exécuter. Un sous-agent, un workflow ou un monitor en cours d'exécution compte comme en cours d'exécution.

818* **Terminé ou en attente de votre prochain message, et non attaché pendant environ une heure** : le superviseur arrête le processus pour libérer des ressources. Une session qui a terminé son tour en vous posant une question compte comme en attente de votre prochain message. La conversation reste sur le disque, et la prochaine fois que vous vous attachez ou répondez, la session reprend là où elle s'était arrêtée. Épinglez une session avec `Ctrl+T` pour garder son processus en cours d'exécution.

819* **Arrêté de manière inattendue tandis que le superviseur est en cours d'exécution** : le superviseur redémarre le processus. Terminer une session que vous avez mise en arrière-plan vous-même avec `←` ou `/background`, par exemple avec `kill`, la marque comme arrêtée au lieu de la redémarrer. Pour les sessions qui se sont terminées avec un arrêt, voir [Les sessions s'affichent comme échouées ou arrêtées après l'arrêt](#sessions-show-as-failed-after-shutdown).

820* **Après une mise à jour automatique** : le superviseur redémarre lui-même sur la nouvelle version et déplace les sessions inactives en arrière-plan. Les sessions qui fonctionnent, qui attendent votre entrée, ou qui sont attachées ne sont pas interrompues.

637 821

638Ces redémarrages ne déplacent jamais une session vers une version plus ancienne. Un superviseur exécutant une version plus ancienne de Claude Code que celle avec laquelle le processus d'une session a été démarré laisse ce processus seul ; la session continue d'exécuter la version plus récente jusqu'à ce qu'un superviseur plus récent prenne le relais.822Quand le processus d'une session s'arrête ou redémarre, les commandes shell en arrière-plan, les workflows dynamiques et les sous-agents en arrière-plan que Claude a démarrés dedans se reportent à son processus suivant ; les monitors en cours d'exécution et les commandes shell qu'un sous-agent a démarrées s'arrêtent avec le processus. Supprimer la session arrête tout ce qu'elle a reporté. Pour arrêter tout cela avec le processus à la place, définissez [`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/docs/fr/env-vars#variables) à `1`.

639 823

640L'exécution de `claude attach` tandis que le superviseur redémarre une session, que ce soit pour une mise à jour, une stagnation, ou une migration, attend le processus de remplacement au lieu d'échouer. Une ligne d'état telle que `Agent is updating to the new Claude Code…` nomme ce qu'il attend et compte les secondes écoulées, et la commande se connecte dès que la session est prête. Après environ 60 secondes, elle arrête d'attendre et signale une erreur. Avant v2.1.205, `claude attach` arrêtait de réessayer après quelques secondes et imprimait une erreur tandis que la session était encore en cours de redémarrage.824Le superviseur et ses sessions s'authentifient avec les mêmes identifiants stockés que vos sessions interactives. Pour savoir quels paramètres et variables shell atteignent une session, y compris `PATH`, voir [Paramètres et fournisseur](#settings-and-provider). Pour les points de terminaison de passerelle, voir [Passerelle LLM](#llm-gateway).

641 825

642<h3 id="where-state-is-stored">826<h3 id="where-state-is-stored">

643 Où l'état est stocké827 Où l'état est stocké

646L'état de la session est stocké sous votre répertoire de configuration Claude Code. Si vous définissez [`CLAUDE_CONFIG_DIR`](/docs/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.830L'état de la session est stocké sous votre répertoire de configuration Claude Code. Si vous définissez [`CLAUDE_CONFIG_DIR`](/docs/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.

647 831

648| Chemin | Contenu |832| Chemin | Contenu |

649| :------------------------------- | :--------------------------------------------------------------------------------------------------------------------------- |833| :------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------- |

651| `~/.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 |835| `~/.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 |

652| `~/.claude/jobs/<id>/state.json` | État par session affiché dans la vue agent |836| `~/.claude/jobs/<id>/state.json` | État par session affiché dans la vue agent. Lisez-le via [`claude agents --json`](#read-session-state-from-a-script) au lieu d'analyser le fichier |

653| `~/.claude/jobs/<id>/tmp/` | Répertoire de travail par session. Les écritures ici ne demandent pas de permission. Supprimé quand la session est supprimée |837| `~/.claude/jobs/<id>/tmp/` | Répertoire de travail par session. Les appels `Write` et `Edit` de Claude ici ne demandent pas de permission. Supprimé quand la session est supprimée |

654 838

655Chaque session en arrière-plan a la variable d'environnement `CLAUDE_JOB_DIR` définie à son répertoire `~/.claude/jobs/<id>`, donc les commandes shell que la session exécute peuvent écrire des fichiers temporaires à `$CLAUDE_JOB_DIR/tmp` sans entrer en collision avec les sessions parallèles.839Chaque session en arrière-plan a la variable d'environnement `CLAUDE_JOB_DIR` définie à son répertoire `~/.claude/jobs/<id>`, donc les commandes shell que la session exécute peuvent écrire des fichiers temporaires à `$CLAUDE_JOB_DIR/tmp` sans entrer en collision avec les sessions parallèles.

656 840

658 842

659La commande avertit également quand le superviseur en cours d'exécution est sur une version différente de celle du `claude` que vous avez invoqué, ce qui se produit après une mise à jour que le superviseur n'a pas encore redémarrée. L'avertissement affiche les deux versions et vous dit d'exécuter `claude daemon stop --any` pour récupérer la nouvelle version. Quand Claude Code est installé en tant que service du système d'exploitation, la commande suggérée est `claude daemon stop` sans le drapeau.843La commande avertit également quand le superviseur en cours d'exécution est sur une version différente de celle du `claude` que vous avez invoqué, ce qui se produit après une mise à jour que le superviseur n'a pas encore redémarrée. L'avertissement affiche les deux versions et vous dit d'exécuter `claude daemon stop --any` pour récupérer la nouvelle version. Quand Claude Code est installé en tant que service du système d'exploitation, la commande suggérée est `claude daemon stop` sans le drapeau.

660 844

661Les sessions survivent à ce décalage de version intact : une version plus ancienne de Claude Code qui met à jour le `state.json` d'une session préserve les champs qu'elle ne reconnaît pas et garde la session listée. La liste des sessions dans `roster.json` suit la même règle : une version plus ancienne qui la réécrit préserve les champs qu'une version plus récente a écrit, donc les sessions démarrées par la version plus récente restent accessibles et continuent d'accepter l'entrée après le redémarrage du superviseur. Avant v2.1.200, les versions plus anciennes pouvaient supprimer ces champs lors de la réécriture.845Les sessions survivent à ce décalage de version intact : une version plus ancienne de Claude Code qui met à jour le `state.json` d'une session préserve les champs qu'elle ne reconnaît pas et garde la session listée. La liste des sessions dans `roster.json` suit la même règle, donc les sessions démarrées par la version plus récente restent accessibles et continuent d'accepter l'entrée après le redémarrage du superviseur.

~~662~~

663Sur Windows, `claude daemon status` affiche l'erreur de fichier sous-jacente quand le fichier de clé pipe du daemon est verrouillé ou illisible au lieu de signaler un échec de connexion générique.

664 846

665<h3 id="turn-off-agent-view">847<h3 id="turn-off-agent-view">

666 Désactiver la vue agent848 Désactiver la vue agent

667</h3>849</h3>

668 850

669Pour désactiver complètement les agents en arrière-plan et la vue agent, définissez le paramètre `disableAgentView` [setting](/docs/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](/docs/fr/permissions#managed-settings).851Pour désactiver complètement les agents en arrière-plan et la vue agent, définissez le paramètre `disableAgentView` [setting](/docs/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](/docs/fr/managed-settings).

670 852

671<h2 id="troubleshooting">853<h2 id="troubleshooting">

672 Dépannage854 Dépannage

684 La vue agent s'ouvre sans sessions866 La vue agent s'ouvre sans sessions

685</h3>867</h3>

686 868

687Avant de lancer votre première session, la vue agent affiche les en-têtes de section vides avec une description sous chacun, plus une explication d'une ligne au-dessus de l'entrée, à la place de la liste des sessions. Tapez une invite dans l'entrée en bas et appuyez sur `Entrée` pour lancer votre première session.869Avant de dispatcher votre première session, la vue agent affiche les en-têtes de section vides avec une description sous chacun, plus une explication d'une ligne au-dessus de l'entrée, à la place de la liste des sessions. Tapez une invite dans l'entrée en bas et appuyez sur `Entrée` pour dispatcher votre première session.

688 870

689<h3 id="backgrounding-shows-a-background-this-session-dialog">871<h3 id="backgrounding-shows-a-background-this-session-dialog">

690 Mise en arrière-plan affiche une boîte de dialogue `Background this session?`872 Le backgrounding affiche une boîte de dialogue `Background this session?`

691</h3>873</h3>

692 874

693Si appuyer sur `←` pour mettre la session actuelle en arrière-plan affiche une boîte de dialogue `Background this session?`, la session a du travail en cours qui ne peut pas se transférer à la session en arrière-plan, comme un [monitor](/docs/fr/tools-reference#monitor-tool) en cours d'exécution, et Claude Code ne l'arrêtera pas silencieusement. La boîte de dialogue nomme le travail qui sera arrêté et, séparément, compte les tâches qui se transfèrent. Exécutez `/tasks` pour voir tout ce qui s'exécute, puis confirmez pour mettre en arrière-plan de toute façon ou choisissez `Stay` pour laisser le travail se terminer d'abord. Voir [À partir d'une session](#from-inside-a-session) pour savoir quels types de tâches se transfèrent et lesquels s'arrêtent.875Si vous appuyez sur `←` pour mettre en arrière-plan la session actuelle et que Claude Code affiche une boîte de dialogue `Background this session?`, la session a du travail en cours que la mise en arrière-plan arrêterait, redémarrerait ou laisserait s'exécuter sans surveillance, et Claude Code demande avant de faire l'une de ces actions :

876

877* **Travail qui ne peut pas être déplacé** : la session a du travail qui ne peut pas être déplacé vers la session en arrière-plan, comme un [monitor](/docs/fr/tools-reference#monitor-tool) en cours d'exécution. La boîte de dialogue nomme le travail que Claude Code arrêterait et, séparément, compte les tâches qui sont transférées.

878* **Un workflow avec des sous-agents en cours d'exécution** : un [dynamic workflow](/docs/fr/workflows) a toujours des sous-agents en cours d'exécution. Le workflow lui-même est transféré, mais ses sous-agents en cours d'exécution redémarrent depuis le début, et la boîte de dialogue indique combien.

879* **Réponses automatiques aux artefacts** : Claude [répond aux commentaires sur un artefact de sa propre initiative](/docs/fr/artifacts#let-claude-reply-to-comments-on-its-own). Ces réponses continuent dans la session en arrière-plan, et la boîte de dialogue le dit.

880

881Exécutez `/tasks` pour voir tout ce qui s'exécute, puis confirmez pour mettre en arrière-plan de toute façon ou choisissez `Stay` pour laisser le travail se terminer d'abord. Consultez [What carries over when you background](#what-carries-over-when-you-background) pour savoir quels types de travail sont transférés et lesquels Claude Code arrête.

694 882

695<h3 id="prompt-rejected-as-too-short">883<h3 id="prompt-rejected-as-too-short">

696 Invite rejetée comme trop courte884 Invite rejetée comme trop courte

697</h3>885</h3>

698 886

699L'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`.887L'entrée de dispatch s'attend à une description de tâche, pas à un ouvreur conversationnel. 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`.

700 888

701<h3 id="sessions-show-as-failed-after-shutdown">889<h3 id="sessions-show-as-failed-after-shutdown">

702 Les sessions s'affichent comme échouées après l'arrêt890 Les sessions s'affichent comme échouées ou arrêtées après l'arrêt

703</h3>891</h3>

704 892

705L'arrêt ou le redémarrage de votre machine arrête les sessions en arrière-plan en cours d'exécution, elles s'affichent donc comme échouées quand vous ouvrez à nouveau la vue agent. Attachez-vous, apercevez, ou répondez à n'importe laquelle d'entre elles et la session redémarre à partir de là où elle s'était arrêtée.893L'arrêt ou le redémarrage de votre machine arrête les sessions en arrière-plan en cours d'exécution. Une session qui attendait votre entrée reste sous `Needs input` quand vous revenez. Pour toute autre session en cours d'exécution, ce que la vue agent affiche dépend de la durée depuis laquelle elle a fait des progrès :

894

895* Dans les 48 heures, la session s'affiche comme échouée. Attachez-la ou répondez-lui et elle redémarre d'où elle s'était arrêtée.

896* Après 48 heures, par exemple après que la machine ait été éteinte pendant des jours, la session s'affiche comme arrêtée avec `ended while the background service was off`. Appuyez sur `Entrée` sur la ligne et le pied de page affiche `Press enter again to resume this session (it ended while the background service was off), or ctrl+x to delete it.` Appuyez sur `Entrée` sur la même ligne à nouveau pour reprendre sa conversation enregistrée. Une réponse ou `claude attach <id>` la reprend sans cette invite de pied de page.

706 897

707La mise en veille seule ne cause pas cela. Les sessions sont préservées lors de la mise en veille et le superviseur se reconnecte à elles au réveil.898Quand le [transcript cleanup](/docs/fr/settings-reference#cleanupperioddays) a supprimé la conversation enregistrée d'une session arrêtée, Claude Code refuse d'ouvrir la ligne : le message dit qu'il n'y a rien à reprendre. `claude rm <id>` supprime la ligne, sauf dans les [cas conservés](#what-deleting-a-session-removes) décrits ci-dessus, et `claude respawn <id>` exécute à nouveau son invite d'origine. Consultez [This session's saved conversation is no longer on disk](/docs/fr/errors#this-sessions-saved-conversation-is-no-longer-on-disk).

899

900Le sommeil seul n'arrête pas les sessions. Les sessions sont préservées lors du sommeil et le superviseur se reconnecte à elles au réveil.

708 901

709<h3 id="opening-a-session-says-the-conversation-is-already-open">902<h3 id="opening-a-session-says-the-conversation-is-already-open">

710 Ouverture d'une session indique que la conversation est déjà ouverte903 L'ouverture d'une session indique que la conversation est déjà ouverte

711</h3>904</h3>

712 905

713L'ouverture d'une ligne arrêtée dont la conversation est également maintenue ouverte par un autre processus Claude Code non interactif en cours d'exécution, par exemple un worker en arrière-plan pour la même conversation qui se termine toujours, affiche `This conversation is already open in another running Claude session` au lieu de démarrer le processus de la ligne, car deux processus ne peuvent pas écrire à la même transcription. Répondez dans la session qui a déjà la conversation ouverte, ou quittez-la et ouvrez la ligne à nouveau. Une réponse que vous avez tapée avec la tentative refusée n'est pas perdue ; elle est envoyée la prochaine fois que la session démarre.906Deux processus ne peuvent pas écrire dans la même transcription. Quand la conversation enregistrée d'une session arrêtée est déjà ouverte dans un autre processus Claude Code actif, Claude Code refuse de démarrer le propre processus de la session. Ce que vous voyez dépend de ce qui détient la conversation :

907

908* Un terminal où vous avez repris la conversation, par exemple avec `claude --resume` ou `/resume` : la ligne affiche `Open in a terminal` avec un indice pour la continuer là, et l'ouverture de la ligne affiche `Can't open — this session is running in another terminal`. Continuez dans ce terminal, ou quittez-le et ouvrez la ligne à nouveau.

909* Un autre processus Claude Code non interactif, par exemple un processus de session en arrière-plan pour la même conversation qui n'a pas encore quitté : l'ouverture de la ligne affiche `This conversation is already open in another running Claude session`. Utilisez ce processus, ou attendez qu'il se termine et ouvrez la ligne à nouveau.

714 910

715Avant la v2.1.203, cet état démarrait un deuxième processus de toute façon. Ce processus s'est terminé avec une erreur `currently running as a background agent` et la ligne s'est affichée comme échouée.911Claude Code enregistre une réponse que vous avez tapée avec la tentative refusée et l'envoie la prochaine fois que la session démarre.

912

913<h3 id="opening-a-session-says-it-has-no-saved-transcript">

914 L'ouverture d'une session indique qu'elle n'a pas de transcription enregistrée

915</h3>

916

917Une session arrêtée qui a été [backgrounded from another conversation](#from-inside-a-session) et s'est arrêtée avant la fin de sa première réponse n'a rien à reprendre : jusqu'à ce que cette première réponse se termine, la conversation vit toujours uniquement dans la session à partir de laquelle elle a été mise en arrière-plan. `claude attach` refuse de l'ouvrir avec `This session has no saved transcript`.

918

919Dans la vue agent, l'ouverture de cette ligne affiche `Press enter again to restart this session fresh` sous la liste. Appuyez sur `Entrée` sur la même ligne à nouveau pour redémarrer la session avec une conversation vide, ou exécutez `claude respawn <id>` depuis le shell.

920

921La conversation d'origine est intacte ; reprenez-la avec `claude --resume` ou continuez à y travailler. Consultez la [référence des erreurs](/docs/fr/errors#this-session-has-no-saved-transcript) pour plus de détails.

922

923<h3 id="the-terminal-host-died-or-the-session-stopped-responding">

924 L'hôte du terminal est mort ou la session a cessé de répondre

925</h3>

926

927Le [supervisor](#the-supervisor-process) exécute le terminal de chaque session en arrière-plan dans son propre processus hôte. Quand ce processus meurt ou cesse de répondre, Claude Code affiche la raison et propose un redémarrage ; dans les deux cas, la conversation est enregistrée et le redémarrage la reprend. La [référence des erreurs](/docs/fr/errors#terminal-host-process-died) cite les messages complets.

928

929Claude Code ne redémarre jamais une ligne exécutant une [shell command](#run-a-shell-command), depuis `Entrée` ou depuis `claude attach`, car cela exécuterait la commande à nouveau ; le message de la ligne et `claude attach` disent tous deux que la commande n'est pas exécutée à nouveau.

930

931<h4 id="terminal-host-died">

932 L'hôte du terminal est mort

933</h4>

934

935Sur Linux et WSL, le superviseur vérifie chaque processus hôte toutes les quelques secondes, que vous ouvriez la session ou non, et marque la session comme échouée quand le processus a quitté mais sa connexion au superviseur ne s'est jamais fermée.

936

937* Dans la vue agent, la ligne affiche `terminal host process died — press Enter to restart`. Appuyez sur `Entrée` dessus et Claude Code redémarre la session sur un processus hôte frais.

938* Depuis le shell, `claude attach <id>` redémarre une session déjà marquée comme échouée. Sinon, il rapporte la cause et se termine, vous disant d'exécuter `claude attach <id>` à nouveau.

939

940<h4 id="session-isn’t-responding">

941 La session ne répond pas

942</h4>

943

944Quand le superviseur accepte une ouverture mais qu'aucune sortie n'arrive pendant environ dix secondes, Claude Code termine la tentative et propose un redémarrage. Une session qui s'est simplement figée, par exemple lors du sommeil de la machine, n'atteint pas cette offre : le superviseur la [redémarre à l'ouverture](#read-session-state) lui-même.

945

946* Dans la vue agent, le pied de page affiche `Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).` Appuyez sur `Entrée` sur la même ligne à nouveau et Claude Code arrête le processus qui ne répond pas et redémarre la session ; il n'arrête rien sans ce deuxième appui.

947* Depuis le shell, `claude attach <id>` rapporte la cause et se termine, vous disant d'exécuter `claude stop <id>`, puis `claude attach <id>`.

716 948

717<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">949<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">

718 Une session échoue avant de démarrer avec une note « possibly low memory »950 Une session échoue avant de démarrer avec une note `possibly low memory`

719</h3>951</h3>

720 952

721À partir de la v2.1.199, quand le processus d'une session en arrière-plan se termine avant de finir de démarrer et que l'hôte manque de mémoire, le statut de la ligne nomme la sortie et ajoute `possibly low memory — free some up and retry`. Les versions antérieures affichaient uniquement la raison de sortie brute pour cet échec.953Quand le processus d'une session en arrière-plan se termine avant de finir de démarrer et que l'hôte manque de mémoire, le statut de la ligne nomme la sortie et ajoute `possibly low memory — free some up and retry`.

722 954

723La note est une hypothèse, pas une cause confirmée. Claude Code l'ajoute uniquement quand le processus s'est terminé silencieusement, sans écrire d'erreur et sans être arrêté par un signal, et que l'hôte a signalé une mémoire faible à ce moment. Quand le processus a écrit une erreur avant de se terminer, la ligne affiche cette erreur à la place.955La note est une hypothèse, pas une cause confirmée. Claude Code l'ajoute uniquement quand le processus s'est terminé silencieusement, sans écrire une erreur et sans être arrêté par un signal, et que l'hôte a signalé une mémoire faible à ce moment. Quand le processus a écrit une erreur avant de se terminer, la ligne affiche cette erreur à la place.

724 956

725Libérez de la mémoire sur la machine, puis attachez-vous, apercevez, ou répondez à la ligne et le superviseur démarre un processus frais pour la session. Quand la mémoire reste faible, le superviseur [arrête également les sessions inactives](#the-supervisor-process) pour libérer des ressources de lui-même.957Libérez de la mémoire sur la machine, puis attachez-vous ou répondez à la ligne et le superviseur démarre un processus frais pour la session. Quand la mémoire reste faible, le superviseur [arrête également les sessions inactives](#the-supervisor-process) pour libérer des ressources de sa propre initiative, et arrête également les sessions épinglées inactives si l'arrêt des autres n'a rien libéré.

726 958

727<h3 id="agent-view-says-the-background-service-did-not-respond">959<h3 id="agent-view-says-the-background-service-did-not-respond">

728 La vue agent indique que le service en arrière-plan n'a pas répondu960 La vue agent indique que le service en arrière-plan n'a pas répondu

729</h3>961</h3>

730 962

731Si l'attachement, l'aperçu, ou `claude logs` signale que le service en arrière-plan n'a pas répondu, le processus superviseur a probablement bloqué. Arrêtez-le et laissez le prochain `claude agents` en démarrer un nouveau. Pour garder vos sessions en arrière-plan en cours d'exécution pendant le redémarrage, passez `--keep-workers` :963Si l'attachement, l'aperçu ou `claude logs` rapporte que le service en arrière-plan n'a pas répondu, le processus superviseur s'est probablement figé. Arrêtez-le et laissez le prochain `claude agents` en démarrer un frais. Pour garder vos sessions en arrière-plan en cours d'exécution lors du redémarrage, passez `--keep-workers` :

732 964

733```bash theme={null}965```bash theme={null}

734claude daemon stop --any --keep-workers966claude daemon stop --any --keep-workers

736 968

737Le nouveau superviseur se reconnecte aux sessions en cours d'exécution. Sans `--keep-workers`, la commande termine également les sessions en arrière-plan. Le drapeau `--any` confirme que vous voulez arrêter un superviseur qui a démarré à la demande plutôt que comme service installé, ce qui est la valeur par défaut.969Le nouveau superviseur se reconnecte aux sessions en cours d'exécution. Sans `--keep-workers`, la commande termine également les sessions en arrière-plan. Le drapeau `--any` confirme que vous voulez arrêter un superviseur qui a démarré à la demande plutôt que comme service installé, ce qui est la valeur par défaut.

738 970

739Un superviseur qui démarre mais ne peut pas accepter les connexions quitte et libère son verrou de lui-même, donc le prochain `claude agents` démarre un nouveau sans cet arrêt manuel. Les étapes ci-dessus s'appliquent quand un superviseur en cours d'exécution bloque.971Un superviseur qui démarre mais ne peut pas accepter les connexions se termine et libère son verrou de sa propre initiative, donc le prochain `claude agents` en démarre un frais sans cet arrêt manuel. Les étapes ci-dessus s'appliquent quand un superviseur en cours d'exécution se fige.

972

973Si la commande se termine plutôt en disant que le processus enregistré n'a pas pu être vérifié comme superviseur, vérifiez l'ID de processus rapporté : s'il s'agit d'un superviseur que vous possédez, arrêtez-le vous-même, puis supprimez `~/.claude/daemon.lock` pour que le prochain `claude agents` démarre frais.

740 974

741Sur Windows, si le superviseur ne répond pas à la demande d'arrêt, la commande affiche son ID de processus. Terminez ce processus avec `taskkill /PID <pid>` pour terminer la récupération. Les sessions en arrière-plan sont toujours préservées quand vous avez passé `--keep-workers`.975Sur Windows, si le superviseur ne répond pas à la demande d'arrêt, la commande affiche son ID de processus. Terminez ce processus avec `taskkill /PID <pid>` pour terminer la récupération. Les sessions en arrière-plan sont toujours préservées quand vous avez passé `--keep-workers`.

742 976

744 Le dispatch échoue avec `Could not resolve authentication method`978 Le dispatch échoue avec `Could not resolve authentication method`

745</h3>979</h3>

746 980

747Si un dispatch en arrière-plan échoue avec `Could not resolve authentication method` tandis que les sessions interactives s'authentifient normalement, le worker qui a reçu le dispatch n'a pas récupéré les identifiants. Le superviseur fournit un nouvel instantané d'identifiants quand il assigne un [worker préchauffé](#the-supervisor-process), donc cette erreur signifie qu'aucun identifiant stocké n'était disponible pour le processus superviseur lui-même. Confirmez que vous avez exécuté `/login` ou configuré une clé API, puis arrêtez le superviseur :981Si un dispatch en arrière-plan échoue avec `Could not resolve authentication method` tandis que les sessions interactives s'authentifient normalement, le worker qui a reçu le dispatch n'a pas récupéré les identifiants. Les sessions en arrière-plan obtiennent leurs identifiants du [supervisor](#the-supervisor-process), donc cette erreur signifie qu'aucun identifiant stocké n'était disponible pour le processus superviseur lui-même. Confirmez que vous avez exécuté `/login` ou configuré une clé API, puis arrêtez le superviseur :

748 982

749```bash theme={null}983```bash theme={null}

750claude daemon stop --any --keep-workers984claude daemon stop --any --keep-workers

751```985```

752 986

753Le prochain `claude agents` ou `claude --bg` démarre un nouveau superviseur qui lit vos identifiants stockés. Si vous vous authentifiez avec une variable d'environnement comme `ANTHROPIC_API_KEY` plutôt qu'avec `/login`, exécutez cette prochaine commande à partir d'un shell où la variable est définie.987Le prochain `claude agents` ou `claude --bg` démarre un superviseur frais qui lit vos identifiants stockés. Si vous vous authentifiez avec une variable d'environnement telle que `ANTHROPIC_API_KEY` plutôt que `/login`, exécutez cette commande suivante depuis un shell où la variable est définie.

754 988

755Voir la [référence d'erreur](/docs/fr/errors#could-not-resolve-authentication-method) pour la liste complète des causes et des correctifs.989Consultez la [référence des erreurs](/docs/fr/errors#could-not-resolve-authentication-method) pour la liste complète des causes et des correctifs.

756 990

757<h3 id="background-sessions-can’t-read-desktop-documents-or-downloads-on-macos">991<h3 id="background-sessions-can’t-read-desktop-documents-or-downloads-on-macos">

758 Les sessions en arrière-plan ne peuvent pas lire Desktop, Documents ou Downloads sur macOS992 Les sessions en arrière-plan ne peuvent pas lire Desktop, Documents ou Downloads sur macOS

759</h3>993</h3>

760 994

761Sur macOS, l'hôte de session en arrière-plan s'exécute comme son propre processus et demande l'accès aux dossiers protégés séparément de votre terminal. Si une session en arrière-plan signale `Operation not permitted` lors de la lecture de `~/Desktop`, `~/Documents`, `~/Downloads`, ou un autre emplacement protégé, accordez l'accès dans Paramètres système sous Confidentialité et sécurité > Fichiers et dossiers, ou activez Accès complet au disque pour l'entrée.995Sur macOS, l'hôte de la session en arrière-plan s'exécute en tant que processus distinct et demande l'accès aux dossiers protégés séparément de votre terminal. Si une session en arrière-plan rapporte `Operation not permitted` lors de la lecture de `~/Desktop`, `~/Documents`, `~/Downloads` ou d'un autre emplacement protégé, accordez l'accès dans Paramètres système sous Confidentialité et sécurité > Fichiers et dossiers, ou activez Accès complet au disque pour l'entrée.

762 996

763Avec l'installateur natif, l'entrée apparaît comme Claude Code et l'autorisation persiste lors des mises à jour. Avec d'autres méthodes d'installation comme Homebrew ou npm, l'entrée affiche le chemin du binaire et peut avoir besoin d'être accordée à nouveau après la mise à jour.997Avec le programme d'installation natif, l'entrée apparaît comme Claude Code et l'octroi persiste lors des mises à jour. Avec d'autres méthodes d'installation telles que Homebrew ou npm, l'entrée affiche le chemin du binaire et peut avoir besoin d'être accordée à nouveau après la mise à jour.

764 998

765<h3 id="background-sessions-can’t-reach-local-network-hosts-on-macos">999<h3 id="background-sessions-can’t-reach-local-network-hosts-on-macos">

766 Les sessions en arrière-plan ne peuvent pas atteindre les hôtes du réseau local sur macOS1000 Les sessions en arrière-plan ne peuvent pas atteindre les hôtes du réseau local sur macOS

767</h3>1001</h3>

768 1002

769Sur macOS 15 et versions ultérieures, le système bloque un processus d'atteindre les appareils sur votre réseau local jusqu'à ce que vous accordiez la permission Réseau local. Avant la v2.1.198, l'hôte de session en arrière-plan n'a jamais demandé cette permission, donc les commandes ciblant une adresse LAN échouaient avec `connect: no route to host` même si la même commande fonctionnait dans un terminal de premier plan. À partir de la v2.1.198, la première commande dans une session en arrière-plan qui se connecte à une adresse de réseau local déclenche l'invite de permission Réseau local de macOS pour Claude Code. Accordez-la une fois et ces commandes atteindront les hôtes LAN de la même manière qu'ils le font dans un terminal de premier plan.1003Sur macOS 15 et versions ultérieures, le système bloque un processus d'atteindre les appareils sur votre réseau local jusqu'à ce que vous accordiez la permission Réseau local, donc une commande ciblant une adresse LAN peut échouer avec `connect: no route to host` dans une session en arrière-plan même si elle fonctionne dans un terminal de premier plan. La première commande dans une session en arrière-plan qui se connecte à une adresse de réseau local déclenche l'invite de permission Réseau local macOS pour Claude Code. Accordez-la une fois et ces commandes atteignent les hôtes LAN de la même manière qu'ils le font dans un terminal de premier plan.

770 1004

771<h3 id="a-session-is-slow-to-respond-after-attaching">1005<h3 id="a-session-is-slow-to-respond-after-attaching">

772 Une session est lente à répondre après l'attachement1006 Une session est lente à répondre après l'attachement

773</h3>1007</h3>

774 1008

775Une 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é et bascule vers la session immédiatement pendant que le processus redémarre. Les sessions qui fonctionnent, attendent votre intervention, ou sont [épinglées](#organize-the-list) ne sont pas arrêtées de cette façon, donc épinglez une session avec `Ctrl+T` pour la garder réactive.1009Quand une session qui a terminé ou attend votre message suivant reste non attachée pendant environ une heure, le superviseur arrête son processus pour libérer des ressources. L'attachement démarre un processus frais d'où il s'était arrêté et bascule vers la session immédiatement tandis que le processus redémarre. Les sessions qui travaillent, en pause sur une invite de permission ou un autre dialogue, ou [épinglées](#organize-the-list) ne sont pas arrêtées de cette façon, donc épinglez une session avec `Ctrl+T` pour la garder réactive.

776 1010

777Pendant que le processus démarre, le dernier écran de la transcription de la session s'affiche avec une note `Session is starting` en dessous, et la session en direct le remplace dès qu'elle est prête.1011Tandis que le processus démarre, Claude Code affiche la queue de la transcription de la session formatée de la manière dont la session active la rend, avec markdown, blocs de code en surbrillance et appels d'outils en tant que lignes estompées, au-dessus d'une zone d'invite estompée avec une note `Session is starting`. La session active la remplace dès qu'elle est prête.

778 1012

779<h3 id="claude/worktrees/-is-filling-up">1013<h3 id="claude/worktrees/-is-filling-up">

780 `.claude/worktrees/` se remplit1014 `.claude/worktrees/` se remplit

781</h3>1015</h3>

782 1016

783Supprimer une session dans la vue agent supprime la worktree que Claude a créée pour elle, et une worktree qui ne peut pas être supprimée en toute sécurité [conserve sa ligne de session](#organize-the-list) pour qu'elle ne soit pas orpheline. `claude rm` conserve une worktree qui a des modifications non validées et affiche le chemin conservé. 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](/docs/fr/worktrees#clean-up-worktrees).1017Supprimer une session dans la vue agent supprime le worktree que Claude a créé pour elle, mais [certaines suppressions conservent le worktree ou laissent son répertoire sur le disque](#what-deleting-a-session-removes), donc les répertoires restants peuvent s'accumuler. Les répertoires que git ne reconnaît plus n'apparaissent pas dans `git worktree list`, donc supprimez-les à la main.

1018

1019Listez les entrées restantes avec `git worktree list` dans le répertoire du projet et supprimez chacune avec `git worktree remove <path>`. Consultez [Clean up worktrees](/docs/fr/worktrees#clean-up-worktrees).

784 1020

785<h2 id="limitations">1021<h2 id="limitations">

786 Limitations1022 Limitations

790 1026

791* **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.1027* **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.

792* **Les sessions sont locales** : les sessions en arrière-plan s'exécutent sur votre machine. Elles sont préservées lors de la mise en veille mais s'arrêtent si la machine s'éteint.1028* **Les sessions sont locales** : les sessions en arrière-plan s'exécutent sur votre machine. Elles sont préservées lors de la mise en veille mais s'arrêtent si la machine s'éteint.

793* **Les worktrees créées par Claude sont supprimées avec la session en vue agent** : validez les modifications avant de supprimer une session qui a modifié des fichiers dans sa propre worktree. Une worktree avec des commits qui ne sont poussés nulle part est conservée avec la session. `claude rm` conserve également une worktree qui a des modifications non validées avec sa session, et une worktree que vous avez créée vous-même est laissée en place.1029* **Les worktrees créées par Claude sont supprimées avec la session en vue agent** : validez les modifications avant de supprimer une session qui a modifié des fichiers dans sa propre worktree. [Certaines suppressions conservent la worktree à la place](#what-deleting-a-session-removes).

794 1030

795<h2 id="related-resources">1031<h2 id="related-resources">

796 Ressources connexes1032 Ressources connexes

797</h2>1033</h2>

798 1034

799Pour d'autres façons d'exécuter Claude en parallèle, consultez :1035Pour d'autres façons d'exécuter Claude en parallèle, et pour transmettre les résultats entre les sessions que vous exécutez, consultez :

800 1036

801* [Exécuter les agents en parallèle](/docs/fr/agents) : comparez la vue agent avec les sous-agents, les équipes d'agents, et les worktrees1037* [Exécuter les agents en parallèle](/docs/fr/agents) : comparez la vue agent avec les sous-agents, les équipes d'agents, et les worktrees

1038* [Messagerie entre sessions](/docs/fr/cross-session-messaging) : faites en sorte que vos sessions se transmettent mutuellement les résultats

802* [Équipes d'agents](/docs/fr/agent-teams) : coordonnez plusieurs sessions qui se messagent mutuellement1039* [Équipes d'agents](/docs/fr/agent-teams) : coordonnez plusieurs sessions qui se messagent mutuellement

803* [Claude Code sur le web](/docs/fr/claude-code-on-the-web) : exécutez les sessions dans un environnement cloud géré au lieu de localement1040* [Claude Code sur le web](/docs/fr/claude-code-on-the-web) : exécutez les sessions dans un environnement cloud géré au lieu de localement

1041* [Projects](/docs/fr/claude-projects) : faites en sorte que Claude coordonne les sessions cloud parallèles à partir d'une conversation et vous indique lesquelles vous sont nécessaires

804 1042

805<h2 id="version-history">1043<h2 id="version-history">

806 Historique des versions1044 Historique des versions

809La vue agent a évolué rapidement pendant l'aperçu de recherche. Si vous êtes sur une version plus ancienne de Claude Code, certains comportements sur cette page peuvent différer ; en particulier, `claude agents` rejette les drapeaux qu'il ne supporte pas encore avec une erreur `unknown option`. Le tableau ci-dessous répertorie quand chaque drapeau et comportement a été ajouté.1047La vue agent a évolué rapidement pendant l'aperçu de recherche. Si vous êtes sur une version plus ancienne de Claude Code, certains comportements sur cette page peuvent différer ; en particulier, `claude agents` rejette les drapeaux qu'il ne supporte pas encore avec une erreur `unknown option`. Le tableau ci-dessous répertorie quand chaque drapeau et comportement a été ajouté.

810 1048

812| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1050| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

813| v2.1.208 | L'attachement à une session dont le processus s'est arrêté affiche le dernier écran de sa transcription tandis que le processus démarre, au lieu d'une simple note `Session is starting`. Une réponse qui ne peut pas être livrée parce que le service en arrière-plan est inaccessible ou l'envoi échoue est enregistrée et envoyée comme l'invite suivante de la session quand son processus redémarre ; avant cette version, une réponse perdue tandis que le service en arrière-plan était inaccessible était supprimée. Un processus dont le binaire lui-même a été remplacé par une mise à jour peut toujours démarrer le superviseur, à partir du lanceur `claude` installé ou de la version la plus récente sur le disque, au lieu d'échouer jusqu'au redémarrage de Claude Code. Un superviseur exécutant une version plus ancienne ne redémarre jamais une session inactive démarrée par une version plus récente sur son propre binaire plus ancien. La suppression d'une session supprime son worktree même après que la session ait déplacé le worktree sur une branche différente, et garde le worktree ensemble avec la ligne de session quand le worktree a des commits qui ne sont poussés nulle part ou une autre session le revendique, au lieu de détruire les commits ou d'orpheliner le worktree. `/install-github-app` et la liste des paramètres `/mcp` et ses actions d'authentification sont refusées dans une session en arrière-plan avec un message nommant l'alternative ; en v2.1.208 uniquement, le sélecteur `/model` a été refusé de la même manière et un `/model <name>` tapé a basculé cette session uniquement au lieu de sauvegarder également votre modèle par défaut. |1051| v2.1.268 | Quand une [suppression est refusée](#what-deleting-a-session-removes) parce que git ou votre hook `WorktreeRemove` n'a pas pu supprimer le worktree, le message nomme la cause, y compris comment le hook s'est terminé et le début de son stderr. Pour un worktree lié sous le répertoire `.claude/worktrees/` du référentiel sans modifications non validées sur les fichiers suivis, sans référentiel imbriqué à l'intérieur, et sans enregistrement d'une autre session le nommant, supprimer la session à nouveau supprime le répertoire de toute façon, à partir de la vue agent ou avec `claude rm <id> --force-remove-worktree <worktree-id>`. Avant cette version, la ligne affichait seulement `worktree could not be removed (WorktreeRemove hook failed)` ou l'erreur de git, le stderr du hook n'allait que dans le journal de débogage, et supprimer à nouveau était refusé de la même manière. |

1052| v2.1.268 | Après que le premier `←` affiche `Press ← again to open agents`, ou `Press ← again to go back to agents` dans une session attachée, [la première pression qui arrive au moins une seconde plus tard bascule](#switch-sessions-without-leaving-the-terminal), même quand les pressions plus rapides entre les deux ont été ignorées. Avant cette version, chaque pression ignorée redémarrait l'attente, donc appuyer sur `←` à nouveau à un rythme régulier ne basculait pas jusqu'à ce que vous fassiez une pause de plus d'une seconde. |

1053| v2.1.260 | Quand vous [mettez une session en arrière-plan](#from-inside-a-session), le [listing agent](/docs/fr/cross-session-messaging#see-which-sessions-claude-can-reach) de vos autres sessions affiche la conversation une fois, comme sa session en arrière-plan, et leurs messages vers elle n'atteignent plus le terminal d'où vous l'avez déplacée. Avant cette version, ce terminal pouvait rester listé comme une deuxième session interactive sous le nom de la conversation, et une session qui avait envoyé un message à la conversation avant le déplacement continuait à livrer à ce terminal. |

1054| v2.1.260 | Quand une [suppression est refusée sur des commits non poussés](#what-deleting-a-session-removes), le message nomme la branche du worktree et combien de commits ne sont pas poussés, et supprimer la session à nouveau abandonne le worktree et ses commits. Avant cette version, le refus disait seulement `worktree has commits that are not pushed anywhere`, supprimer à nouveau était refusé de la même manière, et supprimer la session nécessitait de pousser les commits ou de supprimer le worktree à la main. |

1055| v2.1.257 | `←` [se détache d'une session attachée tandis que l'overlay `/btw` est ouvert](#attach-to-a-session), même en pleine réponse, et l'overlay se rouvre quand vous vous attachez à nouveau. Avant cette version, `←` ne se détachait pas tandis que l'overlay était ouvert. |

1056| v2.1.257 | Quand vous exécutez [`claude --resume <session-id> --bg`](#from-your-shell), Claude Code continue cette session sous son propre ID, ou démarre une copie sous un nouvel ID et affiche une ligne `note:` expliquant pourquoi. `--continue`, un `--resume` nu, et `--resume` avec un nom ou un chemin démarrent une copie avec la même note. Avant cette version, `--resume` avec `--bg` démarrait toujours une copie sous un nouvel ID et ne disait rien. |

1057| v2.1.257 | Quand vous dispatchez une session à partir d'une vue agent que vous avez ouverte avec `←`, Claude Code la démarre dans [le mode de permission que le répertoire cible configure](#permission-mode) via `permissions.defaultMode`. Quand le répertoire n'en définit pas un, le mode de permission de la session d'où vous venez s'applique. Avant cette version, la session dispatchée démarrait toujours dans le mode de permission de la session d'où vous venez, le remplaçant. |

1058| v2.1.257 | `Ctrl+S`, `Ctrl+T`, et `Ctrl+G` dans la vue agent [suivent votre `keybindings.json`](#keyboard-shortcuts) : `Ctrl+S` et `Ctrl+T` via les actions `agents:switchView` et `agents:togglePin` du contexte `Agents`, et `Ctrl+G` via la liaison `chat:externalEditor` du contexte `Chat`. Avant cette version, la vue agent ignorait `keybindings.json` et ces touches étaient fixes. |

1059| v2.1.257 | Démarrer le [service en arrière-plan](#the-supervisor-process) se rétablit de deux causes d'échec. Sur une installation npm macOS, un démarrage pendant une auto-mise à jour [attend l'installation](/docs/fr/errors#eacces-when-starting-a-background-session) au lieu d'exécuter l'espace réservé que npm pose en bas tandis qu'il remplace le binaire. Sur Windows, un `daemon.lock` obsolète écrit avant le dernier démarrage de la machine, ou dont l'ID de processus enregistré appartient maintenant à un processus différent, est remplacé. Avant cette version, le démarrage macOS échouait avec `Error: claude native binary not installed.` pendant la fenêtre d'installation, et le verrou Windows faisait échouer chaque démarrage avec [`exited before it became reachable`](/docs/fr/errors#background-service-exited-before-it-became-reachable) jusqu'à ce que vous supprimiez `~/.claude/daemon.lock`. |

1060| v2.1.257 | Quand vous ouvrez ou dispatchez une session en arrière-plan tandis qu'un autre processus Claude Code télécharge une mise à jour npm, Claude Code [continue d'attendre jusqu'à deux minutes](/docs/fr/errors#eacces-when-starting-a-background-session) tandis que l'installation s'exécute, puis échoue en disant `Claude Code is being updated by npm on this machine`. Avant cette version, l'attente s'arrêtait à dix secondes, donc l'ouverture échouait avec `Couldn't start the background service` tandis que le téléchargement était encore en cours. |

1061| v2.1.257 | Une session en arrière-plan tenant un [message entre sessions](/docs/fr/cross-session-messaging#control-inbound-messages) pour votre approbation affiche `approve message from` sur sa ligne `Needs input`, avec l'adresse de l'expéditeur et le nom que l'expéditeur prétend. Avant cette version, la ligne se déplaçait vers `Needs input` mais gardait son texte précédent, donc rien dans `claude agents` ne nommait le message en attente ou son expéditeur. |

1062| v2.1.257 | Une invite stockée avec `Ctrl+S` à l'intérieur d'une session en arrière-plan ouverte [est conservée avec la session](#what-persists-across-restarts), donc `Ctrl+S` la restaure après l'arrêt et le redémarrage du processus de la session. Avant cette version, le stockage vivait seulement dans le processus en cours d'exécution et était perdu quand la session restait inactive assez longtemps pour que son processus s'arrête, ou quand il était arrêté puis rouvert. |

1063| v2.1.251 | Dans une session en arrière-plan qui n'a pas [déménagé dans un worktree](#how-file-edits-are-isolated), Claude et les sous-agents qu'il génère peuvent modifier les fichiers à l'intérieur d'un worktree git lié. |

1064| v2.1.251 | Claude Code transfère une passerelle de fournisseur cloud exportée dans le shell d'où vous dispatchez, comme `ANTHROPIC_VERTEX_BASE_URL` ou `ANTHROPIC_BEDROCK_BASE_URL` avec son drapeau de contournement d'authentification, vers [le worker de la session](#llm-gateway) dans les mêmes conditions que `ANTHROPIC_BASE_URL`. Avant cette version, si vous mettiez en arrière-plan ou dispatchiez à partir d'un shell authentifié uniquement via une telle passerelle, chaque requête que la session faisait échouait, parce que le point de terminaison et le drapeau étaient supprimés de son environnement. |

1065| v2.1.251 | Quand une session en arrière-plan démarre tandis qu'un autre processus Claude Code actualise une [place de marché de plugins](/docs/fr/plugin-marketplaces), comme une session sœur exécutant la [mise à jour automatique de la place de marché](/docs/fr/discover-plugins#configure-auto-updates), Claude Code garde les plugins de cette place de marché disponibles. Avant cette version, une telle session pouvait démarrer sans aucune des compétences, agents, hooks et serveurs MCP de cette place de marché et rester ainsi pendant toute son exécution. |

1066| v2.1.248 | `Shift+Enter` dans l'[entrée de dispatch](#keyboard-shortcuts) insère une nouvelle ligne, correspondant à l'invite principale, et `Ctrl+Enter` dispatch et attache immédiatement dans les terminaux où l'overlay `?` répertorie `ctrl+enter to start and open`. Avant cette version, `Shift+Enter` dispatchait et attachait. |

1067| v2.1.248 | [Supprimer une session](#what-deleting-a-session-removes) réussit quand les commits du worktree sont déjà sur la copie locale de la branche par défaut de votre remote `origin` et votre checkout principal a cette branche extraite ; avant cette version, la suppression était refusée avec `has commits that are not pushed anywhere`. |

1068| v2.1.248 | Une session mise en arrière-plan avec `←` ou `/background` tient le [`git worktree lock`](/docs/fr/worktrees#clean-up-subagent-and-background-session-worktrees) sur son worktree tandis qu'elle s'exécute ; avant cette version, mettre en arrière-plan libérait le verrou, et le nettoyage ou `git worktree remove` pouvait supprimer le worktree sous la session en cours d'exécution. |

1069| v2.1.248 | Une session en arrière-plan qui n'attendait pas votre entrée et est trouvée morte plus de 48 heures après sa dernière activité, comme après que la machine ait été éteinte pendant des jours, [s'affiche comme arrêtée](#sessions-show-as-failed-after-shutdown) avec `ended while the background service was off`, et `Enter` sur elle demande avant de reprendre sa conversation enregistrée. Avant cette version, une telle session réapparaissait comme un nouvel échec trié en haut de la liste, et un simple `Enter` tirait la conversation de plusieurs semaines au premier plan. |

1070| v2.1.248 | Ouvrir une ligne arrêtée dont la conversation [vous avez reprise dans un autre terminal](#opening-a-session-says-the-conversation-is-already-open) est refusé avec `Can't open — this session is running in another terminal`, et la ligne affiche `Open in a terminal` au lieu d'afficher sous `Working`. Avant cette version, ouvrir la ligne démarrait un deuxième processus écrivant dans la même conversation. |

1071| v2.1.248 | Une session en arrière-plan attendant une décision de permission tandis qu'un hook `PermissionRequest` ou `PreToolUse` a imprimé une réponse invalide [nomme l'événement du hook et l'erreur de schéma sur sa ligne](#peek-and-reply). Avant cette version, la ligne affichait seulement la requête en attente. |

1072| v2.1.248 | Sur Windows, `claude agents` répond au clavier quand lancé dans un onglet de terminal qu'un programme antérieur a laissé en mode win32-input. Avant cette version, Claude Code ne décodait pas les enregistrements de clés qu'un tel onglet envoie. |

1073| v2.1.247 | Sur Linux et WSL, une session [dont le processus hôte du terminal est mort](#the-terminal-host-died-or-the-session-stopped-responding) échoue en quelques secondes avec la raison. Une ouverture qui ne produit aucune sortie se termine après environ dix secondes avec une offre de redémarrage, et `Enter` sur la ligne redémarre la session avec sa conversation ; `claude attach <id>` rapporte la cause et quitte. Avant cette version, ouvrir une telle session affichait `opening… · esc to cancel` indéfiniment et `claude attach <id>` attendait sans rapporter une erreur. |

1074| v2.1.246 | Sur une installation npm, quand le [service en arrière-plan](#the-supervisor-process) échoue à démarrer tandis que `npm install -g @anthropic-ai/claude-code` remplace le binaire, Claude Code attend jusqu'à dix secondes pour que l'installation se termine et réessaie avant de rapporter [`EACCES: permission denied`](/docs/fr/errors#eacces-when-starting-a-background-session). |

1075| v2.1.246 | Quand le processus du [service en arrière-plan](#the-supervisor-process) meurt après avoir imprimé une erreur, Claude Code rapporte l'échec et [cite la première ligne d'erreur du service](/docs/fr/errors#background-service-exited-before-it-became-reachable). |

1076| v2.1.246 | Si votre machine s'endort tandis que le [service en arrière-plan](#the-supervisor-process) démarre, Claude Code réessaie le démarrage une fois au lieu d'échouer. |

1077| v2.1.246 | Claude Code attend environ deux minutes au lieu de 45 secondes pour un [service en arrière-plan](#the-supervisor-process) nouvellement démarré qui est vivant mais lent à accepter les connexions. |

1078| v2.1.246 | Le [service en arrière-plan](#the-supervisor-process) démarre à partir de votre répertoire personnel, donc sur macOS et Linux un répertoire de démarrage qui a été supprimé ou déplacé ne bloque plus le démarrage. |

1079| v2.1.246 | `/fork` [copie la conversation complète](#copy-the-session-with-%2Ffork) à partir d'une session qui elle-même a démarré comme une copie et n'a pas enregistré une nouvelle invite depuis : une copie `/fork` à laquelle vous vous êtes attaché, une session réattachée après que `←` ou `/background` l'ait déplacée en arrière-plan, ou une session démarrée avec `claude --resume <id> --fork-session`. Avant cette version, si vous exécutiez `/fork` dans une telle session avant de lui envoyer une nouvelle invite, Claude Code imprimait la confirmation normale mais démarrait la copie avec une conversation vide. Déplacer une telle session en arrière-plan avec `←` ou `/background` perdait la conversation de la même manière. |

1080| v2.1.246 | Quand vous ouvrez une session que vous venez de dispatcher tandis que son processus worker démarre encore, comme en appuyant sur `Enter` sur sa ligne, Claude Code attend le processus puis s'attache. Avant cette version, si vous appuyiez sur `Enter` tandis que le processus démarrait encore, Claude Code pouvait arrêter la session avec [`Session <id> was stopped while the respawn was in flight`](/docs/fr/errors#session-was-stopped-while-the-respawn-was-in-flight). |

1081| v2.1.246 | Quand vous [mettez en arrière-plan](#from-inside-a-session) une session nommée, Claude Code la répertorie une fois, et quand vous mettez en arrière-plan la même conversation à nouveau, il numérote le nom de la nouvelle ligne, comme `my-session (2)`, la ligne existante gardant son nom. Avant cette version, le terminal sur lequel vous avez appuyé sur `←` pouvait apparaître dans `claude agents --json` comme une deuxième session sous le même nom, et si vous mettiez en arrière-plan la même conversation à nouveau, Claude Code ajoutait une autre ligne sous le nom identique. |

1082| v2.1.239 | Avec le [mode éditeur vim](/docs/fr/interactive-mode#vim-editor-mode) activé, appuyer sur `Esc` dans l'entrée de la vue agent bascule du mode INSERT au mode NORMAL et conserve votre texte, correspondant à l'invite principale ; en mode NORMAL avec du texte toujours dans l'entrée, appuyer sur `Esc` l'efface, et appuyer sur `Esc` sur une entrée vide quitte, comme le décrit le raccourci [`Esc`](#keyboard-shortcuts). Avant cette version, `Esc` effaçait l'entrée. |

1083| v2.1.233 | Pour une session liée à une demande de fusion GitLab, Claude Code écrit l'étiquette de la ligne dans la syntaxe de référence `!1234` de GitLab. Vous pouvez également coller l'URL de la demande de fusion dans l'[entrée de dispatch](#filter-sessions) pour sélectionner cette session. Avant cette version, l'étiquette s'affichait comme `#1234`, et une URL de demande de fusion collée correspondait à une session uniquement quand sa première invite contenait l'URL. |

1084| v2.1.227 | [Supprimer une session](#what-deleting-a-session-removes) garde la session et son worktree tandis qu'une autre session Claude Code en direct s'exécute à l'intérieur de ce répertoire worktree. La vue agent affiche `not deleted` sur la ligne et la raison dans le pied de page, et `claude rm` affiche `kept <id>` avec la raison, qui nomme l'ID de processus de l'autre session. Avant cette version, supprimer la session supprimait le worktree tandis que l'autre session travaillait encore dedans. |

1085| v2.1.225 | `claude agents` dans un répertoire que vous n'avez pas approuvé affiche le même [dialogue de confiance d'espace de travail](/docs/fr/permissions#project-allow-rules-and-workspace-trust) que `claude` affiche au démarrage, avant que la vue agent s'ouvre. Accepter enregistre la confiance pour cet espace de travail ; refuser quitte sans ouvrir la vue agent. Avant cette version, `claude agents` s'ouvrait sans demander, donc les sessions que vous avez dispatchées à partir de celui-ci s'exécutaient dans un répertoire que vous n'aviez jamais été invité à approuver.<br /><br />Avec la liste groupée par répertoire, survoler la souris sur une ligne la met en évidence sans changer la [cible de dispatch](#dispatch-to-a-specific-directory) ; sélectionner une ligne avec les touches fléchées ou un clic change toujours la cible. Avant cette version, déplacer la souris sur une session dans un autre projet changeait silencieusement le répertoire dans lequel la prochaine session dispatchée démarrait. |

1086| v2.1.221 | `/status` affiche une ligne `Session kind` : `background job · attached` ou `background job · unattended` dans une session en arrière-plan, selon qu'un terminal est attaché, et `interactive` dans toute autre session. Avant cette version, `/status` ne rapportait pas le type de session.<br /><br />`/fork` : Claude Code instruit [la copie](#from-inside-a-session) d'isoler son travail de celui de la session originale : la copie crée son propre worktree avant de faire des modifications de code, reste en dehors du worktree de la session originale, et base une nouvelle branche sur la branche de l'original quand sa tâche s'appuie sur ce travail. Voir la section liée pour les conditions exactes. Avant cette version, la copie ne recevait aucune instruction d'isolation et pouvait finir par modifier le worktree ou extraire le checkout sur lequel la session originale travaillait encore.<br /><br />Avec le [mode éditeur vim](/docs/fr/interactive-mode#vim-editor-mode) activé, appuyer sur `←` juste après avoir annulé l'invite jusqu'à vide avec `u` demande la même confirmation que de supprimer le texte ou de se déplacer dans l'historique des invites, et bascule uniquement à la deuxième pression ; avant cette version la pression basculait immédiatement. |

1087| v2.1.219 | Avec le [mode éditeur vim](/docs/fr/interactive-mode#vim-editor-mode) activé, appuyer sur `←` sur une invite vide ouvre la vue agent à partir du mode NORMAL ainsi que INSERT, et l'indice `←` du pied de page s'affiche en mode NORMAL ; avant cette version le geste et l'indice étaient INSERT uniquement, et en mode NORMAL `←` sur une invite vide ne faisait rien. Taper dans l'entrée tandis que Claude Code attend de mettre la session en arrière-plan annule le basculement avec `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.` donc un brouillon tapé n'est pas perdu. |

1088| v2.1.218 | Appuyer sur `←` dans les deux secondes d'une suppression qui a vidé l'invite, ou de se déplacer dans l'historique des invites, affiche `Press ← again to open agents`, ou `Press ← again to go back to agents` dans une session attachée, et bascule uniquement à une deuxième pression au moins une seconde plus tard ; avant cette version la pression basculait immédiatement. Un `←` qui arrive à l'intérieur d'une entrée collée ou scriptée ne déclenche plus le basculement. Mettre en arrière-plan une session au premier plan avec `←` affiche `Your conversation moved to the background` au-dessus de la liste, et `Esc` à la racine de la vue agent revient à cette conversation au lieu de quitter vers le shell, avec double `Ctrl+C` restant la sortie ; si la conversation ne peut pas être rouverte, Claude Code quitte et affiche une commande `claude --resume` pour elle. Sur Windows, un `←` appuyé dans environ une demi-seconde de l'attachement affiche `Ambiguous ←, press again to detach` et se détache à la deuxième pression. |

1089| v2.1.217 | L'insigne de demande de tirage sur la ligne d'une session s'affiche comme un lien hypertexte même quand Claude Code ne peut pas détecter le support de lien hypertexte du terminal, par exemple sur SSH ou tmux ; définissez [`FORCE_HYPERLINK=0`](/docs/fr/env-vars) pour l'afficher en texte brut. Avant cette version, l'insigne s'affichait en texte brut quand le support n'était pas détecté. |

1090| v2.1.216 | `/fork` : la [confirmation](#from-inside-a-session) est une ligne, affichant l'état de la copie, le nom de sa ligne de vue agent, et son ID de session pour `claude attach`, se terminant par `runs in the origin tree` ou `edits this checkout` uniquement quand la copie s'exécute dans l'arborescence de travail principale ou modifie le checkout que vous avez ouvert. Cliquer sur le nom met cette session en arrière-plan et ouvre la vue agent dans la session de la copie. La confirmation ne restate plus le mode de permission hérité de la copie ; les versions antérieures imprimaient une confirmation multi-ligne sans nom cliquable.<br /><br />Needs input : `/install-github-app` et la liste des paramètres `/mcp`, exécutées tandis que personne n'est attaché, affichent la session sous `Needs input` avec une ligne nommant la commande, et s'attacher et réexécuter la commande continue ; de v2.1.208 à v2.1.215 elles étaient refusées purement et simplement dans cet état.<br /><br />Restauration `--agent` : reprendre ou redémarrer une [session `--agent` mise en arrière-plan](#from-your-shell) restaure l'invite système de l'agent et les restrictions d'outils, en cherchant d'abord le répertoire de la session pour l'agent, quand son espace de travail est approuvé ; une session dont l'agent n'existe plus continue avec les outils par défaut et l'invite système et s'ouvre avec un avertissement visible, au lieu de revenir silencieusement à l'agent par défaut.<br /><br />`Ctrl+X` : appuyer dessus deux fois supprime une session même quand la tentative d'arrêt échoue, au lieu qu'un arrêt échoué annule la suppression en attente, et une session supprimée dont le processus worker était mort ne réapparaît plus à la prochaine actualisation.<br /><br />Suppression de worktree : une session dont le répertoire worktree n'appartient à aucun référentiel git peut être supprimée ; avant cette version chaque tentative de suppression d'une telle session était refusée. Un répertoire qui a déjà disparu s'efface immédiatement. La double pression de la vue agent supprime un répertoire qui a toujours des fichiers, en exécutant votre hook `WorktreeRemove` pour un répertoire créé par hook, sauf si les enregistrements d'une autre session le nomment aussi. `claude rm` garde un tel répertoire chaque fois que des fichiers restent. |

1091| v2.1.214 | Une session mise en arrière-plan avec `←` ou `/background` et laissée inactive sans rien en cours d'exécution a son processus arrêté comme toute autre session inactive, au lieu de garder son processus et le service en arrière-plan s'exécutant indéfiniment. Une session complétée peut être supprimée avec `claude rm` ou à partir de la vue agent après que le service en arrière-plan soit devenu inactif, et une session qui a entré un worktree après avoir été dispatchée à partir d'un répertoire qui n'est pas un référentiel git, comme un dossier d'espace de travail multi-repo, peut être supprimée à partir de la vue agent quand le worktree lui-même appartient à un référentiel git, parce que le nettoyage est résolu à partir du worktree au lieu du répertoire à partir duquel la session a été dispatchée ; les deux suppressions étaient refusées à chaque tentative avant. Rouvrir une session arrêtée restaure sa conversation enregistrée même quand un dossier dans le magasin de transcriptions ne peut pas être lu. |

1092| v2.1.213 | `/install-github-app`, la liste des paramètres [`/mcp`](/docs/fr/mcp), et les actions d'authentification MCP fonctionnent dans une session en arrière-plan tandis qu'un terminal est attaché, et sont refusées uniquement quand personne n'est attaché, avec un message vous disant de vous attacher et de réexécuter la commande ; de v2.1.208 à v2.1.212 elles étaient refusées même avec un terminal attaché. |

1093| v2.1.212 | [`/fork` dans une session interactive](#from-inside-a-session) copie la conversation dans une nouvelle session en arrière-plan qui apparaît comme sa propre ligne, nommée d'après la session d'où elle vient ou, pour un fork invité d'une session sans nom, d'après l'invite de fork, tandis que l'original continue de s'exécuter ; le comportement antérieur de fork-subagent de `/fork` s'est déplacé vers `/subtask`. Avec la [vue agent désactivée](#turn-off-agent-view), `/fork` garde le comportement de fork-subagent. Une ligne focalisée qui attend sa première invite affiche `space to send it a prompt`. `Ctrl+J` insère une nouvelle ligne dans l'entrée de dispatch sur les terminaux avec rapport de clés étendu, où la pression de touche était précédemment ignorée, et l'overlay `?` répertorie le raccourci. L'indice de pied de page `←` dans une session interactive affiche brièvement `N done` quand une session en arrière-plan se termine tandis qu'aucune n'a besoin de votre entrée. Taper un `/resume` nu dans la vue agent ouvre un sélecteur de sessions passées du référentiel à partir duquel vous avez ouvert la vue agent, y compris les sessions supprimées de la liste, et en choisir une la reprend comme une session en arrière-plan ; avant cette version `/resume` n'était pas disponible dans la vue agent et les sessions supprimées n'étaient accessibles que via `claude --resume` ou `/resume` à partir d'une session interactive. Les formes ciblées, délimitées et restreintes conservent l'indice `attach to a session to run it` que les versions antérieures affichaient pour chaque forme. Les sessions attendant une invite de sandbox network-host, une demande d'entrée MCP, ou une invite de paramètres gérés s'affichent comme `Needs input` au lieu de `Working`, dans la vue agent et dans `claude agents --json`, et une question de Claude rapporte `waitingFor: input needed` au lieu de `permission prompt`. S'attacher à une session dont le processus s'est arrêté affiche sa transcription formatée de la manière dont la session en direct la rend, au lieu de texte brut. Une session arrêtée dont la transcription est dans un endroit inattendu reprend à partir de celle-ci via une analyse de dernier recours de vos transcriptions enregistrées, et ouvrir une ligne qui n'a pas de transcription enregistrée affiche `Press enter again to restart this session fresh`, la redémarrant à nouveau à la deuxième pression ; v2.1.211 affichait le refus sans moyen de redémarrer à partir de la vue agent. |

1094| v2.1.211 | Réveiller une session arrêtée en s'attachant ou en répondant à partir du répertoire dans lequel elle s'exécute transfère à nouveau la passerelle `ANTHROPIC_BASE_URL` de votre shell, dans les mêmes conditions qu'une dispatch fraîche, donc une session authentifiée via une passerelle `ANTHROPIC_AUTH_TOKEN` reprend sur la passerelle au lieu de rapporter `Not logged in`. S'attacher à une session arrêtée qui a été mise en arrière-plan à partir d'une autre conversation avant que sa première réponse ne se termine est refusé avec `This session has no saved transcript` au lieu de démarrer silencieusement une conversation vierge sous le même ID de session ; ouvrir la même ligne à partir de la vue agent affichait le refus dans le pied de page. Terminer le processus d'une session `←` ou `/background` de l'extérieur de Claude Code la marque arrêtée au lieu que le superviseur la redémarre, un arrêt déjà enregistré sur le disque est honoré sauf si une réponse que vous avez envoyée attend toujours d'être livrée, une session redémarrée après un crash est informée qu'elle a été redémarrée, et une session `←` ou `/background` redémarrée ne reprend pas une réponse interrompue plus ancienne qu'environ une heure. Une réponse de nommage de session qui répond ou refuse l'invite au lieu de l'étiqueter, comme pour une invite qui est surtout un lien, est supprimée et la ligne garde un nom tiré du texte de l'invite. Supprimer une session dont le git du worktree ne reconnaît plus réussit, laissant le répertoire worktree sur le disque et nommant son chemin, au lieu que chaque tentative soit refusée. Un refus de suppression affiche la raison sur la ligne de la session, y compris l'erreur git sous-jacente quand le worktree n'a pas pu être supprimé, au lieu que la ligne réapparaisse silencieusement. |

1095| v2.1.210 | `claude attach` attend tandis que le service en arrière-plan démarre ou se reconnecte au lieu d'échouer avec une erreur `job not found` ou `still starting`, rapporte une session qui s'est terminée pendant l'attachement comme quittée, et applique un redimensionnement de terminal effectué pendant un attachement lent quand l'attachement se termine. L'indice de pied de page `←` du nombre de besoins d'entrée apparaît sur chaque fournisseur, y compris les fournisseurs tiers qui affichaient précédemment la forme `← for agents` simple. Mettre une session en arrière-plan avec `←` porte la liste de tâches de Claude à la session en arrière-plan au lieu de la supprimer. La ligne sur laquelle vous avez appuyé sur `←` garde un nom gras et non estompé après que la sélection se déplace. `claude agents --effort` accepte `ultracode` au lieu de le supprimer silencieusement. |

1096| v2.1.208 | S'attacher à une session dont le processus s'est arrêté affiche le dernier écran de sa transcription tandis que le processus démarre, au lieu d'une simple note `Session is starting`. Une réponse qui ne peut pas être livrée parce que le service en arrière-plan est inaccessible ou l'envoi échoue est enregistrée et envoyée comme l'invite suivante de la session quand son processus redémarre ; avant cette version, une réponse perdue tandis que le service en arrière-plan était inaccessible était supprimée. Un processus dont le binaire lui-même a été remplacé par une mise à jour peut toujours démarrer le superviseur, à partir du lanceur `claude` installé ou de la version la plus récente sur le disque, au lieu d'échouer jusqu'au redémarrage de Claude Code. Un superviseur exécutant une version plus ancienne ne redémarre jamais une session inactive démarrée par une version plus récente sur son propre binaire plus ancien. Supprimer une session supprime son worktree même après que la session ait déplacé le worktree sur une branche différente, et garde le worktree ensemble avec la ligne de session quand le worktree a des commits qui ne sont poussés nulle part ou une autre session le revendique, au lieu de détruire les commits ou d'orpheliner le worktree. `/install-github-app` et la liste des paramètres `/mcp` et ses actions d'authentification sont refusées dans une session en arrière-plan avec un message nommant l'alternative ; en v2.1.208 uniquement, le sélecteur `/model` a été refusé de la même manière et un `/model <name>` tapé a basculé cette session uniquement au lieu de sauvegarder également votre modèle par défaut. |

814| v2.1.207 | Le panneau d'aperçu s'ouvre avec la phrase que la ligne tronque, comme la question exacte pour une session qui vous attend, et affiche combien de temps une session bloquée a attendu comme une seule ligne `waiting 3m` au lieu de préfixer le même horodatage à la phrase de statut et à la question. Coller le même texte à nouveau dans l'entrée de dispatch développe l'espace réservé `[Pasted text #N]` réduit au lieu d'en ajouter un deuxième. Une session en arrière-plan nommée en acceptant un plan affiche ce nom sur sa ligne. Une session en arrière-plan qui s'est déplacée dans un worktree conserve sa conversation quand son processus est redémarré à partir de la vue agent. |1097| v2.1.207 | Le panneau d'aperçu s'ouvre avec la phrase que la ligne tronque, comme la question exacte pour une session qui vous attend, et affiche combien de temps une session bloquée a attendu comme une seule ligne `waiting 3m` au lieu de préfixer le même horodatage à la phrase de statut et à la question. Coller le même texte à nouveau dans l'entrée de dispatch développe l'espace réservé `[Pasted text #N]` réduit au lieu d'en ajouter un deuxième. Une session en arrière-plan nommée en acceptant un plan affiche ce nom sur sa ligne. Une session en arrière-plan qui s'est déplacée dans un worktree conserve sa conversation quand son processus est redémarré à partir de la vue agent. |

815| v2.1.206 | Les résumés des lignes remplissent la largeur restante de la ligne et ne tronquent qu'au bord droit du terminal au lieu de 64 colonnes. Après le redémarrage du superviseur dans une nouvelle version de Claude Code, il redémarre les sessions en arrière-plan inactives restantes sur cette version en arrière-plan au lieu de quelques par minute. La suppression d'une session avec `Ctrl+X` ou `claude rm` l'efface également de la liste de sessions du superviseur, de sorte que la ligne ne réapparaît plus après un redémarrage du superviseur. |1098| v2.1.206 | Les résumés des lignes remplissent la largeur restante de la ligne et ne tronquent qu'au bord droit du terminal au lieu de 64 colonnes. Après le redémarrage du superviseur dans une nouvelle version de Claude Code, il redémarre les sessions en arrière-plan inactives restantes sur cette version en arrière-plan au lieu de quelques par minute. Supprimer une session avec `Ctrl+X` ou `claude rm` l'efface également de la liste de sessions du superviseur, de sorte que la ligne ne réapparaît plus après un redémarrage du superviseur. Une variable de remplacement de corps de requête `CLAUDE_CODE_EXTRA_BODY` exportée dans le shell de dispatching atteint les sessions en arrière-plan au lieu d'être ignorée. |

816| v2.1.205 | Les résumés des lignes affichent le rapport d'une ligne de la session elle-même, tronqué à 64 colonnes, au lieu d'une invocation d'outil brute ou d'un nombre `done/total` ; les lignes groupées par répertoire s'ouvrent avec un mot d'état coloré. Le panneau d'aperçu s'ouvre avec la phrase de statut complète et, pour une session vous attendant, sa question exacte au-dessus de l'entrée de réponse. Les sessions qui modifient, commentent, ferment ou marquent une demande de tirage comme prête avec `gh` y sont liées, pas seulement celles qui créent ou extraient une demande de tirage, une poussée lie une demande de tirage même quand le nom de la branche locale ne correspond pas, et une demande de tirage dont la sortie de la commande de création a dépassé la limite en ligne est également liée. Un tour sans texte lisible conserve l'état précédent de la session au lieu de le basculer vers `Working`. `claude attach` attend jusqu'à environ 60 secondes une session qui redémarre, avec une ligne de statut nommant pourquoi, au lieu d'échouer. |1099| v2.1.205 | L'indice de pied de page `←` du nombre de besoins d'entrée dans une session `claude` régulière compte les agents en arrière-plan vous attendant, comme `← 2 agents`. Les résumés des lignes affichent le rapport d'une ligne de la session elle-même, tronqué à 64 colonnes, au lieu d'une invocation d'outil brute ou d'un nombre `done/total` ; les lignes groupées par répertoire s'ouvrent avec un mot d'état coloré. Le panneau d'aperçu s'ouvre avec la phrase de statut complète et, pour une session vous attendant, sa question exacte au-dessus de l'entrée de réponse. Les sessions qui modifient, commentent, ferment ou marquent une demande de tirage comme prête avec `gh` y sont liées, pas seulement celles qui créent ou extraient une demande de tirage, une poussée lie une demande de tirage même quand le nom de la branche locale ne correspond pas, et une demande de tirage dont la sortie de la commande de création a dépassé la limite en ligne est également liée. Un tour sans texte lisible conserve l'état précédent de la session au lieu de le basculer vers `Working`. `claude attach` attend jusqu'à environ 60 secondes une session qui redémarre, avec une ligne de statut nommant pourquoi, au lieu d'échouer. |

817| v2.1.203 | Une passerelle `ANTHROPIC_BASE_URL` exportée dans le shell de dispatching atteint les sessions dispatchées à partir de celui-ci dans ce même répertoire quand le superviseur partage cet environnement de passerelle, au lieu d'être supprimée tandis que la clé API exportée à côté d'elle était conservée. Le `PATH` du shell de dispatching est appliqué à chaque worker de session. Appuyer sur `←` tandis que les sous-agents s'exécutent les attend au lieu de les redémarrer après dix secondes. La liste vide affiche toujours les en-têtes de section avec une description sous chacun. Taper `@` dans l'entrée de dispatch répertorie également les worktrees git enregistrés du référentiel de lancement qui vivent dans son arborescence de répertoires. Un effort hérité du paramètre `effortLevel` suit les modifications ultérieures de ce paramètre au lieu d'être fixé au dispatching. L'ouverture d'une session arrêtée dont la conversation est déjà ouverte dans une autre session en cours d'exécution est refusée avec un message au lieu d'échouer la ligne. Une commande qui n'est pas disponible dans la vue agent laisse le texte tapé dans l'entrée. Un hook `WorktreeCreate` qui échoue en dehors d'un référentiel git ne bloque plus la session de modifier les fichiers. |1100| v2.1.203 | Une passerelle `ANTHROPIC_BASE_URL` exportée dans le shell de dispatching atteint les sessions dispatchées à partir de celui-ci dans ce même répertoire quand le superviseur partage cet environnement de passerelle, au lieu d'être supprimée tandis que la clé API exportée à côté d'elle était conservée. Le `PATH` du shell de dispatching est appliqué à chaque worker de session. Appuyer sur `←` tandis que les sous-agents s'exécutent les attend au lieu de les redémarrer après dix secondes. La liste vide affiche toujours les en-têtes de section avec une description sous chacun. Taper `@` dans l'entrée de dispatch répertorie également les worktrees git enregistrés du référentiel de lancement qui vivent dans son arborescence de répertoires. Un effort hérité du paramètre `effortLevel` suit les modifications ultérieures de ce paramètre au lieu d'être fixé au dispatching. L'ouverture d'une session arrêtée dont la conversation est déjà ouverte dans une autre session en cours d'exécution est refusée avec un message au lieu d'échouer la ligne. Une commande qui n'est pas disponible dans la vue agent laisse le texte tapé dans l'entrée. Un hook `WorktreeCreate` qui échoue en dehors d'un référentiel git ne bloque plus la session de modifier les fichiers. |

818| v2.1.202 | Un nom défini avec `/rename` ou `Ctrl+R` sur une session en arrière-plan persiste quand le superviseur arrête et redémarre son processus, au lieu de revenir au nom avec lequel la session a été dispatchée. |1101| v2.1.202 | Un nom défini avec `/rename` ou `Ctrl+R` sur une session en arrière-plan persiste quand le superviseur arrête et redémarre son processus, au lieu de revenir au nom avec lequel la session a été dispatchée. |

819| v2.1.200 | Une version plus ancienne de Claude Code qui réécrit la liste de sessions dans `roster.json` préserve les champs écrits par une version plus récente, correspondant à la garantie `state.json` existante, de sorte que les sessions démarrées par la version plus récente continuent d'accepter l'entrée après le redémarrage du superviseur. Quand vous ouvrez une session qui a cessé de répondre, le superviseur redémarre son processus et la session continue la réponse interrompue à partir de là où elle s'était arrêtée. |1102| v2.1.200 | Une version plus ancienne de Claude Code qui réécrit la liste de sessions dans `roster.json` préserve les champs écrits par une version plus récente, correspondant à la garantie `state.json` existante, de sorte que les sessions démarrées par la version plus récente continuent d'accepter l'entrée après le redémarrage du superviseur. Quand vous ouvrez une session qui a cessé de répondre, le superviseur redémarre son processus et la session continue la réponse interrompue à partir de là où elle s'était arrêtée. La vue agent applique un drapeau `--plugin-dir` placé après `agents` à son propre sous-agent et à l'autocomplétion des compétences dans l'entrée de dispatch ainsi qu'aux sessions dispatchées. |

820| v2.1.199 | Une session en arrière-plan dont le processus se termine avant de finir de démarrer sur un hôte à faible mémoire affiche `possibly low memory — free some up and retry` dans le statut de sa ligne au lieu de seulement la raison de sortie brute. Mettre en arrière-plan une session avec `←` ou `/background` transfère son `/color` vers la nouvelle ligne. |1103| v2.1.199 | Une session en arrière-plan dont le processus se termine avant de finir de démarrer sur un hôte à faible mémoire affiche `possibly low memory — free some up and retry` dans le statut de sa ligne au lieu de seulement la raison de sortie brute. Mettre en arrière-plan une session avec `←` ou `/background` transfère son `/color` vers la nouvelle ligne. |

821| v2.1.198 | La vue agent envoie une notification via `preferredNotifChannel` quand une session en arrière-plan a besoin d'une entrée, se termine ou échoue, et déclenche le hook `Notification` avec le type `agent_needs_input` ou `agent_completed`. `←` et `/exit` à l'intérieur de `claude attach <id>` reviennent à la vue agent au lieu de quitter vers le shell ; `Ctrl+Z` revient au shell. Une session en arrière-plan qui a isolé son travail dans un worktree valide, pousse sa propre branche isolée, jamais `main` ou `master`, et ouvre une demande de tirage en brouillon quand elle se termine au lieu de demander d'abord. `/login` s'exécute dans la vue agent et ouvre la boîte de dialogue de connexion. La boîte de dialogue de sortie `Background work is running` propose `Move to background and exit`. Le transfert de sortie couvre également les sous-agents en arrière-plan, qui reprennent à partir de leur transcription à la prochaine activation au lieu d'être signalés comme échoués. `claude --bg` combiné avec `-p` ou `--print` est rejeté avec une erreur. |1104| v2.1.198 | La vue agent envoie une notification via `preferredNotifChannel` quand une session en arrière-plan a besoin d'une entrée, se termine ou échoue, et déclenche le hook `Notification` avec le type `agent_needs_input` ou `agent_completed`. `←` et `/exit` à l'intérieur de `claude attach <id>` reviennent à la vue agent au lieu de quitter vers le shell ; `Ctrl+Z` revient au shell. Une session en arrière-plan qui a isolé son travail dans un worktree valide, pousse sa propre branche isolée, jamais `main` ou `master`, et ouvre une demande de tirage en brouillon quand elle se termine au lieu de demander d'abord. `/login` s'exécute dans la vue agent et ouvre la boîte de dialogue de connexion. La boîte de dialogue de sortie `Background work is running` propose `Move to background and exit`. Le transfert de sortie couvre également les sous-agents en arrière-plan, qui reprennent à partir de leur transcription à la prochaine activation au lieu d'être signalés comme échoués. `claude --bg` combiné avec `-p` ou `--print` est rejeté avec une erreur. L'hôte de session en arrière-plan demande la permission de réseau local macOS à la première utilisation du LAN au lieu d'échouer avec `connect: no route to host`. |

822| v2.1.196 | Une seule pression sur `←` met en arrière-plan une session au premier plan ; les versions antérieures nécessitaient deux pressions, avec un indice de pied de page et une confirmation. `--dangerously-skip-permissions` passé à `claude agents` affiche la clause de non-responsabilité du contournement au lieu d'être silencieusement supprimé. Les sessions interactives que vous n'avez jamais nommées portent un nom par défaut comme `my-app-3f` dans les listes de sessions et `claude agents --json`. Les commandes shell en arrière-plan et les workflows dynamiques survivent à l'arrêt, au redémarrage ou à la mise à jour du processus de la session, y compris sur Windows ; définissez `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` pour désactiver le transfert. Une transcription mal lue comme vide au redémarrage est renommée avec un suffixe `.orphaned-` au lieu d'être supprimée. |1105| v2.1.196 | Une seule pression sur `←` met en arrière-plan une session au premier plan ; les versions antérieures nécessitaient deux pressions, avec un indice de pied de page et une confirmation. `--dangerously-skip-permissions` passé à `claude agents` affiche la clause de non-responsabilité du contournement au lieu d'être silencieusement supprimé. Les sessions interactives que vous n'avez jamais nommées portent un nom par défaut comme `my-app-3f` dans les listes de sessions et `claude agents --json`. Les commandes shell en arrière-plan et les workflows dynamiques survivent à l'arrêt, au redémarrage ou à la mise à jour du processus de la session, y compris sur Windows ; définissez `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` pour désactiver le transfert. Une transcription mal lue comme vide au redémarrage est renommée avec un suffixe `.orphaned-` au lieu d'être supprimée. |

823| v2.1.195 | Le travail en cours se transfère aussi quand vous mettez en arrière-plan une session sur Windows ; définissez `CLAUDE_DISABLE_ADOPT=1` pour l'arrêter à la place. Le groupe `Completed` remplit l'espace vertical restant et l'en-tête se compacte sur les terminaux courts. Une version plus ancienne de Claude Code ne supprime plus les champs `state.json` plus récents des sessions ou ne cache plus ces sessions de `claude agents`. S'attacher à une session arrêtée bascule immédiatement au lieu d'afficher un écran vide pendant jusqu'à cinq secondes. Un superviseur qui ne peut pas accepter les connexions quitte et libère son verrou de lui-même. |1106| v2.1.195 | Le travail en cours se transfère aussi quand vous mettez en arrière-plan une session sur Windows ; définissez `CLAUDE_DISABLE_ADOPT=1` pour l'arrêter à la place. Le groupe `Completed` remplit l'espace vertical restant et l'en-tête se compacte sur les terminaux courts. Une version plus ancienne de Claude Code ne supprime plus les champs `state.json` plus récents des sessions ou ne cache plus ces sessions de `claude agents`. S'attacher à une session arrêtée bascule immédiatement au lieu d'afficher un écran vide pendant jusqu'à cinq secondes. Un superviseur qui ne peut pas accepter les connexions quitte et libère son verrou de lui-même. |

1107| v2.1.191 | `claude --bg` avec un nom `--agent` qui ne correspond à aucun de vos sous-agents échoue le lancement : la session quitte immédiatement avec une erreur `--agent '<name>' not found` au lieu de s'exécuter avec l'agent par défaut. |

824| v2.1.174 | Les sessions en arrière-plan n'héritent plus des variables de point de terminaison de passerelle comme `ANTHROPIC_BASE_URL` du shell de lancement du superviseur ; le superviseur fournit un nouvel instantané d'identifiants aux workers préchauffés, corrigeant les erreurs `Could not resolve authentication method` spurieuses. |1108| v2.1.174 | Les sessions en arrière-plan n'héritent plus des variables de point de terminaison de passerelle comme `ANTHROPIC_BASE_URL` du shell de lancement du superviseur ; le superviseur fournit un nouvel instantané d'identifiants aux workers préchauffés, corrigeant les erreurs `Could not resolve authentication method` spurieuses. |

825| v2.1.172 | `/model` dans l'entrée de dispatch définit un remplacement du modèle de dispatch limité à la session. |1109| v2.1.172 | `/model` dans l'entrée de dispatch définit un remplacement du modèle de dispatch limité à la session. |

826| v2.1.161 | Les résumés des lignes affichent un nombre `done/total` pour les éléments de travail parallèles ; le panneau d'aperçu nomme l'élément de travail parallèle le plus long en cours d'exécution. |1110| v2.1.161 | Les résumés des lignes affichent un nombre `done/total` pour les éléments de travail parallèles ; le panneau d'aperçu nomme l'élément de travail parallèle le plus long en cours d'exécution. |

agent-view.md 2026-09-17 05:00 UTC to 2026-09-18 23:58 UTC

Gérer plusieurs agents avec la vue agent

Démarrage rapide

Ouvrir la vue agent

Dispatcher une session

Jeter un coup d'œil et répondre

S'attacher et se détacher

Amener une session existante

Surveiller les sessions avec la vue agent

Lire l'état de la session

Résumés de lignes

État de la demande de tirage

Aperçu et réponse

Attacher à une session

Basculer les sessions sans quitter le terminal

Organiser la liste

Filtrer les sessions

Raccourcis clavier

Lancer de nouveaux agents

À partir de la vue agent

Lancer vers un répertoire spécifique

À partir d'une session

Envoyer la session en arrière-plan

Copier la session avec /fork

Ce qui se transfère quand vous mettez en arrière-plan

À partir du shell

Exécuter une commande shell

Comment les modifications de fichiers sont isolées

Ce que supprimer une session supprime

Définir le modèle

Mode de permission, modèle et effort

Paramètres et fournisseur

Passerelle LLM

Mode de permission

Valeurs par défaut du lancement

Ce qui persiste lors des redémarrages

Paramètres, plugins et serveurs MCP

Gérer les sessions depuis le shell

Afficher les sessions en tant que JSON

Lire l'état de la session à partir d'un script

Comment les sessions en arrière-plan sont hébergées

Le processus superviseur

Où l'état est stocké

Désactiver la vue agent

Dépannage

`claude agents` affiche les sous-agents au lieu d'ouvrir la vue agent

La vue agent s'ouvre sans sessions

Le backgrounding affiche une boîte de dialogue `Background this session?`

Invite rejetée comme trop courte

Les sessions s'affichent comme échouées ou arrêtées après l'arrêt

L'ouverture d'une session indique que la conversation est déjà ouverte

L'ouverture d'une session indique qu'elle n'a pas de transcription enregistrée

L'hôte du terminal est mort ou la session a cessé de répondre

L'hôte du terminal est mort

La session ne répond pas

Une session échoue avant de démarrer avec une note `possibly low memory`

La vue agent indique que le service en arrière-plan n'a pas répondu

Le dispatch échoue avec `Could not resolve authentication method`

Les sessions en arrière-plan ne peuvent pas lire Desktop, Documents ou Downloads sur macOS

Les sessions en arrière-plan ne peuvent pas atteindre les hôtes du réseau local sur macOS

Une session est lente à répondre après l'attachement

`.claude/worktrees/` se remplit

Limitations

Ressources connexes

Historique des versions