Messaggi tra le tue altre sessioni di Claude Code

​

Quando utilizzare la messaggistica tra sessioni

• Consegna un risultato: quando una sessione scopre un cambiamento che interrompe il funzionamento o prende una decisione, Claude lo riassume per la sessione che lavora sull’area interessata, invece di doverlo rispiegare lì.
• Coordina worktree paralleli: quando le sessioni lavorano lo stesso repository in worktree separati, Claude può dire alle altre sessioni cosa è stato implementato.
• Ottieni lo stato dal lavoro a lunga esecuzione: fai in modo che una migrazione o un’esecuzione di test riferisca alla sessione che stai osservando, oppure chiedilo tu stesso da lì. Se quella sessione è su questa macchina, Claude può anche chiederle un avviso quando successivamente diventa inattiva o esce.
• Messaggi tra macchine: raggiungi una delle tue sessioni su un’altra macchina o sul web.

• Per continuare una conversazione in un altro terminale, o condividere il suo contesto con una nuova sessione, riprendi la sessione
• Per un team coordinato di sessioni che Claude genera e supervisiona, utilizza team di agenti
• Per osservare e dirigere molte sessioni da un unico posto, utilizza agent view
• Per dirigere una sessione tu stesso dal tuo telefono o da un altro dispositivo, piuttosto che far inviare messaggi alle sessioni l’una all’altra, utilizza Remote Control
• Per spingere eventi esterni, come risultati CI o messaggi di chat, in una sessione, utilizza channels

​

Invia un messaggio a un’altra sessione

Chiedi alla sessione in esecuzione nel mio altro terminale se la migrazione è terminata

Spiega quello che abbiamo appena fatto alla sessione che lavora sull'API dei pagamenti

Fai sapere a @api-worker che la migrazione dello schema è terminata

• Una sessione oltre questa macchina: una sessione cloud o Remote Control appare nel typeahead solo dopo che Claude ha elencato o inviato messaggi alle tue sessioni oltre questa macchina, quindi chiedi a Claude di elencarle prima.
• Un nome con uno spazio o altri caratteri al di fuori di lettere, cifre, trattini e sottolineature: digitalo tra virgolette doppie, come @"release notes". Quando scegli la sessione dal typeahead, Claude Code inserisce le virgolette per te.

​

Consegna del messaggio

• Il messaggio è oltre il limite di dimensione. Claude Code lo rifiuta nella sessione di invio, prima che parta.
• Un rapido burst a una sessione su questa macchina ha raggiunto quello che la posta in arrivo di quella sessione accetta. Claude Code rifiuta ulteriori messaggi a quella sessione.
• Il target di risposta su questa macchina non supera un controllo di sicurezza, come un target con collegamento simbolico o un endpoint che non è il processo previsto. Rifiuto di inviare un messaggio tra sessioni elenca questi controlli.
• Claude indirizza il messaggio al nome della sessione stessa, come descritto in Vedi quali sessioni Claude può raggiungere.

• Consegnato: Claude Code passa il messaggio al Claude ricevente.
• Trattenuto: Claude Code mette da parte il messaggio non consegnato. Un messaggio trattenuto raggiunge Claude solo quando lo approvi o un cambio di modalità o impostazioni successivo lo consente.
• Rifiutato: Claude Code elimina il messaggio senza consegnarlo.

​

Ricevi un avviso quando un’altra sessione diventa inattiva

​

Chiedi un avviso

Dimmi quando la sessione di migrazione finisce quello su cui sta lavorando

​

Cosa mostra ogni sessione

​

Limiti

• refuse su entrambi i lati: nulla arriva. La sessione osservata elimina la richiesta senza registrarla o rispondere, quindi l’iscrizione scade senza risposta dopo 12 ore, e una sessione che chiede con refuse non si iscrive mai.
• hold su entrambi i lati: l’avviso arriva con meno. La sessione osservata lascia fuori lo stato di una riga, e la sessione che chiede mostra l’avviso nella tua trascrizione senza consegnarlo a Claude.

​

Vedi quali sessioni Claude può raggiungere

