Messagerie entre vos autres sessions Claude Code

​

Quand utiliser la messagerie entre sessions

• Transmettre une découverte : quand une session découvre un changement cassant ou prend une décision, Claude la résume pour la session travaillant sur la zone affectée, au lieu que vous la réexpliquiez là.
• Coordonner les worktrees parallèles : quand les sessions travaillent le même dépôt dans des worktrees séparés, Claude peut dire aux autres sessions ce qui a atterri.
• Obtenir le statut du travail de longue durée : faire rapporter une migration ou une exécution de test à la session que vous regardez, ou demandez-le vous-même de là. Si cette session est sur cette machine, Claude peut aussi lui demander un avis quand elle devient inactive ou se termine.
• Envoyer des messages entre machines : atteindre l’une de vos sessions sur une autre machine ou sur le web.

• Pour continuer une conversation dans un autre terminal, ou partager son contexte avec une nouvelle session, reprenez la session
• Pour une équipe coordonnée de sessions que Claude crée et supervise, utilisez les équipes d’agents
• Pour regarder et diriger de nombreuses sessions d’un seul endroit, utilisez la vue agent
• Pour diriger une session vous-même depuis votre téléphone ou un autre appareil, plutôt que d’avoir les sessions se envoyer des messages, utilisez la Télécommande
• Pour pousser des événements externes, comme les résultats CI ou les messages de chat, dans une session, utilisez les canaux

​

Envoyer un message à une autre session

Demandez à la session exécutée dans mon autre terminal si la migration est terminée

Expliquez ce que nous venons de faire à la session travaillant sur l'API des paiements

Faites savoir à @api-worker que la migration de schéma est terminée

• Une session au-delà de cette machine : une session cloud ou Télécommande n’apparaît dans la saisie semi-automatique qu’après que Claude ait listé ou envoyé des messages à vos sessions au-delà de cette machine, donc demandez à Claude de les lister en premier.
• Un nom avec un espace ou d’autres caractères en dehors des lettres, chiffres, tirets et traits de soulignement : tapez-le entre guillemets doubles, comme @"release notes". Quand vous choisissez la session dans la saisie semi-automatique, Claude Code insère les guillemets pour vous.

​

Livraison des messages

• Le message est au-delà du plafond de taille. Claude Code le refuse dans la session d’envoi, avant qu’il ne parte.
• Une rafale rapide vers une session sur cette machine a atteint ce que la boîte de réception de cette session accepte. Claude Code refuse d’autres messages à cette session.
• La cible de réponse sur cette machine échoue une vérification de sécurité, comme une cible symlink ou un point de terminaison qui n’est pas le processus attendu. Refuser d’envoyer un message entre sessions liste ces vérifications.
• Claude adresse le message au nom de sa propre session, comme décrit sous Voir quelles sessions Claude peut atteindre.

• Livré : Claude Code transmet le message au Claude récepteur.
• Retenu : Claude Code met le message de côté non livré. Un message retenu atteint Claude seulement quand vous l’approuvez ou qu’un mode ou changement de paramètres ultérieur le permet.
• Refusé : Claude Code supprime le message sans le livrer.

​

Obtenir un avis quand une autre session devient inactive

​

Demander un avis

Dites-moi quand la session de migration termine ce sur quoi elle travaille

​

Ce que chaque session affiche

​

Limites

• refuse de chaque côté : rien n’arrive. La session regardée supprime la demande sans l’enregistrer ou y répondre, donc l’abonnement expire sans réponse après 12 heures, et une session demandante avec refuse ne s’abonne jamais.
• hold de chaque côté : l’avis arrive avec moins. La session regardée laisse le statut d’une ligne de côté, et la session demandante affiche l’avis dans votre transcription sans le livrer à Claude.

​

Voir quelles sessions Claude peut atteindre

