Gestire più agenti con agent view

Invia e gestisci molte sessioni di Claude Code da una sola schermata. Agent view mostra cosa sta facendo ogni sessione e quali hanno bisogno del tuo input.

Agent view, aperto con claude agents, è una sola schermata per tutte le tue sessioni in background: cosa sta girando, cosa ha bisogno del tuo input e cosa è fatto. Invia nuove sessioni, osserva il loro stato a colpo d'occhio invece di scorrere i transcript, e intervieni solo quando uno ne ha bisogno. Ogni sessione in background è una conversazione completa di Claude Code che continua a girare senza un terminale collegato, quindi puoi aprirla, rispondere e andare via quando vuoi.

Agent view in a terminal: the header shows Claude Code v2.1.140, the model, the working directory, and a summary count. Sessions are grouped under Needs input, Working, and Completed, with a dispatch input at the bottom and a footer of keyboard hints.

Usa agent view quando hai diversi compiti indipendenti su cui Claude può lavorare senza che tu guardi ogni passo. Invia una correzione di bug, una revisione di pull request e un'investigazione di test instabile come tre righe, continua a lavorare in un'altra finestra e controlla quando una riga mostra che ha bisogno di te o ha un risultato.

Quando vuoi lavorare più direttamente nella sessione di qualsiasi agente, collegati alla riga per entrare nella conversazione completa.

Per confrontare agent view con subagenti, team di agenti e worktrees, vedi Esegui agenti in parallelo.

Avvio rapido

Questa procedura illustra il ciclo principale della vista agente: invia un'attività, osserva l'aggiornamento della sua riga mentre Claude lavora, controlla per verificare lo stato e rispondi, e collegati per la conversazione completa. La sessione che invii continua a funzionare dopo che chiudi la vista agente, quindi puoi andare via e tornare ad essa.

Apri agent view

Dalla tua shell, esegui:

claude agents

Se non hai ancora accettato la finestra di dialogo di fiducia dell'area di lavoro per la directory, Claude Code la mostra prima che agent view si apra, la stessa finestra di dialogo che mostra claude. Accetta per salvare la fiducia per l'area di lavoro e continua. Se rifiuti, Claude Code esce senza aprire agent view.

Agent view si apre con un input in basso e una tabella che si riempie quando le sessioni iniziano. Premi Esc per tornare alla tua shell; se hai aperto agent view mettendo in background una sessione con ←, Esc ritorna a quella conversazione invece. Le tue sessioni continuano a funzionare mentre sei via e riappaiono la prossima volta che apri agent view.

Invia una sessione

Digita un prompt che descrive un'attività e premi Enter. Una nuova sessione in background inizia su quell'attività e appare come una riga che mostra se sta lavorando, aspettando te, o è completata. La nuova sessione utilizza il modello mostrato nell'intestazione di agent view. La modalità di autorizzazione in cui inizia dipende da come hai aperto agent view.

Ogni prompt che inserisci qui avvia la sua propria nuova sessione. Digitando un altro prompt e premendo Enter avvia una seconda sessione accanto alla prima piuttosto che inviare un follow-up ad essa. Puoi eseguire diversi in parallelo in questo modo.

Ogni sessione utilizza la tua quota di abbonamento indipendentemente, quindi consulta Limitazioni prima di inviare molte sessioni contemporaneamente.

Peek e rispondi

Seleziona una riga con i tasti freccia e premi Space per aprire il pannello peek. Mostra l'output più recente della sessione, o la domanda su cui sta aspettando, piuttosto che la trascrizione completa. Digita una risposta e premi Enter per inviarla senza lasciare agent view.

Collegati e scollega

Premi Enter o → su una riga per collegarti quando vuoi la conversazione completa. La sessione prende il controllo del terminale come una sessione Claude Code interattiva completa. Premi ← su un prompt vuoto per scollegar e tornare alla tabella.

Porta una sessione esistente dentro

Questo passaggio richiede una sessione in esecuzione. Se hai seguito i passaggi precedenti non ne hai una aperta in questo terminale, quindi apri una sessione claude regolare in un altro terminale e invia prima un messaggio.

Per spostare una sessione che hai già aperta in agent view, esegui /bg dentro di essa, o premi ← su un prompt vuoto per metterla in background e aprire agent view in un unico passaggio. In una sessione nuova senza messaggi ancora, /bg ti chiede di inviare prima un messaggio, mentre ← funziona subito. La sessione continua a funzionare e appare come una riga accanto a quelle che hai inviato.

Puoi usare claude agents come tuo punto di ingresso principale invece di claude: invia ogni attività da agent view, collegati quando vuoi la conversazione completa, e premi ← per tornare alla tabella.

All'interno di una sessione claude regolare, l'hint ← del footer del prompt conta gli agenti in background che stanno aspettando te, come ← 2 agents, e ritorna a ← for agents quando nessuno ha bisogno di input. I conteggi superiori a 99 vengono visualizzati come 99+. Il conteggio si aggiorna circa ogni dieci secondi mentre il terminale è focalizzato e immediatamente quando il focus ritorna. Cambia brevemente colore quando si sposta e quando un agente si completa, e quando una sessione in background si completa mentre nessuno ha bisogno del tuo input mostra brevemente il numero completato, come ← 2 done. Entrambi i flash sono disattivati quando l'impostazione prefersReducedMotion è attiva, e l'hint è nascosto in modalità screen reader.

Monitorare le sessioni con agent view

Esegui claude agents per aprire agent view. Prende il controllo del terminale completo ed elenca ogni sessione raggruppata per stato, con sessioni fissate e quelle che hanno bisogno di te in cima. Ogni riga mostra il nome della sessione, l'attività corrente e la sua età, contata da quando la sessione è stata creata; l'età di una sessione terminata si congela a quanto tempo ha impiegato l'esecuzione.

Il nome è tinto con il colore impostato da /color in quella sessione, incluso quando metti in background una sessione con ← o /background.

Per impostazione predefinita, l'elenco mostra ogni sessione in background che hai avviato, in tutti i tuoi progetti. Una sessione che lavora in un repository e un'altra in un worktree diverso appaiono entrambe qui, indipendentemente da quale directory hai aperto agent view. Per limitare l'elenco a un progetto, passa --cwd:

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

Questo mostra solo le sessioni avviate in quella directory. Una sessione che si è spostata in un worktree sotto ~/projects/my-app/.claude/worktrees/ conta ancora come appartenente a ~/projects/my-app.

Le sessioni interattive che hai aperto in altri terminali non appaiono finché non le metti in background. I subagents e i teammates che una sessione genera non sono elencati come righe separate.

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

Leggere lo stato della sessione

Ogni riga inizia con un'icona il cui colore e animazione mostrano lo stato della sessione:

Stato	L'icona mostra	Cosa significa
Working	Animato	Claude sta attivamente eseguendo strumenti o generando una risposta
Needs input	Giallo	Claude sta aspettando qualcosa che solo tu puoi fornire: una risposta a una domanda, una decisione di permesso, o un altro prompt solo tu puoi rispondere, come un prompt sandbox per consentire un host di rete o una richiesta di input di un server MCP. Un comando che ha bisogno di un terminale collegato, come `/install-github-app` o l'elenco delle impostazioni `/mcp`, tiene una sessione incustodita qui anche
Idle	Attenuato	La sessione non ha nulla da fare ed è pronta per il tuo prossimo prompt
Completed	Verde	Il compito è terminato con successo
Failed	Rosso	Il compito è terminato con un errore
Stopped	Grigio	La sessione è stata fermata con `Ctrl+X` o `claude stop`, il suo processo è stato terminato da fuori Claude Code, o è terminato mentre il servizio in background era spento

Separatamente, la forma dell'icona mostra se il processo sottostante è in esecuzione:

Forma	Cosa significa
`✻` o animato `✽`	Il processo della sessione è vivo e risponde immediatamente
`∙`	Il processo è uscito. Puoi ancora fare peek, e quando rispondi o ti colleghi, Claude riavvia da dove l'ha lasciato
`✢`	Una sessione `/loop` che dorme tra le iterazioni. La riga mostra il conteggio delle esecuzioni e un conto alla rovescia

L'etichetta #N o !N che può apparire al bordo destro di una riga è un collegamento alla pull request o merge request della sessione, non parte dell'icona di stato.

Il titolo della scheda del terminale mostra il conteggio awaiting-input mentre agent view è aperto: 2 awaiting input · claude agents quando le sessioni hanno bisogno di input, o claude agents quando nessuna lo fa.

Per leggere lo stato della sessione da uno script o un altro programma, usa claude agents --json piuttosto che i file sotto ~/.claude/jobs/.

Mentre agent view è aperto, Claude Code invia anche una notifica attraverso il tuo canale di notifica del terminale configurato quando una sessione in background locale inizia ad aver bisogno del tuo input, finisce, o fallisce. Le sessioni che vengono eseguite secondo una pianificazione, come le sessioni /loop, notificano solo quando hanno bisogno del tuo input. Le notifiche utilizzano la stessa impostazione preferredNotifChannel del resto di Claude Code e attivano l'hook Notification con il tipo agent_needs_input o agent_completed.

Le sessioni in background non hanno bisogno di alcun terminale aperto per continuare a lavorare. Un processo supervisor separato le esegue, quindi puoi chiudere agent view, chiudere la tua shell, o avviare una nuova sessione interattiva e il tuo lavoro inviato continua.

Lo stato della sessione persiste su disco attraverso gli auto-update e i riavvii del supervisor. Le sessioni sono anche preservate quando la tua macchina dorme. I loro processi riprendono al risveglio e il supervisor si ricollega a loro invece di trattare il gap di tempo come inattività. Lo spegnimento ferma comunque le sessioni in esecuzione; vedi Le sessioni mostrano come non riuscite o fermate dopo lo spegnimento per come recuperarle.

Una sessione che era a metà risposta quando la macchina ha dormito può tornare non responsiva. Quando apri una sessione che ha smesso di rispondere, il supervisor riavvia il suo processo e la sessione continua la risposta interrotta da dove l'ha lasciata.

Riassunti delle righe

Il riassunto su una riga è generato da un modello di classe Haiku in modo che la riga possa dirti cosa sta facendo la sessione, cosa ha bisogno, o cosa ha prodotto senza aprire il transcript. Mentre una sessione sta attivamente lavorando, il testo della riga si aggiorna al massimo una volta ogni 15 secondi dall'output recente della sessione stessa senza inviare una richiesta di modello, e il modello scrive un riassunto fresco quando ogni turno termina.

Una riga di lavoro mostra cosa la sessione dice che sta facendo, e una riga bloccata mostra la domanda che sta ponendo. Durante un turno lungo, il modello riscrive anche il riassunto ogni pochi minuti in modo che una riga occupata non continui a mostrare un riassunto obsoleto. Il testo di riepilogo riempie la larghezza rimanente della riga; apri il pannello peek per leggere una frase che il bordo del terminale taglia.

Quando l'elenco è raggruppato per directory, il riassunto si apre con lo stato della sessione come una parola colorata, come Needs input · double jump or wall climb?. Nel raggruppamento di stato predefinito, l'intestazione del gruppo nomina già lo stato, quindi la riga mostra solo il riassunto.

Il riassunto di fine turno e ogni riscrittura a metà turno sono una breve richiesta di classe Haiku attraverso il tuo provider normale, fatturata e gestita secondo gli stessi termini di utilizzo dei dati della sessione stessa. Gli aggiornamenti di 15 secondi tra le riscritture del modello riutilizzano l'output della sessione stessa e non inviano una richiesta. Su un provider di terze parti o gateway senza un modello Haiku configurato, la richiesta utilizza il modello principale della sessione; imposta ANTHROPIC_DEFAULT_HAIKU_MODEL per sceglierne uno.

Stato della pull request

Quando una sessione apre una pull request, Claude Code aggiunge un'etichetta al bordo destro della riga, collegata alla pull request:

Claude Code scrive l'etichetta come #1234 per una pull request e come !1234 per una merge request di GitLab.
Claude Code emette il collegamento anche quando non riesce a rilevare il supporto dei hyperlink, ad esempio su SSH o tmux. Imposta FORCE_HYPERLINK=0 per rendere l'etichetta come testo semplice.
Dopo aver inviato un follow-up alla sessione, Claude Code mantiene l'etichetta mentre la riga ritorna al progresso live.

Una sessione che lavora su una pull request esistente è collegata a essa allo stesso modo. Claude Code trova la pull request diversamente a seconda del comando che Claude esegue:

Quando Claude modifica, commenta, chiude, o contrassegna una pull request come pronta con gh, Claude Code collega la pull request che l'output del comando stesso nomina. Un comando gh il cui output catturato non nomina alcuna pull request non crea un collegamento; gh pr merge è il caso comune, perché stampa il suo risultato solo su un terminale interattivo.
Quando Claude controlla una pull request con gh pr checkout o esegue il push su un ramo, Claude Code cerca il ramo con gh pr view e collega la sua pull request aperta.
La pull request non ha bisogno di esistere ancora quando Claude esegue il push: Claude Code ritenta la ricerca del ramo dopo fino a cinque comandi git, gh, glab, o curl successivi eseguiti nella stessa directory, quindi una pull request creata dopo il push, inclusa una che Claude crea attraverso l'API REST di GitHub, si collega quando un tentativo la trova.

Quando una sessione è collegata a più di una pull request, l'etichetta mostra un conteggio invece, come 3 PRs, colorato dalla pull request aperta che ha più bisogno di attenzione. Apri il pannello peek per vederle tutte.

Il numero della pull request è colorato dal suo stato:

Colore	Stato della pull request
Giallo	In attesa di controlli o revisione, o controlli falliti
Verde	Controlli superati e nessuna revisione sta bloccando
Viola	Unito
Grigio	Bozza o chiuso

Per un compito che termina in una pull request, controlla questa etichetta per il risultato: rivedi e unisci la pull request quando il suo numero diventa verde.

Peek e rispondi

Premi Space su una riga selezionata per aprire il pannello peek. Si apre con la frase che la riga tronca al bordo del terminale, e quale frase sia dipende dallo stato della sessione:

Una sessione che sta aspettando te: la domanda esatta che sta ponendo, sopra l'input di risposta
Una sessione terminata: il suo risultato
Una sessione che lavora: la sua frase di stato completa

Qualsiasi pull request collegata alla sessione è elencata dopo. Per una sessione che sta aspettando te, una riga come waiting 3m sotto di loro mostra quanto tempo è stata in attesa, ed è l'unico momento mostrato nel pannello. L'età al bordo destro della riga è un numero diverso: conta da quando la sessione è iniziata.

La maggior parte delle volte il pannello peek è sufficiente e non hai bisogno di aprire il transcript completo.

Digita una risposta nel pannello peek e premi Enter per inviarla a quella sessione. Quando la sessione pone una domanda con scelte predefinite, il pannello peek le mostra come un elenco numerato e puoi premere un tasto numero per sceglierne uno. Un prompt di permesso mostra come testo che descrive cosa la sessione vuole eseguire, senza opzioni numerate. Digita una risposta per rispondere, o collegati per rispondere con il prompt standard. Per altre sessioni bloccate, premi Tab per riempire l'input con una risposta suggerita che puoi modificare prima di inviare. Prefissa una risposta con ! per inviare un comando Bash invece.

Quando un hook PermissionRequest o PreToolUse restituisce un output che Claude Code non può convalidare per la chiamata che la sessione sta chiedendo, la riga mostra l'evento hook e hook output invalid: con l'errore di convalida prima del testo della richiesta in sospeso. Per un hook che fallisce in un altro modo, la riga dice che l'hook ha fallito. La sessione continua ad aspettare la stessa richiesta.

Una risposta che non può essere consegnata, perché il servizio in background non è raggiungibile o l'invio fallisce, viene salvata e inviata alla sessione come suo prossimo prompt quando il suo processo si avvia di nuovo, e il messaggio di errore dice che la risposta è stata salvata. Una risposta con prefisso ! non viene salvata, perché il testo salvato raggiungerebbe la sessione come un prompt semplice piuttosto che eseguire come comando Bash.

Con la dettatura vocale abilitata, tieni premuto o tocca il tuo tasto push-to-talk mentre l'input di risposta è focalizzato per dettare una risposta invece di digitarla. Lo stesso funziona nell'input di dispatch in fondo a agent view.

Usa ↑ e ↓ per fare peek alle sessioni adiacenti senza chiudere il pannello, o → per collegarti.

Collegarsi a una sessione

Premi Enter o → su una riga selezionata per collegarti. Agent view è sostituito dalla sessione interattiva completa. Quando ti colleghi, Claude pubblica un breve riassunto di cosa è successo mentre eri via.

Mentre collegato, la sessione si comporta come qualsiasi altra sessione di Claude Code: comandi, scorciatoie da tastiera e funzioni funzionano tutti, con le eccezioni sottostanti.

Mentre sei collegato, /install-github-app e l'elenco delle impostazioni /mcp funzionano normalmente, poiché un umano al terminale può completare i loro dialoghi. Quando nessuno è collegato, questi comandi non possono aprire i loro dialoghi, quindi la sessione appare sotto Needs input in agent view con una riga come open this session to manage MCP servers, e la risposta del transcript dice lo stesso. Collegati ed esegui il comando di nuovo per continuare; la riga needs-input si cancella quando ti colleghi. /mcp reconnect <server>, /mcp enable, e /mcp disable funzionano senza collegarsi in entrambi i casi.

Le sessioni collegate si rendono sempre in modalità fullscreen, indipendentemente dalla tua impostazione tui, perché una sessione in background non ha scrollback del terminale a cui aggiungere. Scorri con PgUp, PgDn, o la rotella del mouse, e premi Ctrl+O per la modalità transcript. Lo scroll nativo del tuo terminale e la modalità copia di tmux mostrano solo il viewport corrente, lo stesso di quando esegui qualsiasi applicazione fullscreen.

Premi ← su un prompt vuoto, o esegui /exit, per scollegar e tornare a agent view, indipendentemente dal fatto che tu abbia aperto la sessione da agent view o con claude attach <id> dalla tua shell.

← scollega anche mentre l'overlay /btw è aperto. Richiede Claude Code v2.1.257 o successivo. Una domanda laterale che sta ancora rispondendo continua a funzionare mentre sei via. La prossima volta che ti colleghi, l'overlay si riapre con essa, o con la sua risposta.

Su Windows, se premi ← entro circa mezzo secondo dal collegamento, Claude Code mostra Ambiguous ←, press again to detach, perché in quella finestra il terminale può rideliver una pressione da prima che ti collegassi. Premi ← di nuovo per scollegar.

Ctrl+Z scollega anche ma torna a dove hai iniziato invece: agent view se ti sei collegato da lì, o la tua shell se hai eseguito claude attach. Usa Ctrl+Z quando una finestra di dialogo ha il focus e non risponde a ←.

Ctrl+C mantiene il suo comportamento di interruzione standard mentre collegato: annulla una risposta in esecuzione o un comando shell ! piuttosto che scollegar. Premere Ctrl+C due volte su un prompt vuoto scollega, come in qualsiasi sessione.

Scollegar non ferma mai una sessione in background: ←, Ctrl+Z, /exit, e doppio Ctrl+C o doppio Ctrl+D la lasciano tutte in esecuzione. Per terminare una sessione da dentro di essa, esegui /stop.

Cambiare sessioni senza lasciare il terminale

In una sessione in esecuzione in primo piano, una che hai avviato nel terminale piuttosto che collegato da agent view, premere ← su un prompt vuoto la mette in background e apre agent view con quella riga selezionata, quindi puoi cambiare sessioni senza lasciare il terminale. Lo stesso singolo press scollega una sessione collegata.

Se premi ← subito dopo aver eliminato l'ultimo testo del prompt o aver spostato la cronologia del prompt, Claude Code ti chiede di confermare: il primo press mostra Press ← again to open agents, o Press ← again to go back to agents in una sessione collegata, e il secondo press cambia.

Quando ← mette in background una sessione in primo piano, agent view mostra Your conversation moved to the background sopra l'elenco, con la riga di quella sessione già selezionata. Da lì:

Premi Enter per riaprire la conversazione.
Premi Esc per annullare il cambio e tornare alla conversazione. Se Esc mostra Still starting — try again in a moment, la sessione in background non è ancora pronta, quindi premi Esc di nuovo tra un momento.
Premi Ctrl+C due volte per uscire alla tua shell.

Quando Claude Code non riesce a riaprire la conversazione, esce e stampa un comando claude --resume che la riprende.

L'elenco delle attività di Claude si sposta alla sessione in background con la conversazione, quindi la checklist è intatta quando torni a quella riga.

La riga su cui hai premuto ← mantiene anche un nome in grassetto e non attenuato dopo aver spostato la selezione con i tasti freccia o il mouse, quindi puoi dire da quale sessione sei venuto.

Se uno strumento è in esecuzione quando premi ←, Claude Code aspetta fino a circa dieci secondi che finisca prima di metterla in background, e Claude continua la risposta nella sessione in background. Premi ← di nuovo per metterla in background immediatamente invece di aspettare. Quando il lavoro in corso non può trasferirsi alla sessione in background, Claude Code mostra prima la finestra di dialogo Background this session?, come con /background.

Il limite di dieci secondi non si applica mentre i subagents in primo piano che Claude ha avviato nella conversazione sono ancora in esecuzione. Claude Code continua ad aspettare in modo che il loro lavoro si trasferisca, e mostra un avviso Still backgrounding after the current tool mentre aspetta. Premi ← di nuovo per metterla in background senza aspettare, il che riavvia quei subagents dall'inizio. Claude Code non aspetta i subagents che un workflow dinamico sta eseguendo. Quando un workflow ha subagents in esecuzione, Claude Code mostra la finestra di dialogo Background this session? invece.

Claude Code non mette in background la sessione mentre hai testo non inviato nell'input del prompt, perché il testo rimane nella casella di input del tuo terminale e non si sposterebbe alla sessione in background. Se digiti nell'input mentre Claude Code aspetta di mettere in background la sessione, annulla il cambio con Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.

Premere ← crea la riga della sessione anche quando la conversazione non ha ancora messaggi, quindi → ritorna comunque a essa.

Puoi disattivare questa scorciatoia con l'impostazione leftArrowOpensAgents in /config.

Organizzare l'elenco

Agent view raggruppa le sessioni in modo che quelle che hanno bisogno di input siano in cima, con Ready for review e Needs input sopra Working e Completed. Questi nomi di gruppo non corrispondono uno a uno agli stati sopra: una sessione si sposta a Ready for review quando ha una pull request aperta, e Completed raccoglie insieme sessioni finite, fallite e fermate.

Premi Ctrl+S per raggruppare per directory invece. La tua scelta persiste tra le esecuzioni.

All'interno di un gruppo:

Premi Ctrl+T per fissare una sessione in cima e mantenere il suo processo in esecuzione mentre inattivo
Premi Shift+↑ o Shift+↓ per riordinare le sessioni
Premi Ctrl+R per rinominare una sessione
Premi Enter su un'intestazione di gruppo per comprimerla

Per rimuovere una sessione dall'elenco, premi Ctrl+X per fermarla e Ctrl+X di nuovo entro due secondi per eliminarla. Premere Ctrl+X su un'intestazione di gruppo elimina ogni sessione in quel gruppo dopo conferma.

Il secondo press elimina la sessione anche quando il tentativo di arresto fallisce, ad esempio perché il servizio in background non sta rispondendo: la conferma rimane attiva per altri due secondi, e l'eliminazione termina il processo della sessione stesso. Premi Esc per chiudere la conferma senza eliminare.

Tranne nei casi mantenuti coperti in Cosa elimina una sessione, l'eliminazione rimuove la sessione dall'elenco, e un worktree che Claude ha creato per essa viene rimosso, mantenuto, o lasciato in posto a seconda di come elimini e cosa contiene il worktree. Il transcript della conversazione rimane sempre sulla tua macchina locale, disponibile attraverso claude --resume.

Per riportare una sessione su Claude Code v2.1.212 o successivo, digita /resume nell'input di dispatch. Si apre un picker con le sessioni passate del repository da cui hai aperto agent view, più recenti per prime, incluse le sessioni che hai eliminato dall'elenco; le sessioni che hanno già una riga non sono elencate. ↑/↓ spostano la selezione, Enter riprende la sessione selezionata come sessione in background in modo che si riunisca all'elenco come riga, e Esc chiude il picker.

Il picker si apre solo per un /resume semplice. Un resume mirato, scoped, o ristretto non può essere servito dal picker, quindi agent view mostra l'hint attach to a session to run it invece quando:

/resume nomina un id o un termine di ricerca
la vista è scoped con --cwd
la vista è stata avviata con --safe-mode
la vista è stata aperta con un flag come --permission-mode o --settings

Le sessioni completate che non si adattano allo schermo si ripiegano in una riga … N more. I fallimenti e le sessioni con una pull request aperta rimangono sempre visibili. Il gruppo Completed riempie lo spazio verticale rimasto dopo i gruppi live, e su un terminale corto l'intestazione si compatta in una singola riga di riepilogo in modo che le sessioni che stanno lavorando o hanno bisogno di input rimangono visibili.

Filtrare le sessioni

Digita nell'input di dispatch per filtrare invece di inviare:

Filtro	Mostra
`a:<name>`	Sessioni che eseguono l'agente denominato
`s:<state>`	Sessioni nello stato dato, come `s:working`. Accetta anche `s:blocked` per tutto ciò che sta aspettando te
`#<number>` o un URL PR o merge request	La sessione che lavora su quella pull request o merge request
Qualsiasi altro URL	La sessione il cui primo prompt conteneva quell'URL

Scorciatoie da tastiera

Premi ? in agent view per vedere ogni scorciatoia nel contesto. La tabella sottostante le riassume.

Scorciatoia	Azione
`↑` / `↓`	Muoviti tra le righe
`Enter`	Collegati alla sessione selezionata, o invia se c'è testo nell'input
`Space`	Apri o chiudi il pannello peek per la sessione selezionata
`Shift+Enter`	Inserisci una nuova riga nell'input di dispatch, come nel prompt principale
`Ctrl+Enter`	Invia e collegati immediatamente, nei terminali dove l'overlay `?` elenca `ctrl+enter to start and open`
`→`	Collegati alla sessione selezionata
`Alt+1`..`Alt+9`	Collegati alla sessione 1–9 nella directory della sessione focalizzata
`Tab`	Su un input vuoto, sfoglia tutti i subagents. Altrimenti applica il suggerimento evidenziato
`Ctrl+S`	Cambia raggruppamento tra stato e directory
`Ctrl+T`	Fissa o scollega la sessione selezionata
`Ctrl+R`	Rinomina la sessione selezionata
`Ctrl+G`	Apri il prompt di dispatch nel tuo `$VISUAL` o `$EDITOR`
`Ctrl+J`	Inserisci una nuova riga nell'input di dispatch
`Ctrl+X`	Ferma la sessione; premi di nuovo entro due secondi per eliminarla
`Shift+↑` / `Shift+↓`	Riordina la sessione selezionata
`Esc`	Chiudi il pannello peek, cancella l'input, o esci. Quando hai aperto agent view mettendo in background la tua sessione con `←`, l'`Esc` finale ritorna a quella conversazione invece di uscire. Con la modalità editor vim attiva, premere `Esc` nell'input passa da modalità INSERT a modalità NORMAL e mantiene il tuo testo, come nel prompt principale
`Ctrl+C`	Cancella l'input; premi due volte per uscire
`?`	Mostra tutte le scorciatoie

Ctrl+S, Ctrl+T, e Ctrl+G seguono il tuo keybindings.json. Riassegna o scollega Ctrl+S e Ctrl+T con le azioni agents:switchView e agents:togglePin nel contesto Agents, e Ctrl+G attraverso il binding chat:externalEditor del contesto Chat. Le altre scorciatoie nella tabella non possono essere riassegnate.

Invia nuovi agenti

Puoi inviare nuove sessioni in background da agent view, inviare una sessione interattiva esistente in background, o avviarne una direttamente dalla shell.

Da agent view

Digita un prompt nell'input in basso di agent view e premi Enter per avviare una nuova sessione in background. La sessione è denominata automaticamente dal prompt; rinominala in seguito con Ctrl+R.

Il nome automatico è un'etichetta breve scritta da un modello di classe Haiku. Un nome che la sessione riceve in seguito appare anche sulla sua riga, incluso il titolo generato che la sessione ottiene quando accetti un piano in quella sessione.

Incolla un'immagine nel prompt per includere uno screenshot o un diagramma con il compito.

Il testo incollato più lungo di 800 caratteri o più di tre righe si comprime in un placeholder [Pasted text #N] in modo che l'input rimanga su una riga; il testo completo viene inviato quando invii. Per rivedere o modificare il testo compresso prima di inviare, incolla lo stesso testo di nuovo e il placeholder si espande di nuovo nell'input.

Prefissa o menziona parti del prompt per controllare come la sessione inizia:

Input	Effetto
`<agent-name> <prompt>`	Se la prima parola corrisponde a un nome di subagent personalizzato, quel subagent viene eseguito come agente principale della sessione con la configurazione dal suo frontmatter
`@<agent-name>`	Menziona un subagent personalizzato in qualsiasi punto del prompt per eseguirlo come agente principale
`@<repo>`	Menziona un repository per eseguire la sessione lì. Vedi Invia a una directory specifica per quali repository sono elencati
`/<command>`	Suggerisci skills e commands da inviare come prompt
`! <command>`	Esegui un comando shell come un job in background invece di avviare una sessione Claude. Il job appare come una riga a cui puoi collegarti, osservare e staccarti
`#<number>` o un URL di pull request o merge request	Se una sessione sta già lavorando su quel pull request o merge request, Claude Code seleziona la sua riga invece di inviare una nuova sessione

Un piccolo insieme di comandi viene eseguito in agent view stesso invece di essere inviato:

/exit e /quit chiudono agent view
/logout ti disconnette
/model imposta il modello di dispatch
A partire da v2.1.198, /login apre la finestra di dialogo di accesso in modo che tu possa accedere di nuovo senza collegarti a una sessione
Un /resume semplice, o il suo alias /continue, apre un picker delle sessioni passate del repository per riportarne una indietro come sessione in background. Richiede Claude Code v2.1.212 o successivo

Skills, i tuoi comandi personali, e built-in che espandono il prompt come /init vengono inviati a una nuova sessione in background come loro primo prompt. Gli altri comandi built-in mostrano un suggerimento attach to a session to run it invece. Tutto ciò che hai digitato rimane nell'input accanto al suggerimento in modo che tu possa modificarlo.

Confezionare un compito ricorrente come una skill ti permette di avviare lo stesso workflow da agent view ripetutamente senza riscrivere il prompt.

Quando lo stesso @name corrisponde sia a un subagent che a un repository fratello, il subagent ha la precedenza. La corrispondenza della prima parola senza @ si applica anche, quindi un prompt che inizia con uno dei tuoi nomi di subagent invia quel subagent piuttosto che trattare la parola come testo semplice. Usa la forma @ quando vuoi essere esplicito, o inizia il prompt con una parola diversa per evitare la corrispondenza.

Invia a una directory specifica

Una nuova sessione viene eseguita nella directory da cui hai aperto agent view. Per indirizzare una directory diversa, utilizza uno qualsiasi di questi:

Apri claude agents in quella directory.
Apri claude agents in una directory padre e menziona un repository figlio con @<repo> nel prompt. Digitando @ vengono elencati questi target:
- Repository Git un livello sotto la directory di lancio
- I git worktrees registrati del repository da cui hai lanciato che si trovano all'interno del suo albero di directory, come quelli che Claude crea sotto .claude/worktrees/, etichettati con il loro ramo estratto. I worktrees aggiunti al di fuori del repository, come con git worktree add ../feature, non sono elencati
- Qualsiasi directory che ha già una sessione nell'elenco
Una directory il cui nome contiene uno spazio non è elencata.
Dalla shell, cd nella directory e esegui claude --bg "<prompt>".

Quando agent view è raggruppato per directory, l'invio invia il prompt alla directory della riga selezionata, quindi puoi selezionare un gruppo e inviare in esso senza riscrivere il percorso.

Da dentro una sessione

Due comandi spostano il lavoro dalla sessione in cui ti trovi in background: /background invia la conversazione corrente lì e libera il tuo terminale, e /fork invia una copia mentre continui a lavorare dove sei.

Invia la sessione in background

Esegui /background o il suo alias /bg per spostare la conversazione corrente in una sessione in background. Passa un prompt come /bg run the test suite and fix any failures per inviare un'istruzione in più prima. Se Claude sta rispondendo quando esegui /bg, la risposta continua nella sessione in background.

L'uscita da una sessione che ha ancora lavoro in background in esecuzione, come subagent, comandi shell in background, workflow, o monitor, mostra una finestra di dialogo Background work is running invece di uscire immediatamente. Scegli Move to background and exit per mettere in background la sessione nello stesso modo in cui /background fa e tornare alla tua shell. L'opzione non viene mostrata quando agent view è disattivato.

Se una sessione in background nell'elenco ha già il nome della conversazione, Claude Code numera il nome della nuova riga, come my-session (2), e lascia il nome della riga esistente invariato. Per rinominare la nuova riga, selezionala in agent view e premi Ctrl+R.

Copia la sessione con /fork

Esegui /fork per copiare la conversazione corrente in una nuova sessione in background mentre l'originale continua a essere eseguita. La copia inizia con tutto nella conversazione fino a quel punto; vedi i punti elenco di seguito per dove viene eseguita la copia. Trasporta anche il modello, la modalità di autorizzazione, il livello di sforzo, e qualsiasi directory o concessioni di autorizzazione "non chiedere di nuovo" che hai aggiunto durante la sessione. La copia appare come sua propria riga in agent view.

Dopo il fork, le due conversazioni sono indipendenti: nulla di ciò che la copia fa entra nella conversazione originale da sola, anche se nelle sessioni in cui la messaggistica tra sessioni è abilitata, la Claude di entrambe le sessioni può esplicitamente inviare messaggi all'altra.

La copia della sessione richiede Claude Code v2.1.212 o successivo; su v2.1.161 attraverso v2.1.211, /fork avvia un subagent con fork invece, che è ora /subtask. Quando agent view è disattivato, /fork mantiene il comportamento del subagent con fork e /subtask non è disponibile.

Passa un prompt come /fork open a draft pull request with the work so far e la copia inizia a lavorarci immediatamente. Senza un prompt la copia aspetta la sua prima istruzione: seleziona la sua riga in claude agents e premi Space per inviarne una, o esegui claude attach <id>. La riga selezionata mostra space to send it a prompt mentre aspetta.

La conferma di /fork è una riga che mostra lo stato della copia, come session running, il nome della sua riga di agent view, e il suo ID di sessione per claude attach. Fai clic sul nome per passare alla copia: questa sessione si sposta in background, come premere ←, e agent view apre la sessione della copia.

Tranne quando la copia modifica in posizione, Claude Code le istruisce di creare un worktree proprio prima di apportare modifiche al codice. Al di fuori di un repository git, solo una copia spostata fuori da un worktree creato da hook riceve l'istruzione; senza un WorktreeCreate hook, la copia modifica in posizione. Una copia spostata fuori dal tuo worktree riceve anche l'istruzione di non modificare mai, eseguire comandi in, o entrare in quel worktree, qualunque sia l'impostazione di isolamento.

Dove la copia inizia dipende da dove è in esecuzione la sessione corrente:

Come qualsiasi sessione inviata, la copia si sposta nel suo worktree prima di modificare i file. In quel caso la conferma non menziona dove viene eseguita la copia.
Quando la tua sessione si è spostata nel suo worktree collegato dopo l'avvio, la copia inizia da dove era la sessione prima dello spostamento e, a meno che non modifichi in posizione, apporta le sue modifiche al codice in un worktree proprio lì. Quando il tuo worktree è estratto su un ramo, quell'istruzione dice anche a una copia il cui compito si basa sul tuo lavoro di basare il suo nuovo ramo sul tuo, poiché il tuo ramo rimane estratto nel tuo worktree. La conferma termina con runs in the origin tree.
Quando hai lanciato la sessione all'interno di un worktree collegato di un repository che ha un albero di lavoro principale, la copia inizia in quell'albero di lavoro principale, con la stessa regola del worktree proprio ma nessuna istruzione di ramo. La conferma termina con runs in the origin tree anche qui.
Una sessione lanciata all'interno di un worktree di un layout di repository bare non ha un albero di lavoro principale a cui tornare, quindi la copia rimane dove si trova, e la conferma termina con edits this checkout. La stessa nota appare quando l'isolamento del worktree è disattivato in una sessione che non è all'interno di un worktree collegato, perché la copia modifica i file che hai aperto.

Le sessioni avviate con flag di lancio che la copia non erediterebbe, come un prompt di sistema sostituito o un allowlist --tools, non possono essere forkate; Claude Code lo dice invece di fare una copia parziale. Una sessione inviata da agent view viene forkata normalmente: la copia viene lanciata con la stessa definizione di agente e istruzioni aggiunte della sessione da cui proviene.

Cosa si trasporta quando metti in background

Mettere in background avvia un nuovo processo che riprende dalla conversazione salvata, e il lavoro in corso si trasferisce ad esso: comandi shell in background in esecuzione, subagent in background, workflow dinamici, compiti programmati che hai creato con /loop, e risposte automatiche di Claude ai commenti degli artefatti si trasferiscono tutti e continuano a essere eseguiti lì. Un subagent si sposta insieme a tutto ciò che ha avviato, quindi si trasferisce solo quando tutto quel lavoro può trasferirsi anche. Per fermare il lavoro in corso invece di trasferirlo, imposta la variabile di ambiente CLAUDE_DISABLE_ADOPT=1; Claude Code ti chiede di confermare prima di mettere in background.

Quando un workflow dinamico ha ancora subagent in esecuzione, Claude Code chiede prima di mettere in background con la finestra di dialogo Background this session?, che dice quanti subagent verrebbero riavviati. Scegli Stay per lasciarli finire prima. Se confermi, Claude Code riproduce l'esecuzione nella sessione in background: i subagent che erano ancora in esecuzione ricominciamo dall'inizio, quindi i token che hanno usato finora vengono spesi di nuovo. Vedi Riprendi dopo una pausa per quali subagent completati restituiscono i loro risultati salvati e quali vengono eseguiti di nuovo.

Claude Code interrompe il lavoro che non può trasferirsi, come un monitor in esecuzione, e interrompe un subagent messo in background che possiede un monitor insieme ad esso. Quando uno qualsiasi di essi è in esecuzione, Claude Code mostra la finestra di dialogo Background this session? in modo che tu possa confermare prima che il lavoro sia interrotto.

Una volta in background, la sessione può avviare nuovi subagent, monitor, e comandi in background, e questi continuano a essere eseguiti durante successivi distacchi e ricollegamenti.

I flag di configurazione dal lancio originale si trasferiscono alla sessione messa in background, quindi i suoi server MCP, le impostazioni e il modello di fallback rimangono in vigore:

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

Le directory che hai aggiunto durante la sessione con /add-dir si trasferiscono anche. Il trasferimento di --allow-dangerously-skip-permissions mantiene bypassPermissions raggiungibile nella sessione messa in background, ma non concede nulla di nuovo: la modalità richiede comunque la stessa accettazione interattiva una tantum descritta in Permission mode, model, and effort.

Dalla tua shell

Passa --bg o la sua forma lunga --background per avviare una sessione che va direttamente in background:

claude --bg "investigate the flaky SettingsChangeDetector test"

Il prompt è l'argomento posizionale, non un valore -p. Claude Code rifiuta --bg combinato con -p o --print prima che qualsiasi sessione sia creata, perché --print non avvia mai la sessione interattiva a cui claude agents si collega.

Per eseguire un subagent specifico che hai definito, come un code-reviewer, come agente principale della sessione, combina --bg con --agent:

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

Se il nome non corrisponde a nessuno dei tuoi subagent, il lancio fallisce: Claude Code stampa un avviso no agent named e comunque segnala la sessione come messa in background, ma la sessione esce immediatamente con un errore --agent '<name>' not found.

Quando la sessione messa in background in seguito riprende o si riavvia, Claude Code ripristina l'agente e le sue restrizioni di strumenti; per il suo prompt di sistema, vedi Flag di prompt di sistema nelle conversazioni riprese. Cerca prima il suo agente nella directory della sessione, a condizione che tu abbia fiducia in quel workspace, quindi un agente con ambito di progetto si carica ancora quando la sessione viene ripresa da un'altra directory. Se l'agente non esiste più, la sessione continua con gli strumenti predefiniti e la sua trascrizione si apre con un avviso che nomina l'agente.

Per continuare una conversazione esistente in background, passa il suo ID di sessione completo con --resume:

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

Su Claude Code v2.1.257 o successivo, Claude Code continua quella sessione con lo stesso ID, o avvia una copia con un nuovo ID e stampa una riga note: che spiega perché non potrebbe continuare in posizione. Quando la sessione continua in posizione, claude agents mostra una riga per essa.

Quando combini --bg con --continue, un --resume semplice, o --resume con un nome o percorso di file, Claude Code avvia sempre una copia di questo tipo. Aggiungi --fork-session per avviare una copia di proposito, senza la nota.

Passa --name per impostare il nome di visualizzazione della sessione in agent view invece di quello generato automaticamente:

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

Dopo aver messo in background, Claude stampa l'ID breve della sessione e i comandi per gestirla. Quando il servizio che ospita le sessioni in background non è già in esecuzione, --bg potrebbe prima stampare Starting background service… sopra questo output. Quando passi --name, il nome appare dopo l'ID breve:

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

Esegui un comando shell

Per eseguire un comando shell come un job in background invece di una sessione Claude, passa --exec. L'esempio seguente esegue pytest -x come un job in background:

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

Da agent view, invia lo stesso tipo di job digitando ! come primo carattere dell'input di dispatch: il ! viene visualizzato come prefisso, tutto ciò che digiti dopo di esso è il comando, e Enter avvia il job.

Il comando viene eseguito come un job supportato da PTY e appare come una riga in agent view, con la riga di output più recente come suo stato. Un job shell esegue il comando al posto di Claude, quindi nessun modello viene invocato e l'output non viene inviato a nessuna sessione.

Per vedere l'output, collegati alla riga, premi Space per visualizzare l'anteprima senza collegarti, o esegui claude logs <id> dalla tua shell. L'output acquisito rimane in memoria e non viene scritto su disco. La riga e il suo output si puliscono automaticamente circa cinque minuti dopo l'uscita del comando, quindi leggi prima se hai bisogno del risultato.

Come sono isolate le modifiche ai file

Ogni sessione in background, che sia avviata da agent view, /bg, o claude --bg, inizia nella tua directory di lavoro. Prima di modificare i file, Claude sposta la sessione in un git worktree isolato sotto .claude/worktrees/, quindi le sessioni parallele possono leggere lo stesso checkout ma ognuna scrive nel suo. Una volta che la sessione è nel suo worktree, Claude Code applica l'isolamento del worktree per la sessione e per qualsiasi subagent che genera.

Claude salta il worktree quando:

La sessione è già all'interno di un git worktree collegato, che Claude l'abbia creato sotto .claude/worktrees/ o tu l'abbia creato con git worktree add da qualche altra parte
Il file che Claude sta modificando è all'interno di un git worktree collegato, come uno che la sessione o il suo subagent ha creato con git worktree add
La directory di lavoro non è un repository git e nessun WorktreeCreate hook è configurato
La scrittura è al di fuori della directory di lavoro

Per disattivare l'isolamento del worktree per un repository dove i git worktree sono impraticabili, imposta worktree.bgIsolation su "none". Le sessioni in background modificheranno quindi la tua copia di lavoro direttamente senza spostarsi prima in un worktree. Aggiungi l'impostazione al file .claude/settings.json del progetto:

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

Al di fuori di un repository git, le sessioni scrivono direttamente nella directory di lavoro e non sono isolate l'una dall'altra, quindi evita di inviare sessioni parallele che modificano gli stessi file. Se utilizzi un sistema di controllo versione diverso, configura un WorktreeCreate hook e Claude isola le modifiche nello stesso modo in cui lo fa per git.

Quando l'hook fallisce in una directory che non è un repository git, Claude salta l'isolamento per quella directory e modifica la directory di lavoro in posizione. All'interno di un repository git, Claude Code blocca le scritture al checkout condiviso finché Claude non sposta la sessione in un worktree.

Per trovare il percorso del worktree di una sessione, visualizza l'anteprima della sessione o collegati e controlla la sua directory di lavoro.

Un subagent che la sessione in background genera eredita la directory di lavoro della sessione, quindi le sue modifiche ai file finiscono nel worktree della sessione piuttosto che nella tua copia di lavoro. Per dare a un subagent il suo proprio worktree separato, imposta isolation: worktree nel suo frontmatter o passa isolation: "worktree" quando lo generi.

Quando una sessione in background ha apportato modifiche al codice in un worktree in cui Claude è entrato, Claude Code istruisce Claude di preservare il lavoro prima di finire, quindi sopravvive se elimini la sessione e il suo worktree:

Commit e push: Claude esegue il commit senza chiedere, e spinge il ramo quando il repository ha un remote.
Bozza di pull request: Claude ne apre una quando il compito lo richiede, e l'etichetta #N appare sulla riga.
Mai: spingere a main o master, force-push, e merge.
Le tue istruzioni git hanno la precedenza: se il compito, CLAUDE.md, o memoria dice che gestisci tu stesso il commit o il push, Claude lascia git a te.

Una sessione che modifica un checkout che non ha isolato da sola chiede comunque prima di fare il commit o di cambiare rami. Questo si applica quando l'isolamento è impostato su "none", quando lo spostamento del worktree è fallito, o quando la sessione è stata avviata all'interno di un worktree che già esisteva.

Qualunque sia il compito, Claude termina il lavoro con un rapporto che dice cosa ha fatto e dove si trova il lavoro: un percorso, un ramo, una pull request, o la risposta stessa.

Cosa elimina l'eliminazione di una sessione

Elimina una sessione con Ctrl+X due volte in agent view o con claude rm. Tranne nei casi mantenuti di seguito, la sessione lascia l'elenco. La sua trascrizione rimane sulla tua macchina attraverso claude --resume, e la rimozione sopravvive ai riavvii del supervisore.

Cosa succede a un worktree che Claude ha creato per la sessione:

Agent view lo rimuove, inclusi eventuali cambiamenti non committati, quindi esegui il commit di ciò che vuoi mantenere prima.
claude rm lo mantiene, insieme alla riga della sessione, quando ha cambiamenti non committati.
Né agent view né claude rm rimuovono un worktree che un'altra sessione in esecuzione sta usando o ha bloccato, e eliminare di nuovo non cambia questo. Claude Code mantiene il worktree e la sessione, e nomina la directory mantenuta e il motivo; in agent view, la riga della sessione mostra not deleted. Chiudi l'altra sessione, quindi elimina di nuovo.
Quando elimini una sessione il cui worktree ha commit che Claude Code non può confermare sono salvati altrove, Claude Code mantiene il worktree e la sessione, e il messaggio nomina il ramo del worktree e quanti commit non sono stati spinti. Il messaggio offre anche i due modi per procedere: spingere i commit, o eliminare di nuovo per scartarli.

I commit su un remote non bloccano l'eliminazione. Nemmeno i commit sulla copia locale del ramo predefinito del tuo remote origin, purché quel ramo sia estratto nel tuo checkout principale, la directory del repository stessa piuttosto che un worktree.

Dopo quel rifiuto, scegli:
- Per mantenere i commit, spingili, o uniscili in quel ramo predefinito, quindi elimina la sessione di nuovo.
- Per scartarli, elimina la sessione di nuovo senza spingere: premi Ctrl+X due volte sulla sua riga in agent view, o esegui il comando claude rm <id> --discard-unpushed che il rifiuto ha stampato. Questo rimuove la sessione e il worktree insieme al suo ramo, scartando i commit non spinti e qualsiasi cambiamento non committato.
Quando elimini di nuovo, Claude Code scarta solo ciò che il rifiuto ha mostrato: se il worktree ha guadagnato un commit da allora, Claude Code lo mantiene di nuovo e mostra lo stato aggiornato.

Quando i record di un'altra sessione finita nominano anche il worktree, rimane quando elimini di nuovo; spingere i commit, quindi eliminare di nuovo.
Un worktree che git non riconosce più, ad esempio dopo git worktree prune, non blocca l'eliminazione. Claude Code elimina la sessione e lascia la directory su disco.
Quando git o il tuo WorktreeRemove hook non riesce a rimuovere il worktree, Claude Code mantiene il worktree e la sessione, e il messaggio nomina la causa. Per un hook, il messaggio dice come è terminato, come exited 1, e cita l'inizio del suo stderr. Il messaggio ti dice anche quale di questi fare dopo:
- Elimina la sessione di nuovo per rimuovere la directory comunque, premendo Ctrl+X due volte sulla sua riga in agent view o eseguendo il comando claude rm <id> --force-remove-worktree <worktree-id> che il rifiuto di claude rm ha stampato. Claude Code offre questo solo quando può confermare che la directory è uno dei worktree collegati del repository sotto .claude/worktrees/ senza cambiamenti non committati ai file tracciati, nessun repository annidato dentro, e nessun record di un'altra sessione che lo nomina. Il ramo del worktree rimane nel repository.
- Correggi ciò che sta nel modo, come committare o stash dei cambiamenti non committati, chiudere tutto ciò che sta usando la directory, o correggere l'hook, quindi elimina la sessione di nuovo.
- Rimuovi la directory tu stesso, quindi elimina la sessione di nuovo.

Un worktree che hai creato tu stesso e in cui hai avviato la sessione viene lasciato in posizione in entrambi i casi.

Una sessione il cui worktree directory non appartiene a nessun repository git, perché il repository è stato eliminato o un WorktreeCreate hook ha creato la directory altrove, può comunque essere eliminata. Mentre i file rimangono nella directory:

Agent view chiede lo stesso doppio Ctrl+X prima di scartarli. Per una directory creata da hook esegue il tuo WorktreeRemove hook invece, e senza uno rifiuta l'eliminazione e mantiene la sessione.
claude rm mantiene la sessione e il worktree, e nomina il motivo.

Entrambi i percorsi mantengono una directory che i record di un'altra sessione finita nominano.

Imposta il modello

Il nome del modello mostrato nell'intestazione di agent view è il default di dispatch. Le nuove sessioni che avvii dall'input utilizzano questo modello, che proviene dall'impostazione model nei tuoi settings utente. Impostalo selezionando un modello nel picker /model, o modifica l'impostazione direttamente.

Per sovrascrivere il default di dispatch per l'intera sessione di agent view, passa --model quando apri agent view. Vedi Permission mode, model, and effort.

Per cambiare il default di dispatch da dentro agent view, digita /model seguito da un nome di modello nell'input di dispatch e premi Enter. L'intestazione si aggiorna per mostrare quel modello con un marcatore (session), e le sessioni che invii successivamente lo utilizzano. Digita /model default per cancellare l'override e tornare al default di dispatch. Questo override dura per il resto della corrente esecuzione di claude agents e non scrive nel tuo file di settings. L'esempio seguente invia una sessione su Opus e la successiva su Sonnet:

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

Ogni sessione in background può essere eseguita su un modello diverso. Per sovrascriverlo per una sessione:

Dalla shell, passa --model con claude --bg.
Collegati a una sessione in esecuzione e esegui /model per passare: una scelta dal picker, o un /model <name> digitato, viene salvato come tuo default per le nuove sessioni a meno che tu non premi s nel picker per un passaggio solo per la sessione. Un passaggio solo per la sessione persiste se la sessione viene riavviata.
Invia un subagent il cui frontmatter imposta un campo model.

Permission mode, model, and effort

Una sessione in background prende le sue impostazioni, provider, modalità di autorizzazione, modello e sforzo da dove e come l'hai inviata. Le sottosezioni di seguito coprono ogni fonte, e cosa persiste quando il supervisore riavvia la sessione.

Impostazioni e provider

Una sessione in background legge le sue impostazioni dalla directory in cui viene eseguita, come se avessi avviato claude lì. Questo include i valori env nelle impostazioni del progetto, quindi un ANTHROPIC_MODEL o una variabile del provider impostata lì si applica a ogni sessione in background in quella directory.

Una sessione in background viene anche eseguita con il PATH della shell da cui l'hai inviata, quindi i comandi che esegue trovano gli stessi strumenti del tuo terminale. Mantiene anche la selezione del cloud provider di quella shell, come CLAUDE_CODE_USE_BEDROCK o CLAUDE_CODE_USE_VERTEX, insieme ai suoi alias ANTHROPIC_DEFAULT_*_MODEL e qualsiasi override CLAUDE_CODE_EXTRA_BODY che hai esportato lì.

Gateway LLM

Se instrada Claude Code attraverso un gateway LLM, metti le variabili del gateway in un blocco env di un file di impostazioni piuttosto che esportarle nella tua shell, e le sessioni in background le leggono insieme al resto delle loro impostazioni. Imposta in un file di impostazioni mostra il blocco e quale file di impostazioni usare per la credenziale.

Se esporti un gateway ANTHROPIC_BASE_URL solo nella tua shell, raggiunge una sessione in background, insieme a ANTHROPIC_CUSTOM_HEADERS e la credenziale che hai esportato con esso, solo quando il supervisore stesso è stato avviato da una shell che ha esportato lo stesso gateway, e solo in questi casi:

Metti in background la tua sessione con ← o /background
Invii una sessione nella directory in cui sei
Svegli una sessione fermata nella directory in cui sei collegandoti o rispondendo ad essa

Claude Code inoltra un gateway davanti a un cloud provider. Se la shell da cui invii seleziona il provider ed esporta il suo endpoint del gateway con il suo flag di bypass dell'autenticazione, Claude Code inoltra la coppia endpoint-e-flag alla sessione nelle condizioni che si applicano a ANTHROPIC_BASE_URL, insieme a ANTHROPIC_CUSTOM_HEADERS. Ad esempio, esporta CLAUDE_CODE_USE_VERTEX=1 con ANTHROPIC_VERTEX_BASE_URL e CLAUDE_CODE_SKIP_VERTEX_AUTH=1, e Claude Code inoltra quell'endpoint e flag.

Claude Code applica un gateway inoltrato solo al processo in esecuzione di quella sessione e non lo scrive mai su disco.

Modalità di autorizzazione

La modalità di autorizzazione dipende da come hai avviato la sessione:

Messa in background con /bg o ←: Claude Code mantiene la modalità di autorizzazione in cui era la sessione, quindi una che hai cambiato in acceptEdits o auto rimane lì dopo il distacco
Inviata da un agent view che hai aperto con ←: la configurazione del target viene prima, e la modalità di autorizzazione della sessione da cui sei venuto si applica quando nulla altro ne imposta una
Inviata da claude agents avviato in una shell, o con claude --bg: la nuova sessione inizia come una nuova sessione claude in quella directory, a meno che non l'abbia inviata da un agent view che hai aperto con dispatch defaults. Quale modalità di autorizzazione una sessione inizia elenca l'ordine

Per una sessione che invii da un agent view aperto con ←, Claude Code prende la modalità di autorizzazione dal primo di questi che si applica:

La permissions.defaultMode della directory target. Due regole di origine si applicano:
- auto e bypassPermissions hanno effetto solo dalle impostazioni gestite, un file --settings, o ~/.claude/settings.json.
- Claude Code rifiuta un defaultMode dal .claude/settings.json o .claude/settings.local.json del progetto che seleziona una modalità più permissiva di quella in cui era la sessione da cui sei venuto.
La modalità di autorizzazione della sessione da cui sei venuto

Quando Claude Code rifiuta la modalità di una fonte come troppo permissiva, la fonte successiva nell'elenco decide. Ad esempio, se invii da una sessione in modalità piano in una directory le cui impostazioni controllate chiedono acceptEdits, la nuova sessione inizia in modalità piano. Se sposti quel defaultMode a ~/.claude/settings.json, si applica indipendentemente dalla modalità di autorizzazione della sessione da cui sei venuto.

La permissività corre piano, poi Manual e dontAsk, poi acceptEdits e auto, che ognuno conta come più permissivo dell'altro, poi bypassPermissions.

Dispatch defaults

Per impostare i default per ogni sessione che invii da agent view, passa uno qualsiasi di --permission-mode, --model, --effort, o --agent quando lo apri:

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

--effort qui accetta gli stessi valori del flag --effort di livello superiore, incluso ultracode.

--agent imposta il subagent utilizzato quando un prompt di dispatch non ne nomina uno, sia con @name che come prima parola. Per impostazione predefinita, utilizza l'impostazione agent se ne è impostata una, altrimenti l'agente catch-all integrato claude. Nominare un subagent nell'input di dispatch sovrascrive entrambi.

claude agents accetta anche --dangerously-skip-permissions come abbreviazione per --permission-mode bypassPermissions, e --allow-dangerously-skip-permissions per rendere bypassPermissions disponibile nel ciclo Shift+Tab di ogni sessione inviata senza avviare in quella modalità. Entrambi corrispondono ai flag CLI di livello superiore.

Passa --restricted per avviare ogni sessione che invii dalla vista in modalità ristretta, come se ognuna fosse lanciata con il flag di livello superiore --restricted. Richiede Claude Code v2.1.248 o successivo.

I default attivi appaiono nel footer sotto l'input di dispatch.

Claude Code rifiuta claude --bg --permission-mode bypassPermissions finché non hai accettato il disclaimer di bypass eseguendo claude --dangerously-skip-permissions una volta in modo interattivo, poiché quella modalità permette a una sessione che non stai guardando di agire senza approvazione. Passare --dangerously-skip-permissions o --permission-mode bypassPermissions a claude agents mostra lo stesso disclaimer quando non l'hai accettato prima, e accettare applica bypassPermissions alle sessioni che avvii dalla vista. Passare --allow-dangerously-skip-permissions mostra lo stesso disclaimer anche, e accettare rende bypassPermissions disponibile nel ciclo Shift+Tab di quelle sessioni senza avviarle in esso.

Cosa persiste attraverso i riavvii

La modalità di autorizzazione, il modello e lo sforzo che hai scelto per una sessione in background, insieme ai flag di configurazione che trasporta, persistono tutti quando il supervisore successivamente arresta e riavvia il processo della sessione. Una sessione che hai lanciato con claude --bg --dangerously-skip-permissions o claude --bg --permission-mode bypassPermissions rimane in bypassPermissions dopo quel riavvio. Un modello o sforzo che hai cambiato a metà sessione con /model o /effort viene mantenuto anche.

Se la sessione ha preso il suo sforzo dalle tue impostazioni piuttosto che da --effort o /effort, Claude Code legge di nuovo le tue impostazioni ogni volta che avvia un processo per la sessione. Dopo aver modificato lo sforzo salvato in settings.json, il cambiamento raggiunge le sessioni che metti in background con ← o /bg, e i loro successivi riavvii. Lo sforzo salvato è la chiave effortLevel o una voce modelSettings.

Claude Code mantiene anche un nome che hai impostato con /rename o Ctrl+R attraverso quel riavvio, quindi puoi ancora eseguire claude --resume <name> per raggiungere la sessione.

Un prompt che hai stashed con Ctrl+S mentre collegato viene mantenuto con la sessione anche. Riapri la sessione dopo che il suo processo è stato fermato o riavviato, e Ctrl+S ripristina il testo stashed. Il contenuto incollato nello stash non sopravvive al riavvio.

Impostazioni, plugin, e server MCP

Agent view accetta gli stessi flag di configurazione di claude per caricare impostazioni, plugin, server MCP, e directory aggiuntive. Agent view applica --settings e --plugin-dir a se stesso e passa ogni flag di configurazione alle sessioni che invii da esso, quindi un plugin o server MCP che carichi in questo modo è disponibile in quelle sessioni.

Flag	Effetto
`--settings <file-or-json>`	Sovrascrivi impostazioni per agent view e sessioni inviate
`--add-dir <path>`	Concedi accesso ai file a una directory aggiuntiva
`--plugin-dir <path>`	Carica un plugin da una directory locale
`--mcp-config <file-or-json>`	Carica server MCP da un file di configurazione o stringa JSON
`--strict-mcp-config`	Usa solo i server MCP da `--mcp-config`, ignorando altre configurazioni MCP. Vedi Controllo esclusivo con managed-mcp.json per cosa fa il flag sotto un file MCP gestito

Ripeti --add-dir, --plugin-dir, o --mcp-config una volta per valore. claude agents non supporta la forma separata da spazi, come --add-dir a b c.

Puoi mettere --settings e --plugin-dir prima o dopo agents. Mantieni --add-dir e --mcp-config dopo agents: se metti uno di questi prima di agents, claude agents --json fallisce con un errore unknown option.

L'esempio seguente apre agent view con un override di impostazioni e una directory extra:

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

--settings accetta un percorso di file o una stringa JSON inline. Un percorso di file deve puntare a un file esistente; Claude Code esce con un errore Settings file not found se non lo fa.

Gestire le sessioni dalla shell

Ogni sessione in background ha un ID breve che puoi usare dalla shell. L'ID viene stampato quando avvii una sessione con claude --bg, e l'ID di ogni sessione è il nome della sua directory sotto ~/.claude/jobs/. Questi comandi sono utili per lo scripting o quando non vuoi aprire agent view.

Comando	Scopo
`claude agents`	Apri agent view
`claude agents --cwd <path>`	Apri agent view limitato alle sessioni avviate sotto `<path>`
`claude agents --json`	Stampa le sessioni come un array JSON e esci. Vedi Elencare le sessioni come JSON
`claude attach <id>`	Collegati a una sessione in questo terminale
`claude logs <id>`	Stampa l'output recente della sessione
`claude stop <id>`	Ferma una sessione. Accetta anche `claude kill`
`claude respawn <id>`	Riavvia una sessione, in esecuzione o fermata, ad esempio per utilizzare un binario Claude Code aggiornato. La sessione riavviata riprende la sua conversazione salvata; quando nessuna è su disco, esegue di nuovo il suo prompt originale come una nuova conversazione
`claude respawn --all`	Riavvia ogni sessione in esecuzione, ad esempio per spostare tutte le sessioni su un binario Claude Code aggiornato contemporaneamente
`claude rm <id>`	Rimuovi una sessione dall'elenco, insieme a un worktree creato da Claude per essa quando è sicuro eliminarlo; vedi Cosa elimina l'eliminazione di una sessione. La trascrizione della conversazione rimane sulla tua macchina locale e rimane disponibile tramite `claude --resume`
`claude rm <id> --discard-unpushed <commit>@<worktree-id>`	Elimina una sessione il cui eliminazione è stata rifiutata a causa di commit non sottoposti a push, scartando il worktree insieme al suo ramo e ai commit. Passa il valore esatto che il rifiuto ha stampato; vedi Cosa elimina l'eliminazione di una sessione. Richiede v2.1.260 o successivo
`claude rm <id> --force-remove-worktree <worktree-id>`	Elimina una sessione il cui eliminazione è stata rifiutata perché git o l'hook `WorktreeRemove` non potevano rimuovere il suo worktree, eliminando comunque la directory del worktree e lasciando il suo ramo nel repository. Passa il valore esatto che il rifiuto ha stampato; vedi Cosa elimina l'eliminazione di una sessione. Richiede v2.1.268 o successivo
`claude daemon status`	Stampa lo stato del supervisore, la versione, la directory socket e il numero di worker
`claude daemon stop --any`	Ferma il processo supervisore e le sessioni in background che ospita. Passa `--keep-workers` per lasciare le sessioni in background in esecuzione in modo che il supervisore successivo si riconnetta ad esse. Il prossimo `claude agents` o `claude --bg` avvia un supervisore nuovo

Elencare le sessioni come JSON

claude agents --json stampa le sessioni attive come un array JSON e esci: ogni sessione live, più sessioni in background che stanno ancora lavorando o sono bloccate anche quando il loro processo è uscito. Aggiungi --all per includere anche le sessioni in background completate, e --cwd <path> per limitare l'elenco alle sessioni avviate sotto quella directory.

Ogni voce descrive una sessione:

Campo	Presente	Descrizione
`cwd`, `kind`, `startedAt`	Sempre	La directory di lavoro, `interactive` o `background`, e l'ora di inizio in millisecondi Unix
`id`	Sessioni in background	ID breve, utilizzabile con `claude attach`, `claude logs`, e `claude stop`
`state`	Sessioni in background	Uno di `working`, `blocked`, `done`, `failed`, o `stopped`. Vedi Leggere lo stato della sessione da uno script per sapere cosa significa ogni valore
`pid`, `status`	Mentre il processo è attivo	ID del processo e uno di `busy`, `waiting`, o `idle`
`waitingFor`	Quando `status` è `waiting`	Su cosa è bloccata la sessione: `permission prompt` per un'approvazione, `input needed` per una domanda da Claude o una richiesta di input da un server MCP, `sandbox request`, `worker request`, o `dialog open`
`sessionId`, `name`	Quando impostati	`sessionId` è l'UUID completo della sessione, utilizzabile con `claude --resume`. Il `name` di una sessione interattiva è il suo nome di visualizzazione predefinito finché non nomini la sessione o accetti un piano in essa

Leggere lo stato della sessione da uno script

claude agents --json è il modo supportato per leggere lo stato della sessione dall'esterno di Claude Code, ad esempio da una barra di stato, un pianificatore, o un'altra sessione Claude che supervisiona il lavoro in background. Esegui il polling di claude agents --json --all, che continua a elencare le sessioni il cui processo è uscito, e leggi state, status, e waitingFor di ogni voce.

`state`	Cosa significa
`working`	Un turno è in esecuzione, o la sessione è tra i passaggi del lavoro che guida da sola, come un'iterazione `/loop` o un'attesa su CI. `status` ti dice se il suo processo è `busy` in questo momento
`blocked`	La sessione è in attesa di te: una domanda che ha posto, una decisione di permesso o sandbox, un errore che solo tu puoi cancellare come un login scaduto, o il suo primo prompt se l'hai avviata senza uno. Quando l'attesa è un prompt aperto in un processo live, `waitingFor` lo nomina
`done`	L'ultimo turno ha finito quello che hai chiesto e la sessione è pronta per il tuo prossimo prompt, indipendentemente dal fatto che il suo processo sia ancora attivo o meno
`failed`, `stopped`	L'attività è terminata con un errore, o la sessione è stata fermata

Una sessione che ha finito il suo turno e sta aspettando la tua prossima istruzione legge done, non blocked. blocked significa sempre che la sessione ha bisogno di qualcosa da te prima di poter continuare.

I file sotto ~/.claude/jobs/<id>/ non sono un'interfaccia stabile. I valori che una sessione o un altro programma scrive in state, detail, tempo, o needs vengono sostituiti al prossimo aggiornamento.

Se vuoi che una sessione segnali il progresso con le sue stesse parole, falle scrivere un file proprio, ad esempio sotto $CLAUDE_JOB_DIR/tmp, invece di modificare state.json.

Come sono ospitate le sessioni in background

Claude Code tratta ogni sessione elencata nella vista agente come una sessione in background, indipendentemente dal fatto che tu sia attualmente collegato ad essa. Al contrario, una sessione avviata eseguendo claude direttamente è legata a quel terminale e termina quando si chiude, a meno che tu non la invii in background.

Per verificare quale tipo di sessione stai utilizzando, esegui /status. La riga Session kind legge background job · attached o background job · unattended in una sessione in background, a seconda che un terminale sia collegato, e interactive in qualsiasi altra sessione.

Il processo supervisor

Il supervisor è un servizio in background che esegue le tue sessioni in background in modo che continuino a funzionare dopo che chiudi la vista agente o il tuo terminale. Claude Code lo avvia la prima volta che metti una sessione in background o apri la vista agente, e non hai bisogno di gestirlo tu stesso.

Ogni sessione è il suo proprio processo Claude Code sotto il supervisor, e ciò che accade a quel processo dipende dallo stato della sessione:

In esecuzione, in pausa su un prompt di permesso o un'altra finestra di dialogo, o collegato: il processo continua a funzionare. Un subagente, workflow o monitor in esecuzione conta come in esecuzione.
Terminato o in attesa del tuo prossimo messaggio, e scollegato per circa un'ora: il supervisor ferma il processo per liberare risorse. Una sessione che ha terminato il suo turno chiedendoti una domanda conta come in attesa del tuo prossimo messaggio. La conversazione rimane su disco, e la prossima volta che ti colleghi o rispondi, la sessione riprende da dove l'ha lasciata. Fissa una sessione con Ctrl+T per mantenere il suo processo in esecuzione.
Uscito inaspettatamente mentre il supervisor è in esecuzione: il supervisor riavvia il processo. Terminare una sessione che hai messo in background tu stesso con ← o /background, ad esempio con kill, la contrassegna come fermata invece di riavviarla. Per le sessioni che sono terminate con un arresto, vedi Le sessioni vengono visualizzate come non riuscite o fermate dopo l'arresto.
Dopo un aggiornamento automatico: il supervisor riavvia se stesso sulla nuova versione e sposta le sessioni inattive in background. Le sessioni che sono in esecuzione, in attesa di te, o collegate non vengono interrotte.

Quando il processo di una sessione si ferma o si riavvia, i comandi shell in background, i workflow dinamici e i subagenti in background che Claude ha avviato in essa si trasferiscono al suo prossimo processo; i monitor in esecuzione e i comandi shell che un subagente ha avviato si fermano con il processo. L'eliminazione della sessione ferma tutto ciò che ha trasferito. Per fermare tutto con il processo invece, imposta CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF su 1.

Il supervisor e le sue sessioni si autenticano con le stesse credenziali archiviate delle tue sessioni interattive. Per quali impostazioni e variabili di shell raggiungono una sessione, incluso PATH, vedi Impostazioni e provider. Per gli endpoint del gateway, vedi Gateway LLM.

Dove lo stato è archiviato

Lo stato della sessione è archiviato sotto la tua directory di configurazione Claude Code. Se imposti CLAUDE_CONFIG_DIR, il supervisor usa quella directory invece di ~/.claude e viene eseguito come un'istanza separata con le sue proprie sessioni.

Percorso	Contenuti
`~/.claude/daemon.log`	Log del supervisor
`~/.claude/daemon/roster.json`	Elenco delle sessioni in background in esecuzione, usato per ricollegarsi dopo un riavvio
`~/.claude/jobs/<id>/state.json`	Stato per sessione mostrato in agent view. Leggilo attraverso `claude agents --json` invece di analizzare il file
`~/.claude/jobs/<id>/tmp/`	Directory di scratch per sessione. Le chiamate `Write` e `Edit` di Claude qui non richiedono il permesso. Rimossa quando la sessione viene eliminata

Ogni sessione in background ha la variabile di ambiente CLAUDE_JOB_DIR impostata sulla sua directory ~/.claude/jobs/<id>, quindi i comandi shell che la sessione esegue possono scrivere file temporanei su $CLAUDE_JOB_DIR/tmp senza collidere con sessioni parallele.

Per ispezionare questo stato senza leggere direttamente i file, esegui claude daemon status. Riporta se il supervisor è raggiungibile, il suo ID processo e versione, la directory socket, e quante sessioni in background sono attive.

Il comando avverte anche quando il supervisor in esecuzione è su una versione diversa da quella di claude che hai invocato, il che accade dopo un aggiornamento in cui il supervisor non si è ancora riavviato. L'avviso mostra entrambe le versioni e ti dice di eseguire claude daemon stop --any per raccogliere la nuova versione. Quando Claude Code è installato come servizio del sistema operativo, il comando suggerito è claude daemon stop senza il flag.

Le sessioni sopravvivono a quel mismatch di versione intatto: una versione più vecchia di Claude Code che aggiorna il file state.json di una sessione preserva i campi che non riconosce e mantiene la sessione elencata. L'elenco delle sessioni in roster.json segue la stessa regola, quindi le sessioni avviate dalla versione più nuova rimangono raggiungibili e continuano ad accettare input dopo il riavvio del supervisor.

Disattiva agent view

Per disattivare completamente gli agenti in background e agent view, imposta l'impostazione disableAgentView su true o imposta la variabile di ambiente CLAUDE_CODE_DISABLE_AGENT_VIEW. Gli amministratori possono applicare questo attraverso impostazioni gestite.

Troubleshooting

`claude agents` elenca subagenti invece di aprire agent view

Se claude agents stampa un conteggio seguito dai tuoi subagenti configurati e poi esce, agent view non è disponibile nel tuo ambiente. Esegui claude update per installare la versione più recente.

Se agent view ancora non si apre dopo l'aggiornamento, verifica se è stata disattivata da un'impostazione o da una variabile di ambiente.

Agent view si apre senza sessioni

Prima di inviare la tua prima sessione, agent view mostra le intestazioni di sezione vuote con una descrizione sotto ognuna, più una spiegazione su una riga sopra l'input, al posto dell'elenco delle sessioni. Digita un prompt nell'input in basso e premi Enter per inviare la tua prima sessione.

Lo spostamento in background mostra una finestra di dialogo `Background this session?`

Se premere ← per mettere in background la sessione corrente e Claude Code mostra una finestra di dialogo Background this session?, la sessione ha lavoro in corso che lo spostamento in background interromperebbe, riavvierebbe o lascerebbe in esecuzione incustodito, e Claude Code chiede prima di fare uno di questi:

Lavoro che non può trasferirsi: la sessione ha lavoro che non può trasferirsi alla sessione in background, come un monitor in esecuzione. La finestra di dialogo nomina il lavoro che Claude Code fermerebbe e, separatamente, conta i compiti che si trasferiscono.
Un workflow con subagenti in esecuzione: un dynamic workflow ha ancora subagenti in esecuzione. Il workflow stesso si trasferisce, ma i suoi subagenti in esecuzione si riavviano dall'inizio, e la finestra di dialogo dice quanti sono.
Risposte automatiche agli artefatti: Claude sta rispondendo ai commenti su un artefatto da solo. Quelle risposte continuano nella sessione in background, e la finestra di dialogo lo dice.

Esegui /tasks per vedere tutto ciò che è in esecuzione, quindi conferma per metterla in background comunque o scegli Stay per lasciare che il lavoro finisca prima. Vedi Cosa si trasferisce quando metti in background per sapere quali tipi di lavoro si trasferiscono e quali Claude Code ferma.

Prompt rifiutato come troppo breve

L'input di dispatch si aspetta una descrizione del compito, non un'apertura conversazionale. Un prompt più corto di quattro caratteri viene rifiutato con un suggerimento Too short in modo che una pressione accidentale non avvii una sessione. Descrivi cosa vuoi che la sessione faccia, come investigate the flaky checkout test.

Le sessioni mostrano come non riuscite o interrotte dopo lo spegnimento

Lo spegnimento o il riavvio della tua macchina interrompe le sessioni in background in esecuzione. Una sessione che era in attesa del tuo input rimane sotto Needs input quando torni. Per qualsiasi altra sessione in esecuzione, ciò che agent view mostra dipende da quanto tempo fa ha fatto progressi per l'ultima volta:

Entro 48 ore, la sessione mostra come non riuscita. Collegati o rispondi ad essa e si riavvia da dove l'ha lasciata.
Passate 48 ore, come dopo che la macchina è stata spenta per giorni, la sessione mostra come interrotta con ended while the background service was off. Premi Enter sulla riga e il footer mostra Press enter again to resume this session (it ended while the background service was off), or ctrl+x to delete it. Premi Enter sulla stessa riga di nuovo per riprendere la sua conversazione salvata. Una risposta, o claude attach <id>, la riprende senza quel prompt del footer.

Quando la pulizia della trascrizione ha rimosso la conversazione salvata di una sessione interrotta, Claude Code rifiuta di aprire la riga: il messaggio dice che non c'è nulla da riprendere. claude rm <id> elimina la riga, tranne nei casi mantenuti descritti sopra, e claude respawn <id> esegue di nuovo il suo prompt originale. Vedi La conversazione salvata di questa sessione non è più su disco.

Il sonno da solo non ferma le sessioni. Le sessioni vengono preservate durante il sonno e il supervisor si ricollega ad esse al risveglio.

L'apertura di una sessione dice che la conversazione è già aperta

Due processi non possono scrivere sulla stessa trascrizione. Quando la conversazione salvata di una sessione interrotta è già aperta in un altro processo Claude Code live, Claude Code rifiuta di avviare il processo della sessione. Ciò che vedi dipende da ciò che tiene la conversazione:

Un terminale dove hai ripreso la conversazione, ad esempio con claude --resume o /resume: la riga mostra Open in a terminal con un suggerimento per continuarla lì, e aprire la riga mostra Can't open — this session is running in another terminal. Continua in quel terminale, o esci da esso e apri di nuovo la riga.
Un altro processo Claude Code non interattivo, ad esempio un processo di sessione in background per la stessa conversazione che non è ancora uscito: aprire la riga mostra This conversation is already open in another running Claude session. Usa quel processo, o aspetta che esca e apri di nuovo la riga.

Claude Code salva una risposta che hai digitato con il tentativo rifiutato e la invia la prossima volta che la sessione si avvia.

L'apertura di una sessione dice che non ha trascrizione salvata

Una sessione interrotta che è stata messa in background da un'altra conversazione e interrotta prima che la sua prima risposta finisse non ha nulla da riprendere: fino a quando quella prima risposta non finisce, la conversazione vive ancora solo nella sessione da cui è stata messa in background. claude attach rifiuta di aprirla con This session has no saved transcript.

In agent view, aprire quella riga mostra Press enter again to restart this session fresh sotto l'elenco. Premi Enter sulla stessa riga di nuovo per riavviare la sessione con una conversazione vuota, o esegui claude respawn <id> dalla shell.

La conversazione originale è intatta; riprendi con claude --resume o continua a lavorarci. Vedi il riferimento degli errori per i dettagli.

L'host del terminale è morto o la sessione ha smesso di rispondere

Il supervisor esegue il terminale di ogni sessione in background nel suo processo host separato. Quando quel processo muore o smette di rispondere, Claude Code mostra il motivo e offre un riavvio; in entrambi i casi la conversazione è salvata e il riavvio la riprende. Il riferimento degli errori cita i messaggi completi.

Claude Code non riavvia mai una riga che esegue un comando shell, da Enter o da claude attach, perché ciò eseguirebbe di nuovo il comando; il messaggio della riga e claude attach entrambi dicono che il comando non viene eseguito di nuovo.

L'host del terminale è morto

Su Linux e WSL, il supervisor controlla ogni processo host ogni pochi secondi, indipendentemente dal fatto che apri la sessione o meno, e contrassegna la sessione come non riuscita quando il processo è uscito ma la sua connessione al supervisor non si è mai chiusa.

In agent view, la riga mostra terminal host process died — press Enter to restart. Premi Enter su di essa e Claude Code riavvia la sessione su un processo host fresco.
Dalla shell, claude attach <id> riavvia una sessione già contrassegnata come non riuscita. Altrimenti segnala la causa e esce, dicendoti di eseguire claude attach <id> di nuovo.

La sessione non sta rispondendo

Quando il supervisor accetta un'apertura ma nessun output arriva per circa dieci secondi, Claude Code termina il tentativo e offre un riavvio. Una sessione che semplicemente si è bloccata, ad esempio durante il sonno della macchina, non raggiunge questa offerta: il supervisor la riavvia all'apertura stesso.

In agent view, il footer mostra Press enter again to restart this session — it isn't responding (its conversation is saved and resumes). Premi Enter sulla stessa riga di nuovo e Claude Code ferma il processo che non risponde e riavvia la sessione; non ferma nulla senza quel secondo press.
Dalla shell, claude attach <id> segnala la causa e esce, dicendoti di eseguire claude stop <id>, poi claude attach <id>.

Una sessione non riesce prima di iniziare con una nota `possibly low memory`

Quando il processo di una sessione in background esce prima di finire l'avvio e l'host ha poca memoria, lo stato della riga nomina l'uscita e aggiunge possibly low memory — free some up and retry.

La nota è un'ipotesi, non una causa confermata. Claude Code la aggiunge solo quando il processo è uscito silenziosamente, senza scrivere un errore e senza essere fermato da un segnale, e l'host ha segnalato poca memoria in quel momento. Quando il processo ha scritto un errore prima di uscire, la riga mostra invece quell'errore.

Libera memoria sulla macchina, quindi collegati o rispondi alla riga e il supervisor avvia un processo fresco per la sessione. Quando la memoria rimane bassa, il supervisor ferma anche le sessioni inattive per liberare risorse da solo, e ferma anche le sessioni fissate inattive se fermare le altre non ha liberato nulla.

Agent view dice che il servizio in background non ha risposto

Se il collegamento, il peek, o claude logs segnala che il servizio in background non ha risposto, il processo supervisor ha probabilmente subito un blocco. Fermalo e lascia che il prossimo claude agents avvii uno nuovo. Per mantenere le tue sessioni in background in esecuzione durante il riavvio, passa --keep-workers:

claude daemon stop --any --keep-workers

Il nuovo supervisor si ricollega alle sessioni in esecuzione. Senza --keep-workers, il comando termina anche le sessioni in background. Il flag --any conferma che desideri fermare un supervisor che è stato avviato su richiesta piuttosto che come servizio installato, che è l'impostazione predefinita.

Un supervisor che si avvia ma non riesce ad accettare connessioni esce e rilascia il suo blocco da solo, quindi il prossimo claude agents avvia uno nuovo senza questo arresto manuale. I passaggi precedenti si applicano quando un supervisor in esecuzione subisce un blocco.

Se il comando invece esce dicendo che il processo registrato non potrebbe essere verificato come il supervisor, controlla l'ID del processo segnalato: se è un supervisor che possiedi, fermalo tu stesso, quindi elimina ~/.claude/daemon.lock in modo che il prossimo claude agents si avvii fresco.

Su Windows, se il supervisor non risponde alla richiesta di arresto, il comando stampa il suo ID di processo. Termina quel processo con taskkill /PID <pid> per completare il recupero. Le sessioni in background vengono comunque preservate quando hai passato --keep-workers.

Dispatch non riesce con `Could not resolve authentication method`

Se un dispatch in background non riesce con Could not resolve authentication method mentre le sessioni interattive si autenticano normalmente, il worker che ha ricevuto il dispatch non ha raccolto le credenziali. Le sessioni in background ottengono le loro credenziali dal supervisor, quindi questo errore significa che nessuna credenziale memorizzata era disponibile per il processo supervisor stesso. Conferma di aver eseguito /login o di aver configurato una chiave API, quindi ferma il supervisor:

claude daemon stop --any --keep-workers

Il prossimo claude agents o claude --bg avvia un supervisor fresco che legge le tue credenziali memorizzate. Se ti autentichi con una variabile di ambiente come ANTHROPIC_API_KEY piuttosto che con /login, esegui quel comando successivo da una shell dove la variabile è impostata.

Vedi il riferimento degli errori per l'elenco completo delle cause e delle correzioni.

Le sessioni in background non riescono a leggere Desktop, Documents o Downloads su macOS

Su macOS, l'host della sessione in background viene eseguito come processo separato e richiede l'accesso alle cartelle protette separatamente dal tuo terminale. Se una sessione in background segnala Operation not permitted durante la lettura di ~/Desktop, ~/Documents, ~/Downloads, o un'altra posizione protetta, concedi l'accesso in Impostazioni di Sistema sotto Privacy e Sicurezza > File e Cartelle, o abilita Accesso Completo al Disco per la voce.

Con il programma di installazione nativo, la voce appare come Claude Code e la concessione persiste tra gli aggiornamenti. Con altri metodi di installazione come Homebrew o npm, la voce mostra il percorso del binario e potrebbe dover essere concessa di nuovo dopo l'aggiornamento.

Le sessioni in background non riescono a raggiungere host della rete locale su macOS

Su macOS 15 e versioni successive, il sistema blocca un processo dal raggiungimento di dispositivi sulla tua rete locale finché non concedi il permesso di Rete Locale, quindi un comando che mira a un indirizzo LAN può non riuscire con connect: no route to host in una sessione in background anche se funziona in un terminale in primo piano. Il primo comando in una sessione in background che si connette a un indirizzo della rete locale attiva il prompt di permesso di Rete Locale di macOS per Claude Code. Concedilo una volta e quei comandi raggiungono gli host LAN nello stesso modo in cui lo fanno in un terminale in primo piano.

Una sessione è lenta a rispondere dopo il collegamento

Quando una sessione che ha finito o è in attesa del tuo prossimo messaggio rimane scollega per circa un'ora, il supervisor ferma il suo processo per liberare risorse. Il collegamento avvia un processo fresco da dove l'ha lasciato e passa alla sessione immediatamente mentre il processo si riavvia. Le sessioni che stanno lavorando, in pausa su un prompt di permesso o un'altra finestra di dialogo, o fissate non sono fermate in questo modo, quindi fissa una sessione con Ctrl+T per mantenerla reattiva.

Mentre il processo si avvia, Claude Code mostra la coda della trascrizione della sessione formattata nel modo in cui la sessione live la rende, con markdown, blocchi di codice evidenziati e chiamate di strumenti come righe attenuate, sopra un'area di prompt attenuata con una nota Session is starting. La sessione live la sostituisce non appena è pronta.

`.claude/worktrees/` si sta riempiendo

L'eliminazione di una sessione in agent view rimuove il worktree che Claude ha creato per essa, ma alcuni elimina mantengono il worktree o lasciano la sua directory su disco, quindi le directory rimaste possono accumularsi. Le directory che git non riconosce più non appaiono in git worktree list, quindi rimuovile a mano.

Elenca le voci rimaste con git worktree list nella directory del progetto e rimuovi ognuna con git worktree remove <path>. Vedi Pulisci i worktrees.

Limitazioni

Agent view è un'anteprima di ricerca con le seguenti limitazioni:

I limiti di velocità si applicano: le sessioni in background consumano l'utilizzo dell'abbonamento allo stesso modo delle sessioni interattive, quindi eseguire dieci agenti in parallelo utilizza la quota approssimativamente dieci volte più velocemente rispetto all'esecuzione di uno.
Le sessioni sono locali: le sessioni in background vengono eseguite sulla vostra macchina. Vengono preservate durante la sospensione ma si fermano se la macchina si spegne.
I worktrees creati da Claude vengono eliminati con la sessione in agent view: unite i cambiamenti prima di eliminare una sessione che ha modificato file nel suo proprio worktree. Alcuni eliminazioni mantengono il worktree.

Per altri modi di eseguire Claude in parallelo, e per passare i risultati tra le sessioni che esegui, vedi:

Esegui agenti in parallelo: confronta agent view con subagenti, team di agenti e worktrees
Messaggistica tra sessioni: fai in modo che le tue sessioni si passino i risultati l'una con l'altra
Team di agenti: coordina più sessioni che si messaggiano l'una con l'altra
Claude Code on the web: esegui sessioni in un ambiente cloud gestito invece che localmente

Cronologia delle versioni

Agent view si è evoluto rapidamente durante l'anteprima di ricerca. Se sei su una versione più vecchia di Claude Code, alcuni comportamenti su questa pagina potrebbero differire; in particolare, claude agents rifiuta i flag che non supporta ancora con un errore di opzione sconosciuta. La tabella sottostante elenca quando ogni flag e comportamento è stato aggiunto.

Versione	Cambiamento
v2.1.268	Quando un delete è rifiutato perché git o il tuo hook `WorktreeRemove` non poteva rimuovere il worktree, il messaggio nomina la causa, incluso come un hook è terminato e l'inizio del suo stderr. Per un worktree collegato sotto la directory `.claude/worktrees/` del repository senza modifiche non sottoposte a commit ai file tracciati, nessun repository annidato al suo interno, e nessun record di un'altra sessione che lo nomina, eliminare di nuovo la sessione rimuove comunque la directory, dalla vista agente o con `claude rm <id> --force-remove-worktree <worktree-id>`. Prima di questa versione, la riga mostrava solo `worktree could not be removed (WorktreeRemove hook failed)` o l'errore di git, lo stderr dell'hook andava solo al log di debug, e eliminare di nuovo era rifiutato allo stesso modo.
v2.1.260	Quando metti in background una sessione, l'elenco agente delle tue altre sessioni mostra la conversazione una volta, come sua sessione in background, e i loro messaggi ad essa non raggiungono più il terminale da cui l'hai spostata. Prima di questa versione, quel terminale poteva rimanere elencato come una seconda sessione interattiva sotto il nome della conversazione, e una sessione che aveva inviato un messaggio alla conversazione prima dello spostamento continuava a consegnare a quel terminale.
v2.1.260	Quando un delete è rifiutato su commit non spinti, il messaggio nomina il ramo del worktree e quanti commit non sono spinti, e eliminare di nuovo la sessione scarta il worktree e i suoi commit. Prima di questa versione, il rifiuto diceva solo `worktree has commits that are not pushed anywhere`, eliminare di nuovo era rifiutato allo stesso modo, e eliminare la sessione richiedeva di spingere i commit o rimuovere il worktree manualmente.
v2.1.257	`←` si stacca da una sessione collegata mentre l'overlay `/btw` è aperto, anche a metà risposta, e l'overlay si riapre quando ti colleghi di nuovo. Prima di questa versione, `←` non si staccava mentre l'overlay era aperto.
v2.1.257	Quando esegui `claude --resume <session-id> --bg`, Claude Code continua quella sessione con il suo ID proprio, o avvia una copia con un nuovo ID e stampa una riga `note:` che spiega il motivo. `--continue`, un `--resume` nudo, e `--resume` con un nome o percorso avviano una copia con la stessa nota. Prima di questa versione, `--resume` con `--bg` avviava sempre una copia con un nuovo ID e non diceva nulla.
v2.1.257	Quando invii una sessione da una vista agente che hai aperto con `←`, Claude Code l'avvia in la modalità di permesso che la directory di destinazione configura attraverso `permissions.defaultMode`. Quando la directory non ne imposta una, si applica la modalità di permesso della sessione da cui provieni. Prima di questa versione, la sessione inviata avviava sempre nella modalità di permesso della sessione da cui provieni, sovrascrivendola.
v2.1.257	`Ctrl+S`, `Ctrl+T`, e `Ctrl+G` in agent view seguono le tue `keybindings.json`: `Ctrl+S` e `Ctrl+T` attraverso le azioni `agents:switchView` e `agents:togglePin` del contesto `Agents`, e `Ctrl+G` attraverso il binding `chat:externalEditor` del contesto `Chat`. Prima di questa versione, agent view ignorava `keybindings.json` e questi tasti erano fissi.
v2.1.257	Avviare il servizio in background si recupera da due cause di fallimento. Su un'installazione npm macOS, un avvio durante un auto-aggiornamento attende l'installazione invece di eseguire il placeholder che npm mette giù mentre sostituisce il binario. Su Windows, un `daemon.lock` stantio scritto prima dell'ultimo avvio della macchina, o il cui ID processo registrato ora appartiene a un processo diverso, viene sostituito. Prima di questa versione, l'avvio macOS falliva con `Error: claude native binary not installed.` durante la finestra di installazione, e il lock Windows faceva fallire ogni avvio con `exited before it became reachable` finché non eliminavi `~/.claude/daemon.lock`.
v2.1.257	Quando apri o invii una sessione in background mentre un altro processo Claude Code sta scaricando un aggiornamento npm, Claude Code continua ad attendere fino a due minuti mentre l'installazione viene eseguita, quindi fallisce dicendo `Claude Code is being updated by npm on this machine`. Prima di questa versione, l'attesa si fermava a dieci secondi, quindi l'apertura falliva con `Couldn't start the background service` mentre il download era ancora in corso.
v2.1.257	Una sessione in background che tiene un messaggio tra sessioni per la tua approvazione mostra `approve message from` sulla sua riga `Needs input`, con l'indirizzo del mittente e il nome che il mittente dichiara. Prima di questa versione, la riga si spostava a `Needs input` ma manteneva il suo testo precedente, quindi nulla in `claude agents` nominava il messaggio in attesa o il suo mittente.
v2.1.257	Un prompt nascosto con `Ctrl+S` dentro una sessione in background aperta viene mantenuto con la sessione, quindi `Ctrl+S` lo ripristina dopo che il processo della sessione viene fermato e riavviato. Prima di questa versione, il nascondiglio viveva solo nel processo in esecuzione e veniva perso quando la sessione rimaneva inattiva abbastanza a lungo da far fermare il suo processo, o quando veniva fermata e poi riaperta.
v2.1.251	In una sessione in background che non ha spostato in un worktree, Claude e i subagent che genera possono modificare file all'interno di un worktree git collegato.
v2.1.251	Claude Code inoltra un gateway del provider cloud esportato nella shell da cui invii, come `ANTHROPIC_VERTEX_BASE_URL` o `ANTHROPIC_BEDROCK_BASE_URL` con il suo flag di bypass dell'autenticazione, al worker della sessione nelle stesse condizioni di `ANTHROPIC_BASE_URL`. Prima di questa versione, se mettevi in background o inviavi da una shell autenticata solo attraverso tale gateway, ogni richiesta che la sessione faceva falliva, perché l'endpoint e il flag venivano eliminati dal suo ambiente.
v2.1.251	Quando una sessione in background si avvia mentre un altro processo Claude Code sta aggiornando un marketplace di plugin, come una sessione fratello che esegue l'auto-aggiornamento del marketplace, Claude Code mantiene disponibili i plugin di quel marketplace. Prima di questa versione, tale sessione poteva avviarsi senza nessuna delle skill, agenti, hook e server MCP di quel marketplace e rimanere così per tutta la sua esecuzione.
v2.1.248	`Shift+Enter` nell'input di dispatch inserisce una nuova riga, corrispondendo al prompt principale, e `Ctrl+Enter` invia e si collega immediatamente nei terminali dove l'overlay `?` elenca `ctrl+enter to start and open`. Prima di questa versione, `Shift+Enter` inviava e si collegava.
v2.1.248	Eliminare una sessione ha successo quando i commit del worktree sono già sulla copia locale del ramo predefinito del tuo remote `origin` e il tuo checkout principale ha quel ramo estratto; prima di questa versione, il delete era rifiutato con `has commits that are not pushed anywhere`.
v2.1.248	Una sessione messa in background con `←` o `/background` tiene il `git worktree lock` sul suo worktree mentre viene eseguita; prima di questa versione, mettere in background rilasciava il lock, e la pulizia o `git worktree remove` poteva rimuovere il worktree sotto la sessione in esecuzione.
v2.1.248	Una sessione in background che non era in attesa del tuo input e viene trovata morta più di 48 ore dopo la sua ultima attività, come dopo che la macchina era spenta per giorni, mostra come fermata con `ended while the background service was off`, e `Enter` su di essa chiede prima di riprendere la sua conversazione salvata. Prima di questa versione, tale sessione riappariva come un fallimento fresco ordinato in cima all'elenco, e un singolo `Enter` tirava la conversazione di settimane fa in primo piano.
v2.1.248	Aprire una riga fermata la cui conversazione hai ripreso in un altro terminale è rifiutato con `Can't open — this session is running in another terminal`, e la riga mostra `Open in a terminal` invece di mostrare sotto `Working`. Prima di questa versione, aprire la riga avviava un secondo processo che scriveva nella stessa conversazione.
v2.1.248	Una sessione in background in attesa di una decisione di permesso mentre un hook `PermissionRequest` o `PreToolUse` ha stampato una risposta non valida nomina l'evento dell'hook e l'errore dello schema sulla sua riga. Prima di questa versione, la riga mostrava solo la richiesta in sospeso.
v2.1.248	Su Windows, `claude agents` risponde alla tastiera quando lanciato in una scheda di terminale che un programma precedente ha lasciato in win32-input-mode. Prima di questa versione, Claude Code non decodificava i record di tasti che tale scheda invia.
v2.1.247	Su Linux e WSL, una sessione il cui processo host del terminale è morto fallisce entro pochi secondi con il motivo. Un'apertura che non produce output termina dopo circa dieci secondi con un'offerta di riavvio, e `Enter` sulla riga riavvia la sessione con la sua conversazione; `claude attach <id>` segnala la causa e esce. Prima di questa versione, aprire tale sessione mostrava `opening… · esc to cancel` indefinitamente e `claude attach <id>` attendeva senza segnalare un errore.
v2.1.246	Su un'installazione npm, quando il servizio in background non riesce ad avviarsi mentre `npm install -g @anthropic-ai/claude-code` sta sostituendo il binario, Claude Code attende fino a dieci secondi affinché l'installazione finisca e riprova prima di segnalare `EACCES: permission denied`.
v2.1.246	Quando il processo del servizio in background muore dopo aver stampato un errore, Claude Code segnala il fallimento e cita la prima riga di errore del servizio.
v2.1.246	Se la tua macchina si addormenta mentre il servizio in background si sta avviando, Claude Code riprova l'avvio una volta invece di fallire.
v2.1.246	Claude Code attende circa due minuti invece di 45 secondi per un servizio in background appena avviato che è vivo ma lento ad accettare connessioni.
v2.1.246	Il servizio in background si avvia dalla tua directory home, quindi su macOS e Linux una directory di avvio che è stata eliminata o spostata non blocca più l'avvio.
v2.1.246	`/fork` copia la conversazione completa da una sessione che stessa è stata avviata come copia e non ha registrato un nuovo prompt da allora: una copia `/fork` a cui ti sei collegato, una sessione ricollegata dopo che `←` o `/background` l'ha spostata in background, o una sessione avviata con `claude --resume <id> --fork-session`. Prima di questa versione, se eseguivi `/fork` in tale sessione prima di inviarle un nuovo prompt, Claude Code stampava la conferma normale ma avviava la copia con una conversazione vuota. Spostare tale sessione in background con `←` o `/background` perdeva la conversazione allo stesso modo.
v2.1.246	Quando apri una sessione che hai appena inviato mentre il suo processo worker si sta ancora avviando, come premendo `Enter` sulla sua riga, Claude Code attende il processo e poi si collega. Prima di questa versione, se premevi `Enter` mentre il processo si stava ancora avviando, Claude Code poteva fermare la sessione con `Session <id> was stopped while the respawn was in flight`.
v2.1.246	Quando metti in background una sessione denominata, Claude Code la elenca una volta, e quando metti in background la stessa conversazione di nuovo, numera il nome della nuova riga, come `my-session (2)`, con la riga esistente che mantiene il suo nome. Prima di questa versione, il terminale in cui hai premuto `←` poteva apparire in `claude agents --json` come una seconda sessione con lo stesso nome, e se mettevi in background la stessa conversazione di nuovo, Claude Code aggiungeva un'altra riga con il nome identico.
v2.1.239	Con modalità editor vim attiva, premere `Esc` nell'input di agent view passa da INSERT a NORMAL mode e mantiene il tuo testo, corrispondendo al prompt principale; in NORMAL mode con testo ancora nell'input, premere `Esc` lo cancella, e premere `Esc` su un input vuoto esce, come la scorciatoia `Esc` descrive. Prima di questa versione, `Esc` cancellava l'input.
v2.1.233	Per una sessione collegata a una merge request di GitLab, Claude Code scrive l'etichetta della riga nella sintassi di riferimento `!1234` di GitLab. Puoi anche incollare l'URL della merge request nell'input di dispatch per selezionare quella sessione. Prima di questa versione, l'etichetta veniva resa come `#1234`, e un URL di merge request incollato corrispondeva a una sessione solo quando il suo primo prompt conteneva l'URL.
v2.1.227	Eliminare una sessione mantiene la sessione e il suo worktree mentre un'altra sessione Claude Code live è in esecuzione all'interno di quella directory worktree. Agent view mostra `not deleted` sulla riga e il motivo nel footer, e `claude rm` stampa `kept <id>` con il motivo, che nomina l'ID processo dell'altra sessione. Prima di questa versione, eliminare la sessione rimuoveva il worktree mentre l'altra sessione stava ancora lavorando in esso.
v2.1.225	`claude agents` in una directory che non hai fiducia mostra lo stesso dialogo di fiducia dell'area di lavoro che `claude` mostra all'avvio, prima che agent view si apra. Accettare salva la fiducia per quell'area di lavoro; rifiutare esce senza aprire agent view. Prima di questa versione, `claude agents` si apriva senza chiedere, quindi le sessioni che inviavi da essa venivano eseguite in una directory di cui non ti era mai stato chiesto di fidarti. Con l'elenco raggruppato per directory, passare il mouse su una riga la evidenzia senza cambiare il target di dispatch; selezionare una riga con i tasti freccia o un clic cambia ancora il target. Prima di questa versione, spostare il mouse su una sessione in un altro progetto cambiava silenziosamente la directory in cui la prossima sessione inviata si avviava.
v2.1.221	`/status` mostra una riga `Session kind`: `background job · attached` o `background job · unattended` in una sessione in background, a seconda che un terminale sia collegato, e `interactive` in qualsiasi altra sessione. Prima di questa versione, `/status` non segnalava il tipo di sessione. `/fork`: Claude Code istruisce la copia di isolare il suo lavoro da quello della sessione originale: la copia crea un worktree proprio prima di apportare modifiche al codice, rimane fuori dal worktree della sessione originale, e basa un nuovo ramo su quello della sessione originale quando il suo compito si basa su quel lavoro. Vedi la sezione collegata per le condizioni esatte. Prima di questa versione, la copia non riceveva alcuna istruzione di isolamento e poteva finire per modificare il worktree o estrarre il checkout su cui la sessione originale stava ancora lavorando. Con modalità editor vim attiva, premere `←` subito dopo aver annullato il prompt tornando a vuoto con `u` chiede la stessa conferma di eliminare il testo o spostarsi nella cronologia dei prompt, e passa solo alla seconda pressione; prima di questa versione la pressione passava immediatamente.
v2.1.219	Con modalità editor vim attiva, premere `←` su un prompt vuoto apre agent view da NORMAL mode così come INSERT, e il suggerimento `←` del footer mostra in NORMAL mode; prima di questa versione il gesto e il suggerimento erano solo INSERT, e in NORMAL mode `←` su un prompt vuoto non faceva nulla. Digitare nell'input mentre Claude Code attende di mettere in background la sessione annulla il passaggio con `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.` quindi una bozza digitata non viene persa.
v2.1.218	Premere `←` entro due secondi da un'eliminazione che ha svuotato il prompt, o da uno spostamento nella cronologia dei prompt, mostra `Press ← again to open agents`, o `Press ← again to go back to agents` in una sessione collegata, e passa solo alla seconda pressione almeno un secondo dopo; prima di questa versione la pressione passava immediatamente. Un `←` che arriva all'interno di input incollato o scritto non attiva più il passaggio. Mettere in background una sessione in primo piano con `←` mostra `Your conversation moved to the background` sopra l'elenco, e `Esc` alla radice di agent view ritorna a quella conversazione invece di uscire alla shell, con doppio `Ctrl+C` che rimane l'uscita; se la conversazione non può essere riaperta, Claude Code esce e stampa un comando `claude --resume` per essa. Su Windows, un `←` premuto entro circa mezzo secondo dal collegamento mostra `Ambiguous ←, press again to detach` e si stacca alla seconda pressione.
v2.1.217	Il badge della pull request sulla riga di una sessione viene reso come un collegamento ipertestuale anche quando Claude Code non riesce a rilevare il supporto del collegamento ipertestuale del terminale, ad esempio su SSH o tmux; imposta `FORCE_HYPERLINK=0` per renderlo come testo semplice. Prima di questa versione, il badge veniva reso come testo semplice quando il supporto non era rilevato.
v2.1.216	`/fork`: la conferma è una riga, mostrando lo stato della copia, il nome della sua riga di agent-view, e il suo ID sessione per `claude attach`, terminando con `runs in the origin tree` o `edits this checkout` solo quando la copia viene eseguita nell'albero di lavoro principale o modifica il checkout che hai aperto. Fare clic sul nome mette in background questa sessione e apre agent view nella sessione della copia. La conferma non ripete più la modalità di permesso ereditata della copia; le versioni precedenti stampavano una conferma multi-riga senza nome cliccabile. Needs input: `/install-github-app` e l'elenco delle impostazioni `/mcp`, eseguiti mentre nessuno è collegato, mostrano la sessione sotto `Needs input` con una riga che nomina il comando, e collegarsi e rieseguire il comando continua; da v2.1.208 a v2.1.215 erano rifiutati completamente in quello stato. `--agent` restore: riprendere o riavviare una sessione `--agent` messa in background ripristina il prompt di sistema dell'agente e le restrizioni degli strumenti, cercando prima la directory propria della sessione per l'agente, quando l'area di lavoro è fidata; una sessione il cui agente non esiste più continua con gli strumenti predefiniti e il prompt di sistema e si apre con un avviso visibile, invece di ripristinare silenziosamente l'agente predefinito. `Ctrl+X`: premendolo due volte elimina una sessione anche quando il tentativo di arresto fallisce, invece di un arresto fallito che annulla il delete in sospeso, e una sessione eliminata il cui processo worker era morto non riappare più al prossimo aggiornamento. Worktree deletion: una sessione il cui directory worktree non appartiene a nessun repository git può essere eliminata; prima di questa versione ogni tentativo di eliminare tale sessione era rifiutato. Una directory che è già scomparsa si cancella immediatamente. La doppia pressione di agent view rimuove una directory che ha ancora file, eseguendo il tuo hook `WorktreeRemove` per una directory creata da hook, a meno che un'altra sessione non la rivendichi anche. `claude rm` mantiene tale directory ogni volta che rimangono file.
v2.1.214	Una sessione messa in background con `←` o `/background` e lasciata inattiva senza nulla in esecuzione ha il suo processo fermato come qualsiasi altra sessione inattiva, invece di mantenere il suo processo e il servizio in background in esecuzione indefinitamente. Una sessione completata può essere rimossa con `claude rm` o da agent view dopo che il servizio in background è diventato inattivo, e una sessione che è entrata in un worktree dopo essere stata inviata da una directory che non è un repository git, come una cartella di area di lavoro multi-repo, può essere eliminata da agent view quando il worktree stesso appartiene a un repository git, perché la pulizia viene risolta dal worktree invece che dalla directory da cui la sessione è stata inviata; entrambe le rimozioni erano rifiutate ad ogni tentativo prima. Riaprire una sessione fermata ripristina la sua conversazione salvata anche quando una cartella nell'archivio delle trascrizioni non può essere letta.
v2.1.213	`/install-github-app`, l'elenco delle impostazioni `/mcp`, e le azioni di autenticazione MCP funzionano in una sessione in background mentre un terminale è collegato, e sono rifiutate solo quando nessuno è collegato, con un messaggio che ti dice di collegarti e rieseguire il comando; da v2.1.208 a v2.1.212 erano rifiutate anche con un terminale collegato.
v2.1.212	`/fork` in una sessione interattiva copia la conversazione in una nuova sessione in background che appare come sua propria riga, denominata dopo la sessione da cui proviene o, per un fork richiesto di una sessione senza nome, dopo il prompt di fork, mentre l'originale continua a funzionare; il comportamento precedente di fork-subagent di `/fork` si è spostato a `/subtask`. Con agent view disattivato, `/fork` mantiene il comportamento di fork-subagent. Una riga focalizzata che è in attesa del suo primo prompt mostra `space to send it a prompt`. `Ctrl+J` inserisce una nuova riga nell'input di dispatch su terminali con segnalazione di tasti estesa, dove la pressione del tasto era precedentemente ignorata, e l'overlay `?` elenca la scorciatoia. Il suggerimento del footer `←` in una sessione interattiva mostra brevemente `N done` quando una sessione in background finisce mentre nessuna ha bisogno del tuo input. Digitare un `/resume` nudo in agent view apre un picker di sessioni passate del repository da cui hai aperto agent view, incluse le sessioni eliminate dall'elenco, e sceglierne una la riprende come sessione in background; prima di questa versione `/resume` non era disponibile in agent view e le sessioni eliminate erano raggiungibili solo con `claude --resume` o `/resume` da una sessione interattiva. I moduli mirati, scoped e ristretti mantengono il suggerimento `attach to a session to run it` che le versioni precedenti mostravano per ogni modulo. Le sessioni in attesa di un prompt di rete-host sandbox, una richiesta di input MCP, o un prompt di impostazioni gestite mostrano come `Needs input` invece di `Working`, in agent view e in `claude agents --json`, e una domanda da Claude segnala `waitingFor: input needed` invece di `permission prompt`. Collegarsi a una sessione il cui processo si è fermato mostra la sua trascrizione formattata nel modo in cui la sessione live la rende, invece che come testo grezzo. Una sessione fermata la cui trascrizione è in un posto inaspettato riprende da essa tramite una scansione di ultimo ricorso delle tue trascrizioni salvate, e aprire una riga che non ha trascrizione salvata mostra `Press enter again to restart this session fresh`, riavviandola da zero alla seconda pressione; v2.1.211 mostrava il rifiuto senza modo di riavviare da agent view.
v2.1.211	Svegliare una sessione fermata collegandosi o rispondendo dalla directory in cui viene eseguita inoltra di nuovo il gateway `ANTHROPIC_BASE_URL` della tua shell, nelle stesse condizioni di un dispatch fresco, quindi una sessione autenticata attraverso un gateway `ANTHROPIC_AUTH_TOKEN` riprende sul gateway invece di segnalare `Not logged in`. Collegarsi a una sessione fermata che è stata messa in background da un'altra conversazione prima che la sua prima risposta finisse è rifiutato con `This session has no saved transcript` invece di avviare silenziosamente una conversazione vuota con lo stesso session id; aprire la stessa riga da agent view mostrava il rifiuto nel footer. Terminare il processo di una sessione `←` o `/background` da fuori Claude Code la contrassegna come fermata invece che il supervisor la riavvia, un arresto già registrato su disco è onorato a meno che una risposta che hai inviato sia ancora in attesa di essere consegnata, una sessione riavviata dopo un crash le viene detto che è stata riavviata, e una sessione `←` o `/background` riavviata non riprende una risposta interrotta più vecchia di circa un'ora. Una risposta di denominazione della sessione che risponde o rifiuta il prompt invece di etichettarlo, come per un prompt che è principalmente un link, viene scartata e la riga mantiene un nome preso dal testo del prompt. Eliminare una sessione il cui git worktree non riconosce più ha successo, lasciando la directory worktree su disco e nominando il suo percorso, invece che ogni tentativo sia rifiutato. Un delete rifiutato mostra il motivo sulla riga della sessione, incluso l'errore git sottostante quando il worktree non poteva essere rimosso, invece che la riga riappaia silenziosamente.
v2.1.210	`claude attach` attende mentre il servizio in background si sta avviando o riconnettendo invece di fallire con un errore `job not found` o `still starting`, segnala una sessione che è terminata durante il collegamento come uscita, e applica un ridimensionamento del terminale fatto durante un collegamento lento quando il collegamento si completa. Il conteggio `←` needs-input del footer del prompt appare su ogni provider, inclusi i provider di terze parti che precedentemente mostravano il modulo `← for agents` semplice. Mettere in background una sessione con `←` trasporta l'elenco dei compiti di Claude alla sessione in background invece di scartarlo. La riga su cui hai premuto `←` mantiene un nome in grassetto, non attenuato dopo che la selezione si sposta. `claude agents --effort` accetta `ultracode` invece di scartarlo silenziosamente.
v2.1.208	Collegarsi a una sessione il cui processo si è fermato mostra l'ultimo schermo pieno della sua trascrizione mentre il processo si avvia, invece di solo una nota `Session is starting`. Una risposta che non può essere consegnata perché il servizio in background non è raggiungibile o l'invio fallisce viene salvata e inviata come prompt successivo della sessione quando il suo processo si avvia di nuovo; prima di questa versione, una risposta persa mentre il servizio in background non era raggiungibile veniva scartata. Un processo il cui binario è stato sostituito da un aggiornamento può comunque avviare il supervisor, dal launcher `claude` installato o dalla versione più recente su disco, invece di fallire fino al riavvio di Claude Code. Un supervisor che esegue una versione più vecchia non riavvia mai una sessione inattiva avviata da una versione più nuova sul suo binario più vecchio. L'eliminazione di una sessione rimuove il suo worktree anche dopo che la sessione ha spostato il worktree su un ramo diverso, e mantiene il worktree insieme alla riga della sessione quando il worktree ha commit che non sono stati spinti da nessuna parte o un'altra sessione lo rivendica, invece di distruggere i commit o lasciare il worktree orfano. `/install-github-app` e l'elenco delle impostazioni `/mcp` e le sue azioni di autenticazione vengono rifiutate in una sessione in background con un messaggio che nomina l'alternativa; solo in v2.1.208, il picker `/model` è stato rifiutato allo stesso modo e un `/model <name>` digitato ha cambiato solo quella sessione invece di salvare anche il tuo modello predefinito.
v2.1.207	Il pannello peek si apre con la frase che la riga tronca, come la domanda esatta per una sessione che ti sta aspettando, e mostra quanto a lungo una sessione bloccata è stata in attesa come una singola riga `waiting 3m` invece di anteporre lo stesso timestamp alla frase di stato e alla domanda. Incollare di nuovo lo stesso testo nell'input di dispatch espande il placeholder `[Pasted text #N]` compresso invece di aggiungerne un secondo. Una sessione in background denominata accettando un piano mostra quel nome sulla sua riga. Una sessione in background che si è spostata in un worktree mantiene la sua conversazione quando il suo processo viene riavviato dalla vista agente.
v2.1.206	I riassunti delle righe riempiono la larghezza rimanente della riga e si troncano solo al bordo destro del terminale invece che a 64 colonne. Dopo che il supervisor si riavvia in una nuova versione di Claude Code, riavvia le restanti sessioni in background inattive su quella versione in background invece di poche al minuto. L'eliminazione di una sessione con `Ctrl+X` o `claude rm` la cancella anche dall'elenco delle sessioni del supervisor, quindi la riga non riappare più dopo un riavvio del supervisor. Un override del corpo della richiesta `CLAUDE_CODE_EXTRA_BODY` esportato nella shell di dispatching raggiunge le sessioni in background invece di essere ignorato.
v2.1.205	Il suggerimento `←` del footer del prompt in una sessione `claude` regolare conta gli agenti in background in attesa di te, come `← 2 agents`. I riassunti delle righe mostrano il rapporto di una riga della sessione, troncato a 64 colonne, invece di una raw tool invocation o un conteggio `done/total`; le righe raggruppate per directory si aprono con una parola di stato colorata. Il pannello peek si apre con la frase di stato completa e, per una sessione in attesa di te, la sua domanda esatta sopra l'input di risposta. Le sessioni che modificano, commentano, chiudono, o contrassegnano una pull request come pronta con `gh` sono collegate ad essa, non solo quelle che creano o controllano una pull request, un push collega una pull request anche quando il nome del ramo locale non corrisponde, e una pull request il cui output del comando di creazione ha superato il limite inline è collegata anche. Un turno senza testo leggibile mantiene lo stato precedente della sessione invece di capovolgere di nuovo a `Working`. `claude attach` attende fino a circa 60 secondi una sessione che si sta riavviando, con una riga di stato che nomina il motivo, invece di fallire.
v2.1.203	Un gateway `ANTHROPIC_BASE_URL` esportato nella shell di dispatching raggiunge le sessioni inviate da essa nella stessa directory quando il supervisor condivide quel gateway environment, invece di essere scartato mentre la chiave API esportata insieme ad esso veniva mantenuta. Il `PATH` della shell di dispatching viene applicato a ogni worker della sessione. Premere `←` mentre i subagent sono in esecuzione attende che finiscano invece di riavviarli dopo dieci secondi. L'elenco vuoto mostra sempre le intestazioni della sezione con una descrizione sotto ciascuna. Digitare `@` nell'input di dispatch elenca anche i git worktrees registrati del repository di avvio che si trovano all'interno del suo albero di directory. Uno sforzo ereditato dall'impostazione `effortLevel` segue i successivi edit a quell'impostazione invece di essere fissato al dispatch. Aprire una sessione fermata la cui conversazione è già aperta in un'altra sessione in esecuzione viene rifiutato con un messaggio invece di far fallire la riga. Un comando che non è disponibile in agent view lascia il testo digitato nell'input. Un hook `WorktreeCreate` che fallisce al di fuori di un repository git non blocca più la sessione dall'editing dei file.
v2.1.202	Un nome impostato con `/rename` o `Ctrl+R` su una sessione in background persiste quando il supervisor arresta e riavvia il suo processo, invece di ripristinare il nome con cui la sessione è stata inviata.
v2.1.200	Una versione più vecchia di Claude Code che riscrive l'elenco delle sessioni in `roster.json` preserva i campi scritti da una versione più nuova, corrispondendo alla garanzia `state.json` esistente, quindi le sessioni avviate dalla versione più nuova continuano ad accettare input dopo il riavvio del supervisor. Quando apri una sessione che ha smesso di rispondere, il supervisor riavvia il suo processo e la sessione continua la risposta interrotta da dove si era fermata. Agent view applica un flag `--plugin-dir` posizionato dopo `agents` al suo proprio subagent e skill autocomplete nell'input di dispatch così come alle sessioni inviate.
v2.1.199	Una sessione in background il cui processo esce prima di finire l'avvio su un host con poca memoria mostra `possibly low memory — free some up and retry` nello stato della sua riga invece di solo il motivo dell'uscita nudo. Mettere in background una sessione con `←` o `/background` trasporta il suo `/color` alla nuova riga.
v2.1.198	Agent view invia una notifica attraverso `preferredNotifChannel` quando una sessione in background ha bisogno di input, finisce, o fallisce, e attiva l'hook `Notification` con il tipo `agent_needs_input` o `agent_completed`. `←` e `/exit` dentro `claude attach <id>` ritornano a agent view invece di uscire alla shell; `Ctrl+Z` ritorna alla shell. Una sessione in background che ha isolato il suo lavoro in un worktree esegue il commit, spinge il suo ramo isolato proprio, mai `main` o `master`, e apre una pull request in bozza quando finisce invece di chiedere prima. `/login` viene eseguito in agent view e apre la finestra di dialogo di accesso. La finestra di dialogo di uscita `Background work is running` offre `Move to background and exit`. Il trasferimento di uscita copre anche i subagent in background, che riprendono dal loro transcript al prossimo risveglio invece di essere segnalati come falliti. `claude --bg` combinato con `-p` o `--print` viene rifiutato con un errore. L'host della sessione in background richiede il permesso di rete locale macOS al primo accesso LAN invece di fallire con `connect: no route to host`.
v2.1.196	Una singola pressione di `←` mette in background una sessione in primo piano; le versioni precedenti richiedevano due pressioni, con un suggerimento nel footer e una conferma. `--dangerously-skip-permissions` passato a `claude agents` mostra il disclaimer di bypass invece di essere silenziosamente scartato. Le sessioni interattive che non hai mai nominato portano un nome predefinito come `my-app-3f` negli elenchi di sessioni e `claude agents --json`. I comandi shell in background e i workflow dinamici sopravvivono al processo della sessione che viene fermato, riavviato, o aggiornato, incluso su Windows; imposta `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` per disattivare il trasferimento. Un transcript frainteso come vuoto al riavvio viene rinominato con un suffisso `.orphaned-` invece di essere eliminato.
v2.1.195	Il lavoro in corso si trasferisce anche quando metti in background una sessione su Windows; imposta `CLAUDE_DISABLE_ADOPT=1` per fermarlo invece. Il gruppo `Completed` riempie lo spazio verticale rimanente e l'intestazione si compatta su terminali corti. Una versione più vecchia di Claude Code non scarta più i campi `state.json` delle sessioni più nuove o nasconde quelle sessioni da `claude agents`. Il collegamento a una sessione fermata passa immediatamente invece di mostrare una schermata vuota per fino a cinque secondi. Un supervisor che non riesce ad accettare connessioni esce e rilascia il suo blocco da solo.
v2.1.191	`claude --bg` con un nome `--agent` che non corrisponde a nessuno dei tuoi subagent fallisce il lancio: la sessione esce immediatamente con un errore `--agent '<name>' not found` invece di eseguire con l'agente predefinito.
v2.1.174	Le sessioni in background non ereditano più variabili di endpoint gateway come `ANTHROPIC_BASE_URL` dalla shell di avvio del supervisor; il supervisor fornisce uno snapshot di credenziali fresco ai worker pre-riscaldati, correggendo gli errori spurii di `Could not resolve authentication method`.
v2.1.172	`/model` nell'input di dispatch imposta un override del modello di dispatch con ambito di sessione.
v2.1.161	I riassunti delle righe mostrano un conteggio `done/total` per elementi di lavoro paralleli; il pannello peek nomina l'elemento di lavoro parallelo che sta girando più a lungo.
v2.1.157	`claude agents` accetta `--agent`; le sessioni inviate rispettano l'impostazione `agent`.
v2.1.145	Dettatura vocale supportata nell'input di risposta del pannello peek e nell'input di dispatch.
v2.1.143	Impostazione `worktree.bgIsolation` aggiunta; `claude agents` accetta `--allow-dangerously-skip-permissions`.
v2.1.142	`claude agents` accetta `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions`, `--settings`, `--add-dir`, `--plugin-dir`, `--mcp-config`, e `--strict-mcp-config`.
v2.1.141	`claude agents` accetta `--cwd` per limitare l'elenco a un progetto.
v2.1.139	Agent view introdotto come anteprima di ricerca.

agent-view.md +450 −170

19Per confrontare agent view con subagenti, team di agenti e worktrees, vedi [Esegui agenti in parallelo](/docs/it/agents).19Per confrontare agent view con subagenti, team di agenti e worktrees, vedi [Esegui agenti in parallelo](/docs/it/agents).

20 20

21<Note>21<Note>

22 Agent view è in anteprima di ricerca e richiede Claude Code v2.1.139 o successivo. Controlla la tua versione con `claude --version`. L'interfaccia e le scorciatoie da tastiera potrebbero cambiare mentre la funzione si evolve.22 Agent view è in anteprima di ricerca. L'interfaccia e le scorciatoie da tastiera potrebbero cambiare mentre la funzione si evolve.

23</Note>23</Note>

24 24

~~25Questa pagina copre:~~

~~27* [Avvio rapido](#quick-start): dai a Claude un compito su cui lavorare in background, controlla come sta andando e intervieni quando necessario~~

~~28* [Monitorare le sessioni con agent view](#monitor-sessions-with-agent-view), inclusi icone di stato, peek e reply, collegamento, organizzazione e scorciatoie da tastiera~~

~~29* [Invia nuovi agenti](#dispatch-new-agents) da agent view, da dentro una sessione, o dalla tua shell~~

~~30* [Gestire le sessioni dalla shell](#manage-sessions-from-the-shell) con `claude agents`, `claude attach` e comandi correlati~~

~~31* [Come sono ospitate le sessioni in background](#how-background-sessions-are-hosted) dal processo supervisor~~

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

34 Avvio rapido26 Avvio rapido

35</h2>27</h2>

44 claude agents36 claude agents

45 ```37 ```

46 38

47 Agent view si apre con un input in basso e una tabella che si riempie quando le sessioni iniziano. Premi `Esc` in qualsiasi momento per tornare alla tua shell. Le tue sessioni continuano a funzionare mentre sei via e riappaiono la prossima volta che apri agent view.39 Se non hai ancora accettato la [finestra di dialogo di fiducia dell'area di lavoro](/docs/it/permissions#project-allow-rules-and-workspace-trust) per la directory, Claude Code la mostra prima che agent view si apra, la stessa finestra di dialogo che mostra `claude`. Accetta per salvare la fiducia per l'area di lavoro e continua. Se rifiuti, Claude Code esce senza aprire agent view.

41 Agent view si apre con un input in basso e una tabella che si riempie quando le sessioni iniziano. Premi `Esc` per tornare alla tua shell; se hai aperto agent view mettendo in background una sessione con `←`, `Esc` ritorna a quella conversazione invece. Le tue sessioni continuano a funzionare mentre sei via e riappaiono la prossima volta che apri agent view.

48 </Step>42 </Step>

49 43

50 <Step title="Invia una sessione">44 <Step title="Invia una sessione">

51 Digita un prompt che descrive un'attività e premi `Enter`. Una nuova sessione in background inizia su quell'attività e appare come una riga che mostra se sta lavorando, aspettando te, o è completata. La nuova sessione utilizza il modello mostrato nell'intestazione di agent view e la stessa [modalità di autorizzazione](#permission-mode-model-and-effort) che otterresti eseguendo `claude` in quella directory.45 Digita un prompt che descrive un'attività e premi `Enter`. Una nuova sessione in background inizia su quell'attività e appare come una riga che mostra se sta lavorando, aspettando te, o è completata. La nuova sessione utilizza il modello mostrato nell'intestazione di agent view. [La modalità di autorizzazione in cui inizia](#permission-mode-model-and-effort) dipende da come hai aperto agent view.

52 46

53 Ogni prompt che inserisci qui avvia la sua propria nuova sessione. Digitando un altro prompt e premendo `Enter` avvia una seconda sessione accanto alla prima piuttosto che inviare un follow-up ad essa. Puoi eseguire diversi in parallelo in questo modo.47 Ogni prompt che inserisci qui avvia la sua propria nuova sessione. Digitando un altro prompt e premendo `Enter` avvia una seconda sessione accanto alla prima piuttosto che inviare un follow-up ad essa. Puoi eseguire diversi in parallelo in questo modo.

54 48

64 </Step>58 </Step>

65 59

66 <Step title="Porta una sessione esistente dentro">60 <Step title="Porta una sessione esistente dentro">

67 Per spostare una sessione che hai già aperta in agent view, esegui `/bg` dentro di essa, o premi `←` su un prompt vuoto per metterla in background e aprire agent view in un unico passaggio. La sessione continua a funzionare e appare come una riga accanto a quelle che hai inviato.61 Questo passaggio richiede una sessione in esecuzione. Se hai seguito i passaggi precedenti non ne hai una aperta in questo terminale, quindi apri una sessione `claude` regolare in un altro terminale e invia prima un messaggio.

63 Per spostare una sessione che hai già aperta in agent view, esegui `/bg` dentro di essa, o premi `←` su un prompt vuoto per metterla in background e aprire agent view in un unico passaggio. In una sessione nuova senza messaggi ancora, `/bg` ti chiede di inviare prima un messaggio, mentre `←` funziona subito. La sessione continua a funzionare e appare come una riga accanto a quelle che hai inviato.

68 </Step>64 </Step>

69</Steps>65</Steps>

70 66

71Puoi usare `claude agents` come tuo punto di ingresso principale invece di `claude`: invia ogni attività da agent view, collegati quando vuoi la conversazione completa, e premi `←` per tornare alla tabella.67Puoi usare `claude agents` come tuo punto di ingresso principale invece di `claude`: invia ogni attività da agent view, collegati quando vuoi la conversazione completa, e premi `←` per tornare alla tabella.

72 68

73All'interno di una sessione `claude` regolare, l'hint `←` del footer del prompt conta gli agenti in background che stanno aspettando te, come `← 2 agents`, e ritorna a `← for agents` quando nessuno ha bisogno di input. I conteggi superiori a 99 vengono visualizzati come `99+`. Il conteggio si aggiorna circa ogni dieci secondi mentre il terminale è focalizzato e immediatamente quando il focus ritorna. Cambia brevemente colore quando si sposta e quando un agente si completa, a meno che l'impostazione [`prefersReducedMotion`](/docs/it/settings#available-settings) sia attiva, ed è nascosto in [modalità screen reader](/docs/it/accessibility). Su [Amazon Bedrock, Google Cloud's Agent Platform, e Microsoft Foundry](/docs/it/third-party-integrations), l'hint rimane nella sua forma semplice `← for agents` senza il conteggio. Richiede Claude Code v2.1.205 o successivo.69All'interno di una sessione `claude` regolare, l'hint `←` del footer del prompt conta gli agenti in background che stanno aspettando te, come `← 2 agents`, e ritorna a `← for agents` quando nessuno ha bisogno di input. I conteggi superiori a 99 vengono visualizzati come `99+`. Il conteggio si aggiorna circa ogni dieci secondi mentre il terminale è focalizzato e immediatamente quando il focus ritorna. Cambia brevemente colore quando si sposta e quando un agente si completa, e quando una sessione in background si completa mentre nessuno ha bisogno del tuo input mostra brevemente il numero completato, come `← 2 done`. Entrambi i flash sono disattivati quando l'impostazione [`prefersReducedMotion`](/docs/it/settings-reference#prefersreducedmotion) è attiva, e l'hint è nascosto in [modalità screen reader](/docs/it/accessibility).

74 70

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

76 Monitorare le sessioni con agent view72 Monitorare le sessioni con agent view

78 74

79Esegui `claude agents` per aprire agent view. Prende il controllo del terminale completo ed elenca ogni sessione raggruppata per stato, con sessioni fissate e quelle che hanno bisogno di te in cima. Ogni riga mostra il nome della sessione, l'attività corrente e la sua età, contata da quando la sessione è stata creata; l'età di una sessione terminata si congela a quanto tempo ha impiegato l'esecuzione.75Esegui `claude agents` per aprire agent view. Prende il controllo del terminale completo ed elenca ogni sessione raggruppata per stato, con sessioni fissate e quelle che hanno bisogno di te in cima. Ogni riga mostra il nome della sessione, l'attività corrente e la sua età, contata da quando la sessione è stata creata; l'età di una sessione terminata si congela a quanto tempo ha impiegato l'esecuzione.

80 76

81Il nome è tinto con il colore impostato da [`/color`](/docs/it/commands) in quella sessione. A partire da v2.1.199 il colore si trasporta quando [metti in background una sessione](#from-inside-a-session) con `←` o `/background`.77Il nome è tinto con il colore impostato da [`/color`](/docs/it/commands) in quella sessione, incluso quando [metti in background una sessione](#from-inside-a-session) con `←` o `/background`.

82 78

83Per impostazione predefinita, l'elenco mostra ogni sessione in background che hai avviato, in tutti i tuoi progetti. Una sessione che lavora in un repository e un'altra in un worktree diverso appaiono entrambe qui, indipendentemente da quale directory hai aperto agent view. Per limitare l'elenco a un progetto, passa `--cwd`:79Per impostazione predefinita, l'elenco mostra ogni sessione in background che hai avviato, in tutti i tuoi progetti. Una sessione che lavora in un repository e un'altra in un worktree diverso appaiono entrambe qui, indipendentemente da quale directory hai aperto agent view. Per limitare l'elenco a un progetto, passa `--cwd`:

84 80

117Ogni riga inizia con un'icona il cui colore e animazione mostrano lo stato della sessione:113Ogni riga inizia con un'icona il cui colore e animazione mostrano lo stato della sessione:

118 114

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

122| Needs input | Giallo | Claude sta aspettando una domanda specifica o una decisione di permesso da te |118| Needs input | Giallo | Claude sta aspettando qualcosa che solo tu puoi fornire: una risposta a una domanda, una decisione di permesso, o un altro prompt solo tu puoi rispondere, come un prompt [sandbox](/docs/it/sandboxing) per consentire un host di rete o una [richiesta di input](/docs/it/mcp#respond-to-mcp-elicitation-requests) di un server MCP. Un comando che ha bisogno di un terminale collegato, come `/install-github-app` o l'elenco delle impostazioni `/mcp`, [tiene una sessione incustodita qui anche](#attach-to-a-session) |

126| Stopped | Grigio | La sessione è stata fermata con `Ctrl+X` o `claude stop` |122| Stopped | Grigio | La sessione è stata fermata con `Ctrl+X` o `claude stop`, [il suo processo è stato terminato da fuori Claude Code](#the-supervisor-process), o [è terminato mentre il servizio in background era spento](#sessions-show-as-failed-after-shutdown) |

127 123

128Separatamente, la forma dell'icona mostra se il processo sottostante è in esecuzione:124Separatamente, la forma dell'icona mostra se il processo sottostante è in esecuzione:

129 125

130| Forma | Cosa significa |126| Forma | Cosa significa |

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

133| `∙` | Il processo è uscito. Puoi ancora fare peek, rispondere o collegarti, e Claude riavvia da dove l'ha lasciato |129| `∙` | Il processo è uscito. Puoi ancora fare peek, e quando rispondi o ti colleghi, Claude riavvia da dove l'ha lasciato |

134| `✢` | Una sessione [`/loop`](/docs/it/scheduled-tasks) che dorme tra le iterazioni. La riga mostra il conteggio delle esecuzioni e un conto alla rovescia |130| `✢` | Una sessione [`/loop`](/docs/it/scheduled-tasks) che dorme tra le iterazioni. La riga mostra il conteggio delle esecuzioni e un conto alla rovescia |

135 131

136L'etichetta `#N` che può apparire al bordo destro di una riga è una [pull request che la sessione è collegata a](#pull-request-status), non parte dell'icona di stato.132L'etichetta `#N` o `!N` che può apparire al bordo destro di una riga è un collegamento alla [pull request o merge request](#pull-request-status) della sessione, non parte dell'icona di stato.

137 133

138Il titolo della scheda del terminale mostra il conteggio awaiting-input mentre agent view è aperto: `2 awaiting input · claude agents` quando le sessioni hanno bisogno di input, o `claude agents` quando nessuna lo fa.134Il titolo della scheda del terminale mostra il conteggio awaiting-input mentre agent view è aperto: `2 awaiting input · claude agents` quando le sessioni hanno bisogno di input, o `claude agents` quando nessuna lo fa.

139 135

140A partire da v2.1.198, mentre agent view è aperto, Claude Code invia anche una notifica attraverso il tuo [canale di notifica del terminale](/docs/it/terminal-config#get-a-terminal-bell-or-notification) configurato quando una sessione in background locale inizia ad aver bisogno del tuo input, finisce, o fallisce. Le sessioni che vengono eseguite secondo una pianificazione, come le sessioni [`/loop`](/docs/it/scheduled-tasks), notificano solo quando hanno bisogno del tuo input. Le notifiche utilizzano la stessa impostazione [`preferredNotifChannel`](/docs/it/settings#available-settings) del resto di Claude Code e attivano l'hook [`Notification`](/docs/it/hooks#notification) con il tipo `agent_needs_input` o `agent_completed`.136Per leggere lo stato della sessione da uno script o un altro programma, usa [`claude agents --json`](#read-session-state-from-a-script) piuttosto che i file sotto `~/.claude/jobs/`.

137

138Mentre agent view è aperto, Claude Code invia anche una notifica attraverso il tuo [canale di notifica del terminale](/docs/it/terminal-config#get-a-terminal-bell-or-notification) configurato quando una sessione in background locale inizia ad aver bisogno del tuo input, finisce, o fallisce. Le sessioni che vengono eseguite secondo una pianificazione, come le sessioni [`/loop`](/docs/it/scheduled-tasks), notificano solo quando hanno bisogno del tuo input. Le notifiche utilizzano la stessa impostazione [`preferredNotifChannel`](/docs/it/settings-reference#preferrednotifchannel) del resto di Claude Code e attivano l'hook [`Notification`](/docs/it/hooks#notification) con il tipo `agent_needs_input` o `agent_completed`.

141 139

142Le sessioni in background non hanno bisogno di alcun terminale aperto per continuare a lavorare. Un [processo supervisor](#the-supervisor-process) separato le esegue, quindi puoi chiudere agent view, chiudere la tua shell, o avviare una nuova sessione interattiva e il tuo lavoro inviato continua.140Le sessioni in background non hanno bisogno di alcun terminale aperto per continuare a lavorare. Un [processo supervisor](#the-supervisor-process) separato le esegue, quindi puoi chiudere agent view, chiudere la tua shell, o avviare una nuova sessione interattiva e il tuo lavoro inviato continua.

143 141

144Lo stato della sessione persiste su disco attraverso gli auto-update e i riavvii del supervisor. Le sessioni sono anche preservate quando la tua macchina dorme. I loro processi riprendono al risveglio e il supervisor si ricollega a loro invece di trattare il gap di tempo come inattività. Lo spegnimento ferma comunque le sessioni in esecuzione; vedi [Le sessioni mostrano come non riuscite dopo lo spegnimento](#sessions-show-as-failed-after-shutdown) per come recuperarle.142Lo stato della sessione persiste su disco attraverso gli auto-update e i riavvii del supervisor. Le sessioni sono anche preservate quando la tua macchina dorme. I loro processi riprendono al risveglio e il supervisor si ricollega a loro invece di trattare il gap di tempo come inattività. Lo spegnimento ferma comunque le sessioni in esecuzione; vedi [Le sessioni mostrano come non riuscite o fermate dopo lo spegnimento](#sessions-show-as-failed-after-shutdown) per come recuperarle.

145 143

146Quando apri una sessione che ha smesso di rispondere, il supervisor riavvia il suo processo e la sessione continua la risposta interrotta da dove l'ha lasciata. Una sessione può finire in quello stato quando la macchina dorme mentre è a metà risposta. Richiede Claude Code v2.1.200 o successivo.144Una sessione che era a metà risposta quando la macchina ha dormito può tornare non responsiva. Quando apri una sessione che ha smesso di rispondere, il supervisor riavvia il suo processo e la sessione continua la risposta interrotta da dove l'ha lasciata.

147 145

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

149 Riassunti delle righe147 Riassunti delle righe

151 149

152Il riassunto su una riga è generato da un [modello di classe Haiku](/docs/it/model-config) in modo che la riga possa dirti cosa sta facendo la sessione, cosa ha bisogno, o cosa ha prodotto senza aprire il transcript. Mentre una sessione sta attivamente lavorando, il testo della riga si aggiorna al massimo una volta ogni 15 secondi dall'output recente della sessione stessa senza inviare una richiesta di modello, e il modello scrive un riassunto fresco quando ogni turno termina.150Il riassunto su una riga è generato da un [modello di classe Haiku](/docs/it/model-config) in modo che la riga possa dirti cosa sta facendo la sessione, cosa ha bisogno, o cosa ha prodotto senza aprire il transcript. Mentre una sessione sta attivamente lavorando, il testo della riga si aggiorna al massimo una volta ogni 15 secondi dall'output recente della sessione stessa senza inviare una richiesta di modello, e il modello scrive un riassunto fresco quando ogni turno termina.

153 151

154Una riga di lavoro mostra cosa la sessione dice che sta facendo, e una riga bloccata mostra la domanda che sta ponendo. Durante un turno lungo, il modello riscrive anche il riassunto circa una volta al minuto, aspettando il doppio dopo ogni riscrittura fino a quattro minuti, quindi una riga occupata non continua a mostrare un riassunto obsoleto. Prima di v2.1.205, una riga di lavoro potrebbe mostrare un'invocazione di strumento grezzo invece di un rapporto, e una sessione che esegue elementi di lavoro paralleli mostrava un conteggio `done/total` come `2/5` prima del testo.152Una riga di lavoro mostra cosa la sessione dice che sta facendo, e una riga bloccata mostra la domanda che sta ponendo. Durante un turno lungo, il modello riscrive anche il riassunto ogni pochi minuti in modo che una riga occupata non continui a mostrare un riassunto obsoleto. Il testo di riepilogo riempie la larghezza rimanente della riga; apri il [pannello peek](#peek-and-reply) per leggere una frase che il bordo del terminale taglia.

155 153

156Il testo di riepilogo riempie la larghezza rimanente della riga e si tronca solo al bordo destro del terminale; apri il [pannello peek](#peek-and-reply) per leggere una frase che il bordo taglia. Prima di v2.1.206, il testo era tagliato a 64 colonne indipendentemente dalla larghezza del terminale.154Quando l'elenco è [raggruppato per directory](#organize-the-list), il riassunto si apre con lo stato della sessione come una parola colorata, come `Needs input · double jump or wall climb?`. Nel raggruppamento di stato predefinito, l'intestazione del gruppo nomina già lo stato, quindi la riga mostra solo il riassunto.

157 155

158Quando l'elenco è [raggruppato per directory](#organize-the-list), il riassunto si apre con lo stato della sessione come una parola colorata, come `Needs input · double jump or wall climb?`. Nel raggruppamento di stato predefinito, l'intestazione del gruppo nomina già lo stato, quindi la riga mostra solo il riassunto. Prima di v2.1.205, le righe raggruppate per directory non portavano alcuna parola di stato.156Il riassunto di fine turno e ogni riscrittura a metà turno sono una breve richiesta di classe Haiku attraverso il tuo provider normale, fatturata e gestita secondo gli stessi [termini di utilizzo dei dati](/docs/it/data-usage) della sessione stessa. Gli aggiornamenti di 15 secondi tra le riscritture del modello riutilizzano l'output della sessione stessa e non inviano una richiesta. Su un provider di terze parti o gateway senza un modello Haiku configurato, la richiesta utilizza il modello principale della sessione; imposta [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/docs/it/model-config#environment-variables) per sceglierne uno.

~~159~~

160Un turno il cui intero output non contiene lettere o cifre, come una sessione [`/loop`](/docs/it/scheduled-tasks) che stampa un simbolo solitario su un'iterazione tranquilla, mantiene il riassunto e lo stato precedenti della riga. Prima di v2.1.205, quel turno è stato riclassificato e potrebbe capovolgere una sessione che stava aspettando il tuo input di nuovo a `Working`.

~~161~~

162Il riassunto di fine turno e ogni riscrittura a metà turno sono una breve richiesta di classe Haiku attraverso il tuo provider normale, fatturata e gestita secondo gli stessi [termini di utilizzo dei dati](/docs/it/data-usage) della sessione stessa. Gli aggiornamenti di 15 secondi tra le riscritture del modello riutilizzano l'output della sessione stessa e non inviano una richiesta. Su provider di terze parti come Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e gateway personalizzati, la richiesta ritorna al modello principale della sessione quando nessun modello Haiku è configurato. Imposta [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/docs/it/model-config#environment-variables) per scegliere il modello per questi riassunti su quei provider.

163 157

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

165 Stato della pull request159 Stato della pull request

166</h3>160</h3>

167 161

168Quando una sessione apre una pull request, un'etichetta `#1234` appare al bordo destro della riga, collegata alla pull request nei terminali che supportano i hyperlink. L'etichetta persiste quando invii un follow-up alla sessione, quindi la pull request rimane visibile mentre la riga ritorna al progresso live. Le sessioni in background che hanno isolato i loro cambiamenti in un worktree aprono queste pull request da sole; [Come i file edits sono isolati](#how-file-edits-are-isolated) copre quando accade e cosa una sessione non fa mai senza chiedere.162Quando una sessione [apre una pull request](#how-file-edits-are-isolated), Claude Code aggiunge un'etichetta al bordo destro della riga, collegata alla pull request:

169 163

170Una sessione che lavora su una pull request esistente è collegata a essa allo stesso modo. Modificare, commentare, chiudere, o contrassegnare una pull request come pronta con `gh` collega la pull request che l'output del comando stesso nomina, quindi un comando `gh` il cui output catturato non nomina alcuna pull request non crea un collegamento; `gh pr merge` è il caso comune, perché stampa il suo risultato solo su un terminale interattivo. Controllare una pull request con `gh pr checkout`, o eseguire il push su un ramo che ha una pull request aperta, la collega cercando quel ramo con `gh pr view` invece. Prima di v2.1.205, solo le pull request che la sessione ha creato o controllato erano collegate, e un push ne collegava una solo quando il nome del ramo locale corrispondeva.164* Claude Code scrive l'etichetta come `#1234` per una pull request e come `!1234` per una merge request di GitLab.

165* Claude Code emette il collegamento anche quando non riesce a rilevare il supporto dei hyperlink, ad esempio su SSH o tmux. Imposta [`FORCE_HYPERLINK=0`](/docs/it/env-vars) per rendere l'etichetta come testo semplice.

166* Dopo aver inviato un follow-up alla sessione, Claude Code mantiene l'etichetta mentre la riga ritorna al progresso live.

171 167

172Claude Code legge la pull request dall'output completo del comando, inclusa la parte salvata in un file quando l'output di un comando supera il limite inline. Prima di v2.1.205, una pull request creata in una chiamata Bash il cui output superava circa 30.000 caratteri non era collegata.168Una sessione che lavora su una pull request esistente è collegata a essa allo stesso modo. Claude Code trova la pull request diversamente a seconda del comando che Claude esegue:

169

170* Quando Claude modifica, commenta, chiude, o contrassegna una pull request come pronta con `gh`, Claude Code collega la pull request che l'output del comando stesso nomina. Un comando `gh` il cui output catturato non nomina alcuna pull request non crea un collegamento; `gh pr merge` è il caso comune, perché stampa il suo risultato solo su un terminale interattivo.

171* Quando Claude controlla una pull request con `gh pr checkout` o esegue il push su un ramo, Claude Code cerca il ramo con `gh pr view` e collega la sua pull request aperta.

172* La pull request non ha bisogno di esistere ancora quando Claude esegue il push: Claude Code ritenta la ricerca del ramo dopo fino a cinque comandi `git`, `gh`, `glab`, o `curl` successivi eseguiti nella stessa directory, quindi una pull request creata dopo il push, inclusa una che Claude crea attraverso l'API REST di GitHub, si collega quando un tentativo la trova.

173 173

174Quando una sessione è collegata a più di una pull request, l'etichetta mostra un conteggio invece, come `3 PRs`, colorato dalla pull request aperta che ha più bisogno di attenzione. Apri il [pannello peek](#peek-and-reply) per vederle tutte.174Quando una sessione è collegata a più di una pull request, l'etichetta mostra un conteggio invece, come `3 PRs`, colorato dalla pull request aperta che ha più bisogno di attenzione. Apri il [pannello peek](#peek-and-reply) per vederle tutte.

175 175

182| Viola | Unito |182| Viola | Unito |

183| Grigio | Bozza o chiuso |183| Grigio | Bozza o chiuso |

184 184

185Per la maggior parte dei compiti questa colonna è dove raccogli il risultato: rivedi e unisci la pull request quando il suo numero diventa verde.185Per un compito che termina in una pull request, controlla questa etichetta per il risultato: rivedi e unisci la pull request quando il suo numero diventa verde.

186 186

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

188 Peek e rispondi188 Peek e rispondi

198 198

199La maggior parte delle volte il pannello peek è sufficiente e non hai bisogno di aprire il transcript completo.199La maggior parte delle volte il pannello peek è sufficiente e non hai bisogno di aprire il transcript completo.

200 200

201Prima di v2.1.207, ogni peek si apriva con la frase di stato e un timestamp nudo, e una sessione bloccata aveva la sua domanda che appariva sotto di loro con lo stesso timestamp ripetuto una seconda volta.201Digita una risposta nel pannello peek e premi `Enter` per inviarla a quella sessione. Quando la sessione pone una domanda con scelte predefinite, il pannello peek le mostra come un elenco numerato e puoi premere un tasto numero per sceglierne uno. Un prompt di permesso mostra come testo che descrive cosa la sessione vuole eseguire, senza opzioni numerate. Digita una risposta per rispondere, o collegati per rispondere con il prompt standard. Per altre sessioni bloccate, premi `Tab` per riempire l'input con una risposta suggerita che puoi modificare prima di inviare. Prefissa una risposta con `!` per inviare un comando Bash invece.

202 202

203Digita una risposta nel pannello peek e premi `Enter` per inviarla a quella sessione. Quando la sessione sta facendo una domanda a scelta multipla, il pannello peek mostra le opzioni e puoi premere un tasto numero per sceglierne uno. Per altre sessioni bloccate, premi `Tab` per riempire l'input con una risposta suggerita che puoi modificare prima di inviare. Prefissa una risposta con `!` per inviare un comando Bash invece.203Quando un hook [`PermissionRequest`](/docs/it/hooks#permissionrequest) o [`PreToolUse`](/docs/it/hooks#pretooluse) restituisce un output che Claude Code non può convalidare per la chiamata che la sessione sta chiedendo, la riga mostra l'evento hook e `hook output invalid:` con l'errore di convalida prima del testo della richiesta in sospeso. Per un hook che fallisce in un altro modo, la riga dice che l'hook ha fallito. La sessione continua ad aspettare la stessa richiesta.

204 204

205Una risposta che non può essere consegnata, perché il servizio in background non è raggiungibile o l'invio fallisce, viene salvata e inviata alla sessione come suo prossimo prompt quando il suo processo si avvia di nuovo, e il messaggio di errore dice che la risposta è stata salvata. Una risposta con prefisso `!` non viene salvata, perché il testo salvato raggiungerebbe la sessione come un prompt semplice piuttosto che eseguire come comando Bash.205Una risposta che non può essere consegnata, perché il servizio in background non è raggiungibile o l'invio fallisce, viene salvata e inviata alla sessione come suo prossimo prompt quando il suo processo si avvia di nuovo, e il messaggio di errore dice che la risposta è stata salvata. Una risposta con prefisso `!` non viene salvata, perché il testo salvato raggiungerebbe la sessione come un prompt semplice piuttosto che eseguire come comando Bash.

206 206

216 216

217Mentre collegato, la sessione si comporta come qualsiasi altra sessione di Claude Code: [comandi](/docs/it/commands), scorciatoie da tastiera e funzioni funzionano tutti, con le eccezioni sottostanti.217Mentre collegato, la sessione si comporta come qualsiasi altra sessione di Claude Code: [comandi](/docs/it/commands), scorciatoie da tastiera e funzioni funzionano tutti, con le eccezioni sottostanti.

218 218

219Una sessione in background rifiuta `/install-github-app` e l'elenco delle impostazioni [`/mcp`](/docs/it/mcp), incluse le sue azioni di autenticazione, sia che tu sia collegato o che rispondi dal pannello peek. Il messaggio ti indirizza a una sessione `claude` regolare, e `/mcp reconnect <server>`, `/mcp enable`, e `/mcp disable` funzionano ancora.219Mentre sei collegato, `/install-github-app` e l'elenco delle impostazioni [`/mcp`](/docs/it/mcp) funzionano normalmente, poiché un umano al terminale può completare i loro dialoghi. Quando nessuno è collegato, questi comandi non possono aprire i loro dialoghi, quindi la sessione appare sotto `Needs input` in agent view con una riga come `open this session to manage MCP servers`, e la risposta del transcript dice lo stesso. Collegati ed esegui il comando di nuovo per continuare; la riga needs-input si cancella quando ti colleghi. `/mcp reconnect <server>`, `/mcp enable`, e `/mcp disable` funzionano senza collegarsi in entrambi i casi.

220 220

221Le sessioni collegate si rendono sempre in [modalità fullscreen](/docs/it/fullscreen), indipendentemente dalla tua impostazione `tui`, perché una sessione in background non ha scrollback del terminale a cui aggiungere. Scorri con `PgUp`, `PgDn`, o la rotella del mouse, e premi `Ctrl+O` per la modalità transcript. Lo scroll nativo del tuo terminale e la modalità copia di tmux mostrano solo il viewport corrente, lo stesso di quando esegui qualsiasi applicazione fullscreen.221Le sessioni collegate si rendono sempre in [modalità fullscreen](/docs/it/fullscreen), indipendentemente dalla tua impostazione `tui`, perché una sessione in background non ha scrollback del terminale a cui aggiungere. Scorri con `PgUp`, `PgDn`, o la rotella del mouse, e premi `Ctrl+O` per la modalità transcript. Lo scroll nativo del tuo terminale e la modalità copia di tmux mostrano solo il viewport corrente, lo stesso di quando esegui qualsiasi applicazione fullscreen.

222 222

223Premi `←` su un prompt vuoto, o esegui `/exit`, per scollegar e tornare a agent view. A partire da v2.1.198 questo funziona allo stesso modo sia che tu abbia aperto la sessione da agent view o con `claude attach <id>` dalla tua shell.223Premi `←` su un prompt vuoto, o esegui `/exit`, per scollegar e tornare a agent view, indipendentemente dal fatto che tu abbia aperto la sessione da agent view o con `claude attach <id>` dalla tua shell.

224

225`←` scollega anche mentre l'[overlay `/btw`](/docs/it/interactive-mode#side-questions-with-%2Fbtw) è aperto. Richiede Claude Code v2.1.257 o successivo. Una domanda laterale che sta ancora rispondendo continua a funzionare mentre sei via. La prossima volta che ti colleghi, l'overlay si riapre con essa, o con la sua risposta.

226

227Su Windows, se premi `←` entro circa mezzo secondo dal collegamento, Claude Code mostra `Ambiguous ←, press again to detach`, perché in quella finestra il terminale può rideliver una pressione da prima che ti collegassi. Premi `←` di nuovo per scollegar.

224 228

225`Ctrl+Z` scollega anche ma torna a dove hai iniziato invece: agent view se ti sei collegato da lì, o la tua shell se hai eseguito `claude attach`. Usa `Ctrl+Z` quando una finestra di dialogo ha il focus e non risponde a `←`.229`Ctrl+Z` scollega anche ma torna a dove hai iniziato invece: agent view se ti sei collegato da lì, o la tua shell se hai eseguito `claude attach`. Usa `Ctrl+Z` quando una finestra di dialogo ha il focus e non risponde a `←`.

226 230

228 232

229Scollegar non ferma mai una sessione in background: `←`, `Ctrl+Z`, `/exit`, e doppio `Ctrl+C` o doppio `Ctrl+D` la lasciano tutte in esecuzione. Per terminare una sessione da dentro di essa, esegui `/stop`.233Scollegar non ferma mai una sessione in background: `←`, `Ctrl+Z`, `/exit`, e doppio `Ctrl+C` o doppio `Ctrl+D` la lasciano tutte in esecuzione. Per terminare una sessione da dentro di essa, esegui `/stop`.

230 234

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

236 Cambiare sessioni senza lasciare il terminale

237</h4>

238

231In una sessione in esecuzione in primo piano, una che hai avviato nel terminale piuttosto che collegato da agent view, premere `←` su un prompt vuoto la mette in background e apre agent view con quella riga selezionata, quindi puoi cambiare sessioni senza lasciare il terminale. Lo stesso singolo press scollega una sessione collegata.239In una sessione in esecuzione in primo piano, una che hai avviato nel terminale piuttosto che collegato da agent view, premere `←` su un prompt vuoto la mette in background e apre agent view con quella riga selezionata, quindi puoi cambiare sessioni senza lasciare il terminale. Lo stesso singolo press scollega una sessione collegata.

232 240

233Se uno strumento è in esecuzione quando premi `←`, Claude Code aspetta fino a circa dieci secondi che finisca prima di metterla in background, e la risposta continua nella sessione in background. Premi `←` di nuovo per metterla in background immediatamente invece di aspettare. Quando il lavoro in corso non può trasferirsi alla sessione in background, appare prima la finestra di dialogo `Background this session?`, come con [`/background`](#from-inside-a-session).241Se premi `←` subito dopo aver eliminato l'ultimo testo del prompt o aver spostato la cronologia del prompt, Claude Code ti chiede di confermare: il primo press mostra `Press ← again to open agents`, o `Press ← again to go back to agents` in una sessione collegata, e il secondo press cambia.

242

243Quando `←` mette in background una sessione in primo piano, agent view mostra `Your conversation moved to the background` sopra l'elenco, con la riga di quella sessione già selezionata. Da lì:

244

245* Premi `Enter` per riaprire la conversazione.

246* Premi `Esc` per annullare il cambio e tornare alla conversazione. Se `Esc` mostra `Still starting — try again in a moment`, la sessione in background non è ancora pronta, quindi premi `Esc` di nuovo tra un momento.

247* Premi `Ctrl+C` due volte per uscire alla tua shell.

248

249Quando Claude Code non riesce a riaprire la conversazione, esce e stampa un comando `claude --resume` che la riprende.

250

251L'[elenco delle attività](/docs/it/interactive-mode#task-list) di Claude si sposta alla sessione in background con la conversazione, quindi la checklist è intatta quando torni a quella riga.

252

253La riga su cui hai premuto `←` mantiene anche un nome in grassetto e non attenuato dopo aver spostato la selezione con i tasti freccia o il mouse, quindi puoi dire da quale sessione sei venuto.

254

255Se uno strumento è in esecuzione quando premi `←`, Claude Code aspetta fino a circa dieci secondi che finisca prima di metterla in background, e Claude continua la risposta nella sessione in background. Premi `←` di nuovo per metterla in background immediatamente invece di aspettare. Quando il lavoro in corso non può trasferirsi alla sessione in background, Claude Code mostra prima la finestra di dialogo `Background this session?`, come con [`/background`](#from-inside-a-session).

234 256

235Il limite di dieci secondi non si applica mentre i [subagents](/docs/it/sub-agents) sono in esecuzione. Claude Code continua ad aspettare in modo che il loro lavoro si trasferisca, e mostra un avviso `Still backgrounding after the current tool` mentre aspetta; premi `←` di nuovo per metterla in background senza aspettare, il che riavvia i subagents dall'inizio. Prima di v2.1.203, l'attesa è terminata dopo dieci secondi e i subagents in esecuzione sono stati riavviati dall'inizio senza avvertimento.257Il limite di dieci secondi non si applica mentre i [subagents in primo piano](/docs/it/sub-agents#run-subagents-in-foreground-or-background) che Claude ha avviato nella conversazione sono ancora in esecuzione. Claude Code continua ad aspettare in modo che il loro lavoro si trasferisca, e mostra un avviso `Still backgrounding after the current tool` mentre aspetta. Premi `←` di nuovo per metterla in background senza aspettare, il che riavvia quei subagents dall'inizio. Claude Code non aspetta i subagents che un [workflow dinamico](/docs/it/workflows) sta eseguendo. Quando un workflow ha subagents in esecuzione, Claude Code mostra la finestra di dialogo `Background this session?` invece.

236 258

237La riga viene creata anche da una sessione nuova senza cronologia di conversazione, quindi `→` vi ritorna. Prima di v2.1.203, agent view mostrava un suggerimento di onboarding sotto quella riga quando era l'unica.259Claude Code non mette in background la sessione mentre hai testo non inviato nell'input del prompt, perché il testo rimane nella casella di input del tuo terminale e non si sposterebbe alla sessione in background. Se digiti nell'input mentre Claude Code aspetta di mettere in background la sessione, annulla il cambio con `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.`

260

261Premere `←` crea la riga della sessione anche quando la conversazione non ha ancora messaggi, quindi `→` ritorna comunque a essa.

238 262

239Puoi disattivare questa scorciatoia con l'impostazione `leftArrowOpensAgents` in `/config`.263Puoi disattivare questa scorciatoia con l'impostazione `leftArrowOpensAgents` in `/config`.

240 264

255 279

256Per rimuovere una sessione dall'elenco, premi `Ctrl+X` per fermarla e `Ctrl+X` di nuovo entro due secondi per eliminarla. Premere `Ctrl+X` su un'intestazione di gruppo elimina ogni sessione in quel gruppo dopo conferma.280Per rimuovere una sessione dall'elenco, premi `Ctrl+X` per fermarla e `Ctrl+X` di nuovo entro due secondi per eliminarla. Premere `Ctrl+X` su un'intestazione di gruppo elimina ogni sessione in quel gruppo dopo conferma.

257 281

258L'eliminazione rimuove la sessione da agent view. Se Claude ha [creato un worktree](#how-file-edits-are-isolated) per la sessione, l'eliminazione rimuove anche quel worktree, inclusi eventuali cambiamenti non committati in esso, quindi esegui il commit del lavoro che vuoi mantenere prima. Un worktree che hai creato tu stesso e in cui hai avviato la sessione viene lasciato in posto. Il transcript della conversazione rimane sulla tua macchina locale e rimane disponibile attraverso `claude --resume`.282Il secondo press elimina la sessione anche quando il tentativo di arresto fallisce, ad esempio perché il [servizio in background non sta rispondendo](#agent-view-says-the-background-service-did-not-respond): la conferma rimane attiva per altri due secondi, e l'eliminazione termina il processo della sessione stesso. Premi `Esc` per chiudere la conferma senza eliminare.

283

284Tranne nei casi mantenuti coperti in [Cosa elimina una sessione](#what-deleting-a-session-removes), l'eliminazione rimuove la sessione dall'elenco, e un worktree che Claude ha creato per essa viene rimosso, mantenuto, o lasciato in posto a seconda di come elimini e cosa contiene il worktree. Il transcript della conversazione rimane sempre sulla tua macchina locale, disponibile attraverso `claude --resume`.

285

286Per riportare una sessione su Claude Code v2.1.212 o successivo, digita `/resume` nell'input di dispatch. Si apre un picker con le sessioni passate del repository da cui hai aperto agent view, più recenti per prime, incluse le sessioni che hai eliminato dall'elenco; le sessioni che hanno già una riga non sono elencate. `↑`/`↓` spostano la selezione, `Enter` riprende la sessione selezionata come sessione in background in modo che si riunisca all'elenco come riga, e `Esc` chiude il picker.

259 287

260L'eliminazione non rimuove mai un worktree con commit che non sono stati spinti da nessuna parte, o uno che un'altra sessione in esecuzione rivendica o ha bloccato. Claude Code mantiene il worktree e la sessione, e il footer nomina il percorso mantenuto e il motivo. Spingi i commit, o chiudi l'altra sessione, quindi elimina di nuovo.288Il picker si apre solo per un `/resume` semplice. Un resume mirato, scoped, o ristretto non può essere servito dal picker, quindi agent view mostra l'hint `attach to a session to run it` invece quando:

261 289

262L'eliminazione cancella anche la sessione dall'[elenco delle sessioni del supervisor](#the-supervisor-process), sia che tu elimini con `Ctrl+X` o con [`claude rm`](#manage-sessions-from-the-shell) dalla shell, quindi la rimozione persiste attraverso i riavvii del supervisor. Prima di v2.1.206, rimuovere una sessione mentre il supervisor stava riavviando o era irraggiungibile la lasciava in quell'elenco, e il prossimo supervisor riavviava il suo processo e mostrava la riga di nuovo.290* `/resume` nomina un id o un termine di ricerca

291* la vista è scoped con `--cwd`

292* la vista è stata avviata con [`--safe-mode`](/docs/it/cli-reference#cli-flags)

293* la vista è stata aperta con un flag come `--permission-mode` o `--settings`

263 294

264Le sessioni completate che non si adattano allo schermo si ripiegano in una riga `… N more`. I fallimenti e le sessioni con una pull request aperta rimangono sempre visibili. Il gruppo `Completed` riempie lo spazio verticale rimasto dopo i gruppi live, e su un terminale corto l'intestazione si compatta in una singola riga di riepilogo in modo che le sessioni che stanno lavorando o hanno bisogno di input rimangono visibili.295Le sessioni completate che non si adattano allo schermo si ripiegano in una riga `… N more`. I fallimenti e le sessioni con una pull request aperta rimangono sempre visibili. Il gruppo `Completed` riempie lo spazio verticale rimasto dopo i gruppi live, e su un terminale corto l'intestazione si compatta in una singola riga di riepilogo in modo che le sessioni che stanno lavorando o hanno bisogno di input rimangono visibili.

265 296

270Digita nell'input di dispatch per filtrare invece di inviare:301Digita nell'input di dispatch per filtrare invece di inviare:

271 302

272| Filtro | Mostra |303| Filtro | Mostra |

273| :---------------------- | :--------------------------------------------------------------------------------------------------------- |304| :-------------------------------------- | :--------------------------------------------------------------------------------------------------------- |

275| `s:<state>` | Sessioni nello stato dato, come `s:working`. Accetta anche `s:blocked` per tutto ciò che sta aspettando te |306| `s:<state>` | Sessioni nello stato dato, come `s:working`. Accetta anche `s:blocked` per tutto ciò che sta aspettando te |

277| Qualsiasi altro URL | La sessione il cui primo prompt conteneva quell'URL |308| Qualsiasi altro URL | La sessione il cui primo prompt conteneva quell'URL |

278 309

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

283Premi `?` in agent view per vedere ogni scorciatoia nel contesto. La tabella sottostante le riassume.314Premi `?` in agent view per vedere ogni scorciatoia nel contesto. La tabella sottostante le riassume.

284 315

285| Scorciatoia | Azione |316| Scorciatoia | Azione |

286| :-------------------- | :------------------------------------------------------------------------------------------- |317| :-------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

287| `↑` / `↓` | Muoviti tra le righe |318| `↑` / `↓` | Muoviti tra le righe |

322| `Ctrl+Enter` | Invia e collegati immediatamente, nei terminali dove l'overlay `?` elenca `ctrl+enter to start and open` |

291| `→` | Collegati alla sessione selezionata |323| `→` | Collegati alla sessione selezionata |

293| `Tab` | Su un input vuoto, sfoglia tutti i subagents. Altrimenti applica il suggerimento evidenziato |325| `Tab` | Su un input vuoto, sfoglia tutti i subagents. Altrimenti applica il suggerimento evidenziato |

330| `Ctrl+J` | Inserisci una nuova riga nell'input di dispatch |

300| `Esc` | Chiudi il pannello peek, cancella l'input, o esci |333| `Esc` | Chiudi il pannello peek, cancella l'input, o esci. Quando hai aperto agent view mettendo in background la tua sessione con `←`, l'`Esc` finale ritorna a quella conversazione invece di uscire. Con la [modalità editor vim](/docs/it/interactive-mode#vim-editor-mode) attiva, premere `Esc` nell'input passa da modalità INSERT a modalità NORMAL e mantiene il tuo testo, come nel prompt principale |

302| `?` | Mostra tutte le scorciatoie |335| `?` | Mostra tutte le scorciatoie |

303 336

337`Ctrl+S`, `Ctrl+T`, e `Ctrl+G` seguono il tuo [`keybindings.json`](/docs/it/keybindings). Riassegna o scollega `Ctrl+S` e `Ctrl+T` con le azioni `agents:switchView` e `agents:togglePin` nel contesto [`Agents`](/docs/it/keybindings#agents-actions), e `Ctrl+G` attraverso il binding `chat:externalEditor` del contesto `Chat`. Le altre scorciatoie nella tabella non possono essere riassegnate.

338

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

305 Invia nuovi agenti340 Invia nuovi agenti

306</h2>341</h2>

313 348

314Digita un prompt nell'input in basso di agent view e premi `Enter` per avviare una nuova sessione in background. La sessione è denominata automaticamente dal prompt; rinominala in seguito con `Ctrl+R`.349Digita un prompt nell'input in basso di agent view e premi `Enter` per avviare una nuova sessione in background. La sessione è denominata automaticamente dal prompt; rinominala in seguito con `Ctrl+R`.

315 350

316Un nome che la sessione riceve in seguito appare anche sulla sua riga, incluso il nome che Claude deriva quando [accetti un piano](/docs/it/permission-modes#review-and-approve-a-plan) in quella sessione. Prima di v2.1.207, una sessione in background denominata accettando un piano mostrava quel nome in `/status` ma non sulla sua riga di agent view finché non la rinominavi tu stesso.351Il nome automatico è un'etichetta breve scritta da un [modello di classe Haiku](/docs/it/model-config). Un nome che la sessione riceve in seguito appare anche sulla sua riga, incluso il [titolo generato](/docs/it/sessions#name-your-sessions) che la sessione ottiene quando [accetti un piano](/docs/it/permission-modes#review-and-approve-a-plan) in quella sessione.

317 352

318Incolla un'immagine nel prompt per includere uno screenshot o un diagramma con il compito.353Incolla un'immagine nel prompt per includere uno screenshot o un diagramma con il compito.

319 354

320Il testo incollato più lungo di 800 caratteri o più di due righe si comprime in un placeholder `[Pasted text #N]` in modo che l'input rimanga su una riga; il testo completo viene inviato quando invii. Per rivedere o modificare il testo compresso prima di inviare, incolla lo stesso testo di nuovo e il placeholder si espande di nuovo nell'input. Un promemoria `paste again to expand` appare sotto l'input per alcuni secondi dopo l'incolla su terminali larghi almeno 90 colonne. Prima di v2.1.207, incollare lo stesso testo di nuovo aggiungeva un secondo placeholder invece di espandere il primo.355Il testo incollato più lungo di 800 caratteri o più di tre righe si comprime in un placeholder `[Pasted text #N]` in modo che l'input rimanga su una riga; il testo completo viene inviato quando invii. Per rivedere o modificare il testo compresso prima di inviare, incolla lo stesso testo di nuovo e il placeholder si espande di nuovo nell'input.

321 356

322Prefissa o menziona parti del prompt per controllare come la sessione inizia:357Prefissa o menziona parti del prompt per controllare come la sessione inizia:

323 358

324| Input | Effetto |359| Input | Effetto |

325| :----------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |360| :--------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

326| `<agent-name> <prompt>` | Se la prima parola corrisponde a un nome di [subagent](/docs/it/sub-agents) personalizzato, quel subagent viene eseguito come agente principale della sessione con la configurazione dal suo frontmatter |361| `<agent-name> <prompt>` | Se la prima parola corrisponde a un nome di [subagent](/docs/it/sub-agents) personalizzato, quel subagent viene eseguito come agente principale della sessione con la configurazione dal suo frontmatter |

327| `@<agent-name>` | Menziona un subagent personalizzato in qualsiasi punto del prompt per eseguirlo come agente principale |362| `@<agent-name>` | Menziona un subagent personalizzato in qualsiasi punto del prompt per eseguirlo come agente principale |

328| `@<repo>` | Menziona un repository per eseguire la sessione lì. Vedi [Invia a una directory specifica](#dispatch-to-a-specific-directory) per quali repository sono elencati |363| `@<repo>` | Menziona un repository per eseguire la sessione lì. Vedi [Invia a una directory specifica](#dispatch-to-a-specific-directory) per quali repository sono elencati |

330| `! <command>` | Esegui un comando shell come un job in background invece di avviare una sessione Claude. Il job appare come una riga a cui puoi collegarti, osservare e staccarti |365| `! <command>` | Esegui un comando shell come un job in background invece di avviare una sessione Claude. Il job appare come una riga a cui puoi collegarti, osservare e staccarti |

331| `#<number>` o un URL di pull request | Se una sessione sta già lavorando su quel PR, selezionala invece di inviare |366| `#<number>` o un URL di pull request o merge request | Se una sessione sta già lavorando su quel pull request o merge request, Claude Code seleziona la sua riga invece di inviare una nuova sessione |

332| `Shift+Enter` | Invia e collegati immediatamente alla nuova sessione |

333 367

334Un piccolo insieme di comandi viene eseguito in agent view stesso invece di essere inviato:368Un piccolo insieme di comandi viene eseguito in agent view stesso invece di essere inviato:

335 369

337* `/logout` ti disconnette371* `/logout` ti disconnette

338* `/model` imposta il [modello di dispatch](#set-the-model)372* `/model` imposta il [modello di dispatch](#set-the-model)

339* A partire da v2.1.198, `/login` apre la finestra di dialogo di accesso in modo che tu possa accedere di nuovo senza collegarti a una sessione373* A partire da v2.1.198, `/login` apre la finestra di dialogo di accesso in modo che tu possa accedere di nuovo senza collegarti a una sessione

374* Un `/resume` semplice, o il suo alias `/continue`, apre un picker delle sessioni passate del repository per [riportarne una indietro](#organize-the-list) come sessione in background. Richiede Claude Code v2.1.212 o successivo

340 375

341Skills, i tuoi comandi personali, e built-in che espandono il prompt come `/init` vengono inviati a una nuova sessione in background come loro primo prompt. Gli altri comandi built-in mostrano un suggerimento `attach to a session to run it` invece. Tutto ciò che hai digitato rimane nell'input accanto al suggerimento in modo che tu possa modificarlo. Prima di v2.1.203, il suggerimento cancellava l'input e il testo digitato andava perso.376Skills, i tuoi comandi personali, e built-in che espandono il prompt come `/init` vengono inviati a una nuova sessione in background come loro primo prompt. Gli altri comandi built-in mostrano un suggerimento `attach to a session to run it` invece. Tutto ciò che hai digitato rimane nell'input accanto al suggerimento in modo che tu possa modificarlo.

342 377

343Confezionare un compito ricorrente come una [skill](/docs/it/skills) ti permette di avviare lo stesso workflow da agent view ripetutamente senza riscrivere il prompt.378Confezionare un compito ricorrente come una [skill](/docs/it/skills) ti permette di avviare lo stesso workflow da agent view ripetutamente senza riscrivere il prompt.

344 379

357 * I [git worktrees](/docs/it/worktrees) registrati del repository da cui hai lanciato che si trovano all'interno del suo albero di directory, come quelli che Claude crea sotto `.claude/worktrees/`, etichettati con il loro ramo estratto. I worktrees aggiunti al di fuori del repository, come con `git worktree add ../feature`, non sono elencati392 * I [git worktrees](/docs/it/worktrees) registrati del repository da cui hai lanciato che si trovano all'interno del suo albero di directory, come quelli che Claude crea sotto `.claude/worktrees/`, etichettati con il loro ramo estratto. I worktrees aggiunti al di fuori del repository, come con `git worktree add ../feature`, non sono elencati

358 * Qualsiasi directory che ha già una sessione nell'elenco393 * Qualsiasi directory che ha già una sessione nell'elenco

359 394

360 Una directory il cui nome contiene uno spazio non è elencata. Prima di v2.1.203, i worktrees registrati non erano elencati, quindi l'invio in uno significava eseguire `claude --bg` dalla directory di quel worktree.395 Una directory il cui nome contiene uno spazio non è elencata.

361* Dalla shell, `cd` nella directory e esegui `claude --bg "<prompt>"`.396* Dalla shell, `cd` nella directory e esegui `claude --bg "<prompt>"`.

362 397

363Quando agent view è raggruppato per directory, la directory della riga evidenziata diventa il target di dispatch, quindi puoi scorrere a un gruppo e inviare in esso senza riscrivere il percorso.398Quando agent view è raggruppato per directory, l'invio invia il prompt alla directory della riga selezionata, quindi puoi selezionare un gruppo e inviare in esso senza riscrivere il percorso.

364 399

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

366 Da dentro una sessione401 Da dentro una sessione

367</h3>402</h3>

368 403

404Due comandi spostano il lavoro dalla sessione in cui ti trovi in background: `/background` invia la conversazione corrente lì e libera il tuo terminale, e `/fork` invia una copia mentre continui a lavorare dove sei.

405

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

407 Invia la sessione in background

408</h4>

409

369Esegui `/background` o il suo alias `/bg` per spostare la conversazione corrente in una sessione in background. Passa un prompt come `/bg run the test suite and fix any failures` per inviare un'istruzione in più prima. Se Claude sta rispondendo quando esegui `/bg`, la risposta continua nella sessione in background.410Esegui `/background` o il suo alias `/bg` per spostare la conversazione corrente in una sessione in background. Passa un prompt come `/bg run the test suite and fix any failures` per inviare un'istruzione in più prima. Se Claude sta rispondendo quando esegui `/bg`, la risposta continua nella sessione in background.

370 411

371L'uscita da una sessione interattiva che ha ancora lavoro in background in esecuzione, come subagent, comandi shell in background, workflow, o [monitor](/docs/it/tools-reference#monitor-tool), mostra una finestra di dialogo `Background work is running` invece di uscire immediatamente. A partire da v2.1.198 la finestra di dialogo offre `Move to background and exit` insieme a `Exit anyway` e `Stay`. Sceglierla sposta la sessione in background nello stesso modo in cui `/background` fa, quindi ti restituisce alla tua shell, in modo che il lavoro che può continuare rimane in esecuzione e la sessione appare in agent view. L'opzione non viene mostrata quando agent view è [disattivato](#turn-off-agent-view).412L'uscita da una sessione che ha ancora lavoro in background in esecuzione, come subagent, comandi shell in background, workflow, o [monitor](/docs/it/tools-reference#monitor-tool), mostra una finestra di dialogo `Background work is running` invece di uscire immediatamente. Scegli `Move to background and exit` per mettere in background la sessione nello stesso modo in cui `/background` fa e tornare alla tua shell. L'opzione non viene mostrata quando agent view è [disattivato](#turn-off-agent-view).

413

414Se una sessione in background nell'elenco ha già il nome della conversazione, Claude Code numera il nome della nuova riga, come `my-session (2)`, e lascia il nome della riga esistente invariato. Per rinominare la nuova riga, selezionala in agent view e premi `Ctrl+R`.

415

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

417 Copia la sessione con /fork

418</h4>

419

420Esegui `/fork` per copiare la conversazione corrente in una nuova sessione in background mentre l'originale continua a essere eseguita. La copia inizia con tutto nella conversazione fino a quel punto; vedi i punti elenco di seguito per dove viene eseguita la copia. Trasporta anche il modello, la modalità di autorizzazione, il livello di sforzo, e qualsiasi directory o concessioni di autorizzazione "non chiedere di nuovo" che hai aggiunto durante la sessione. La copia appare come sua propria riga in agent view.

421

422Dopo il fork, le due conversazioni sono indipendenti: nulla di ciò che la copia fa entra nella conversazione originale da sola, anche se nelle sessioni in cui [la messaggistica tra sessioni](/docs/it/cross-session-messaging) è abilitata, la Claude di entrambe le sessioni può esplicitamente inviare messaggi all'altra.

423

424La copia della sessione richiede Claude Code v2.1.212 o successivo; su v2.1.161 attraverso v2.1.211, `/fork` avvia un [subagent con fork](/docs/it/sub-agents#fork-the-current-conversation) invece, che è ora `/subtask`. Quando [agent view è disattivato](#turn-off-agent-view), `/fork` mantiene il comportamento del subagent con fork e `/subtask` non è disponibile.

425

426Passa un prompt come `/fork open a draft pull request with the work so far` e la copia inizia a lavorarci immediatamente. Senza un prompt la copia aspetta la sua prima istruzione: seleziona la sua riga in `claude agents` e premi `Space` per inviarne una, o esegui `claude attach <id>`. La riga selezionata mostra `space to send it a prompt` mentre aspetta.

372 427

373Lo spostamento in background da una sessione interattiva avvia un nuovo processo che riprende dalla conversazione salvata, e il lavoro in corso si trasferisce ad esso: comandi shell in background in esecuzione, subagent in background, workflow dinamici, e compiti programmati che hai creato con [`/loop`](/docs/it/scheduled-tasks) si trasferiscono alla sessione in background e continuano a girare lì. Un subagent si sposta insieme a tutto ciò che ha avviato, quindi si trasferisce solo quando tutto quel lavoro può trasferirsi anche, incluso su Windows. Per fermare il lavoro in corso invece di trasferirlo, imposta la variabile di ambiente [`CLAUDE_DISABLE_ADOPT=1`](/docs/it/env-vars#variables); Claude Code ti chiede di confermare prima di metterla in background.428La conferma di `/fork` è una riga che mostra lo stato della copia, come `session running`, il nome della sua riga di agent view, e il suo ID di sessione per `claude attach`. Fai clic sul nome per passare alla copia: questa sessione si sposta in background, come premere `←`, e agent view apre la sessione della copia.

374 429

375Il lavoro che non può trasferirsi, come un [monitor](/docs/it/tools-reference#monitor-tool) in esecuzione, viene fermato. Un subagent messo in background che possiede un monitor viene fermato insieme ad esso. Quando uno qualsiasi di essi è in esecuzione, Claude Code mostra una finestra di dialogo `Background this session?` in modo che tu possa confermare prima che sia fermato.430Tranne quando la copia [modifica in posizione](#how-file-edits-are-isolated), Claude Code le istruisce di creare un worktree proprio prima di apportare modifiche al codice. Al di fuori di un repository git, solo una copia spostata fuori da un worktree creato da hook riceve l'istruzione; senza un [`WorktreeCreate` hook](/docs/it/hooks#worktreecreate), la copia modifica in posizione. Una copia spostata fuori dal tuo worktree riceve anche l'istruzione di non modificare mai, eseguire comandi in, o entrare in quel worktree, qualunque sia l'impostazione di isolamento.

431

432Dove la copia inizia dipende da dove è in esecuzione la sessione corrente:

433

434* Come qualsiasi sessione inviata, la copia [si sposta nel suo worktree prima di modificare i file](#how-file-edits-are-isolated). In quel caso la conferma non menziona dove viene eseguita la copia.

435* Quando la tua sessione si è spostata nel suo [worktree](/docs/it/worktrees) collegato dopo l'avvio, la copia inizia da dove era la sessione prima dello spostamento e, a meno che non [modifichi in posizione](#how-file-edits-are-isolated), apporta le sue modifiche al codice in un worktree proprio lì. Quando il tuo worktree è estratto su un ramo, quell'istruzione dice anche a una copia il cui compito si basa sul tuo lavoro di basare il suo nuovo ramo sul tuo, poiché il tuo ramo rimane estratto nel tuo worktree. La conferma termina con `runs in the origin tree`.

436* Quando hai lanciato la sessione all'interno di un worktree collegato di un repository che ha un albero di lavoro principale, la copia inizia in quell'albero di lavoro principale, con la stessa regola del worktree proprio ma nessuna istruzione di ramo. La conferma termina con `runs in the origin tree` anche qui.

437* Una sessione lanciata all'interno di un worktree di un layout di repository bare non ha un albero di lavoro principale a cui tornare, quindi la copia rimane dove si trova, e la conferma termina con `edits this checkout`. La stessa nota appare quando l'isolamento del worktree è [disattivato](#how-file-edits-are-isolated) in una sessione che non è all'interno di un worktree collegato, perché la copia modifica i file che hai aperto.

438

439Le sessioni avviate con flag di lancio che la copia non erediterebbe, come un prompt di sistema sostituito o un allowlist `--tools`, non possono essere forkate; Claude Code lo dice invece di fare una copia parziale. Una sessione inviata da agent view viene forkata normalmente: la copia viene lanciata con la stessa [definizione di agente](/docs/it/sub-agents) e istruzioni aggiunte della sessione da cui proviene.

440

441<h4 id="what-carries-over-when-you-background">

442 Cosa si trasporta quando metti in background

443</h4>

444

445Mettere in background avvia un nuovo processo che riprende dalla conversazione salvata, e il lavoro in corso si trasferisce ad esso: comandi shell in background in esecuzione, subagent in background, workflow dinamici, compiti programmati che hai creato con [`/loop`](/docs/it/scheduled-tasks), e [risposte automatiche di Claude ai commenti degli artefatti](/docs/it/artifacts#let-claude-reply-to-comments-on-its-own) si trasferiscono tutti e continuano a essere eseguiti lì. Un subagent si sposta insieme a tutto ciò che ha avviato, quindi si trasferisce solo quando tutto quel lavoro può trasferirsi anche. Per fermare il lavoro in corso invece di trasferirlo, imposta la variabile di ambiente [`CLAUDE_DISABLE_ADOPT=1`](/docs/it/env-vars#variables); Claude Code ti chiede di confermare prima di mettere in background.

446

447Quando un [workflow dinamico](/docs/it/workflows) ha ancora subagent in esecuzione, Claude Code chiede prima di mettere in background con la finestra di dialogo `Background this session?`, che dice quanti subagent verrebbero riavviati. Scegli `Stay` per lasciarli finire prima. Se confermi, Claude Code riproduce l'esecuzione nella sessione in background: i subagent che erano ancora in esecuzione ricominciamo dall'inizio, quindi i token che hanno usato finora vengono spesi di nuovo. Vedi [Riprendi dopo una pausa](/docs/it/workflows#resume-after-a-pause) per quali subagent completati restituiscono i loro risultati salvati e quali vengono eseguiti di nuovo.

448

449Claude Code interrompe il lavoro che non può trasferirsi, come un [monitor](/docs/it/tools-reference#monitor-tool) in esecuzione, e interrompe un subagent messo in background che possiede un monitor insieme ad esso. Quando uno qualsiasi di essi è in esecuzione, Claude Code mostra la finestra di dialogo `Background this session?` in modo che tu possa confermare prima che il lavoro sia interrotto.

376 450

377Una volta in background, la sessione può avviare nuovi subagent, monitor, e comandi in background, e questi continuano a essere eseguiti durante successivi distacchi e ricollegamenti.451Una volta in background, la sessione può avviare nuovi subagent, monitor, e comandi in background, e questi continuano a essere eseguiti durante successivi distacchi e ricollegamenti.

378 452

385* `--fallback-model`459* `--fallback-model`

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

387 461

388Le directory che hai aggiunto durante la sessione con [`/add-dir`](/docs/it/permissions#additional-directories-grant-file-access-not-configuration) si trasferiscono anche.462Le directory che hai aggiunto durante la sessione con [`/add-dir`](/docs/it/permissions#additional-directories-grant-file-access-not-configuration) si trasferiscono anche. Il trasferimento di `--allow-dangerously-skip-permissions` mantiene `bypassPermissions` raggiungibile nella sessione messa in background, ma non concede nulla di nuovo: la modalità richiede comunque la stessa accettazione interattiva una tantum descritta in [Permission mode, model, and effort](#permission-mode-model-and-effort).

~~389~~

390Il trasferimento di `--allow-dangerously-skip-permissions` mantiene `bypassPermissions` raggiungibile nella sessione messa in background, ma non concede nulla di nuovo. La modalità richiede comunque la stessa accettazione interattiva una tantum descritta in [Permission mode, model, and effort](#permission-mode-model-and-effort) prima che qualsiasi sessione possa utilizzarla.

391 463

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

393 Dalla tua shell465 Dalla tua shell

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

400```472```

401 473

402Il prompt è l'argomento posizionale, non un valore `-p`. A partire da v2.1.198, combinare `--bg` con `-p` o `--print` viene rifiutato con un errore prima che qualsiasi sessione sia creata, perché `--print` non avvia mai la sessione interattiva a cui `claude agents` si collega.474Il prompt è l'argomento posizionale, non un valore `-p`. Claude Code rifiuta `--bg` combinato con `-p` o `--print` prima che qualsiasi sessione sia creata, perché `--print` non avvia mai la sessione interattiva a cui `claude agents` si collega.

403 475

404Per eseguire un subagent specifico come agente principale della sessione, combina `--bg` con `--agent`:476Per eseguire un [subagent](/docs/it/sub-agents) specifico che hai definito, come un `code-reviewer`, come agente principale della sessione, combina `--bg` con `--agent`:

405 477

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

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

408```480```

409 481

482Se il nome non corrisponde a nessuno dei tuoi subagent, il lancio fallisce: Claude Code stampa un avviso `no agent named` e comunque segnala la sessione come messa in background, ma la sessione esce immediatamente con un errore `--agent '<name>' not found`.

483

484Quando la sessione messa in background in seguito riprende o si riavvia, Claude Code ripristina l'agente e le sue restrizioni di strumenti; per il suo prompt di sistema, vedi [Flag di prompt di sistema nelle conversazioni riprese](/docs/it/cli-reference#system-prompt-flags-in-resumed-conversations). Cerca prima il suo agente nella directory della sessione, a condizione che tu abbia [fiducia in quel workspace](/docs/it/permissions#project-allow-rules-and-workspace-trust), quindi un agente con ambito di progetto si carica ancora quando la sessione viene ripresa da un'altra directory. Se l'agente non esiste più, la sessione continua con gli strumenti predefiniti e la sua trascrizione si apre con un [avviso che nomina l'agente](/docs/it/errors#session-agent-no-longer-available).

485

486Per continuare una conversazione esistente in background, passa il suo ID di sessione completo con `--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

492Su Claude Code v2.1.257 o successivo, Claude Code continua quella sessione con lo stesso ID, o avvia una copia con un nuovo ID e stampa una riga `note:` che spiega perché non potrebbe continuare in posizione. Quando la sessione continua in posizione, `claude agents` mostra una riga per essa.

493

494Quando combini `--bg` con `--continue`, un `--resume` semplice, o `--resume` con un nome o percorso di file, Claude Code avvia sempre una copia di questo tipo. Aggiungi `--fork-session` per avviare una copia di proposito, senza la nota.

495

410Passa `--name` per impostare il nome di visualizzazione della sessione in agent view invece di quello generato automaticamente:496Passa `--name` per impostare il nome di visualizzazione della sessione in agent view invece di quello generato automaticamente:

411 497

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

427 Esegui un comando shell513 Esegui un comando shell

428</h4>514</h4>

429 515

430Per eseguire un comando shell come un job in background invece di una sessione Claude, digita `!` come primo carattere dell'input di dispatch di agent view. Il `!` viene visualizzato come prefisso e tutto ciò che digiti dopo di esso è il comando. L'esempio seguente invia `pytest -x` dalla casella di input di agent view:516Per eseguire un comando shell come un job in background invece di una sessione Claude, passa `--exec`. L'esempio seguente esegue `pytest -x` come un job in background:

~~431~~

432```text theme={null}

433! pytest -x

434```

~~435~~

436Premi `Enter` per avviare il job. Lo stesso job può anche essere lanciato direttamente dalla tua shell con `--exec`:

437 517

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

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

440```520```

441 521

522Da agent view, invia lo stesso tipo di job digitando `!` come primo carattere dell'input di dispatch: il `!` viene visualizzato come prefisso, tutto ciò che digiti dopo di esso è il comando, e `Enter` avvia il job.

523

442Il comando viene eseguito come un job supportato da PTY e appare come una riga in agent view, con la riga di output più recente come suo stato. Un job shell esegue il comando al posto di Claude, quindi nessun modello viene invocato e l'output non viene inviato a nessuna sessione.524Il comando viene eseguito come un job supportato da PTY e appare come una riga in agent view, con la riga di output più recente come suo stato. Un job shell esegue il comando al posto di Claude, quindi nessun modello viene invocato e l'output non viene inviato a nessuna sessione.

443 525

444Per vedere l'output, collegati alla riga, premi `Space` per visualizzare l'anteprima senza collegarti, o esegui `claude logs <id>` dalla tua shell. L'output acquisito rimane in memoria e non viene scritto su disco. La riga e il suo output si puliscono automaticamente circa cinque minuti dopo l'uscita del comando, quindi leggi prima se hai bisogno del risultato.526Per vedere l'output, collegati alla riga, premi `Space` per visualizzare l'anteprima senza collegarti, o esegui `claude logs <id>` dalla tua shell. L'output acquisito rimane in memoria e non viene scritto su disco. La riga e il suo output si puliscono automaticamente circa cinque minuti dopo l'uscita del comando, quindi leggi prima se hai bisogno del risultato.

447 Come sono isolate le modifiche ai file529 Come sono isolate le modifiche ai file

448</h3>530</h3>

449 531

450Ogni sessione in background, che sia avviata da agent view, `/bg`, o `claude --bg`, inizia nella tua directory di lavoro. Prima di modificare i file, Claude sposta la sessione in un [git worktree](/docs/it/worktrees) isolato sotto `.claude/worktrees/`, quindi le sessioni parallele possono leggere lo stesso checkout ma ognuna scrive nel suo.532Ogni sessione in background, che sia avviata da agent view, `/bg`, o `claude --bg`, inizia nella tua directory di lavoro. Prima di modificare i file, Claude sposta la sessione in un [git worktree](/docs/it/worktrees) isolato sotto `.claude/worktrees/`, quindi le sessioni parallele possono leggere lo stesso checkout ma ognuna scrive nel suo. Una volta che la sessione è nel suo worktree, Claude Code [applica l'isolamento del worktree](/docs/it/worktrees#how-claude-code-enforces-isolation) per la sessione e per qualsiasi subagent che genera.

451 533

452Claude salta il worktree quando:534Claude salta il worktree quando:

453 535

454* La sessione è già all'interno di un git worktree collegato, che Claude l'abbia creato sotto `.claude/worktrees/` o tu l'abbia creato con `git worktree add` da qualche altra parte536* La sessione è già all'interno di un git worktree collegato, che Claude l'abbia creato sotto `.claude/worktrees/` o tu l'abbia creato con `git worktree add` da qualche altra parte

537* Il file che Claude sta modificando è all'interno di un git worktree collegato, come uno che la sessione o il suo subagent ha creato con `git worktree add`

455* La directory di lavoro non è un repository git e nessun [`WorktreeCreate` hook](/docs/it/hooks#worktreecreate) è configurato538* La directory di lavoro non è un repository git e nessun [`WorktreeCreate` hook](/docs/it/hooks#worktreecreate) è configurato

456* La scrittura è al di fuori della directory di lavoro539* La scrittura è al di fuori della directory di lavoro

457 540

458Per disattivare l'isolamento del worktree per un repository dove i git worktree sono impraticabili, imposta [`worktree.bgIsolation`](/docs/it/settings#worktree-settings) su `"none"`. Le sessioni in background modificheranno quindi la tua copia di lavoro direttamente senza spostarsi prima in un worktree. Aggiungi l'impostazione al file `.claude/settings.json` del progetto:541Per disattivare l'isolamento del worktree per un repository dove i git worktree sono impraticabili, imposta [`worktree.bgIsolation`](/docs/it/settings-reference#worktree-bgisolation) su `"none"`. Le sessioni in background modificheranno quindi la tua copia di lavoro direttamente senza spostarsi prima in un worktree. Aggiungi l'impostazione al file `.claude/settings.json` del progetto:

459 542

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

461{544{

467 550

468Al di fuori di un repository git, le sessioni scrivono direttamente nella directory di lavoro e non sono isolate l'una dall'altra, quindi evita di inviare sessioni parallele che modificano gli stessi file. Se utilizzi un sistema di controllo versione diverso, configura un [`WorktreeCreate` hook](/docs/it/worktrees#non-git-version-control) e Claude isola le modifiche nello stesso modo in cui lo fa per git.551Al di fuori di un repository git, le sessioni scrivono direttamente nella directory di lavoro e non sono isolate l'una dall'altra, quindi evita di inviare sessioni parallele che modificano gli stessi file. Se utilizzi un sistema di controllo versione diverso, configura un [`WorktreeCreate` hook](/docs/it/worktrees#non-git-version-control) e Claude isola le modifiche nello stesso modo in cui lo fa per git.

469 552

470Quando l'hook fallisce in una directory che non è un repository git, la sessione salta l'isolamento per quella directory e modifica la directory di lavoro in posizione. All'interno di un repository git, le scritture rimangono bloccate finché la sessione non si isola. Prima di v2.1.203, una sessione in background in quello stato non poteva modificare alcun file: ogni scrittura era rifiutata finché non si isolava, e l'hook non poteva mai isolare quella directory.553Quando l'hook fallisce in una directory che non è un repository git, Claude salta l'isolamento per quella directory e modifica la directory di lavoro in posizione. All'interno di un repository git, Claude Code blocca le scritture al checkout condiviso finché Claude non sposta la sessione in un worktree.

~~471~~

472L'eliminazione di una sessione rimuove o mantiene il worktree che Claude ha creato per essa, a seconda di come lo elimini e di cosa contiene il worktree:

~~473~~

474* L'eliminazione in agent view con `Ctrl+X` due volte rimuove il worktree, inclusi eventuali cambiamenti non committati, quindi unisci o spingi i cambiamenti che vuoi mantenere prima.

475* L'eliminazione dalla shell con [`claude rm`](#manage-sessions-from-the-shell) mantiene un worktree che ha cambiamenti non committati, insieme alla sua riga di sessione.

476* Nessuno dei due percorsi rimuove un worktree con commit che non sono stati spinti da nessuna parte: il worktree è [mantenuto insieme alla sua sessione](#organize-the-list) e l'output nomina il percorso mantenuto e il motivo.

477* Un worktree che hai creato tu stesso e in cui hai avviato la sessione viene lasciato in posizione in entrambi i casi.

478 554

479Per trovare il percorso del worktree di una sessione, visualizza l'anteprima della sessione o collegati e controlla la sua directory di lavoro.555Per trovare il percorso del worktree di una sessione, visualizza l'anteprima della sessione o collegati e controlla la sua directory di lavoro.

480 556

481Un [subagent](/docs/it/sub-agents) che la sessione in background genera eredita la directory di lavoro della sessione, quindi le sue modifiche ai file finiscono nel worktree della sessione piuttosto che nella tua copia di lavoro. Per dare a un subagent il suo proprio worktree separato, imposta [`isolation: worktree`](/docs/it/sub-agents#supported-frontmatter-fields) nel suo frontmatter o passa `isolation: "worktree"` quando lo generi.557Un [subagent](/docs/it/sub-agents) che la sessione in background genera eredita la directory di lavoro della sessione, quindi le sue modifiche ai file finiscono nel worktree della sessione piuttosto che nella tua copia di lavoro. Per dare a un subagent il suo proprio worktree separato, imposta [`isolation: worktree`](/docs/it/sub-agents#supported-frontmatter-fields) nel suo frontmatter o passa `isolation: "worktree"` quando lo generi.

482 558

483A partire da v2.1.198, una sessione in background che ha isolato i suoi cambiamenti di codice in un worktree esegue anche il commit, spinge il suo ramo, e apre una bozza di pull request senza fermarsi a chiedere. L'etichetta [`#N`](#pull-request-status) appare sulla sua riga quando il pull request si apre. Non spinge mai a `main` o `master`, non fa mai force-push o merge, e salta il pull request quando gli hai detto di non aprirne uno o il repository non ha un remote.559Quando una sessione in background ha apportato modifiche al codice in un worktree in cui Claude è entrato, Claude Code istruisce Claude di preservare il lavoro prima di finire, quindi sopravvive se elimini la sessione e il suo worktree:

560

561* **Commit e push**: Claude esegue il commit senza chiedere, e spinge il ramo quando il repository ha un remote.

562* **Bozza di pull request**: Claude ne apre una quando il compito lo richiede, e l'etichetta [`#N`](#pull-request-status) appare sulla riga.

563* **Mai**: spingere a `main` o `master`, force-push, e merge.

564* **Le tue istruzioni git hanno la precedenza**: se il compito, `CLAUDE.md`, o [memoria](/docs/it/memory) dice che gestisci tu stesso il commit o il push, Claude lascia git a te.

484 565

485Una sessione che modifica un checkout che non ha isolato da sola chiede comunque prima di fare il commit o di cambiare rami. Questo si applica quando l'isolamento è impostato su `"none"`, quando lo spostamento del worktree è fallito, o quando la sessione è stata avviata all'interno di un worktree che già esisteva.566Una sessione che modifica un checkout che non ha isolato da sola chiede comunque prima di fare il commit o di cambiare rami. Questo si applica quando l'isolamento è impostato su `"none"`, quando lo spostamento del worktree è fallito, o quando la sessione è stata avviata all'interno di un worktree che già esisteva.

486 567

568Qualunque sia il compito, Claude termina il lavoro con un rapporto che dice cosa ha fatto e dove si trova il lavoro: un percorso, un ramo, una pull request, o la risposta stessa.

569

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

571 Cosa elimina l'eliminazione di una sessione

572</h4>

573

574Elimina una sessione con `Ctrl+X` due volte in [agent view](#organize-the-list) o con [`claude rm`](#manage-sessions-from-the-shell). Tranne nei casi mantenuti di seguito, la sessione lascia l'elenco. La sua trascrizione rimane sulla tua macchina attraverso `claude --resume`, e la rimozione sopravvive ai riavvii del supervisore.

575

576Cosa succede a un worktree che Claude ha creato per la sessione:

577

578* Agent view lo rimuove, inclusi eventuali cambiamenti non committati, quindi esegui il commit di ciò che vuoi mantenere prima.

579* `claude rm` lo mantiene, insieme alla riga della sessione, quando ha cambiamenti non committati.

580* Né agent view né `claude rm` rimuovono un worktree che un'altra sessione in esecuzione sta usando o ha bloccato, e eliminare di nuovo non cambia questo. Claude Code mantiene il worktree e la sessione, e nomina la directory mantenuta e il motivo; in agent view, la riga della sessione mostra `not deleted`. Chiudi l'altra sessione, quindi elimina di nuovo.

581* Quando elimini una sessione il cui worktree ha commit che Claude Code non può confermare sono salvati altrove, Claude Code mantiene il worktree e la sessione, e il messaggio nomina il ramo del worktree e quanti commit non sono stati spinti. Il messaggio offre anche i due modi per procedere: spingere i commit, o eliminare di nuovo per scartarli.

582

583 I commit su un remote non bloccano l'eliminazione. Nemmeno i commit sulla copia locale del ramo predefinito del tuo remote `origin`, purché quel ramo sia estratto nel tuo checkout principale, la directory del repository stessa piuttosto che un worktree.

584

585 Dopo quel rifiuto, scegli:

586

587 * Per mantenere i commit, spingili, o uniscili in quel ramo predefinito, quindi elimina la sessione di nuovo.

588 * Per scartarli, elimina la sessione di nuovo senza spingere: premi `Ctrl+X` due volte sulla sua riga in agent view, o esegui il comando `claude rm <id> --discard-unpushed` che il rifiuto ha stampato. Questo rimuove la sessione e il worktree insieme al suo ramo, scartando i commit non spinti e qualsiasi cambiamento non committato.

589

590 Quando elimini di nuovo, Claude Code scarta solo ciò che il rifiuto ha mostrato: se il worktree ha guadagnato un commit da allora, Claude Code lo mantiene di nuovo e mostra lo stato aggiornato.

591

592 Quando i record di un'altra sessione finita nominano anche il worktree, rimane quando elimini di nuovo; spingere i commit, quindi eliminare di nuovo.

593* Un worktree che git non riconosce più, ad esempio dopo `git worktree prune`, non blocca l'eliminazione. Claude Code elimina la sessione e lascia la directory su disco.

594* Quando git o il tuo [`WorktreeRemove` hook](/docs/it/hooks#worktreeremove) non riesce a rimuovere il worktree, Claude Code mantiene il worktree e la sessione, e il messaggio nomina la causa. Per un hook, il messaggio dice come è terminato, come `exited 1`, e cita l'inizio del suo stderr. Il messaggio ti dice anche quale di questi fare dopo:

595

596 * Elimina la sessione di nuovo per rimuovere la directory comunque, premendo `Ctrl+X` due volte sulla sua riga in agent view o eseguendo il comando `claude rm <id> --force-remove-worktree <worktree-id>` che il rifiuto di `claude rm` ha stampato. Claude Code offre questo solo quando può confermare che la directory è uno dei worktree collegati del repository sotto `.claude/worktrees/` senza cambiamenti non committati ai file tracciati, nessun repository annidato dentro, e nessun record di un'altra sessione che lo nomina. Il ramo del worktree rimane nel repository.

597 * Correggi ciò che sta nel modo, come committare o stash dei cambiamenti non committati, chiudere tutto ciò che sta usando la directory, o correggere l'hook, quindi elimina la sessione di nuovo.

598 * Rimuovi la directory tu stesso, quindi elimina la sessione di nuovo.

599

600Un worktree che hai creato tu stesso e in cui hai avviato la sessione viene lasciato in posizione in entrambi i casi.

601

602Una sessione il cui worktree directory non appartiene a nessun repository git, perché il repository è stato eliminato o un [`WorktreeCreate` hook](/docs/it/hooks#worktreecreate) ha creato la directory altrove, può comunque essere eliminata. Mentre i file rimangono nella directory:

603

604* Agent view chiede lo stesso doppio `Ctrl+X` prima di scartarli. Per una directory creata da hook esegue il tuo [`WorktreeRemove` hook](/docs/it/hooks#worktreeremove) invece, e senza uno rifiuta l'eliminazione e mantiene la sessione.

605* `claude rm` mantiene la sessione e il worktree, e nomina il motivo.

606

607Entrambi i percorsi mantengono una directory che i record di un'altra sessione finita nominano.

608

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

488 Imposta il modello610 Imposta il modello

489</h3>611</h3>

490 612

491Il nome del modello mostrato nell'intestazione di agent view è il default di dispatch. Le nuove sessioni che avvii dall'input utilizzano questo modello, che proviene dall'impostazione [`model`](/docs/it/settings#available-settings) nei tuoi settings utente. Impostalo selezionando un modello nel picker [`/model`](/docs/it/model-config), o modifica l'impostazione direttamente.613Il nome del modello mostrato nell'intestazione di agent view è il default di dispatch. Le nuove sessioni che avvii dall'input utilizzano questo modello, che proviene dall'impostazione [`model`](/docs/it/settings-reference#model) nei tuoi settings utente. Impostalo selezionando un modello nel picker [`/model`](/docs/it/model-config), o modifica l'impostazione direttamente.

492 614

493Per sovrascrivere il default di dispatch per l'intera sessione di agent view, passa `--model` quando apri agent view. Vedi [Permission mode, model, and effort](#permission-mode-model-and-effort).615Per sovrascrivere il default di dispatch per l'intera sessione di agent view, passa `--model` quando apri agent view. Vedi [Permission mode, model, and effort](#permission-mode-model-and-effort).

494 616

511 Permission mode, model, and effort633 Permission mode, model, and effort

512</h3>634</h3>

513 635

514Una sessione in background legge i suoi [settings](/docs/it/settings) dalla directory in cui viene eseguita, come se avessi avviato `claude` lì. Questo include i valori [`env`](/docs/it/settings#available-settings) nei settings del progetto, quindi un `ANTHROPIC_MODEL` o una variabile del provider impostata lì si applica alle sessioni in background in quella directory.636Una sessione in background prende le sue impostazioni, provider, modalità di autorizzazione, modello e sforzo da dove e come l'hai inviata. Le sottosezioni di seguito coprono ogni fonte, e cosa persiste quando il supervisore riavvia la sessione.

637

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

639 Impostazioni e provider

640</h4>

641

642Una sessione in background legge le sue [impostazioni](/docs/it/settings) dalla directory in cui viene eseguita, come se avessi avviato `claude` lì. Questo include i valori [`env`](/docs/it/settings-reference#env) nelle impostazioni del progetto, quindi un `ANTHROPIC_MODEL` o una variabile del provider impostata lì si applica a ogni sessione in background in quella directory.

643

644Una sessione in background viene anche eseguita con il `PATH` della shell da cui l'hai inviata, quindi i comandi che esegue trovano gli stessi strumenti del tuo terminale. Mantiene anche la selezione del cloud provider di quella shell, come `CLAUDE_CODE_USE_BEDROCK` o `CLAUDE_CODE_USE_VERTEX`, insieme ai suoi alias `ANTHROPIC_DEFAULT_*_MODEL` e qualsiasi override [`CLAUDE_CODE_EXTRA_BODY`](/docs/it/env-vars) che hai esportato lì.

645

646<h4 id="llm-gateway">

647 Gateway LLM

648</h4>

649

650Se instrada Claude Code attraverso un [gateway LLM](/docs/it/llm-gateway), metti le variabili del gateway in un blocco `env` di un file di impostazioni piuttosto che esportarle nella tua shell, e le sessioni in background le leggono insieme al resto delle loro impostazioni. [Imposta in un file di impostazioni](/docs/it/llm-gateway-connect#set-in-a-settings-file) mostra il blocco e quale file di impostazioni usare per la credenziale.

515 651

516La selezione del cloud provider, come `CLAUDE_CODE_USE_BEDROCK` o `CLAUDE_CODE_USE_VERTEX`, e gli alias `ANTHROPIC_DEFAULT_*_MODEL` seguono la shell che ha inviato la sessione. Se esporti un override del corpo della richiesta [`CLAUDE_CODE_EXTRA_BODY`](/docs/it/env-vars) in quella shell, raggiunge la sessione nello stesso modo. Prima di v2.1.206, i worker in background ignoravano un `CLAUDE_CODE_EXTRA_BODY` esportato dalla shell.652Se esporti un gateway `ANTHROPIC_BASE_URL` solo nella tua shell, raggiunge una sessione in background, insieme a `ANTHROPIC_CUSTOM_HEADERS` e la credenziale che hai esportato con esso, solo quando il [supervisore](#the-supervisor-process) stesso è stato avviato da una shell che ha esportato lo stesso gateway, e solo in questi casi:

517 653

518Se esporti un gateway `ANTHROPIC_BASE_URL` nella shell di dispatch, raggiunge la sessione anche, insieme a `ANTHROPIC_CUSTOM_HEADERS`, quando il supervisore viene eseguito con lo stesso ambiente gateway e la sessione viene eseguita nella directory da cui hai inviato o è la tua sessione messa in background con `←` o `/background`. Questo è il caso normale quando la prima shell ad aprire agent view o inviare una sessione in background è la shell gateway. L'invio in una directory diversa con `@repo` o `--cwd` non trasporta il gateway della shell; le [impostazioni](/docs/it/settings) di quel progetto forniscono l'endpoint. Vedi [il processo supervisore](#the-supervisor-process) per come le sessioni in background ottengono le impostazioni del provider e le credenziali.654* Metti in background la tua sessione con `←` o `/background`

655* Invii una sessione nella directory in cui sei

656* Svegli una sessione fermata nella directory in cui sei collegandoti o rispondendo ad essa

519 657

520Il [permission mode](/docs/it/permissions) dipende da come hai avviato la sessione. Lo spostamento in background di una sessione esistente con `/bg` o `←` mantiene il permission mode corrente, quindi una sessione che hai cambiato in `acceptEdits` o `auto` rimane in quella modalità dopo il distacco. L'invio da agent view input o l'esecuzione di `claude --bg` dalla tua shell utilizza il `defaultMode` dai settings di quella directory, o il `permissionMode` dal frontmatter del [subagent inviato](/docs/it/sub-agents#supported-frontmatter-fields).658Claude Code inoltra un gateway davanti a un cloud provider. Se la shell da cui invii seleziona il provider ed esporta il suo endpoint del gateway con il suo flag di bypass dell'autenticazione, Claude Code inoltra la coppia endpoint-e-flag alla sessione nelle condizioni che si applicano a `ANTHROPIC_BASE_URL`, insieme a `ANTHROPIC_CUSTOM_HEADERS`. Ad esempio, esporta `CLAUDE_CODE_USE_VERTEX=1` con `ANTHROPIC_VERTEX_BASE_URL` e `CLAUDE_CODE_SKIP_VERTEX_AUTH=1`, e Claude Code inoltra quell'endpoint e flag.

521 659

522Il permission mode, il modello e lo sforzo con cui una sessione in background è stata avviata, insieme ai [flag di configurazione che trasporta](#from-inside-a-session), persistono tutti quando il supervisore successivamente [arresta e riavvia](#the-supervisor-process) il processo della sessione. Una sessione che hai lanciato con `claude --bg --dangerously-skip-permissions` o `claude --bg --permission-mode bypassPermissions` rimane in `bypassPermissions` dopo quel riavvio invece di tornare al `defaultMode` della directory, e un modello o sforzo che hai cambiato a metà sessione con `/model` o `/effort` viene mantenuto.660Claude Code applica un gateway inoltrato solo al processo in esecuzione di quella sessione e non lo scrive mai su disco.

523 661

524Uno sforzo che la sessione ha preso dall'impostazione [`effortLevel`](/docs/it/settings#available-settings) piuttosto che da `--effort` o `/effort` non è fissato al dispatch: ogni processo avviato per la sessione legge di nuovo l'impostazione, quindi modificare `effortLevel` in `settings.json` raggiunge le sessioni che metti in background con `←` o `/bg` e i loro successivi riavvii. Prima di v2.1.203, mettere in background una sessione registrava il suo sforzo derivato dalle impostazioni come se avessi passato `--effort`, quindi i successivi edit di `effortLevel` non lo raggiungevano mai.662<h4 id="permission-mode">

663 Modalità di autorizzazione

664</h4>

665

666La [modalità di autorizzazione](/docs/it/permissions) dipende da come hai avviato la sessione:

667

668* **Messa in background con `/bg` o `←`**: Claude Code mantiene la modalità di autorizzazione in cui era la sessione, quindi una che hai cambiato in `acceptEdits` o `auto` rimane lì dopo il distacco

669* **Inviata da un agent view che hai aperto con `←`**: la configurazione del target viene prima, e la modalità di autorizzazione della sessione da cui sei venuto si applica quando nulla altro ne imposta una

670* **Inviata da `claude agents` avviato in una shell, o con `claude --bg`**: la nuova sessione inizia come una nuova sessione `claude` in quella directory, a meno che non l'abbia inviata da un agent view che hai aperto con [dispatch defaults](#dispatch-defaults). [Quale modalità di autorizzazione una sessione inizia](/docs/it/permission-modes#which-mode-a-session-starts-in) elenca l'ordine

671

672Per una sessione che invii da un agent view aperto con `←`, Claude Code prende la modalità di autorizzazione dal primo di questi che si applica:

673

6741. La [`permissions.defaultMode`](/docs/it/settings-reference#permissions-defaultmode) della directory target. Due regole di origine si applicano:

675 * `auto` e `bypassPermissions` [hanno effetto solo dalle impostazioni gestite, un file `--settings`, o `~/.claude/settings.json`](/docs/it/settings-reference#permissions-defaultmode).

676 * Claude Code rifiuta un `defaultMode` dal `.claude/settings.json` o `.claude/settings.local.json` del progetto che seleziona una modalità più permissiva di quella in cui era la sessione da cui sei venuto.

6772. La modalità di autorizzazione della sessione da cui sei venuto

525 678

526Un nome che hai impostato con [`/rename`](/docs/it/commands) o `Ctrl+R` persiste anche attraverso quel riavvio, quindi [`claude --resume <name>`](/docs/it/sessions#name-your-sessions) risolve ancora la sessione. Prima di v2.1.202, il riavvio ripristinava la sessione al nome con cui era stata inviata e il nuovo nome smetteva di risolvere.679Quando Claude Code rifiuta la modalità di una fonte come troppo permissiva, la fonte successiva nell'elenco decide. Ad esempio, se invii da una sessione in modalità piano in una directory le cui impostazioni controllate chiedono `acceptEdits`, la nuova sessione inizia in modalità piano. Se sposti quel `defaultMode` a `~/.claude/settings.json`, si applica indipendentemente dalla modalità di autorizzazione della sessione da cui sei venuto.

680

681La permissività corre piano, poi Manual e `dontAsk`, poi `acceptEdits` e auto, che ognuno conta come più permissivo dell'altro, poi `bypassPermissions`.

682

683<h4 id="dispatch-defaults">

684 Dispatch defaults

685</h4>

527 686

528Per impostare i default per ogni sessione che invii da agent view, passa uno qualsiasi di `--permission-mode`, `--model`, `--effort`, o `--agent` quando lo apri:687Per impostare i default per ogni sessione che invii da agent view, passa uno qualsiasi di `--permission-mode`, `--model`, `--effort`, o `--agent` quando lo apri:

529 688

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

532```691```

533 692

534`--agent` imposta il [subagent](/docs/it/sub-agents) utilizzato quando un prompt di dispatch non ne nomina uno, sia con `@name` che come prima parola. Per impostazione predefinita, utilizza l'impostazione [`agent`](/docs/it/settings#available-settings) se ne è impostata una, altrimenti l'agente catch-all integrato `claude`. Nominare un subagent nell'input di dispatch sovrascrive entrambi.693`--effort` qui accetta gli stessi valori del [flag `--effort` di livello superiore](/docs/it/cli-reference#cli-flags), incluso `ultracode`.

694

695`--agent` imposta il [subagent](/docs/it/sub-agents) utilizzato quando un prompt di dispatch non ne nomina uno, sia con `@name` che come prima parola. Per impostazione predefinita, utilizza l'impostazione [`agent`](/docs/it/settings-reference#agent) se ne è impostata una, altrimenti l'agente catch-all integrato `claude`. Nominare un subagent nell'input di dispatch sovrascrive entrambi.

535 696

536`claude agents` accetta anche `--dangerously-skip-permissions` come abbreviazione per `--permission-mode bypassPermissions`, e `--allow-dangerously-skip-permissions` per rendere `bypassPermissions` disponibile nel ciclo `Shift+Tab` di ogni sessione inviata senza avviare in quella modalità. Entrambi corrispondono ai [flag CLI di livello superiore](/docs/it/cli-reference).697`claude agents` accetta anche `--dangerously-skip-permissions` come abbreviazione per `--permission-mode bypassPermissions`, e `--allow-dangerously-skip-permissions` per rendere `bypassPermissions` disponibile nel ciclo `Shift+Tab` di ogni sessione inviata senza avviare in quella modalità. Entrambi corrispondono ai [flag CLI di livello superiore](/docs/it/cli-reference).

537 698

699Passa `--restricted` per avviare ogni sessione che invii dalla vista in [modalità ristretta](/docs/it/cli-reference#cli-flags), come se ognuna fosse lanciata con il flag di livello superiore `--restricted`. Richiede Claude Code v2.1.248 o successivo.

700

538I default attivi appaiono nel footer sotto l'input di dispatch.701I default attivi appaiono nel footer sotto l'input di dispatch.

539 702

540Senza questi flag, la sessione utilizza il `defaultMode` dai settings di quella directory o il `permissionMode` dal frontmatter del [subagent inviato](/docs/it/sub-agents#supported-frontmatter-fields), e il modello mostrato nell'intestazione di agent view.703Claude Code rifiuta `claude --bg --permission-mode bypassPermissions` finché non hai accettato il disclaimer di bypass eseguendo `claude --dangerously-skip-permissions` una volta in modo interattivo, poiché quella modalità permette a una sessione che non stai guardando di agire senza approvazione. Passare `--dangerously-skip-permissions` o `--permission-mode bypassPermissions` a `claude agents` mostra lo stesso disclaimer quando non l'hai accettato prima, e accettare applica `bypassPermissions` alle sessioni che avvii dalla vista. Passare `--allow-dangerously-skip-permissions` mostra lo stesso disclaimer anche, e accettare rende `bypassPermissions` disponibile nel ciclo `Shift+Tab` di quelle sessioni senza avviarle in esso.

704

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

706 Cosa persiste attraverso i riavvii

707</h4>

708

709La modalità di autorizzazione, il modello e lo sforzo che hai scelto per una sessione in background, insieme ai [flag di configurazione che trasporta](#what-carries-over-when-you-background), persistono tutti quando il supervisore successivamente [arresta e riavvia](#the-supervisor-process) il processo della sessione. Una sessione che hai lanciato con `claude --bg --dangerously-skip-permissions` o `claude --bg --permission-mode bypassPermissions` rimane in `bypassPermissions` dopo quel riavvio. Un modello o sforzo che hai cambiato a metà sessione con `/model` o `/effort` viene mantenuto anche.

710

711Se la sessione ha preso il suo sforzo dalle tue impostazioni piuttosto che da `--effort` o `/effort`, Claude Code legge di nuovo le tue impostazioni ogni volta che avvia un processo per la sessione. Dopo aver modificato lo sforzo salvato in `settings.json`, il cambiamento raggiunge le sessioni che metti in background con `←` o `/bg`, e i loro successivi riavvii. Lo sforzo salvato è la chiave [`effortLevel`](/docs/it/settings-reference#effortlevel) o una voce [`modelSettings`](/docs/it/settings-reference#modelsettings).

541 712

542L'uso di `bypassPermissions` con `claude --bg --permission-mode` è rifiutato finché non hai accettato il disclaimer di bypass eseguendo `claude --dangerously-skip-permissions` una volta in modo interattivo, poiché quella modalità permette a una sessione che non stai guardando di agire senza approvazione. Passare `--dangerously-skip-permissions` o `--permission-mode bypassPermissions` a `claude agents` mostra lo stesso disclaimer quando non l'hai accettato prima, e accettare applica `bypassPermissions` alle sessioni che avvii dalla vista. Passare `--allow-dangerously-skip-permissions` mostra lo stesso disclaimer anche, e accettare rende `bypassPermissions` disponibile nel ciclo `Shift+Tab` di quelle sessioni senza avviarle in esso.713Claude Code mantiene anche un nome che hai impostato con [`/rename`](/docs/it/commands) o `Ctrl+R` attraverso quel riavvio, quindi puoi ancora eseguire [`claude --resume <name>`](/docs/it/sessions#name-your-sessions) per raggiungere la sessione.

714

715Un prompt che hai stashed con [`Ctrl+S`](/docs/it/interactive-mode#general-controls) mentre collegato viene mantenuto con la sessione anche. Riapri la sessione dopo che il suo processo è stato fermato o riavviato, e `Ctrl+S` ripristina il testo stashed. Il contenuto incollato nello stash non sopravvive al riavvio.

543 716

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

545 Settings, plugins, and MCP servers718 Impostazioni, plugin, e server MCP

546</h3>719</h3>

547 720

548Agent view accetta gli stessi flag di configurazione di `claude` per caricare settings, plugins, server MCP, e directory aggiuntive. Ogni flag si applica a agent view stesso e viene passato a ogni sessione che invii da esso, quindi un plugin o server MCP che carichi in questo modo è disponibile anche in quelle sessioni.721Agent view accetta gli stessi flag di configurazione di `claude` per caricare impostazioni, plugin, server MCP, e directory aggiuntive. Agent view applica `--settings` e `--plugin-dir` a se stesso e passa ogni flag di configurazione alle sessioni che invii da esso, quindi un plugin o server MCP che carichi in questo modo è disponibile in quelle sessioni.

549 722

550| Flag | Effetto |723| Flag | Effetto |

551| :----------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------- |724| :----------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

553| [`--add-dir <path>`](/docs/it/permissions#additional-directories-grant-file-access-not-configuration) | Concedi accesso ai file a una directory aggiuntiva |726| [`--add-dir <path>`](/docs/it/permissions#additional-directories-grant-file-access-not-configuration) | Concedi accesso ai file a una directory aggiuntiva |

556| `--strict-mcp-config` | Usa solo i server MCP da `--mcp-config`, ignorando altre configurazioni MCP |729| `--strict-mcp-config` | Usa solo i server MCP da `--mcp-config`, ignorando altre configurazioni MCP. Vedi [Controllo esclusivo con managed-mcp.json](/docs/it/managed-mcp#exclusive-control-with-managed-mcp-json) per cosa fa il flag sotto un file MCP gestito |

730

731Ripeti `--add-dir`, `--plugin-dir`, o `--mcp-config` una volta per valore. `claude agents` non supporta la forma separata da spazi, come `--add-dir a b c`.

557 732

558Ripeti `--add-dir`, `--plugin-dir`, o `--mcp-config` una volta per valore. La forma separata da spazi, come `--add-dir a b c`, non è supportata con `claude agents`.733Puoi mettere `--settings` e `--plugin-dir` prima o dopo `agents`. Mantieni `--add-dir` e `--mcp-config` dopo `agents`: se metti uno di questi prima di `agents`, [`claude agents --json`](#manage-sessions-from-the-shell) fallisce con un errore `unknown option`.

559 734

560L'esempio seguente apre agent view con un override di settings e una directory extra:735L'esempio seguente apre agent view con un override di impostazioni e una directory extra:

561 736

562```bash theme={null}737```bash theme={null}

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

564```739```

565 740

741`--settings` accetta un percorso di file o una stringa JSON inline. Un percorso di file deve puntare a un file esistente; Claude Code esce con un errore `Settings file not found` se non lo fa.

742

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

567 Gestire le sessioni dalla shell744 Gestire le sessioni dalla shell

568</h2>745</h2>

570Ogni sessione in background ha un ID breve che puoi usare dalla shell. L'ID viene stampato quando avvii una sessione con `claude --bg`, e l'ID di ogni sessione è il nome della sua directory sotto `~/.claude/jobs/`. Questi comandi sono utili per lo scripting o quando non vuoi aprire agent view.747Ogni sessione in background ha un ID breve che puoi usare dalla shell. L'ID viene stampato quando avvii una sessione con `claude --bg`, e l'ID di ogni sessione è il nome della sua directory sotto `~/.claude/jobs/`. Questi comandi sono utili per lo scripting o quando non vuoi aprire agent view.

571 748

572| Comando | Scopo |749| Comando | Scopo |

573| :--------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |750| :--------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

576| `claude agents --json` | Stampa le sessioni attive come un array JSON e esci: ogni sessione live, più sessioni in background che stanno ancora lavorando o sono bloccate anche quando il loro processo è uscito. Aggiungi `--all` per includere anche le sessioni in background completate. Ogni voce ha `cwd`, `kind`, e `startedAt`. Le voci in background hanno anche `id`, utilizzabile con `claude attach`/`logs`/`stop`, e `state`: uno di `working`, `blocked`, `done`, `failed`, o `stopped`. `pid` e `status` sono presenti solo mentre il processo è attivo, più `waitingFor` quando status è `waiting`, che dice su cosa è bloccata la sessione, come `permission prompt` o `input needed`; `sessionId` e `name` appaiono quando impostati. Una voce interattiva che non hai mai nominato porta un nome predefinito costruito dal nome della directory di lavoro più un suffisso di due caratteri, come `my-app-3f`. Combina con `--cwd <path>` per filtrare |753| `claude agents --json` | Stampa le sessioni come un array JSON e esci. Vedi [Elencare le sessioni come JSON](#list-sessions-as-json) |

580| `claude respawn <id>` | Riavvia una sessione, in esecuzione o fermata, con la sua conversazione intatta, ad esempio per utilizzare un binario Claude Code aggiornato |757| `claude respawn <id>` | Riavvia una sessione, in esecuzione o fermata, ad esempio per utilizzare un binario Claude Code aggiornato. La sessione riavviata riprende la sua conversazione salvata; quando nessuna è su disco, esegue di nuovo il suo prompt originale come una nuova conversazione |

581| `claude respawn --all` | Riavvia ogni sessione in esecuzione, ad esempio per spostare tutte le sessioni su un binario Claude Code aggiornato contemporaneamente |758| `claude respawn --all` | Riavvia ogni sessione in esecuzione, ad esempio per spostare tutte le sessioni su un binario Claude Code aggiornato contemporaneamente |

582| `claude rm <id>` | Rimuovi una sessione dall'elenco. Rimuove un worktree creato da Claude per la sessione se non ha modifiche non sottoposte a commit e nessun commit che non sia stato sottoposto a push da nessuna parte; altrimenti la sessione viene mantenuta anche, e il comando stampa il percorso del worktree e il motivo in modo che tu possa risolverlo ed eseguire di nuovo `claude rm`. Lascia in posizione un worktree che hai creato tu stesso. La trascrizione della conversazione rimane sulla tua macchina locale e rimane disponibile tramite `claude --resume` |759| `claude rm <id>` | Rimuovi una sessione dall'elenco, insieme a un worktree creato da Claude per essa quando è sicuro eliminarlo; vedi [Cosa elimina l'eliminazione di una sessione](#what-deleting-a-session-removes). La trascrizione della conversazione rimane sulla tua macchina locale e rimane disponibile tramite `claude --resume` |

760| `claude rm <id> --discard-unpushed <commit>@<worktree-id>` | Elimina una sessione il cui eliminazione è stata rifiutata a causa di commit non sottoposti a push, scartando il worktree insieme al suo ramo e ai commit. Passa il valore esatto che il rifiuto ha stampato; vedi [Cosa elimina l'eliminazione di una sessione](#what-deleting-a-session-removes). Richiede v2.1.260 o successivo |

761| `claude rm <id> --force-remove-worktree <worktree-id>` | Elimina una sessione il cui eliminazione è stata rifiutata perché git o l'hook `WorktreeRemove` non potevano rimuovere il suo worktree, eliminando comunque la directory del worktree e lasciando il suo ramo nel repository. Passa il valore esatto che il rifiuto ha stampato; vedi [Cosa elimina l'eliminazione di una sessione](#what-deleting-a-session-removes). Richiede v2.1.268 o successivo |

583| `claude daemon status` | Stampa lo stato del [supervisore](#the-supervisor-process), la versione, la directory socket e il numero di worker |762| `claude daemon status` | Stampa lo stato del [supervisore](#the-supervisor-process), la versione, la directory socket e il numero di worker |

584| `claude daemon stop --any` | Ferma il processo supervisore e le sessioni in background che ospita. Passa `--keep-workers` per lasciare le sessioni in background in esecuzione in modo che il supervisore successivo si riconnetta ad esse. Il prossimo `claude agents` o `claude --bg` avvia un supervisore nuovo |763| `claude daemon stop --any` | Ferma il processo supervisore e le sessioni in background che ospita. Passa `--keep-workers` per lasciare le sessioni in background in esecuzione in modo che il supervisore successivo si riconnetta ad esse. Il prossimo `claude agents` o `claude --bg` avvia un supervisore nuovo |

585 764

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

587 Come sono ospitate le sessioni in background766 Elencare le sessioni come JSON

588</h2>

~~589~~

590Ogni sessione elencata nella vista agente è considerata una sessione in background, indipendentemente dal fatto che tu sia attualmente collegato ad essa. Al contrario, una sessione avviata eseguendo `claude` direttamente è legata a quel terminale e termina quando si chiude, a meno che tu non la [invii in background](#from-inside-a-session).

~~591~~

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

593 Il processo supervisor

594</h3>767</h3>

595 768

596Le sessioni in background sono ospitate da un processo supervisor per utente, separato dal tuo terminale e da agent view. Il supervisor si avvia automaticamente la prima volta che metti una sessione in background o apri agent view, e non lo gestisci direttamente.769`claude agents --json` stampa le sessioni attive come un array JSON e esci: ogni sessione live, più sessioni in background che stanno ancora lavorando o sono bloccate anche quando il loro processo è uscito. Aggiungi `--all` per includere anche le sessioni in background completate, e `--cwd <path>` per limitare l'elenco alle sessioni avviate sotto quella directory.

~~597~~

598Quando un aggiornamento ha sostituito o rimosso il binario da cui è stato avviato un processo Claude Code in esecuzione, quel processo avvia il supervisor da un'altra copia installata, come il launcher `claude` installato o la versione più recente su disco.

~~599~~

600Il supervisor mantiene un processo worker pre-riscaldato pronto in modo che un dispatch da agent view o `claude --bg` si avvii senza il ritardo di un avvio a freddo. Quando esegui un dispatch, il supervisor assegna il worker pre-riscaldato alla tua sessione, applica la directory, le impostazioni e le credenziali di quella sessione ad esso, e quindi avvia una sostituzione per il prossimo dispatch. Se nessun worker pre-riscaldato sano è disponibile, il supervisor avvia un processo fresco invece.

601 770

602Il supervisor e le sue sessioni si autenticano con le stesse credenziali archiviate delle tue sessioni interattive e non fanno connessioni di rete aggiuntive oltre l'API del modello. Le variabili di selezione del provider come `CLAUDE_CODE_USE_BEDROCK` e gli alias `ANTHROPIC_DEFAULT_*_MODEL` vengono letti dalla shell che ha eseguito il dispatch di ogni sessione e vengono applicati al suo worker.771Ogni voce descrive una sessione:

603 772

604Il `PATH` della shell di dispatch viene applicato al worker allo stesso modo, quindi i comandi shell che la sessione esegue trovano gli stessi strumenti del tuo terminale. Prima di v2.1.203, una sessione in background manteneva il `PATH` della shell che ha avviato per primo il supervisor, quindi gli strumenti aggiunti al tuo `PATH` da allora potevano mancare, il più delle volte su Windows.773| Campo | Presente | Descrizione |

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

775| `cwd`, `kind`, `startedAt` | Sempre | La directory di lavoro, `interactive` o `background`, e l'ora di inizio in millisecondi Unix |

776| `id` | Sessioni in background | ID breve, utilizzabile con `claude attach`, `claude logs`, e `claude stop` |

777| `state` | Sessioni in background | Uno di `working`, `blocked`, `done`, `failed`, o `stopped`. Vedi [Leggere lo stato della sessione da uno script](#read-session-state-from-a-script) per sapere cosa significa ogni valore |

778| `pid`, `status` | Mentre il processo è attivo | ID del processo e uno di `busy`, `waiting`, o `idle` |

779| `waitingFor` | Quando `status` è `waiting` | Su cosa è bloccata la sessione: `permission prompt` per un'approvazione, `input needed` per una domanda da Claude o una richiesta di input da un server MCP, `sandbox request`, `worker request`, o `dialog open` |

780| `sessionId`, `name` | Quando impostati | `sessionId` è l'UUID completo della sessione, utilizzabile con [`claude --resume`](/docs/it/sessions). Il `name` di una sessione interattiva è il suo [nome di visualizzazione predefinito](/docs/it/sessions#name-your-sessions) finché non nomini la sessione o accetti un piano in essa |

605 781

606Una sessione in background non eredita variabili di endpoint gateway come `ANTHROPIC_BASE_URL` o le variabili di URL base equivalenti di Amazon Bedrock, Google Cloud's Agent Platform, e Microsoft Foundry dalla shell che ha avviato il supervisor. Senza un gateway esportato nella shell da cui esegui il dispatch, la sessione utilizza le tue credenziali archiviate e qualsiasi valore `env` nella directory del progetto [settings](/docs/it/settings). Per puntare ogni sessione in un progetto a un [gateway LLM](/docs/it/llm-gateway), imposta `ANTHROPIC_BASE_URL` nel blocco `env` del file `.claude/settings.json` di quel progetto.782<h3 id="read-session-state-from-a-script">

~~607~~ 783 Leggere lo stato della sessione da uno script

608Se esporti un gateway `ANTHROPIC_BASE_URL` nella shell da cui esegui il dispatch, raggiunge il worker di quella sessione. `ANTHROPIC_CUSTOM_HEADERS` e la credenziale esportata insieme ad essi vengono inoltrati con esso. Questo accade quando il supervisor è stato avviato da un ambiente con lo stesso gateway. Il supervisor cattura il suo ambiente dalla prima shell che apre agent view o esegue il dispatch di una sessione in background, quindi avviare dalla shell del gateway gli dà quell'ambiente. L'inoltro si applica anche solo alle sessioni inviate nella directory da cui stai eseguendo il dispatch, o messe in background dalla tua stessa sessione con `←` o `/background`: eseguire il dispatch in una directory diversa con `@repo` o `--cwd` non porta il gateway della shell, e il blocco `env` del file `settings.json` di quel progetto fornisce l'endpoint invece. Quando l'ambiente del supervisor porta un gateway diverso o nessuno, il worker mantiene le tue credenziali archiviate contro l'endpoint predefinito invece di mescolare la credenziale di un ambiente con l'endpoint di un altro. Prima di v2.1.203, il `ANTHROPIC_BASE_URL` della shell di dispatch veniva eliminato mentre il `ANTHROPIC_API_KEY` esportato insieme ad esso veniva mantenuto, quindi la chiave del gateway veniva inviata all'endpoint predefinito e ogni richiesta falliva con un 401.784</h3>

~~609~~

610L'endpoint inoltrato si applica solo a quel processo attivo e non viene mai scritto su disco. Quando il supervisor ferma una sessione inattiva e successivamente la riavvia, il processo riavviato legge il suo endpoint dalle tue impostazioni di nuovo: con un `ANTHROPIC_AUTH_TOKEN` del gateway torna alle tue credenziali archiviate, e con un `ANTHROPIC_API_KEY` emesso dal gateway può non riuscire ad autenticarsi fino a quando il gateway non è impostato nelle impostazioni.

~~611~~

612Ogni sessione in background è il suo proprio processo Claude Code, gestito dal supervisor piuttosto che legato al tuo terminale. Una sessione che sta attivamente lavorando, aspettando il tuo input, o ha un terminale collegato mantiene il suo processo in esecuzione. Un comando shell in background in esecuzione, un subagente, un workflow dinamico, o un monitor conta come lavoro attivo, quindi un processo a lunga esecuzione come un server di sviluppo mantiene la sessione attiva.

613 785

614Una volta che una sessione finisce e rimane scollega per circa un'ora, il supervisor ferma il suo processo per liberare risorse. Una sessione che hai [fissato](#organize-the-list) con `Ctrl+T` è esente e mantiene il suo processo in esecuzione mentre inattivo. Il transcript e lo stato rimangono su disco comunque, e la prossima volta che ti colleghi, fai peek, o rispondi a una sessione fermata, il supervisor avvia un processo fresco da dove l'ha lasciato. Quando ogni sessione è finita e nessun terminale è collegato, il supervisor stesso esce e si avvia di nuovo la prossima volta che ne hai bisogno.786`claude agents --json` è il modo supportato per leggere lo stato della sessione dall'esterno di Claude Code, ad esempio da una barra di stato, un pianificatore, o un'altra sessione Claude che supervisiona il lavoro in background. Esegui il polling di `claude agents --json --all`, che continua a elencare le sessioni il cui processo è uscito, e leggi `state`, `status`, e `waitingFor` di ogni voce.

615 787

616Il lavoro in background che la sessione stessa ha avviato al livello superiore viene consegnato quando il suo processo viene fermato, riavviato, o aggiornato, incluso su Windows. Il prossimo processo avviato per quella sessione lo riprende:788| `state` | Cosa significa |

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

790| `working` | Un turno è in esecuzione, o la sessione è tra i passaggi del lavoro che guida da sola, come un'iterazione [`/loop`](/docs/it/scheduled-tasks) o un'attesa su CI. `status` ti dice se il suo processo è `busy` in questo momento |

791| `blocked` | La sessione è in attesa di te: una domanda che ha posto, una decisione di permesso o sandbox, un errore che solo tu puoi cancellare come un login scaduto, o il suo primo prompt se l'hai avviata senza uno. Quando l'attesa è un prompt aperto in un processo live, `waitingFor` lo nomina |

792| `done` | L'ultimo turno ha finito quello che hai chiesto e la sessione è pronta per il tuo prossimo prompt, indipendentemente dal fatto che il suo processo sia ancora attivo o meno |

793| `failed`, `stopped` | L'attività è terminata con un errore, o la sessione è stata fermata |

617 794

618* Un comando shell in background che è finito nel frattempo viene segnalato come completato con il suo output795Una sessione che ha finito il suo turno e sta aspettando la tua prossima istruzione legge `done`, non `blocked`. `blocked` significa sempre che la sessione ha bisogno di qualcosa da te prima di poter continuare.

619* Un workflow dinamico riprende da dove l'ha lasciato

620* Un [subagente in background](/docs/it/sub-agents#run-subagents-in-foreground-or-background) riprende dal suo proprio transcript

621 796

622A partire da v2.1.198 la consegna copre tutti e tre. Prima di v2.1.198 copriva solo i comandi shell e i workflow, quindi un subagente in background si fermava con il processo e veniva segnalato come fallito al prossimo risveglio.797I file sotto `~/.claude/jobs/<id>/` non sono un'interfaccia stabile. I valori che una sessione o un altro programma scrive in `state`, `detail`, `tempo`, o `needs` vengono sostituiti al prossimo aggiornamento.

623 798

624Il lavoro il cui stato vive solo all'interno del processo stesso si ferma con esso invece di essere consegnato. Questo riguarda i comandi shell che un subagente ha avviato, che il subagente ripreso può avviare di nuovo, e i [monitor](/docs/it/tools-reference#monitor-tool) in esecuzione, il cui flusso di eventi non può essere spostato in un altro processo.799Se vuoi che una sessione segnali il progresso con le sue stesse parole, falle scrivere un file proprio, ad esempio sotto `$CLAUDE_JOB_DIR/tmp`, invece di modificare `state.json`.

625 800

626L'eliminazione della sessione ferma tutto ciò che ha consegnato. Per fermare tutto il lavoro in background della sessione con il processo invece di consegnarlo, imposta la variabile di ambiente [`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/docs/it/env-vars#variables) su `1`.801<h2 id="how-background-sessions-are-hosted">

802 Come sono ospitate le sessioni in background

803</h2>

627 804

628Un processo riavviato trova la conversazione di una sessione che [si è spostata in un worktree](#how-file-edits-are-isolated) a metà attività: quando il transcript non è dove la sessione è stata avviata, Claude Code cerca anche sotto i worktree registrati del repository. Prima di v2.1.207, riaprire quella sessione da agent view dopo che il suo processo si era fermato poteva mostrare una conversazione vuota con solo il suo prompt originale, con il transcript ancora intatto su disco; aprire la sessione di nuovo su v2.1.207 o successivo lo recupera.805Claude Code tratta ogni sessione elencata nella vista agente come una sessione in background, indipendentemente dal fatto che tu sia attualmente collegato ad essa. Al contrario, una sessione avviata eseguendo `claude` direttamente è legata a quel terminale e termina quando si chiude, a meno che tu non la [invii in background](#from-inside-a-session).

629 806

630Se una sessione riavviata torna mostrando solo il suo prompt originale perché Claude Code ha frainteso il suo transcript come vuoto, il transcript della conversazione viene rinominato con un suffisso `.orphaned-` invece di essere eliminato, quindi rimane sulla tua macchina.807Per verificare quale tipo di sessione stai utilizzando, esegui [`/status`](/docs/it/commands). La riga `Session kind` legge `background job · attached` o `background job · unattended` in una sessione in background, a seconda che un terminale sia collegato, e `interactive` in qualsiasi altra sessione.

631 808

632Una riga vuota rimasta dalla pressione di `←` che non è mai stata data un prompt viene rimossa completamente dopo circa cinque minuti in modo che l'elenco si cancelli da solo. Le sessioni avviate con `claude --bg` e le sessioni in attesa di un prompt di configurazione come una finestra di dialogo di fiducia non vengono rimosse in questo modo.809<h3 id="the-supervisor-process">

810 Il processo supervisor

811</h3>

633 812

634Quando l'host ha poca memoria, il supervisor ferma prima le sessioni inattive non fissate e ferma quelle fissate inattive solo se ciò non ha liberato nulla.813Il supervisor è un servizio in background che esegue le tue sessioni in background in modo che continuino a funzionare dopo che chiudi la vista agente o il tuo terminale. Claude Code lo avvia la prima volta che metti una sessione in background o apri la vista agente, e non hai bisogno di gestirlo tu stesso.

635 814

636Il supervisor osserva il binario Claude Code installato su disco e si riavvia nella nuova versione dopo che l'[auto-updater](/docs/it/setup#auto-updates) regolare lo sostituisce. Questo è un watch di file locale, non un controllo di rete. Le sessioni in background sono processi scollegati, quindi continuano a girare attraverso il riavvio e il nuovo supervisor si ricollega a loro. Una sessione fissata inattiva viene anche riavviata in posizione sulla nuova versione in modo che raccolga l'aggiornamento senza che tu ti ricollega.815Ogni sessione è il suo proprio processo Claude Code sotto il supervisor, e ciò che accade a quel processo dipende dallo stato della sessione:

637 816

638Una volta che il nuovo supervisor prende il controllo, riavvia anche le sessioni inattive rimanenti sulla nuova versione, un po' alla volta in background, dopo un breve ritardo che consente ai terminali collegati attraverso il riavvio di ricollegarsi per primi. Una sessione che sta lavorando, aspettando il tuo input, o ha un terminale collegato non viene interrotta; si sposta sulla nuova versione la prossima volta che il suo processo si riavvia. Prima di v2.1.206, il supervisor spostava solo poche sessioni inattive al minuto su una nuova versione, quindi le sessioni potevano continuare a eseguire quella vecchia per un po' dopo un aggiornamento.817* **In esecuzione, in pausa su un prompt di permesso o un'altra finestra di dialogo, o collegato**: il processo continua a funzionare. Un subagente, workflow o monitor in esecuzione conta come in esecuzione.

818* **Terminato o in attesa del tuo prossimo messaggio, e scollegato per circa un'ora**: il supervisor ferma il processo per liberare risorse. Una sessione che ha terminato il suo turno chiedendoti una domanda conta come in attesa del tuo prossimo messaggio. La conversazione rimane su disco, e la prossima volta che ti colleghi o rispondi, la sessione riprende da dove l'ha lasciata. Fissa una sessione con `Ctrl+T` per mantenere il suo processo in esecuzione.

819* **Uscito inaspettatamente mentre il supervisor è in esecuzione**: il supervisor riavvia il processo. Terminare una sessione che hai messo in background tu stesso con `←` o `/background`, ad esempio con `kill`, la contrassegna come fermata invece di riavviarla. Per le sessioni che sono terminate con un arresto, vedi [Le sessioni vengono visualizzate come non riuscite o fermate dopo l'arresto](#sessions-show-as-failed-after-shutdown).

820* **Dopo un aggiornamento automatico**: il supervisor riavvia se stesso sulla nuova versione e sposta le sessioni inattive in background. Le sessioni che sono in esecuzione, in attesa di te, o collegate non vengono interrotte.

639 821

640Questi riavvii spostano solo una sessione su una versione più recente. Un supervisor che esegue una versione di Claude Code più vecchia di quella con cui è stato avviato il processo della sessione lascia quel processo da solo; la sessione continua a eseguire la versione più recente fino a quando un supervisor più recente non prende il controllo.822Quando il processo di una sessione si ferma o si riavvia, i comandi shell in background, i workflow dinamici e i subagenti in background che Claude ha avviato in essa si trasferiscono al suo prossimo processo; i monitor in esecuzione e i comandi shell che un subagente ha avviato si fermano con il processo. L'eliminazione della sessione ferma tutto ciò che ha trasferito. Per fermare tutto con il processo invece, imposta [`CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF`](/docs/it/env-vars#variables) su `1`.

641 823

642L'esecuzione di `claude attach` mentre il supervisor sta riavviando una sessione, sia per un aggiornamento, un blocco, o una migrazione, attende il processo di sostituzione invece di fallire. Una riga di stato come `Agent is updating to the new Claude Code…` nomina ciò che sta aspettando e conta i secondi trascorsi, e il comando si connette non appena la sessione è pronta. Dopo circa 60 secondi smette di aspettare e segnala un errore. Prima di v2.1.205, `claude attach` smetteva di riprovare dopo pochi secondi e stampava un errore mentre la sessione era ancora in fase di riavvio.824Il supervisor e le sue sessioni si autenticano con le stesse credenziali archiviate delle tue sessioni interattive. Per quali impostazioni e variabili di shell raggiungono una sessione, incluso `PATH`, vedi [Impostazioni e provider](#settings-and-provider). Per gli endpoint del gateway, vedi [Gateway LLM](#llm-gateway).

643 825

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

645 Dove lo stato è archiviato827 Dove lo stato è archiviato

648Lo stato della sessione è archiviato sotto la tua directory di configurazione Claude Code. Se imposti [`CLAUDE_CONFIG_DIR`](/docs/it/env-vars), il supervisor usa quella directory invece di `~/.claude` e viene eseguito come un'istanza separata con le sue proprie sessioni.830Lo stato della sessione è archiviato sotto la tua directory di configurazione Claude Code. Se imposti [`CLAUDE_CONFIG_DIR`](/docs/it/env-vars), il supervisor usa quella directory invece di `~/.claude` e viene eseguito come un'istanza separata con le sue proprie sessioni.

649 831

650| Percorso | Contenuti |832| Percorso | Contenuti |

651| :------------------------------- | :------------------------------------------------------------------------------------------------------------------------- |833| :------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------- |

653| `~/.claude/daemon/roster.json` | Elenco delle sessioni in background in esecuzione, usato per ricollegarsi dopo un riavvio |835| `~/.claude/daemon/roster.json` | Elenco delle sessioni in background in esecuzione, usato per ricollegarsi dopo un riavvio |

654| `~/.claude/jobs/<id>/state.json` | Stato per sessione mostrato in agent view |836| `~/.claude/jobs/<id>/state.json` | Stato per sessione mostrato in agent view. Leggilo attraverso [`claude agents --json`](#read-session-state-from-a-script) invece di analizzare il file |

655| `~/.claude/jobs/<id>/tmp/` | Directory di scratch per sessione. Le scritture qui non richiedono il permesso. Rimossa quando la sessione viene eliminata |837| `~/.claude/jobs/<id>/tmp/` | Directory di scratch per sessione. Le chiamate `Write` e `Edit` di Claude qui non richiedono il permesso. Rimossa quando la sessione viene eliminata |

656 838

657Ogni sessione in background ha la variabile di ambiente `CLAUDE_JOB_DIR` impostata sulla sua directory `~/.claude/jobs/<id>`, quindi i comandi shell che la sessione esegue possono scrivere file temporanei su `$CLAUDE_JOB_DIR/tmp` senza collidere con sessioni parallele.839Ogni sessione in background ha la variabile di ambiente `CLAUDE_JOB_DIR` impostata sulla sua directory `~/.claude/jobs/<id>`, quindi i comandi shell che la sessione esegue possono scrivere file temporanei su `$CLAUDE_JOB_DIR/tmp` senza collidere con sessioni parallele.

658 840

660 842

661Il comando avverte anche quando il supervisor in esecuzione è su una versione diversa da quella di `claude` che hai invocato, il che accade dopo un aggiornamento in cui il supervisor non si è ancora riavviato. L'avviso mostra entrambe le versioni e ti dice di eseguire `claude daemon stop --any` per raccogliere la nuova versione. Quando Claude Code è installato come servizio del sistema operativo, il comando suggerito è `claude daemon stop` senza il flag.843Il comando avverte anche quando il supervisor in esecuzione è su una versione diversa da quella di `claude` che hai invocato, il che accade dopo un aggiornamento in cui il supervisor non si è ancora riavviato. L'avviso mostra entrambe le versioni e ti dice di eseguire `claude daemon stop --any` per raccogliere la nuova versione. Quando Claude Code è installato come servizio del sistema operativo, il comando suggerito è `claude daemon stop` senza il flag.

662 844

663Le sessioni sopravvivono a quel mismatch di versione intatto: una versione più vecchia di Claude Code che aggiorna il file `state.json` di una sessione preserva i campi che non riconosce e mantiene la sessione elencata. L'elenco delle sessioni in `roster.json` segue la stessa regola: una versione più vecchia che lo riscrive preserva i campi che una versione più nuova ha scritto, quindi le sessioni avviate dalla versione più nuova rimangono raggiungibili e continuano ad accettare input dopo il riavvio del supervisor. Prima di v2.1.200, le versioni più vecchie potevano eliminare quei campi al riscrittura.845Le sessioni sopravvivono a quel mismatch di versione intatto: una versione più vecchia di Claude Code che aggiorna il file `state.json` di una sessione preserva i campi che non riconosce e mantiene la sessione elencata. L'elenco delle sessioni in `roster.json` segue la stessa regola, quindi le sessioni avviate dalla versione più nuova rimangono raggiungibili e continuano ad accettare input dopo il riavvio del supervisor.

~~664~~

665Su Windows, `claude daemon status` espone l'errore di file sottostante quando il file della chiave pipe del daemon è bloccato o illeggibile invece di segnalare un errore di connessione generico.

666 846

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

668 Disattiva agent view848 Disattiva agent view

669</h3>849</h3>

670 850

671Per disattivare completamente gli agenti in background e agent view, imposta l'[impostazione](/docs/it/settings) `disableAgentView` su `true` o imposta la variabile di ambiente `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Gli amministratori possono applicare questo attraverso [impostazioni gestite](/docs/it/permissions#managed-settings).851Per disattivare completamente gli agenti in background e agent view, imposta l'[impostazione](/docs/it/settings) `disableAgentView` su `true` o imposta la variabile di ambiente `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Gli amministratori possono applicare questo attraverso [impostazioni gestite](/docs/it/managed-settings).

672 852

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

674 Troubleshooting854 Troubleshooting

692 Lo spostamento in background mostra una finestra di dialogo `Background this session?`872 Lo spostamento in background mostra una finestra di dialogo `Background this session?`

693</h3>873</h3>

694 874

695Se premere `←` per mettere in background la sessione corrente mostra una finestra di dialogo `Background this session?`, la sessione ha lavoro in corso che non può trasferirsi alla sessione in background, come un [monitor](/docs/it/tools-reference#monitor-tool) in esecuzione, e Claude Code non lo fermerà silenziosamente. La finestra di dialogo nomina il lavoro che verrà fermato e, separatamente, conta i compiti che si trasferiscono. Esegui `/tasks` per vedere tutto ciò che è in esecuzione, quindi conferma per metterla in background comunque o scegli `Stay` per lasciare che il lavoro finisca prima. Vedi [Da dentro una sessione](#from-inside-a-session) per sapere quali tipi di compiti si trasferiscono e quali vengono fermati.875Se premere `←` per mettere in background la sessione corrente e Claude Code mostra una finestra di dialogo `Background this session?`, la sessione ha lavoro in corso che lo spostamento in background interromperebbe, riavvierebbe o lascerebbe in esecuzione incustodito, e Claude Code chiede prima di fare uno di questi:

876

877* **Lavoro che non può trasferirsi**: la sessione ha lavoro che non può trasferirsi alla sessione in background, come un [monitor](/docs/it/tools-reference#monitor-tool) in esecuzione. La finestra di dialogo nomina il lavoro che Claude Code fermerebbe e, separatamente, conta i compiti che si trasferiscono.

878* **Un workflow con subagenti in esecuzione**: un [dynamic workflow](/docs/it/workflows) ha ancora subagenti in esecuzione. Il workflow stesso si trasferisce, ma i suoi subagenti in esecuzione si riavviano dall'inizio, e la finestra di dialogo dice quanti sono.

879* **Risposte automatiche agli artefatti**: Claude sta [rispondendo ai commenti su un artefatto da solo](/docs/it/artifacts#let-claude-reply-to-comments-on-its-own). Quelle risposte continuano nella sessione in background, e la finestra di dialogo lo dice.

880

881Esegui `/tasks` per vedere tutto ciò che è in esecuzione, quindi conferma per metterla in background comunque o scegli `Stay` per lasciare che il lavoro finisca prima. Vedi [Cosa si trasferisce quando metti in background](#what-carries-over-when-you-background) per sapere quali tipi di lavoro si trasferiscono e quali Claude Code ferma.

696 882

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

698 Prompt rifiutato come troppo breve884 Prompt rifiutato come troppo breve

701L'input di dispatch si aspetta una descrizione del compito, non un'apertura conversazionale. Un prompt più corto di quattro caratteri viene rifiutato con un suggerimento `Too short` in modo che una pressione accidentale non avvii una sessione. Descrivi cosa vuoi che la sessione faccia, come `investigate the flaky checkout test`.887L'input di dispatch si aspetta una descrizione del compito, non un'apertura conversazionale. Un prompt più corto di quattro caratteri viene rifiutato con un suggerimento `Too short` in modo che una pressione accidentale non avvii una sessione. Descrivi cosa vuoi che la sessione faccia, come `investigate the flaky checkout test`.

702 888

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

704 Le sessioni mostrano come non riuscite dopo lo spegnimento890 Le sessioni mostrano come non riuscite o interrotte dopo lo spegnimento

705</h3>891</h3>

706 892

707Lo spegnimento o il riavvio della tua macchina interrompe le sessioni in background in esecuzione, quindi mostrano come non riuscite quando apri di nuovo agent view. Collegati, fai peek, o rispondi a qualsiasi sessione e la sessione si riavvia da dove l'ha lasciata.893Lo spegnimento o il riavvio della tua macchina interrompe le sessioni in background in esecuzione. Una sessione che era in attesa del tuo input rimane sotto `Needs input` quando torni. Per qualsiasi altra sessione in esecuzione, ciò che agent view mostra dipende da quanto tempo fa ha fatto progressi per l'ultima volta:

894

895* Entro 48 ore, la sessione mostra come non riuscita. Collegati o rispondi ad essa e si riavvia da dove l'ha lasciata.

896* Passate 48 ore, come dopo che la macchina è stata spenta per giorni, la sessione mostra come interrotta con `ended while the background service was off`. Premi `Enter` sulla riga e il footer mostra `Press enter again to resume this session (it ended while the background service was off), or ctrl+x to delete it.` Premi `Enter` sulla stessa riga di nuovo per riprendere la sua conversazione salvata. Una risposta, o `claude attach <id>`, la riprende senza quel prompt del footer.

708 897

709Il sonno da solo non causa questo. Le sessioni vengono preservate durante il sonno e il supervisor si ricollega ad esse al risveglio.898Quando la [pulizia della trascrizione](/docs/it/settings-reference#cleanupperioddays) ha rimosso la conversazione salvata di una sessione interrotta, Claude Code rifiuta di aprire la riga: il messaggio dice che non c'è nulla da riprendere. `claude rm <id>` elimina la riga, tranne nei [casi mantenuti](#what-deleting-a-session-removes) descritti sopra, e `claude respawn <id>` esegue di nuovo il suo prompt originale. Vedi [La conversazione salvata di questa sessione non è più su disco](/docs/it/errors#this-sessions-saved-conversation-is-no-longer-on-disk).

899

900Il sonno da solo non ferma le sessioni. Le sessioni vengono preservate durante il sonno e il supervisor si ricollega ad esse al risveglio.

710 901

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

712 L'apertura di una sessione dice che la conversazione è già aperta903 L'apertura di una sessione dice che la conversazione è già aperta

713</h3>904</h3>

714 905

715L'apertura di una riga interrotta la cui conversazione è anche tenuta aperta da un altro processo Claude Code non interattivo in esecuzione, ad esempio un worker in background per la stessa conversazione che sta ancora terminando, mostra `This conversation is already open in another running Claude session` invece di avviare il processo della riga, perché due processi non possono scrivere sulla stessa trascrizione. Rispondi nella sessione che ha già la conversazione aperta, o esci da essa e apri di nuovo la riga. Una risposta che hai digitato con il tentativo rifiutato non viene persa; viene inviata la prossima volta che la sessione si avvia.906Due processi non possono scrivere sulla stessa trascrizione. Quando la conversazione salvata di una sessione interrotta è già aperta in un altro processo Claude Code live, Claude Code rifiuta di avviare il processo della sessione. Ciò che vedi dipende da ciò che tiene la conversazione:

907

908* Un terminale dove hai ripreso la conversazione, ad esempio con `claude --resume` o `/resume`: la riga mostra `Open in a terminal` con un suggerimento per continuarla lì, e aprire la riga mostra `Can't open — this session is running in another terminal`. Continua in quel terminale, o esci da esso e apri di nuovo la riga.

909* Un altro processo Claude Code non interattivo, ad esempio un processo di sessione in background per la stessa conversazione che non è ancora uscito: aprire la riga mostra `This conversation is already open in another running Claude session`. Usa quel processo, o aspetta che esca e apri di nuovo la riga.

716 910

717Prima della v2.1.203, questo stato avviava comunque un secondo processo. Quel processo usciva con un errore `currently running as a background agent` e la riga mostrava come non riuscita.911Claude Code salva una risposta che hai digitato con il tentativo rifiutato e la invia la prossima volta che la sessione si avvia.

912

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

914 L'apertura di una sessione dice che non ha trascrizione salvata

915</h3>

916

917Una sessione interrotta che è stata [messa in background da un'altra conversazione](#from-inside-a-session) e interrotta prima che la sua prima risposta finisse non ha nulla da riprendere: fino a quando quella prima risposta non finisce, la conversazione vive ancora solo nella sessione da cui è stata messa in background. `claude attach` rifiuta di aprirla con `This session has no saved transcript`.

918

919In agent view, aprire quella riga mostra `Press enter again to restart this session fresh` sotto l'elenco. Premi `Enter` sulla stessa riga di nuovo per riavviare la sessione con una conversazione vuota, o esegui `claude respawn <id>` dalla shell.

920

921La conversazione originale è intatta; riprendi con `claude --resume` o continua a lavorarci. Vedi il [riferimento degli errori](/docs/it/errors#this-session-has-no-saved-transcript) per i dettagli.

922

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

924 L'host del terminale è morto o la sessione ha smesso di rispondere

925</h3>

926

927Il [supervisor](#the-supervisor-process) esegue il terminale di ogni sessione in background nel suo processo host separato. Quando quel processo muore o smette di rispondere, Claude Code mostra il motivo e offre un riavvio; in entrambi i casi la conversazione è salvata e il riavvio la riprende. Il [riferimento degli errori](/docs/it/errors#terminal-host-process-died) cita i messaggi completi.

928

929Claude Code non riavvia mai una riga che esegue un [comando shell](#run-a-shell-command), da `Enter` o da `claude attach`, perché ciò eseguirebbe di nuovo il comando; il messaggio della riga e `claude attach` entrambi dicono che il comando non viene eseguito di nuovo.

930

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

932 L'host del terminale è morto

933</h4>

934

935Su Linux e WSL, il supervisor controlla ogni processo host ogni pochi secondi, indipendentemente dal fatto che apri la sessione o meno, e contrassegna la sessione come non riuscita quando il processo è uscito ma la sua connessione al supervisor non si è mai chiusa.

936

937* In agent view, la riga mostra `terminal host process died — press Enter to restart`. Premi `Enter` su di essa e Claude Code riavvia la sessione su un processo host fresco.

938* Dalla shell, `claude attach <id>` riavvia una sessione già contrassegnata come non riuscita. Altrimenti segnala la causa e esce, dicendoti di eseguire `claude attach <id>` di nuovo.

939

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

941 La sessione non sta rispondendo

942</h4>

943

944Quando il supervisor accetta un'apertura ma nessun output arriva per circa dieci secondi, Claude Code termina il tentativo e offre un riavvio. Una sessione che semplicemente si è bloccata, ad esempio durante il sonno della macchina, non raggiunge questa offerta: il supervisor la [riavvia all'apertura](#read-session-state) stesso.

945

946* In agent view, il footer mostra `Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).` Premi `Enter` sulla stessa riga di nuovo e Claude Code ferma il processo che non risponde e riavvia la sessione; non ferma nulla senza quel secondo press.

947* Dalla shell, `claude attach <id>` segnala la causa e esce, dicendoti di eseguire `claude stop <id>`, poi `claude attach <id>`.

718 948

719<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">

720 Una sessione non riesce prima di iniziare con una nota `possibly low memory`950 Una sessione non riesce prima di iniziare con una nota `possibly low memory`

721</h3>951</h3>

722 952

723A partire dalla v2.1.199, quando il processo di una sessione in background esce prima di finire l'avvio e l'host ha poca memoria, lo stato della riga nomina l'uscita e aggiunge `possibly low memory — free some up and retry`. Le versioni precedenti mostravano solo il motivo dell'uscita nudo per questo errore.953Quando il processo di una sessione in background esce prima di finire l'avvio e l'host ha poca memoria, lo stato della riga nomina l'uscita e aggiunge `possibly low memory — free some up and retry`.

724 954

725La nota è un'ipotesi, non una causa confermata. Claude Code la aggiunge solo quando il processo è uscito silenziosamente, senza scrivere un errore e senza essere fermato da un segnale, e l'host ha segnalato poca memoria in quel momento. Quando il processo ha scritto un errore prima di uscire, la riga mostra invece quell'errore.955La nota è un'ipotesi, non una causa confermata. Claude Code la aggiunge solo quando il processo è uscito silenziosamente, senza scrivere un errore e senza essere fermato da un segnale, e l'host ha segnalato poca memoria in quel momento. Quando il processo ha scritto un errore prima di uscire, la riga mostra invece quell'errore.

726 956

727Libera memoria sulla macchina, quindi collegati, fai peek, o rispondi alla riga e il supervisor avvia un processo fresco per la sessione. Quando la memoria rimane bassa, il supervisor [ferma anche le sessioni inattive](#the-supervisor-process) per liberare risorse da solo.957Libera memoria sulla macchina, quindi collegati o rispondi alla riga e il supervisor avvia un processo fresco per la sessione. Quando la memoria rimane bassa, il supervisor [ferma anche le sessioni inattive](#the-supervisor-process) per liberare risorse da solo, e ferma anche le sessioni fissate inattive se fermare le altre non ha liberato nulla.

728 958

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

730 Agent view dice che il servizio in background non ha risposto960 Agent view dice che il servizio in background non ha risposto

740 970

741Un supervisor che si avvia ma non riesce ad accettare connessioni esce e rilascia il suo blocco da solo, quindi il prossimo `claude agents` avvia uno nuovo senza questo arresto manuale. I passaggi precedenti si applicano quando un supervisor in esecuzione subisce un blocco.971Un supervisor che si avvia ma non riesce ad accettare connessioni esce e rilascia il suo blocco da solo, quindi il prossimo `claude agents` avvia uno nuovo senza questo arresto manuale. I passaggi precedenti si applicano quando un supervisor in esecuzione subisce un blocco.

742 972

973Se il comando invece esce dicendo che il processo registrato non potrebbe essere verificato come il supervisor, controlla l'ID del processo segnalato: se è un supervisor che possiedi, fermalo tu stesso, quindi elimina `~/.claude/daemon.lock` in modo che il prossimo `claude agents` si avvii fresco.

974

743Su Windows, se il supervisor non risponde alla richiesta di arresto, il comando stampa il suo ID di processo. Termina quel processo con `taskkill /PID <pid>` per completare il recupero. Le sessioni in background vengono comunque preservate quando hai passato `--keep-workers`.975Su Windows, se il supervisor non risponde alla richiesta di arresto, il comando stampa il suo ID di processo. Termina quel processo con `taskkill /PID <pid>` per completare il recupero. Le sessioni in background vengono comunque preservate quando hai passato `--keep-workers`.

744 976

745<h3 id="dispatch-fails-with-could-not-resolve-authentication-method">977<h3 id="dispatch-fails-with-could-not-resolve-authentication-method">

746 Dispatch non riesce con `Could not resolve authentication method`978 Dispatch non riesce con `Could not resolve authentication method`

747</h3>979</h3>

748 980

749Se un dispatch in background non riesce con `Could not resolve authentication method` mentre le sessioni interattive si autenticano normalmente, il worker che ha ricevuto il dispatch non ha raccolto le credenziali. Il supervisor fornisce uno snapshot di credenziali fresco quando assegna un [worker pre-riscaldato](#the-supervisor-process), quindi questo errore significa che nessuna credenziale memorizzata era disponibile per il processo supervisor stesso. Conferma di aver eseguito `/login` o di aver configurato una chiave API, quindi ferma il supervisor:981Se un dispatch in background non riesce con `Could not resolve authentication method` mentre le sessioni interattive si autenticano normalmente, il worker che ha ricevuto il dispatch non ha raccolto le credenziali. Le sessioni in background ottengono le loro credenziali dal [supervisor](#the-supervisor-process), quindi questo errore significa che nessuna credenziale memorizzata era disponibile per il processo supervisor stesso. Conferma di aver eseguito `/login` o di aver configurato una chiave API, quindi ferma il supervisor:

750 982

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

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

768 Le sessioni in background non riescono a raggiungere host della rete locale su macOS1000 Le sessioni in background non riescono a raggiungere host della rete locale su macOS

769</h3>1001</h3>

770 1002

771Su macOS 15 e versioni successive, il sistema blocca un processo dal raggiungimento di dispositivi sulla tua rete locale finché non concedi il permesso di Rete Locale. Prima della v2.1.198 l'host della sessione in background non ha mai richiesto quel permesso, quindi i comandi che mirano a un indirizzo LAN non riuscivano con `connect: no route to host` anche se lo stesso comando funzionava in un terminale in primo piano. A partire dalla v2.1.198, il primo comando in una sessione in background che si connette a un indirizzo della rete locale attiva il prompt di permesso di Rete Locale di macOS per Claude Code. Concedilo una volta e quei comandi raggiungono gli host LAN nello stesso modo in cui lo fanno in un terminale in primo piano.1003Su macOS 15 e versioni successive, il sistema blocca un processo dal raggiungimento di dispositivi sulla tua rete locale finché non concedi il permesso di Rete Locale, quindi un comando che mira a un indirizzo LAN può non riuscire con `connect: no route to host` in una sessione in background anche se funziona in un terminale in primo piano. Il primo comando in una sessione in background che si connette a un indirizzo della rete locale attiva il prompt di permesso di Rete Locale di macOS per Claude Code. Concedilo una volta e quei comandi raggiungono gli host LAN nello stesso modo in cui lo fanno in un terminale in primo piano.

772 1004

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

774 Una sessione è lenta a rispondere dopo il collegamento1006 Una sessione è lenta a rispondere dopo il collegamento

775</h3>1007</h3>

776 1008

777Una volta che una sessione è finita e rimane scollega per circa un'ora, il supervisor ferma il suo processo per liberare risorse. Il collegamento avvia un processo fresco da dove l'ha lasciato e passa alla sessione immediatamente mentre il processo si riavvia. Le sessioni che stanno lavorando, aspettando te, o [fissate](#organize-the-list) non sono fermate in questo modo, quindi fissa una sessione con `Ctrl+T` per mantenerla reattiva.1009Quando una sessione che ha finito o è in attesa del tuo prossimo messaggio rimane scollega per circa un'ora, il supervisor ferma il suo processo per liberare risorse. Il collegamento avvia un processo fresco da dove l'ha lasciato e passa alla sessione immediatamente mentre il processo si riavvia. Le sessioni che stanno lavorando, in pausa su un prompt di permesso o un'altra finestra di dialogo, o [fissate](#organize-the-list) non sono fermate in questo modo, quindi fissa una sessione con `Ctrl+T` per mantenerla reattiva.

778 1010

779Mentre il processo si avvia, l'ultimo schermo della trascrizione della sessione viene mostrato con una nota `Session is starting` sotto di esso, e la sessione live lo sostituisce non appena è pronta.1011Mentre il processo si avvia, Claude Code mostra la coda della trascrizione della sessione formattata nel modo in cui la sessione live la rende, con markdown, blocchi di codice evidenziati e chiamate di strumenti come righe attenuate, sopra un'area di prompt attenuata con una nota `Session is starting`. La sessione live la sostituisce non appena è pronta.

780 1012

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

782 `.claude/worktrees/` si sta riempiendo1014 `.claude/worktrees/` si sta riempiendo

783</h3>1015</h3>

784 1016

785L'eliminazione di una sessione in agent view rimuove il worktree che Claude ha creato per essa, e un worktree che non può essere rimosso in sicurezza [mantiene la sua riga di sessione](#organize-the-list) in modo che non sia orfano. `claude rm` mantiene un worktree che ha modifiche non committate, e la sua riga di sessione, e stampa il percorso mantenuto. Elenca le voci rimaste con `git worktree list` nella directory del progetto e rimuovi ognuna con `git worktree remove <path>`. Vedi [Pulisci i worktrees](/docs/it/worktrees#clean-up-worktrees).1017L'eliminazione di una sessione in agent view rimuove il worktree che Claude ha creato per essa, ma [alcuni elimina mantengono il worktree o lasciano la sua directory su disco](#what-deleting-a-session-removes), quindi le directory rimaste possono accumularsi. Le directory che git non riconosce più non appaiono in `git worktree list`, quindi rimuovile a mano.

1018

1019Elenca le voci rimaste con `git worktree list` nella directory del progetto e rimuovi ognuna con `git worktree remove <path>`. Vedi [Pulisci i worktrees](/docs/it/worktrees#clean-up-worktrees).

786 1020

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

788 Limitazioni1022 Limitazioni

792 1026

793* **I limiti di velocità si applicano**: le sessioni in background consumano l'utilizzo dell'abbonamento allo stesso modo delle sessioni interattive, quindi eseguire dieci agenti in parallelo utilizza la quota approssimativamente dieci volte più velocemente rispetto all'esecuzione di uno.1027* **I limiti di velocità si applicano**: le sessioni in background consumano l'utilizzo dell'abbonamento allo stesso modo delle sessioni interattive, quindi eseguire dieci agenti in parallelo utilizza la quota approssimativamente dieci volte più velocemente rispetto all'esecuzione di uno.

794* **Le sessioni sono locali**: le sessioni in background vengono eseguite sulla vostra macchina. Vengono preservate durante la sospensione ma si fermano se la macchina si spegne.1028* **Le sessioni sono locali**: le sessioni in background vengono eseguite sulla vostra macchina. Vengono preservate durante la sospensione ma si fermano se la macchina si spegne.

795* **I worktrees creati da Claude vengono eliminati con la sessione in agent view**: unite i cambiamenti prima di eliminare una sessione che ha modificato file nel suo proprio worktree. Un worktree con commit che non sono stati inviati da nessuna parte viene mantenuto insieme alla sessione. `claude rm` mantiene anche un worktree che ha modifiche non sottoposte a commit insieme alla sua sessione, e un worktree che avete creato voi stessi viene lasciato in posizione.1029* **I worktrees creati da Claude vengono eliminati con la sessione in agent view**: unite i cambiamenti prima di eliminare una sessione che ha modificato file nel suo proprio worktree. [Alcuni eliminazioni mantengono il worktree](#what-deleting-a-session-removes).

796 1030

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

798 Risorse correlate1032 Risorse correlate

799</h2>1033</h2>

800 1034

801Per altri modi di eseguire Claude in parallelo, vedi:1035Per altri modi di eseguire Claude in parallelo, e per passare i risultati tra le sessioni che esegui, vedi:

802 1036

803* [Esegui agenti in parallelo](/docs/it/agents): confronta agent view con subagenti, team di agenti e worktrees1037* [Esegui agenti in parallelo](/docs/it/agents): confronta agent view con subagenti, team di agenti e worktrees

1038* [Messaggistica tra sessioni](/docs/it/cross-session-messaging): fai in modo che le tue sessioni si passino i risultati l'una con l'altra

804* [Team di agenti](/docs/it/agent-teams): coordina più sessioni che si messaggiano l'una con l'altra1039* [Team di agenti](/docs/it/agent-teams): coordina più sessioni che si messaggiano l'una con l'altra

805* [Claude Code on the web](/docs/it/claude-code-on-the-web): esegui sessioni in un ambiente cloud gestito invece che localmente1040* [Claude Code on the web](/docs/it/claude-code-on-the-web): esegui sessioni in un ambiente cloud gestito invece che localmente

806 1041

811Agent view si è evoluto rapidamente durante l'anteprima di ricerca. Se sei su una versione più vecchia di Claude Code, alcuni comportamenti su questa pagina potrebbero differire; in particolare, `claude agents` rifiuta i flag che non supporta ancora con un errore di opzione sconosciuta. La tabella sottostante elenca quando ogni flag e comportamento è stato aggiunto.1046Agent view si è evoluto rapidamente durante l'anteprima di ricerca. Se sei su una versione più vecchia di Claude Code, alcuni comportamenti su questa pagina potrebbero differire; in particolare, `claude agents` rifiuta i flag che non supporta ancora con un errore di opzione sconosciuta. La tabella sottostante elenca quando ogni flag e comportamento è stato aggiunto.

812 1047

814| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |1049| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

815| v2.1.208 | Il collegamento a una sessione il cui processo si è fermato mostra l'ultimo schermo pieno della sua trascrizione mentre il processo si avvia, invece di solo una nota `Session is starting`. Una risposta che non può essere consegnata perché il servizio in background non è raggiungibile o l'invio fallisce viene salvata e inviata come prompt successivo della sessione quando il suo processo si avvia di nuovo; prima di questa versione, una risposta persa mentre il servizio in background non era raggiungibile veniva scartata. Un processo il cui binario è stato sostituito da un aggiornamento può comunque avviare il supervisor, dal launcher `claude` installato o dalla versione più recente su disco, invece di fallire fino al riavvio di Claude Code. Un supervisor che esegue una versione più vecchia non riavvia mai una sessione inattiva avviata da una versione più nuova sul suo binario più vecchio. L'eliminazione di una sessione rimuove il suo worktree anche dopo che la sessione ha spostato il worktree su un ramo diverso, e mantiene il worktree insieme alla riga della sessione quando il worktree ha commit che non sono stati spinti da nessuna parte o un'altra sessione lo rivendica, invece di distruggere i commit o lasciare il worktree orfano. `/install-github-app` e l'elenco delle impostazioni `/mcp` e le sue azioni di autenticazione vengono rifiutate in una sessione in background con un messaggio che nomina l'alternativa; solo in v2.1.208, il picker `/model` è stato rifiutato allo stesso modo e un `/model <name>` digitato ha cambiato solo quella sessione invece di salvare anche il tuo modello predefinito. |1050| v2.1.268 | Quando un [delete è rifiutato](#what-deleting-a-session-removes) perché git o il tuo hook `WorktreeRemove` non poteva rimuovere il worktree, il messaggio nomina la causa, incluso come un hook è terminato e l'inizio del suo stderr. Per un worktree collegato sotto la directory `.claude/worktrees/` del repository senza modifiche non sottoposte a commit ai file tracciati, nessun repository annidato al suo interno, e nessun record di un'altra sessione che lo nomina, eliminare di nuovo la sessione rimuove comunque la directory, dalla vista agente o con `claude rm <id> --force-remove-worktree <worktree-id>`. Prima di questa versione, la riga mostrava solo `worktree could not be removed (WorktreeRemove hook failed)` o l'errore di git, lo stderr dell'hook andava solo al log di debug, e eliminare di nuovo era rifiutato allo stesso modo. |

1051| v2.1.260 | Quando [metti in background una sessione](#from-inside-a-session), l'[elenco agente](/docs/it/cross-session-messaging#see-which-sessions-claude-can-reach) delle tue altre sessioni mostra la conversazione una volta, come sua sessione in background, e i loro messaggi ad essa non raggiungono più il terminale da cui l'hai spostata. Prima di questa versione, quel terminale poteva rimanere elencato come una seconda sessione interattiva sotto il nome della conversazione, e una sessione che aveva inviato un messaggio alla conversazione prima dello spostamento continuava a consegnare a quel terminale. |

1052| v2.1.260 | Quando un [delete è rifiutato su commit non spinti](#what-deleting-a-session-removes), il messaggio nomina il ramo del worktree e quanti commit non sono spinti, e eliminare di nuovo la sessione scarta il worktree e i suoi commit. Prima di questa versione, il rifiuto diceva solo `worktree has commits that are not pushed anywhere`, eliminare di nuovo era rifiutato allo stesso modo, e eliminare la sessione richiedeva di spingere i commit o rimuovere il worktree manualmente. |

1053| v2.1.257 | `←` [si stacca da una sessione collegata mentre l'overlay `/btw` è aperto](#attach-to-a-session), anche a metà risposta, e l'overlay si riapre quando ti colleghi di nuovo. Prima di questa versione, `←` non si staccava mentre l'overlay era aperto. |

1054| v2.1.257 | Quando esegui [`claude --resume <session-id> --bg`](#from-your-shell), Claude Code continua quella sessione con il suo ID proprio, o avvia una copia con un nuovo ID e stampa una riga `note:` che spiega il motivo. `--continue`, un `--resume` nudo, e `--resume` con un nome o percorso avviano una copia con la stessa nota. Prima di questa versione, `--resume` con `--bg` avviava sempre una copia con un nuovo ID e non diceva nulla. |

1055| v2.1.257 | Quando invii una sessione da una vista agente che hai aperto con `←`, Claude Code l'avvia in [la modalità di permesso che la directory di destinazione configura](#permission-mode) attraverso `permissions.defaultMode`. Quando la directory non ne imposta una, si applica la modalità di permesso della sessione da cui provieni. Prima di questa versione, la sessione inviata avviava sempre nella modalità di permesso della sessione da cui provieni, sovrascrivendola. |

1056| v2.1.257 | `Ctrl+S`, `Ctrl+T`, e `Ctrl+G` in agent view [seguono le tue `keybindings.json`](#keyboard-shortcuts): `Ctrl+S` e `Ctrl+T` attraverso le azioni `agents:switchView` e `agents:togglePin` del contesto `Agents`, e `Ctrl+G` attraverso il binding `chat:externalEditor` del contesto `Chat`. Prima di questa versione, agent view ignorava `keybindings.json` e questi tasti erano fissi. |

1057| v2.1.257 | Avviare il [servizio in background](#the-supervisor-process) si recupera da due cause di fallimento. Su un'installazione npm macOS, un avvio durante un auto-aggiornamento [attende l'installazione](/docs/it/errors#eacces-when-starting-a-background-session) invece di eseguire il placeholder che npm mette giù mentre sostituisce il binario. Su Windows, un `daemon.lock` stantio scritto prima dell'ultimo avvio della macchina, o il cui ID processo registrato ora appartiene a un processo diverso, viene sostituito. Prima di questa versione, l'avvio macOS falliva con `Error: claude native binary not installed.` durante la finestra di installazione, e il lock Windows faceva fallire ogni avvio con [`exited before it became reachable`](/docs/it/errors#background-service-exited-before-it-became-reachable) finché non eliminavi `~/.claude/daemon.lock`. |

1058| v2.1.257 | Quando apri o invii una sessione in background mentre un altro processo Claude Code sta scaricando un aggiornamento npm, Claude Code [continua ad attendere fino a due minuti](/docs/it/errors#eacces-when-starting-a-background-session) mentre l'installazione viene eseguita, quindi fallisce dicendo `Claude Code is being updated by npm on this machine`. Prima di questa versione, l'attesa si fermava a dieci secondi, quindi l'apertura falliva con `Couldn't start the background service` mentre il download era ancora in corso. |

1059| v2.1.257 | Una sessione in background che tiene un [messaggio tra sessioni](/docs/it/cross-session-messaging#control-inbound-messages) per la tua approvazione mostra `approve message from` sulla sua riga `Needs input`, con l'indirizzo del mittente e il nome che il mittente dichiara. Prima di questa versione, la riga si spostava a `Needs input` ma manteneva il suo testo precedente, quindi nulla in `claude agents` nominava il messaggio in attesa o il suo mittente. |

1060| v2.1.257 | Un prompt nascosto con `Ctrl+S` dentro una sessione in background aperta [viene mantenuto con la sessione](#what-persists-across-restarts), quindi `Ctrl+S` lo ripristina dopo che il processo della sessione viene fermato e riavviato. Prima di questa versione, il nascondiglio viveva solo nel processo in esecuzione e veniva perso quando la sessione rimaneva inattiva abbastanza a lungo da far fermare il suo processo, o quando veniva fermata e poi riaperta. |

1061| v2.1.251 | In una sessione in background che non ha [spostato in un worktree](#how-file-edits-are-isolated), Claude e i subagent che genera possono modificare file all'interno di un worktree git collegato. |

1062| v2.1.251 | Claude Code inoltra un gateway del provider cloud esportato nella shell da cui invii, come `ANTHROPIC_VERTEX_BASE_URL` o `ANTHROPIC_BEDROCK_BASE_URL` con il suo flag di bypass dell'autenticazione, [al worker della sessione](#llm-gateway) nelle stesse condizioni di `ANTHROPIC_BASE_URL`. Prima di questa versione, se mettevi in background o inviavi da una shell autenticata solo attraverso tale gateway, ogni richiesta che la sessione faceva falliva, perché l'endpoint e il flag venivano eliminati dal suo ambiente. |

1063| v2.1.251 | Quando una sessione in background si avvia mentre un altro processo Claude Code sta aggiornando un [marketplace di plugin](/docs/it/plugin-marketplaces), come una sessione fratello che esegue l'[auto-aggiornamento del marketplace](/docs/it/discover-plugins#configure-auto-updates), Claude Code mantiene disponibili i plugin di quel marketplace. Prima di questa versione, tale sessione poteva avviarsi senza nessuna delle skill, agenti, hook e server MCP di quel marketplace e rimanere così per tutta la sua esecuzione. |

1064| v2.1.248 | `Shift+Enter` nell'[input di dispatch](#keyboard-shortcuts) inserisce una nuova riga, corrispondendo al prompt principale, e `Ctrl+Enter` invia e si collega immediatamente nei terminali dove l'overlay `?` elenca `ctrl+enter to start and open`. Prima di questa versione, `Shift+Enter` inviava e si collegava. |

1065| v2.1.248 | [Eliminare una sessione](#what-deleting-a-session-removes) ha successo quando i commit del worktree sono già sulla copia locale del ramo predefinito del tuo remote `origin` e il tuo checkout principale ha quel ramo estratto; prima di questa versione, il delete era rifiutato con `has commits that are not pushed anywhere`. |

1066| v2.1.248 | Una sessione messa in background con `←` o `/background` tiene il [`git worktree lock`](/docs/it/worktrees#clean-up-subagent-and-background-session-worktrees) sul suo worktree mentre viene eseguita; prima di questa versione, mettere in background rilasciava il lock, e la pulizia o `git worktree remove` poteva rimuovere il worktree sotto la sessione in esecuzione. |

1067| v2.1.248 | Una sessione in background che non era in attesa del tuo input e viene trovata morta più di 48 ore dopo la sua ultima attività, come dopo che la macchina era spenta per giorni, [mostra come fermata](#sessions-show-as-failed-after-shutdown) con `ended while the background service was off`, e `Enter` su di essa chiede prima di riprendere la sua conversazione salvata. Prima di questa versione, tale sessione riappariva come un fallimento fresco ordinato in cima all'elenco, e un singolo `Enter` tirava la conversazione di settimane fa in primo piano. |

1068| v2.1.248 | Aprire una riga fermata la cui conversazione [hai ripreso in un altro terminale](#opening-a-session-says-the-conversation-is-already-open) è rifiutato con `Can't open — this session is running in another terminal`, e la riga mostra `Open in a terminal` invece di mostrare sotto `Working`. Prima di questa versione, aprire la riga avviava un secondo processo che scriveva nella stessa conversazione. |

1069| v2.1.248 | Una sessione in background in attesa di una decisione di permesso mentre un hook `PermissionRequest` o `PreToolUse` ha stampato una risposta non valida [nomina l'evento dell'hook e l'errore dello schema sulla sua riga](#peek-and-reply). Prima di questa versione, la riga mostrava solo la richiesta in sospeso. |

1070| v2.1.248 | Su Windows, `claude agents` risponde alla tastiera quando lanciato in una scheda di terminale che un programma precedente ha lasciato in win32-input-mode. Prima di questa versione, Claude Code non decodificava i record di tasti che tale scheda invia. |

1071| v2.1.247 | Su Linux e WSL, una sessione [il cui processo host del terminale è morto](#the-terminal-host-died-or-the-session-stopped-responding) fallisce entro pochi secondi con il motivo. Un'apertura che non produce output termina dopo circa dieci secondi con un'offerta di riavvio, e `Enter` sulla riga riavvia la sessione con la sua conversazione; `claude attach <id>` segnala la causa e esce. Prima di questa versione, aprire tale sessione mostrava `opening… · esc to cancel` indefinitamente e `claude attach <id>` attendeva senza segnalare un errore. |

1072| v2.1.246 | Su un'installazione npm, quando il [servizio in background](#the-supervisor-process) non riesce ad avviarsi mentre `npm install -g @anthropic-ai/claude-code` sta sostituendo il binario, Claude Code attende fino a dieci secondi affinché l'installazione finisca e riprova prima di segnalare [`EACCES: permission denied`](/docs/it/errors#eacces-when-starting-a-background-session). |

1073| v2.1.246 | Quando il processo del [servizio in background](#the-supervisor-process) muore dopo aver stampato un errore, Claude Code segnala il fallimento e [cita la prima riga di errore del servizio](/docs/it/errors#background-service-exited-before-it-became-reachable). |

1074| v2.1.246 | Se la tua macchina si addormenta mentre il [servizio in background](#the-supervisor-process) si sta avviando, Claude Code riprova l'avvio una volta invece di fallire. |

1075| v2.1.246 | Claude Code attende circa due minuti invece di 45 secondi per un [servizio in background](#the-supervisor-process) appena avviato che è vivo ma lento ad accettare connessioni. |

1076| v2.1.246 | Il [servizio in background](#the-supervisor-process) si avvia dalla tua directory home, quindi su macOS e Linux una directory di avvio che è stata eliminata o spostata non blocca più l'avvio. |

1077| v2.1.246 | `/fork` [copia la conversazione completa](#copy-the-session-with-%2Ffork) da una sessione che stessa è stata avviata come copia e non ha registrato un nuovo prompt da allora: una copia `/fork` a cui ti sei collegato, una sessione ricollegata dopo che `←` o `/background` l'ha spostata in background, o una sessione avviata con `claude --resume <id> --fork-session`. Prima di questa versione, se eseguivi `/fork` in tale sessione prima di inviarle un nuovo prompt, Claude Code stampava la conferma normale ma avviava la copia con una conversazione vuota. Spostare tale sessione in background con `←` o `/background` perdeva la conversazione allo stesso modo. |

1078| v2.1.246 | Quando apri una sessione che hai appena inviato mentre il suo processo worker si sta ancora avviando, come premendo `Enter` sulla sua riga, Claude Code attende il processo e poi si collega. Prima di questa versione, se premevi `Enter` mentre il processo si stava ancora avviando, Claude Code poteva fermare la sessione con [`Session <id> was stopped while the respawn was in flight`](/docs/it/errors#session-was-stopped-while-the-respawn-was-in-flight). |

1079| v2.1.246 | Quando [metti in background](#from-inside-a-session) una sessione denominata, Claude Code la elenca una volta, e quando metti in background la stessa conversazione di nuovo, numera il nome della nuova riga, come `my-session (2)`, con la riga esistente che mantiene il suo nome. Prima di questa versione, il terminale in cui hai premuto `←` poteva apparire in `claude agents --json` come una seconda sessione con lo stesso nome, e se mettevi in background la stessa conversazione di nuovo, Claude Code aggiungeva un'altra riga con il nome identico. |

1080| v2.1.239 | Con [modalità editor vim](/docs/it/interactive-mode#vim-editor-mode) attiva, premere `Esc` nell'input di agent view passa da INSERT a NORMAL mode e mantiene il tuo testo, corrispondendo al prompt principale; in NORMAL mode con testo ancora nell'input, premere `Esc` lo cancella, e premere `Esc` su un input vuoto esce, come la scorciatoia [`Esc`](#keyboard-shortcuts) descrive. Prima di questa versione, `Esc` cancellava l'input. |

1081| v2.1.233 | Per una sessione collegata a una merge request di GitLab, Claude Code scrive l'etichetta della riga nella sintassi di riferimento `!1234` di GitLab. Puoi anche incollare l'URL della merge request nell'[input di dispatch](#filter-sessions) per selezionare quella sessione. Prima di questa versione, l'etichetta veniva resa come `#1234`, e un URL di merge request incollato corrispondeva a una sessione solo quando il suo primo prompt conteneva l'URL. |

1082| v2.1.227 | [Eliminare una sessione](#what-deleting-a-session-removes) mantiene la sessione e il suo worktree mentre un'altra sessione Claude Code live è in esecuzione all'interno di quella directory worktree. Agent view mostra `not deleted` sulla riga e il motivo nel footer, e `claude rm` stampa `kept <id>` con il motivo, che nomina l'ID processo dell'altra sessione. Prima di questa versione, eliminare la sessione rimuoveva il worktree mentre l'altra sessione stava ancora lavorando in esso. |

1083| v2.1.225 | `claude agents` in una directory che non hai fiducia mostra lo stesso [dialogo di fiducia dell'area di lavoro](/docs/it/permissions#project-allow-rules-and-workspace-trust) che `claude` mostra all'avvio, prima che agent view si apra. Accettare salva la fiducia per quell'area di lavoro; rifiutare esce senza aprire agent view. Prima di questa versione, `claude agents` si apriva senza chiedere, quindi le sessioni che inviavi da essa venivano eseguite in una directory di cui non ti era mai stato chiesto di fidarti.<br /><br />Con l'elenco raggruppato per directory, passare il mouse su una riga la evidenzia senza cambiare il [target di dispatch](#dispatch-to-a-specific-directory); selezionare una riga con i tasti freccia o un clic cambia ancora il target. Prima di questa versione, spostare il mouse su una sessione in un altro progetto cambiava silenziosamente la directory in cui la prossima sessione inviata si avviava. |

1084| v2.1.221 | `/status` mostra una riga `Session kind`: `background job · attached` o `background job · unattended` in una sessione in background, a seconda che un terminale sia collegato, e `interactive` in qualsiasi altra sessione. Prima di questa versione, `/status` non segnalava il tipo di sessione.<br /><br />`/fork`: Claude Code istruisce [la copia](#from-inside-a-session) di isolare il suo lavoro da quello della sessione originale: la copia crea un worktree proprio prima di apportare modifiche al codice, rimane fuori dal worktree della sessione originale, e basa un nuovo ramo su quello della sessione originale quando il suo compito si basa su quel lavoro. Vedi la sezione collegata per le condizioni esatte. Prima di questa versione, la copia non riceveva alcuna istruzione di isolamento e poteva finire per modificare il worktree o estrarre il checkout su cui la sessione originale stava ancora lavorando.<br /><br />Con [modalità editor vim](/docs/it/interactive-mode#vim-editor-mode) attiva, premere `←` subito dopo aver annullato il prompt tornando a vuoto con `u` chiede la stessa conferma di eliminare il testo o spostarsi nella cronologia dei prompt, e passa solo alla seconda pressione; prima di questa versione la pressione passava immediatamente. |

1085| v2.1.219 | Con [modalità editor vim](/docs/it/interactive-mode#vim-editor-mode) attiva, premere `←` su un prompt vuoto apre agent view da NORMAL mode così come INSERT, e il suggerimento `←` del footer mostra in NORMAL mode; prima di questa versione il gesto e il suggerimento erano solo INSERT, e in NORMAL mode `←` su un prompt vuoto non faceva nulla. Digitare nell'input mentre Claude Code attende di mettere in background la sessione annulla il passaggio con `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.` quindi una bozza digitata non viene persa. |

1086| v2.1.218 | Premere `←` entro due secondi da un'eliminazione che ha svuotato il prompt, o da uno spostamento nella cronologia dei prompt, mostra `Press ← again to open agents`, o `Press ← again to go back to agents` in una sessione collegata, e passa solo alla seconda pressione almeno un secondo dopo; prima di questa versione la pressione passava immediatamente. Un `←` che arriva all'interno di input incollato o scritto non attiva più il passaggio. Mettere in background una sessione in primo piano con `←` mostra `Your conversation moved to the background` sopra l'elenco, e `Esc` alla radice di agent view ritorna a quella conversazione invece di uscire alla shell, con doppio `Ctrl+C` che rimane l'uscita; se la conversazione non può essere riaperta, Claude Code esce e stampa un comando `claude --resume` per essa. Su Windows, un `←` premuto entro circa mezzo secondo dal collegamento mostra `Ambiguous ←, press again to detach` e si stacca alla seconda pressione. |

1087| v2.1.217 | Il badge della pull request sulla riga di una sessione viene reso come un collegamento ipertestuale anche quando Claude Code non riesce a rilevare il supporto del collegamento ipertestuale del terminale, ad esempio su SSH o tmux; imposta [`FORCE_HYPERLINK=0`](/docs/it/env-vars) per renderlo come testo semplice. Prima di questa versione, il badge veniva reso come testo semplice quando il supporto non era rilevato. |

1088| v2.1.216 | `/fork`: la [conferma](#from-inside-a-session) è una riga, mostrando lo stato della copia, il nome della sua riga di agent-view, e il suo ID sessione per `claude attach`, terminando con `runs in the origin tree` o `edits this checkout` solo quando la copia viene eseguita nell'albero di lavoro principale o modifica il checkout che hai aperto. Fare clic sul nome mette in background questa sessione e apre agent view nella sessione della copia. La conferma non ripete più la modalità di permesso ereditata della copia; le versioni precedenti stampavano una conferma multi-riga senza nome cliccabile.<br /><br />Needs input: `/install-github-app` e l'elenco delle impostazioni `/mcp`, eseguiti mentre nessuno è collegato, mostrano la sessione sotto `Needs input` con una riga che nomina il comando, e collegarsi e rieseguire il comando continua; da v2.1.208 a v2.1.215 erano rifiutati completamente in quello stato.<br /><br />`--agent` restore: riprendere o riavviare una [sessione `--agent` messa in background](#from-your-shell) ripristina il prompt di sistema dell'agente e le restrizioni degli strumenti, cercando prima la directory propria della sessione per l'agente, quando l'area di lavoro è fidata; una sessione il cui agente non esiste più continua con gli strumenti predefiniti e il prompt di sistema e si apre con un avviso visibile, invece di ripristinare silenziosamente l'agente predefinito.<br /><br />`Ctrl+X`: premendolo due volte elimina una sessione anche quando il tentativo di arresto fallisce, invece di un arresto fallito che annulla il delete in sospeso, e una sessione eliminata il cui processo worker era morto non riappare più al prossimo aggiornamento.<br /><br />Worktree deletion: una sessione il cui directory worktree non appartiene a nessun repository git può essere eliminata; prima di questa versione ogni tentativo di eliminare tale sessione era rifiutato. Una directory che è già scomparsa si cancella immediatamente. La doppia pressione di agent view rimuove una directory che ha ancora file, eseguendo il tuo hook `WorktreeRemove` per una directory creata da hook, a meno che un'altra sessione non la rivendichi anche. `claude rm` mantiene tale directory ogni volta che rimangono file. |

1089| v2.1.214 | Una sessione messa in background con `←` o `/background` e lasciata inattiva senza nulla in esecuzione ha il suo processo fermato come qualsiasi altra sessione inattiva, invece di mantenere il suo processo e il servizio in background in esecuzione indefinitamente. Una sessione completata può essere rimossa con `claude rm` o da agent view dopo che il servizio in background è diventato inattivo, e una sessione che è entrata in un worktree dopo essere stata inviata da una directory che non è un repository git, come una cartella di area di lavoro multi-repo, può essere eliminata da agent view quando il worktree stesso appartiene a un repository git, perché la pulizia viene risolta dal worktree invece che dalla directory da cui la sessione è stata inviata; entrambe le rimozioni erano rifiutate ad ogni tentativo prima. Riaprire una sessione fermata ripristina la sua conversazione salvata anche quando una cartella nell'archivio delle trascrizioni non può essere letta. |

1090| v2.1.213 | `/install-github-app`, l'[elenco delle impostazioni `/mcp`](/docs/it/mcp), e le azioni di autenticazione MCP funzionano in una sessione in background mentre un terminale è collegato, e sono rifiutate solo quando nessuno è collegato, con un messaggio che ti dice di collegarti e rieseguire il comando; da v2.1.208 a v2.1.212 erano rifiutate anche con un terminale collegato. |

1091| v2.1.212 | [`/fork` in una sessione interattiva](#from-inside-a-session) copia la conversazione in una nuova sessione in background che appare come sua propria riga, denominata dopo la sessione da cui proviene o, per un fork richiesto di una sessione senza nome, dopo il prompt di fork, mentre l'originale continua a funzionare; il comportamento precedente di fork-subagent di `/fork` si è spostato a `/subtask`. Con [agent view disattivato](#turn-off-agent-view), `/fork` mantiene il comportamento di fork-subagent. Una riga focalizzata che è in attesa del suo primo prompt mostra `space to send it a prompt`. `Ctrl+J` inserisce una nuova riga nell'input di dispatch su terminali con segnalazione di tasti estesa, dove la pressione del tasto era precedentemente ignorata, e l'overlay `?` elenca la scorciatoia. Il suggerimento del footer `←` in una sessione interattiva mostra brevemente `N done` quando una sessione in background finisce mentre nessuna ha bisogno del tuo input. Digitare un `/resume` nudo in agent view apre un picker di sessioni passate del repository da cui hai aperto agent view, incluse le sessioni eliminate dall'elenco, e sceglierne una la riprende come sessione in background; prima di questa versione `/resume` non era disponibile in agent view e le sessioni eliminate erano raggiungibili solo con `claude --resume` o `/resume` da una sessione interattiva. I moduli mirati, scoped e ristretti mantengono il suggerimento `attach to a session to run it` che le versioni precedenti mostravano per ogni modulo. Le sessioni in attesa di un prompt di rete-host sandbox, una richiesta di input MCP, o un prompt di impostazioni gestite mostrano come `Needs input` invece di `Working`, in agent view e in `claude agents --json`, e una domanda da Claude segnala `waitingFor: input needed` invece di `permission prompt`. Collegarsi a una sessione il cui processo si è fermato mostra la sua trascrizione formattata nel modo in cui la sessione live la rende, invece che come testo grezzo. Una sessione fermata la cui trascrizione è in un posto inaspettato riprende da essa tramite una scansione di ultimo ricorso delle tue trascrizioni salvate, e aprire una riga che non ha trascrizione salvata mostra `Press enter again to restart this session fresh`, riavviandola da zero alla seconda pressione; v2.1.211 mostrava il rifiuto senza modo di riavviare da agent view. |

1092| v2.1.211 | Svegliare una sessione fermata collegandosi o rispondendo dalla directory in cui viene eseguita inoltra di nuovo il gateway `ANTHROPIC_BASE_URL` della tua shell, nelle stesse condizioni di un dispatch fresco, quindi una sessione autenticata attraverso un gateway `ANTHROPIC_AUTH_TOKEN` riprende sul gateway invece di segnalare `Not logged in`. Collegarsi a una sessione fermata che è stata messa in background da un'altra conversazione prima che la sua prima risposta finisse è rifiutato con `This session has no saved transcript` invece di avviare silenziosamente una conversazione vuota con lo stesso session id; aprire la stessa riga da agent view mostrava il rifiuto nel footer. Terminare il processo di una sessione `←` o `/background` da fuori Claude Code la contrassegna come fermata invece che il supervisor la riavvia, un arresto già registrato su disco è onorato a meno che una risposta che hai inviato sia ancora in attesa di essere consegnata, una sessione riavviata dopo un crash le viene detto che è stata riavviata, e una sessione `←` o `/background` riavviata non riprende una risposta interrotta più vecchia di circa un'ora. Una risposta di denominazione della sessione che risponde o rifiuta il prompt invece di etichettarlo, come per un prompt che è principalmente un link, viene scartata e la riga mantiene un nome preso dal testo del prompt. Eliminare una sessione il cui git worktree non riconosce più ha successo, lasciando la directory worktree su disco e nominando il suo percorso, invece che ogni tentativo sia rifiutato. Un delete rifiutato mostra il motivo sulla riga della sessione, incluso l'errore git sottostante quando il worktree non poteva essere rimosso, invece che la riga riappaia silenziosamente. |

1093| v2.1.210 | `claude attach` attende mentre il servizio in background si sta avviando o riconnettendo invece di fallire con un errore `job not found` o `still starting`, segnala una sessione che è terminata durante il collegamento come uscita, e applica un ridimensionamento del terminale fatto durante un collegamento lento quando il collegamento si completa. Il conteggio `←` needs-input del footer del prompt appare su ogni provider, inclusi i provider di terze parti che precedentemente mostravano il modulo `← for agents` semplice. Mettere in background una sessione con `←` trasporta l'elenco dei compiti di Claude alla sessione in background invece di scartarlo. La riga su cui hai premuto `←` mantiene un nome in grassetto, non attenuato dopo che la selezione si sposta. `claude agents --effort` accetta `ultracode` invece di scartarlo silenziosamente. |

1094| v2.1.208 | Collegarsi a una sessione il cui processo si è fermato mostra l'ultimo schermo pieno della sua trascrizione mentre il processo si avvia, invece di solo una nota `Session is starting`. Una risposta che non può essere consegnata perché il servizio in background non è raggiungibile o l'invio fallisce viene salvata e inviata come prompt successivo della sessione quando il suo processo si avvia di nuovo; prima di questa versione, una risposta persa mentre il servizio in background non era raggiungibile veniva scartata. Un processo il cui binario è stato sostituito da un aggiornamento può comunque avviare il supervisor, dal launcher `claude` installato o dalla versione più recente su disco, invece di fallire fino al riavvio di Claude Code. Un supervisor che esegue una versione più vecchia non riavvia mai una sessione inattiva avviata da una versione più nuova sul suo binario più vecchio. L'eliminazione di una sessione rimuove il suo worktree anche dopo che la sessione ha spostato il worktree su un ramo diverso, e mantiene il worktree insieme alla riga della sessione quando il worktree ha commit che non sono stati spinti da nessuna parte o un'altra sessione lo rivendica, invece di distruggere i commit o lasciare il worktree orfano. `/install-github-app` e l'elenco delle impostazioni `/mcp` e le sue azioni di autenticazione vengono rifiutate in una sessione in background con un messaggio che nomina l'alternativa; solo in v2.1.208, il picker `/model` è stato rifiutato allo stesso modo e un `/model <name>` digitato ha cambiato solo quella sessione invece di salvare anche il tuo modello predefinito. |

816| v2.1.207 | Il pannello peek si apre con la frase che la riga tronca, come la domanda esatta per una sessione che ti sta aspettando, e mostra quanto a lungo una sessione bloccata è stata in attesa come una singola riga `waiting 3m` invece di anteporre lo stesso timestamp alla frase di stato e alla domanda. Incollare di nuovo lo stesso testo nell'input di dispatch espande il placeholder `[Pasted text #N]` compresso invece di aggiungerne un secondo. Una sessione in background denominata accettando un piano mostra quel nome sulla sua riga. Una sessione in background che si è spostata in un worktree mantiene la sua conversazione quando il suo processo viene riavviato dalla vista agente. |1095| v2.1.207 | Il pannello peek si apre con la frase che la riga tronca, come la domanda esatta per una sessione che ti sta aspettando, e mostra quanto a lungo una sessione bloccata è stata in attesa come una singola riga `waiting 3m` invece di anteporre lo stesso timestamp alla frase di stato e alla domanda. Incollare di nuovo lo stesso testo nell'input di dispatch espande il placeholder `[Pasted text #N]` compresso invece di aggiungerne un secondo. Una sessione in background denominata accettando un piano mostra quel nome sulla sua riga. Una sessione in background che si è spostata in un worktree mantiene la sua conversazione quando il suo processo viene riavviato dalla vista agente. |

817| v2.1.206 | I riassunti delle righe riempiono la larghezza rimanente della riga e si troncano solo al bordo destro del terminale invece che a 64 colonne. Dopo che il supervisor si riavvia in una nuova versione di Claude Code, riavvia le restanti sessioni in background inattive su quella versione in background invece di poche al minuto. L'eliminazione di una sessione con `Ctrl+X` o `claude rm` la cancella anche dall'elenco delle sessioni del supervisor, quindi la riga non riappare più dopo un riavvio del supervisor. |1096| v2.1.206 | I riassunti delle righe riempiono la larghezza rimanente della riga e si troncano solo al bordo destro del terminale invece che a 64 colonne. Dopo che il supervisor si riavvia in una nuova versione di Claude Code, riavvia le restanti sessioni in background inattive su quella versione in background invece di poche al minuto. L'eliminazione di una sessione con `Ctrl+X` o `claude rm` la cancella anche dall'elenco delle sessioni del supervisor, quindi la riga non riappare più dopo un riavvio del supervisor. Un override del corpo della richiesta `CLAUDE_CODE_EXTRA_BODY` esportato nella shell di dispatching raggiunge le sessioni in background invece di essere ignorato. |

818| v2.1.205 | I riassunti delle righe mostrano il rapporto di una riga della sessione, troncato a 64 colonne, invece di una raw tool invocation o un conteggio `done/total`; le righe raggruppate per directory si aprono con una parola di stato colorata. Il pannello peek si apre con la frase di stato completa e, per una sessione in attesa di te, la sua domanda esatta sopra l'input di risposta. Le sessioni che modificano, commentano, chiudono, o contrassegnano una pull request come pronta con `gh` sono collegate ad essa, non solo quelle che creano o controllano una pull request, un push collega una pull request anche quando il nome del ramo locale non corrisponde, e una pull request il cui output del comando di creazione ha superato il limite inline è collegata anche. Un turno senza testo leggibile mantiene lo stato precedente della sessione invece di capovolgere di nuovo a `Working`. `claude attach` attende fino a circa 60 secondi una sessione che si sta riavviando, con una riga di stato che nomina il motivo, invece di fallire. |1097| v2.1.205 | Il suggerimento `←` del footer del prompt in una sessione `claude` regolare conta gli agenti in background in attesa di te, come `← 2 agents`. I riassunti delle righe mostrano il rapporto di una riga della sessione, troncato a 64 colonne, invece di una raw tool invocation o un conteggio `done/total`; le righe raggruppate per directory si aprono con una parola di stato colorata. Il pannello peek si apre con la frase di stato completa e, per una sessione in attesa di te, la sua domanda esatta sopra l'input di risposta. Le sessioni che modificano, commentano, chiudono, o contrassegnano una pull request come pronta con `gh` sono collegate ad essa, non solo quelle che creano o controllano una pull request, un push collega una pull request anche quando il nome del ramo locale non corrisponde, e una pull request il cui output del comando di creazione ha superato il limite inline è collegata anche. Un turno senza testo leggibile mantiene lo stato precedente della sessione invece di capovolgere di nuovo a `Working`. `claude attach` attende fino a circa 60 secondi una sessione che si sta riavviando, con una riga di stato che nomina il motivo, invece di fallire. |

819| v2.1.203 | Un gateway `ANTHROPIC_BASE_URL` esportato nella shell di dispatching raggiunge le sessioni inviate da essa nella stessa directory quando il supervisor condivide quel gateway environment, invece di essere scartato mentre la chiave API esportata insieme ad esso veniva mantenuta. Il `PATH` della shell di dispatching viene applicato a ogni worker della sessione. Premere `←` mentre i subagent sono in esecuzione attende che finiscano invece di riavviarli dopo dieci secondi. L'elenco vuoto mostra sempre le intestazioni della sezione con una descrizione sotto ciascuna. Digitare `@` nell'input di dispatch elenca anche i git worktrees registrati del repository di avvio che si trovano all'interno del suo albero di directory. Uno sforzo ereditato dall'impostazione `effortLevel` segue i successivi edit a quell'impostazione invece di essere fissato al dispatch. Aprire una sessione fermata la cui conversazione è già aperta in un'altra sessione in esecuzione viene rifiutato con un messaggio invece di far fallire la riga. Un comando che non è disponibile in agent view lascia il testo digitato nell'input. Un hook `WorktreeCreate` che fallisce al di fuori di un repository git non blocca più la sessione dall'editing dei file. |1098| v2.1.203 | Un gateway `ANTHROPIC_BASE_URL` esportato nella shell di dispatching raggiunge le sessioni inviate da essa nella stessa directory quando il supervisor condivide quel gateway environment, invece di essere scartato mentre la chiave API esportata insieme ad esso veniva mantenuta. Il `PATH` della shell di dispatching viene applicato a ogni worker della sessione. Premere `←` mentre i subagent sono in esecuzione attende che finiscano invece di riavviarli dopo dieci secondi. L'elenco vuoto mostra sempre le intestazioni della sezione con una descrizione sotto ciascuna. Digitare `@` nell'input di dispatch elenca anche i git worktrees registrati del repository di avvio che si trovano all'interno del suo albero di directory. Uno sforzo ereditato dall'impostazione `effortLevel` segue i successivi edit a quell'impostazione invece di essere fissato al dispatch. Aprire una sessione fermata la cui conversazione è già aperta in un'altra sessione in esecuzione viene rifiutato con un messaggio invece di far fallire la riga. Un comando che non è disponibile in agent view lascia il testo digitato nell'input. Un hook `WorktreeCreate` che fallisce al di fuori di un repository git non blocca più la sessione dall'editing dei file. |

820| v2.1.202 | Un nome impostato con `/rename` o `Ctrl+R` su una sessione in background persiste quando il supervisor arresta e riavvia il suo processo, invece di ripristinare il nome con cui la sessione è stata inviata. |1099| v2.1.202 | Un nome impostato con `/rename` o `Ctrl+R` su una sessione in background persiste quando il supervisor arresta e riavvia il suo processo, invece di ripristinare il nome con cui la sessione è stata inviata. |

821| v2.1.200 | Una versione più vecchia di Claude Code che riscrive l'elenco delle sessioni in `roster.json` preserva i campi scritti da una versione più nuova, corrispondendo alla garanzia `state.json` esistente, quindi le sessioni avviate dalla versione più nuova continuano ad accettare input dopo il riavvio del supervisor. Quando apri una sessione che ha smesso di rispondere, il supervisor riavvia il suo processo e la sessione continua la risposta interrotta da dove si era fermata. |1100| v2.1.200 | Una versione più vecchia di Claude Code che riscrive l'elenco delle sessioni in `roster.json` preserva i campi scritti da una versione più nuova, corrispondendo alla garanzia `state.json` esistente, quindi le sessioni avviate dalla versione più nuova continuano ad accettare input dopo il riavvio del supervisor. Quando apri una sessione che ha smesso di rispondere, il supervisor riavvia il suo processo e la sessione continua la risposta interrotta da dove si era fermata. Agent view applica un flag `--plugin-dir` posizionato dopo `agents` al suo proprio subagent e skill autocomplete nell'input di dispatch così come alle sessioni inviate. |

822| v2.1.199 | Una sessione in background il cui processo esce prima di finire l'avvio su un host con poca memoria mostra `possibly low memory — free some up and retry` nello stato della sua riga invece di solo il motivo dell'uscita nudo. Mettere in background una sessione con `←` o `/background` trasporta il suo `/color` alla nuova riga. |1101| v2.1.199 | Una sessione in background il cui processo esce prima di finire l'avvio su un host con poca memoria mostra `possibly low memory — free some up and retry` nello stato della sua riga invece di solo il motivo dell'uscita nudo. Mettere in background una sessione con `←` o `/background` trasporta il suo `/color` alla nuova riga. |

823| v2.1.198 | Agent view invia una notifica attraverso `preferredNotifChannel` quando una sessione in background ha bisogno di input, finisce, o fallisce, e attiva l'hook `Notification` con il tipo `agent_needs_input` o `agent_completed`. `←` e `/exit` dentro `claude attach <id>` ritornano a agent view invece di uscire alla shell; `Ctrl+Z` ritorna alla shell. Una sessione in background che ha isolato il suo lavoro in un worktree esegue il commit, spinge il suo ramo isolato proprio, mai `main` o `master`, e apre una pull request in bozza quando finisce invece di chiedere prima. `/login` viene eseguito in agent view e apre la finestra di dialogo di accesso. La finestra di dialogo di uscita `Background work is running` offre `Move to background and exit`. Il trasferimento di uscita copre anche i subagent in background, che riprendono dal loro transcript al prossimo risveglio invece di essere segnalati come falliti. `claude --bg` combinato con `-p` o `--print` viene rifiutato con un errore. |1102| v2.1.198 | Agent view invia una notifica attraverso `preferredNotifChannel` quando una sessione in background ha bisogno di input, finisce, o fallisce, e attiva l'hook `Notification` con il tipo `agent_needs_input` o `agent_completed`. `←` e `/exit` dentro `claude attach <id>` ritornano a agent view invece di uscire alla shell; `Ctrl+Z` ritorna alla shell. Una sessione in background che ha isolato il suo lavoro in un worktree esegue il commit, spinge il suo ramo isolato proprio, mai `main` o `master`, e apre una pull request in bozza quando finisce invece di chiedere prima. `/login` viene eseguito in agent view e apre la finestra di dialogo di accesso. La finestra di dialogo di uscita `Background work is running` offre `Move to background and exit`. Il trasferimento di uscita copre anche i subagent in background, che riprendono dal loro transcript al prossimo risveglio invece di essere segnalati come falliti. `claude --bg` combinato con `-p` o `--print` viene rifiutato con un errore. L'host della sessione in background richiede il permesso di rete locale macOS al primo accesso LAN invece di fallire con `connect: no route to host`. |

824| v2.1.196 | Una singola pressione di `←` mette in background una sessione in primo piano; le versioni precedenti richiedevano due pressioni, con un suggerimento nel footer e una conferma. `--dangerously-skip-permissions` passato a `claude agents` mostra il disclaimer di bypass invece di essere silenziosamente scartato. Le sessioni interattive che non hai mai nominato portano un nome predefinito come `my-app-3f` negli elenchi di sessioni e `claude agents --json`. I comandi shell in background e i workflow dinamici sopravvivono al processo della sessione che viene fermato, riavviato, o aggiornato, incluso su Windows; imposta `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` per disattivare il trasferimento. Un transcript frainteso come vuoto al riavvio viene rinominato con un suffisso `.orphaned-` invece di essere eliminato. |1103| v2.1.196 | Una singola pressione di `←` mette in background una sessione in primo piano; le versioni precedenti richiedevano due pressioni, con un suggerimento nel footer e una conferma. `--dangerously-skip-permissions` passato a `claude agents` mostra il disclaimer di bypass invece di essere silenziosamente scartato. Le sessioni interattive che non hai mai nominato portano un nome predefinito come `my-app-3f` negli elenchi di sessioni e `claude agents --json`. I comandi shell in background e i workflow dinamici sopravvivono al processo della sessione che viene fermato, riavviato, o aggiornato, incluso su Windows; imposta `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` per disattivare il trasferimento. Un transcript frainteso come vuoto al riavvio viene rinominato con un suffisso `.orphaned-` invece di essere eliminato. |

825| v2.1.195 | Il lavoro in corso si trasferisce anche quando metti in background una sessione su Windows; imposta `CLAUDE_DISABLE_ADOPT=1` per fermarlo invece. Il gruppo `Completed` riempie lo spazio verticale rimanente e l'intestazione si compatta su terminali corti. Una versione più vecchia di Claude Code non scarta più i campi `state.json` delle sessioni più nuove o nasconde quelle sessioni da `claude agents`. Il collegamento a una sessione fermata passa immediatamente invece di mostrare una schermata vuota per fino a cinque secondi. Un supervisor che non riesce ad accettare connessioni esce e rilascia il suo blocco da solo. |1104| v2.1.195 | Il lavoro in corso si trasferisce anche quando metti in background una sessione su Windows; imposta `CLAUDE_DISABLE_ADOPT=1` per fermarlo invece. Il gruppo `Completed` riempie lo spazio verticale rimanente e l'intestazione si compatta su terminali corti. Una versione più vecchia di Claude Code non scarta più i campi `state.json` delle sessioni più nuove o nasconde quelle sessioni da `claude agents`. Il collegamento a una sessione fermata passa immediatamente invece di mostrare una schermata vuota per fino a cinque secondi. Un supervisor che non riesce ad accettare connessioni esce e rilascia il suo blocco da solo. |

1105| v2.1.191 | `claude --bg` con un nome `--agent` che non corrisponde a nessuno dei tuoi subagent fallisce il lancio: la sessione esce immediatamente con un errore `--agent '<name>' not found` invece di eseguire con l'agente predefinito. |

826| v2.1.174 | Le sessioni in background non ereditano più variabili di endpoint gateway come `ANTHROPIC_BASE_URL` dalla shell di avvio del supervisor; il supervisor fornisce uno snapshot di credenziali fresco ai worker pre-riscaldati, correggendo gli errori spurii di `Could not resolve authentication method`. |1106| v2.1.174 | Le sessioni in background non ereditano più variabili di endpoint gateway come `ANTHROPIC_BASE_URL` dalla shell di avvio del supervisor; il supervisor fornisce uno snapshot di credenziali fresco ai worker pre-riscaldati, correggendo gli errori spurii di `Could not resolve authentication method`. |

827| v2.1.172 | `/model` nell'input di dispatch imposta un override del modello di dispatch con ambito di sessione. |1107| v2.1.172 | `/model` nell'input di dispatch imposta un override del modello di dispatch con ambito di sessione. |

828| v2.1.161 | I riassunti delle righe mostrano un conteggio `done/total` per elementi di lavoro paralleli; il pannello peek nomina l'elemento di lavoro parallelo che sta girando più a lungo. |1108| v2.1.161 | I riassunti delle righe mostrano un conteggio `done/total` per elementi di lavoro paralleli; il pannello peek nomina l'elemento di lavoro parallelo che sta girando più a lungo. |

agent-view.md 2026-09-13 21:00 UTC to 2026-09-14 22:58 UTC

Gestire più agenti con agent view

Avvio rapido

Apri agent view

Invia una sessione

Peek e rispondi

Collegati e scollega

Porta una sessione esistente dentro

Monitorare le sessioni con agent view

Leggere lo stato della sessione

Riassunti delle righe

Stato della pull request

Peek e rispondi

Collegarsi a una sessione

Cambiare sessioni senza lasciare il terminale

Organizzare l'elenco

Filtrare le sessioni

Scorciatoie da tastiera

Invia nuovi agenti

Da agent view

Invia a una directory specifica

Da dentro una sessione

Invia la sessione in background

Copia la sessione con /fork

Cosa si trasporta quando metti in background

Dalla tua shell

Esegui un comando shell

Come sono isolate le modifiche ai file

Cosa elimina l'eliminazione di una sessione

Imposta il modello

Permission mode, model, and effort

Impostazioni e provider

Gateway LLM

Modalità di autorizzazione

Dispatch defaults

Cosa persiste attraverso i riavvii

Impostazioni, plugin, e server MCP

Gestire le sessioni dalla shell

Elencare le sessioni come JSON

Leggere lo stato della sessione da uno script

Come sono ospitate le sessioni in background

Il processo supervisor

Dove lo stato è archiviato

Disattiva agent view

Troubleshooting

`claude agents` elenca subagenti invece di aprire agent view

Agent view si apre senza sessioni

Lo spostamento in background mostra una finestra di dialogo `Background this session?`

Prompt rifiutato come troppo breve

Le sessioni mostrano come non riuscite o interrotte dopo lo spegnimento

L'apertura di una sessione dice che la conversazione è già aperta

L'apertura di una sessione dice che non ha trascrizione salvata

L'host del terminale è morto o la sessione ha smesso di rispondere

L'host del terminale è morto

La sessione non sta rispondendo

Una sessione non riesce prima di iniziare con una nota `possibly low memory`

Agent view dice che il servizio in background non ha risposto

Dispatch non riesce con `Could not resolve authentication method`

Le sessioni in background non riescono a leggere Desktop, Documents o Downloads su macOS

Le sessioni in background non riescono a raggiungere host della rete locale su macOS

Una sessione è lenta a rispondere dopo il collegamento

`.claude/worktrees/` si sta riempiendo

Limitazioni

Risorse correlate

Cronologia delle versioni