• Subagenti: agenti in esecuzione all’interno della sessione corrente.
• Colleghi: i colleghi del team di agenti della sessione stessa. Prima della v2.1.239, i colleghi non apparivano nell’elenco, anche se Claude poteva già inviar loro messaggi per nome.
• Le tue altre sessioni locali: sessioni Claude Code in esecuzione sulla stessa macchina, incluse sessioni in background. Una sessione appare solo quando associa un socket della posta in arrivo.
• Le tue sessioni cloud: le tue sessioni Claude Code sul web, mostrate mentre questa sessione è connessa a Remote Control. Claude Code le etichetta cloud nell’elenco.
• Le tue sessioni Remote Control su altre macchine: mostrate mentre questa sessione è connessa a Remote Control, ed etichettate Remote Control. Claude Code mostra offline come lo stato di una sessione la cui connessione Remote Control è caduta.

• Directory di lavoro: lascia fuori la directory di lavoro di ogni sessione locale.
• Nomi delle sessioni: lascia fuori qualsiasi nome di sessione che non può attribuire a una persona, quindi una riga rimasta senza nome legge (unnamed session).
• La prima riga: lascia fuori la riga con il nome della sessione stessa a meno che tu non abbia digitato quel nome a questo terminale, con --name o con /rename e il nome, da quando hai avviato o ripreso l’ultima volta la sessione.

• Una sessione risponde al nome: Claude Code consegna il messaggio solo sul nome.
• Diverse sessioni condividono il nome, o Claude Code non potrebbe controllare ovunque vengono eseguite le tue sessioni: Claude aggiunge un breve identificatore a ogni riga del suo elenco e utilizza l’identificatore nell’indirizzo.

​

Invia messaggi a sessioni su altre macchine

​

Come una sessione tratta un messaggio in arrivo

• Non può approvare nulla: un messaggio da un’altra sessione non conta mai come il tuo consenso, quindi non può rispondere a un prompt di autorizzazione in sospeso per tuo conto.
• Non può cambiare la configurazione: Claude Code istruisce il Claude ricevente a non cambiare mai le impostazioni di autorizzazione, CLAUDE.md o altre configurazioni perché un’altra sessione lo ha chiesto.
• I comandi non vengono eseguiti: un comando nel testo del messaggio, come /compact, arriva come testo semplice. Claude Code non lo esegue mai.
• I prompt di autorizzazione si attivano comunque: se agire sul messaggio richiede un’autorizzazione che la sessione ricevente non ha, vedi lo stesso prompt che vedresti per qualsiasi altro lavoro.

​

Come appare un messaggio

• Premi Ctrl+O per aprire il visualizzatore di trascrizioni e leggi il testo completo sotto il nome della sessione del mittente.
• In una sessione avviata con --verbose, Claude Code mostra il testo completo invece dell’anteprima.

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

​

Controlla i messaggi in entrata

• La sessione ricevente richiede autorizzazioni: Claude Code consegna ogni messaggio. Trattiene uno per la tua approvazione solo quando la sessione di invio si identifica come bypassando i prompt di autorizzazione.
• La sessione ricevente bypassa i prompt di autorizzazione: Claude Code trattiene ogni messaggio per la tua approvazione. Consegna uno solo quando la sessione di invio si identifica come bypassando anche.

• Approve consegna quel messaggio a Claude.
• Deny, o chiudere la finestra di dialogo, lo elimina.
• Quando la finestra di dialogo rimane senza risposta oltre la scadenza dialogExpiry, Claude Code la chiude e elimina il messaggio. La scadenza predefinita è cinque minuti.
• Mentre nessun terminale è collegato a una sessione in background, Claude Code lascia la finestra di dialogo aperta oltre la scadenza. Dopo che colleghi, se la finestra di dialogo rimane senza risposta per un intero periodo di scadenza, Claude Code la chiude e elimina il messaggio.
• Se la classe di modalità di autorizzazione di questa sessione cambia mentre i messaggi sono trattenuti, Claude Code riapplica le regole in entrata, consegna i messaggi che ora accetta, e mostra un avviso.
• Se un cambio di impostazioni fa applicare refuse mentre i messaggi sono trattenuti, Claude Code elimina ogni messaggio trattenuto e segnala un rifiuto a ogni mittente che può raggiungere.