• Sous-agents : agents exécutés à l’intérieur de la session actuelle.
• Coéquipiers : les coéquipiers de la propre équipe d’agents de cette session. Avant v2.1.239, les coéquipiers n’apparaissaient pas dans la liste, bien que Claude puisse déjà les envoyer des messages par nom.
• Vos autres sessions locales : sessions Claude Code exécutées sur la même machine, y compris les sessions en arrière-plan. Une session n’apparaît que quand elle lie une socket de boîte de réception.
• Vos sessions cloud : vos sessions Claude Code sur le web, affichées pendant que cette session est connectée à la Télécommande. Claude Code les étiquette cloud dans la liste.
• Vos sessions Télécommande sur d’autres machines : affichées pendant que cette session est connectée à la Télécommande, et étiquetées Remote Control. Claude Code affiche offline comme le statut d’une session dont la connexion Télécommande a chuté.

• Répertoires de travail : il laisse de côté le répertoire de travail de chaque session locale.
• Noms de session : il laisse de côté tout nom de session qu’il ne peut pas attribuer à une personne, donc une ligne laissée sans nom lit (unnamed session).
• La première ligne : il laisse de côté la ligne avec le nom de cette session à moins que vous ayez tapé ce nom à ce terminal, avec --name ou avec /rename et le nom, depuis que vous avez lancé ou repris la session.

• Une session répond au nom : Claude Code livre le message sur le nom seul.
• Plusieurs sessions partagent le nom, ou Claude Code ne pouvait pas vérifier partout où vos sessions s’exécutent : Claude ajoute un court identifiant à chaque ligne de sa liste et utilise l’identifiant dans l’adresse.

​

Envoyer des messages aux sessions sur d’autres machines

​

Comment une session traite un message entrant

• Il ne peut rien approuver : un message d’une autre session ne compte jamais comme votre consentement, donc il ne peut pas répondre à une invite de permission en attente en votre nom.
• Il ne peut pas changer la configuration : Claude Code instruit le Claude récepteur de ne jamais changer les paramètres de permission, CLAUDE.md ou d’autres configurations parce qu’une autre session l’a demandé.
• Les commandes ne s’exécutent pas : une commande dans le texte du message, comme /compact, arrive sous forme de texte brut. Claude Code ne l’exécute jamais.
• Les invites de permission se déclenchent toujours : si agir sur le message nécessite une permission que la session réceptrice n’a pas, vous voyez la même invite que vous verriez pour tout autre travail.

​

À quoi ressemble un message

• Appuyez sur Ctrl+O pour ouvrir la visionneuse de transcription et lire le texte complet sous le nom de session de l’expéditeur.
• Dans une session démarrée avec --verbose, Claude Code affiche le texte complet au lieu de l’aperçu.

Schema migration finished
The new column is tenant_id, and rebasing on main is safe now.

​

Contrôler les messages entrants

• La session réceptrice invite pour les permissions : Claude Code livre chaque message. Il retient un pour votre approbation seulement quand la session d’envoi s’identifie comme contournant les invites de permission.
• La session réceptrice contourne les invites de permission : Claude Code retient chaque message pour votre approbation. Il livre un seulement quand la session d’envoi s’identifie aussi comme contournant.

• Approuver livre ce message à Claude.
• Refuser, ou fermer la boîte de dialogue, le supprime.
• Quand la boîte de dialogue reste sans réponse au-delà de la date limite dialogExpiry, Claude Code la ferme et supprime le message. La date limite par défaut est de cinq minutes. Pendant qu’aucun terminal n’est attaché à une session en arrière-plan, Claude Code laisse la boîte de dialogue ouverte au-delà de la date limite. Après que vous attachiez, Claude Code ferme la boîte de dialogue et supprime le message seulement s’il reste sans réponse pendant une période de date limite complète.
• Si la classe de mode de permission de cette session change pendant que les messages sont retenus, Claude Code réapplique les règles entrantes, livre les messages qu’elles acceptent maintenant, et affiche un avis.
• Si un changement de paramètres rend refuse applicable pendant que les messages sont retenus, Claude Code supprime chaque message retenu et rapporte un refus à chaque expéditeur qu’il peut atteindre.

​

Sessions non-interactives