​

Sessioni non interattive

• Prima della scadenza: se una modalità o un cambio di impostazioni consente il messaggio, Claude Code lo consegna.
• Oltre la scadenza: Claude Code elimina il messaggio e lo segnala come scaduto a un mittente che può raggiungere.

​

Il socket della posta in arrivo della sessione

• /status lo mostra nella riga Peer address. Il percorso è prefissato con uds:.
• Claude Code lo esporta a hooks e comandi Bash come la variabile di ambiente CLAUDE_CODE_MESSAGING_SOCKET:
  • In una sessione che inizia con la messaggistica attiva, Claude Code esporta la variabile prima che qualsiasi hook venga eseguito, incluso SessionStart.
  • Ogni sessione esporta il suo socket, mai uno ereditato da una sessione genitore.

• macOS e Linux, incluso WSL 2: la riga è facoltativa. Claude Code accetta una connessione con o senza di essa.
• Windows nativo: la riga è obbligatoria. Claude Code chiude qualsiasi connessione la cui prima riga non è una riga di autenticazione valida e non consegna nulla da quella connessione.

• Messaggi propri-figli: quando nessun valore crossSessionInbound si applica, Claude Code consegna un messaggio che verifica è venuto dai processi figli della sessione stessa, come un hook o un comando Bash che pubblica di nuovo nel socket della posta in arrivo della sua stessa sessione.
  • Su Linux, incluso all’interno di WSL 2, Claude Code può verificare per evidenza di processo anche per un figlio che è già uscito. Su macOS può verificare in quel modo solo mentre il processo di pubblicazione è ancora in esecuzione, e in un contenitore dove Claude Code viene eseguito come ID processo 1 non ha alcuna evidenza di processo. Su Windows nativo non ne ha nemmeno.
  • Su macOS dopo che il processo di pubblicazione è uscito e in contenitori dove Claude Code viene eseguito come ID processo 1, quella evidenza di processo manca, e Claude Code verifica invece un figlio che ha inviato il CLAUDE_CODE_MESSAGING_TOKEN esportato della sessione nella riga di autenticazione che ha aperto la sua connessione. Su Windows nativo, quel token è l’unico modo in cui Claude Code verifica un messaggio proprio-figlio.
  • Quando Claude Code non può verificare in nessun modo, tratta il messaggio come qualsiasi altro che non asserisce alcuna classe di autorizzazione, quindi una sessione che bypassa i prompt di autorizzazione lo trattiene per la tua approvazione.
• Sessioni in sandbox: controlla se un comando Bash può raggiungere il socket dall’interno della sandbox con le impostazioni del socket Unix della sandbox, sandbox.network.allowAllUnixSockets e sandbox.network.allowUnixSockets.

​

Limitare la messaggistica tra sessioni

​

Richiedere approvazione per i messaggi tra macchine

{
  "isolatePeerMachines": true
}

​

Disattivare la messaggistica tra sessioni

• Interrompere la ricezione: impostare crossSessionInbound su refuse, e Claude Code elimina i messaggi peer in arrivo senza consegnarli. Dalle impostazioni di progetto o locali, refuse si applica su ogni altra fonte, e dalle impostazioni utente si applica a meno che le impostazioni gestite o il flag --settings impostino un valore.
• Interrompere l’invio e l’elenco: aggiungere regole di negazione delle autorizzazioni che denominano SendMessage e ListAgents. Entrambi accettano il nome dello strumento senza specificatore.

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

​

Disponibilità

• Sistema operativo: disponibile su macOS, Windows e Linux, incluso Linux all’interno di WSL 2.
• Sessioni su questa macchina: disponibile su ogni provider, inclusi Amazon Bedrock, Claude Platform su AWS, Agent Platform di Google Cloud e Microsoft Foundry, e in sessioni che vengono eseguite con fetching dei flag di funzionalità disattivato. Su quei provider, e con il fetching dei flag disattivato, la messaggistica sulla stessa macchina richiede Claude Code v2.1.248 o successiva. Claude Code consegna questi messaggi su un socket per sessione sulla tua macchina, mai attraverso i server Anthropic. Per impedire a una sessione di riceverli, imposta crossSessionInbound su refuse.
• Sessioni oltre questa macchina: Claude trova le tue sessioni Claude Code sul web e le tue sessioni su altre macchine da una sessione che è connessa a Remote Control, che ha bisogno di un accesso claude.ai come autenticazione attiva di questa sessione e degli altri requisiti di Remote Control. Claude non può trovare quelle sessioni con una chiave API o su Amazon Bedrock, Claude Platform su AWS, Agent Platform di Google Cloud e Microsoft Foundry.