• Avant la date limite : si un mode ou changement de paramètres permet le message, Claude Code le livre.
• Au-delà de la date limite : Claude Code supprime le message et le rapporte comme expiré à un expéditeur qu’il peut atteindre.

​

La socket de boîte de réception de la session

• /status l’affiche dans la ligne Peer address. Le chemin est préfixé avec uds:.
• Claude Code l’exporte vers les hooks et les commandes Bash comme la variable d’environnement CLAUDE_CODE_MESSAGING_SOCKET :
  • Dans une session qui démarre avec la messagerie activée, Claude Code exporte la variable avant que tout hook ne s’exécute, y compris SessionStart.
  • Chaque session exporte sa propre socket, jamais une héritée d’une session parent.

• macOS et Linux, y compris WSL 2 : la ligne est optionnelle. Claude Code accepte une connexion avec ou sans elle.
• Windows natif : la ligne est requise. Claude Code ferme toute connexion dont la première ligne n’est pas une ligne d’authentification valide et ne livre rien de cette connexion.

• Messages propres-enfant : quand aucune valeur crossSessionInbound ne s’applique, Claude Code livre un message qu’il vérifie provenir des processus enfants de la session, comme un hook ou une commande Bash postant vers la socket de sa propre session.
  • Sur Linux, y compris à l’intérieur de WSL 2, Claude Code peut vérifier par preuve de processus même pour un enfant qui a déjà quitté. Sur macOS il ne peut vérifier que de cette manière que pendant que le processus de postage s’exécute toujours, et dans un conteneur où Claude Code s’exécute comme ID de processus 1 il n’a aucune preuve de processus du tout. Sur Windows natif il n’en a pas non plus.
  • Sur macOS après que le processus de postage ait quitté et dans les conteneurs où Claude Code s’exécute comme ID de processus 1, cette preuve de processus manque, et Claude Code vérifie plutôt un enfant qui a envoyé le CLAUDE_CODE_MESSAGING_TOKEN exporté de la session dans la ligne d’authentification qui a ouvert sa connexion. Sur Windows natif, ce jeton est la seule façon que Claude Code vérifie un message propre-enfant.
  • Quand Claude Code ne peut vérifier de l’une ou l’autre manière, il traite le message comme tout autre qui n’affirme aucune classe de permission, donc une session qui contourne les invites de permission le retient pour votre approbation.
• Sessions sandboxées : contrôlez si une commande Bash peut atteindre la socket de l’intérieur du sandbox avec les paramètres de socket Unix du sandbox, sandbox.network.allowAllUnixSockets et sandbox.network.allowUnixSockets.

​

Restreindre la messagerie entre sessions

​

Exiger l’approbation pour les messages entre machines

{
  "isolatePeerMachines": true
}

​

Désactiver la messagerie entre sessions

• Arrêter la réception : définissez crossSessionInbound à refuse, et Claude Code supprime les messages pair entrants sans les livrer. À partir des paramètres de projet ou locaux, refuse s’applique sur chaque autre source, et à partir de vos paramètres utilisateur il s’applique à moins que les paramètres gérés ou l’indicateur --settings définissent une valeur.
• Arrêter l’envoi et la liste : ajoutez des règles de permission de refus spécifiques à l’outil nommant SendMessage et ListAgents. Les deux prennent le nom d’outil nu sans spécificateur.

{
  "permissions": {
    "deny": ["SendMessage", "ListAgents"]
  },
  "crossSessionInbound": "refuse"
}

​

Disponibilité