• /list-agents non è riconosciuto: la sessione non ha messaggistica tra sessioni. Lavora attraverso i requisiti sopra, iniziando con claude --version per il requisito di versione.
• /list-agents funziona ma un invio non è arrivato: la messaggistica è attiva, e qualcosa di più stretto si applica:
  • Regole di negazione: una regola di autorizzazione di negazione rimuove gli strumenti SendMessage e ListAgents.
  • Controlli in entrata: i controlli in entrata della sessione ricevente possono trattenere o eliminare quello che invii.
  • Sessione cloud mancante: una sessione cloud appare solo mentre questa sessione è connessa a Remote Control.
  • Sessione su un’altra macchina mancante: una sessione su un’altra delle tue macchine appare solo quando viene eseguita con Remote Control e questa sessione è connessa anche.
  • Sessione su un’altra macchina offline: un messaggio a una sessione elencata come offline va a buon fine, ma arriva solo dopo che la macchina di quella sessione si riconnette.
  • Sessione cloud o su un’altra macchina più vecchia mancante: Claude Code legge quegli elenchi di sessioni dal più recente al più vecchio e si ferma dopo un numero limitato di pagine, quindi Claude non può inviare un messaggio a una sessione che è caduta oltre di loro per nome.
  • Avvio di una conversazione: Invia messaggi a sessioni su altre macchine copre l’avvio di una conversazione con una sessione oltre questa macchina.

​

Limitazioni

• Solo testo semplice: Claude invia solo testo semplice tra sessioni. I messaggi del protocollo team di agenti strutturati rimangono all’interno di un team.
• La dimensione del messaggio sulla stessa macchina è limitata: Claude Code rifiuta un messaggio a una sessione su questa macchina una volta che la sua forma serializzata supera circa un milione di caratteri. Il rifiuto nomina le dimensioni esatte. Nulla raggiunge la sessione ricevente.
• I burst rapidi a una sessione vengono rifiutati al mittente: una volta che un burst rapido di messaggi a una sessione su questa macchina raggiunge quello che la posta in arrivo di quella sessione accetta, Claude Code rifiuta ulteriori invii nella sessione di invio. Il rifiuto nomina il burst e dice a Claude di raggruppare il resto in un messaggio o aspettare. Prima della v2.1.236, Claude Code segnalava quegli invii come inviati mentre la sessione ricevente li eliminava.
• I loop di messaggi sono limitati: nella sessione ricevente, Claude Code limita la velocità dei messaggi ripetuti per mittente, elimina i ripetuti identici che arrivano entro una breve finestra, e mette in coda al massimo 50 messaggi accettati per Claude da leggere. Un loop di messaggi tra due sessioni quindi si ferma da solo. Quando il limite di velocità, il controllo di ripetizione o il limite di coda elimina un messaggio da una sessione interattiva su questa macchina, Claude Code dice a quella sessione quale lo ha eliminato e dice al suo Claude di non rinviare subito.

​

Risorse correlate

• Subagenti e team di agenti: messaggistica all’interno di una singola sessione o team
• Agenti in background: invia e monitora le sessioni parallele che potresti inviare messaggi
• Remote Control: connetti questa sessione per raggiungere le tue sessioni su altre macchine
• Impostazioni: crossSessionInbound, isolatePeerMachines e dialogExpiry
• Modalità di autorizzazione: le modalità dietro il default in entrata delle due classi
• Riferimento degli strumenti: le righe ListAgents e SendMessage nella tabella degli strumenti
• Esegui agenti in parallelo: confronta i modi in cui Claude Code esegue più agenti