• Système d’exploitation : disponible sur macOS, Windows et Linux, y compris Linux à l’intérieur de WSL 2.
• Sessions sur cette machine : disponible sur chaque fournisseur, y compris Amazon Bedrock, Claude Platform sur AWS, Agent Platform de Google Cloud et Microsoft Foundry, et dans les sessions qui s’exécutent avec la récupération de drapeau de fonctionnalité désactivée. Sur ces fournisseurs, et avec la récupération de drapeau désactivée, la messagerie sur la même machine nécessite Claude Code v2.1.248 ou ultérieure. Claude Code livre ces messages sur une socket par session sur votre machine, jamais par les serveurs Anthropic. Pour arrêter une session de les recevoir, définissez crossSessionInbound à refuse.
• Sessions au-delà de cette machine : Claude trouve vos sessions Claude Code sur le web et vos sessions sur d’autres machines à partir d’une session connectée à la Télécommande, qui nécessite une connexion claude.ai comme authentification active de cette session et les autres exigences de Télécommande. Claude ne peut pas trouver ces sessions avec une clé API ou sur Amazon Bedrock, Claude Platform sur AWS, Agent Platform de Google Cloud et Microsoft Foundry.

• /list-agents n’est pas reconnu : la session n’a pas la messagerie entre sessions. Travaillez à travers les exigences ci-dessus, en commençant par claude --version pour l’exigence de version.
• /list-agents fonctionne mais un envoi n’est pas arrivé : la messagerie est activée, et quelque chose de plus étroit s’applique :
  • Règles de refus : une règle de permission de refus supprime les outils SendMessage et ListAgents.
  • Contrôles entrants : les contrôles entrants de la session réceptrice peuvent retenir ou supprimer ce que vous lui envoyez.
  • Session cloud manquante : une session cloud n’apparaît que pendant que cette session est connectée à la Télécommande.
  • Session sur une autre machine manquante : une session sur une autre de vos machines n’apparaît que quand elle s’exécute avec la Télécommande et que cette session est aussi connectée.
  • Session cloud ou sur une autre machine plus ancienne manquante : Claude Code lit ces listes de sessions les plus récentes en premier et s’arrête après un nombre limité de pages, donc Claude ne peut pas envoyer un message à une session qui a dépassé par nom.
  • Démarrer une conversation : Envoyer des messages aux sessions sur d’autres machines couvre le démarrage d’une conversation avec une session au-delà de cette machine.

​

Limitations

• Texte brut seulement : Claude envoie seulement du texte brut entre les sessions. Les messages de protocole structuré d’équipe d’agents restent au sein d’une équipe.
• La taille du message sur la même machine est plafonnée : Claude Code refuse un message à une session sur cette machine une fois que sa forme sérialisée dépasse environ un million de caractères. Le refus nomme les tailles exactes. Rien n’atteint la session réceptrice.
• Les rafales rapides vers une session sont refusées à l’expéditeur : une fois qu’une rafale rapide de messages vers une session sur cette machine atteint ce que la boîte de réception de cette session accepte, Claude Code refuse d’autres envois dans la session d’envoi. Le refus nomme la rafale et dit à Claude de regrouper le reste en un message ou d’attendre. Avant v2.1.236, Claude Code rapportait ces envois comme envoyés pendant que la session réceptrice les supprimait.
• Les boucles de message sont limitées : dans la session réceptrice, Claude Code limite le débit des messages répétés par expéditeur, supprime les répétitions identiques arrivant dans une courte fenêtre, et met en file d’attente au maximum 50 messages acceptés pour que Claude les lise. Une boucle de message entre deux sessions s’arrête donc d’elle-même. Quand la limite de débit, la vérification de répétition ou le plafond de file d’attente supprime un message d’une session interactive sur cette machine, Claude Code dit à cette session lequel l’a supprimé et dit à son Claude de ne pas renvoyer immédiatement.

​

Ressources connexes

• Sous-agents et équipes d’agents : messagerie au sein d’une seule session ou équipe
• Agents en arrière-plan : dispatcher et surveiller les sessions parallèles que vous pourriez envoyer des messages
• Télécommande : connectez cette session pour atteindre vos sessions sur d’autres machines
• Paramètres : crossSessionInbound, isolatePeerMachines et dialogExpiry
• Modes de permission : les modes derrière les deux classes du défaut entrant
• Référence des outils : les lignes ListAgents et SendMessage dans le tableau des outils
• Exécuter les agents en parallèle : comparez les façons que Claude Code exécute plusieurs agents