6 6
7> 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.7> 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.
8 8
9Agent 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. Le sessioni continuano a girare in background senza un terminale collegato.9Agent 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.
10 10
11Usa agent view quando hai diversi compiti indipendenti su cui Claude può lavorare contemporaneamente, come correggere un bug, revisionare una pull request o investigare un log. Quando vuoi lavorare insieme a un problema, collegati a una sessione e usa Claude Code in modo interattivo come al solito.11<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-light.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=7a186c96ed47d6700d084d77e786be65" className="dark:hidden" alt="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." width="1772" height="780" data-path="images/agent-view-light.png" />
12 12
13Le sessioni in agent view vengono eseguite in modo indipendente e riferiscono solo a te. Per confrontare con subagenti, team di agenti e worktrees, vedi [Run agents in parallel](/it/agents).13<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-dark.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=a5bed7434bae368faea3a8f023b52aa2" className="hidden dark:block" alt="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." width="1772" height="780" data-path="images/agent-view-dark.png" />
14
15Usa 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.
16
17Quando vuoi lavorare più direttamente nella sessione di qualsiasi agente, collegati alla riga per entrare nella conversazione completa.
18
19Per confrontare agent view con subagenti, team di agenti e worktrees, vedi [Run agents in parallel](/it/agents).
14 20
15<Note>21<Note>
16 Agent view è un'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, e gli amministratori possono disabilitare agent view per un'organizzazione con l'impostazione gestita [`disableAgentView`](#how-background-sessions-are-hosted).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.
17</Note>23</Note>
18 24
19Questa pagina copre:25Questa pagina copre:
20 26
21* [Quick start](#quick-start)27* [Quick start](#quick-start): dai a Claude un compito su cui lavorare in background, controlla come sta andando e intervieni quando necessario
22* [Monitor sessions with agent view](#monitor-sessions-with-agent-view), inclusi icone di stato, peek e reply, collegamento, organizzazione e scorciatoie da tastiera28* [Monitor sessions with agent view](#monitor-sessions-with-agent-view), inclusi icone di stato, peek e reply, collegamento, organizzazione e scorciatoie da tastiera
23* [Dispatch new agents](#dispatch-new-agents) da agent view, da dentro una sessione, o dalla shell29* [Dispatch new agents](#dispatch-new-agents) da agent view, da dentro una sessione, o dalla tua shell
24* [Manage sessions from the shell](#manage-sessions-from-the-shell)30* [Manage sessions from the shell](#manage-sessions-from-the-shell)
25* [How background sessions are hosted](#how-background-sessions-are-hosted) dal processo supervisor31* [How background sessions are hosted](#how-background-sessions-are-hosted) dal processo supervisor
26 32
27## Avvio rapido33## Avvio rapido
28 34
29Questa procedura apre agent view, invia una sessione, risponde dal pannello peek e si collega per la conversazione completa.35Questa 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.
30 36
31<Steps>37<Steps>
32 <Step title="Open agent view">38 <Step title="Open agent view">
36 claude agents42 claude agents
37 ```43 ```
38 44
39 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 uscire. Le tue sessioni continuano a girare.45 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.
40 </Step>46 </Step>
41 47
42 <Step title="Dispatch a session">48 <Step title="Dispatch a session">
43 Digita un prompt nell'input e premi `Enter`. Una nuova sessione inizia e appare come una riga che mostra se sta lavorando, aspettando te, o è completata. Ripeti per eseguire più sessioni in parallelo. Ognuna utilizza la tua quota di abbonamento indipendentemente, quindi consulta [Limitazioni](#limitations) prima di inviare molte sessioni contemporaneamente.49 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-and-settings) che otterresti eseguendo `claude` in quella directory.
50
51 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.
52
53 Ogni sessione utilizza la tua quota di abbonamento indipendentemente, quindi consulta [Limitazioni](#limitations) prima di inviare molte sessioni contemporaneamente.
44 </Step>54 </Step>
45 55
46 <Step title="Peek and reply">56 <Step title="Peek and reply">
47 Seleziona una riga con i tasti freccia e premi `Space` per vedere cosa sta facendo la sessione o cosa ha bisogno da te. Digita una risposta e premi `Enter` per inviarla senza lasciare agent view.57 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.
48 </Step>58 </Step>
49 59
50 <Step title="Attach and detach">60 <Step title="Attach and detach">
51 Premi `Enter` o `→` su una riga per collegarti quando vuoi la conversazione completa. La sessione prende il controllo del terminale esattamente come se avessi eseguito `claude`. Premi `←` su un prompt vuoto per scollegar e tornare alla tabella.61 Premi `Enter` o `→` su una riga per collegarti quando vuoi la conversazione completa. La sessione prende il controllo del terminale esattamente come se avessi eseguito `claude`. Premi `←` su un prompt vuoto per scollegar e tornare alla tabella.
52 </Step>62 </Step>
53</Steps>
54 63
55Per portare una sessione interattiva esistente in agent view, esegui `/bg` dentro di essa, o premi `←` su un prompt vuoto per mettere la sessione in background e aprire agent view in un unico passaggio. La sessione continua a girare in background e appare come una riga. Per avviare una nuova sessione in background direttamente dalla shell, esegui `claude --bg "<prompt>"`.64 <Step title="Bring an existing session in">
65 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.
66 </Step>
67</Steps>
56 68
57Puoi usare `claude agents` come tuo punto di ingresso principale invece di `claude`: invia ogni compito da agent view, collegati quando vuoi la conversazione completa, e premi `←` per tornare alla tabella.69Puoi 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.
58 70
59## Monitorare le sessioni con agent view71## Monitorare le sessioni con agent view
60 72
61Esegui `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 quanto tempo fa è cambiata l'ultima volta.73Esegui `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 quanto tempo fa è cambiata l'ultima volta.
62 74
63L'elenco copre ogni sessione in background nella tua [directory di configurazione](#how-background-sessions-are-hosted), indipendentemente da quale progetto o worktree su cui sta lavorando, quindi una sessione avviata in un repository e un'altra avviata in un worktree diverso appaiono insieme. Le sessioni interattive che hai aperto in altri terminali non appaiono finché non le [metti in background](#from-inside-a-session), e i [subagents](/it/sub-agents) in esecuzione dentro una sessione non sono elencati come righe separate.75L'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. Le sessioni interattive che hai aperto in altri terminali non appaiono finché non le [metti in background](#from-inside-a-session). I [subagents](/it/sub-agents) e i [teammates](/it/agent-teams) che una sessione genera non sono elencati come righe separate.
64 76
65```text theme={null}77```text theme={null}
66Pinned78Pinned
67 ✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m79 ✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m
68 80
69Ready for review81Ready for review
70 ∙ jump physics github.com/anthropics/example/pull/2048 ● 2h82 ∙ jump physics github.com/example/game/pull/2048 ● 2h
71 83
72Needs input84Needs input
73 ✻ power-up design needs input: double jump or wall climb? 1m85 ✻ power-up design needs input: double jump or wall climb? 1m
82 … 6 more94 … 6 more
83```95```
84 96
85L'icona di ogni riga trasmette due segnali. L'indicatore ti dice lo stato della sessione, e la forma dell'icona ti dice se il processo sottostante è ancora in esecuzione. Gli stati sono:97### Leggere lo stato della sessione
98
99Ogni riga inizia con un'icona il cui colore e animazione mostrano lo stato della sessione:
100
101| Stato | L'icona mostra | Cosa significa |
102| :---------- | :------------- | :---------------------------------------------------------------------------- |
103| Working | Animato | Claude sta attivamente eseguendo strumenti o generando una risposta |
104| Needs input | Giallo | Claude sta aspettando una domanda specifica o una decisione di permesso da te |
105| Idle | Attenuato | La sessione non ha nulla da fare ed è pronta per il tuo prossimo prompt |
106| Completed | Verde | Il compito è terminato con successo |
107| Failed | Rosso | Il compito è terminato con un errore |
108| Stopped | Grigio | La sessione è stata fermata con `Ctrl+X` o `claude stop` |
86 109
87| Indicatore | Stato | Cosa significa |110Separatamente, la forma dell'icona mostra se il processo sottostante è in esecuzione:
88| :--------- | :---------- | :--------------------------------------------------------------------------------------- |
89| Animato | Working | Claude sta attivamente eseguendo strumenti o generando una risposta |
90| Giallo | Needs input | Claude sta aspettando il tuo input, solitamente una decisione di permesso o una risposta |
91| Attenuato | Idle | La sessione sta aspettando input ma non è bloccata su una domanda specifica |
92| Verde | Completed | Il compito è terminato con successo |
93| Rosso | Failed | Il compito è terminato con un errore |
94| Grigio | Stopped | La sessione è stata fermata con `Ctrl+X` o `claude stop` |
95 111
96La forma dell'icona ti dice se il processo sottostante è ancora in esecuzione. Un `✻`, o un animato `✽` mentre Claude sta lavorando, significa che la sessione è viva e puoi rispondere immediatamente. Un `∙` significa che il processo è uscito, ma puoi ancora fare peek, rispondere o collegarti: Claude riavvia la sessione da dove l'ha lasciata. Un `✢` è una sessione [`/loop`](/it/commands) che dorme tra le iterazioni, con la riga che mostra il conteggio delle esecuzioni e un conto alla rovescia per la prossima iterazione.112| Forma | Cosa significa |
113| :---------------- | :--------------------------------------------------------------------------------------------------------------------------------------------- |
114| `✻` o animato `✽` | Il processo della sessione è vivo e risponde immediatamente |
115| `∙` | Il processo è uscito. Puoi ancora fare peek, rispondere o collegarti, e Claude riavvia da dove l'ha lasciato |
116| `✢` | Una sessione [`/loop`](/it/scheduled-tasks) che dorme tra le iterazioni. La riga mostra il conteggio delle esecuzioni e un conto alla rovescia |
97 117
98Le sessioni in background non hanno bisogno di alcun terminale aperto per continuare a lavorare. Un [processo supervisor](#how-background-sessions-are-hosted) separato le esegue, quindi puoi chiudere agent view, chiudere la tua shell, o avviare una nuova sessione interattiva e il tuo lavoro inviato continua.118Le 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.
99 119
100Le sessioni persistono su disco: chiudere il tuo terminale o un auto-update non le perde, e riaprire `claude agents` le mostra tutte. Se la tua macchina dorme o si spegne, le sessioni in esecuzione si fermano; riavviale con `claude respawn --all`.120Lo stato della sessione persiste su disco attraverso gli auto-update e i riavvii del supervisor. Se la tua macchina dorme o si spegne, le sessioni in esecuzione si fermano; riavviale con `claude respawn --all`.
101 121
102Il riassunto di una riga è generato dal tuo [modello di classe Haiku](/it/model-config) configurato 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 riassunto si aggiorna al massimo una volta ogni 15 secondi, più una volta quando ogni turno termina. Ogni aggiornamento è una breve richiesta di classe Haiku attraverso il tuo provider normale, fatturato e gestito secondo gli stessi [termini di utilizzo dei dati](/it/data-usage) della sessione stessa.122### Riassunti delle righe
123
124Il riassunto su una riga è generato da un [modello di classe Haiku](/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 riassunto si aggiorna al massimo una volta ogni 15 secondi, più una volta quando ogni turno termina.
125
126Ogni aggiornamento è una breve richiesta di classe Haiku attraverso il tuo provider normale, fatturato e gestito secondo gli stessi [termini di utilizzo dei dati](/it/data-usage) della sessione stessa.
127
128### Stato della pull request
103 129
104Quando una sessione apre una pull request, un punto di stato appare al bordo destro della riga, collegato alla pull request nei terminali che supportano i hyperlink. Quando la sessione ha aperto più di una pull request, il conteggio appare prima del punto e il colore riflette quale ha più bisogno di attenzione.130Quando una sessione apre una pull request, un punto di stato appare al bordo destro della riga, collegato alla pull request nei terminali che supportano i hyperlink. Quando la sessione ha aperto più di una pull request, il conteggio appare prima del punto e il colore riflette quale ha più bisogno di attenzione.
105 131
120 146
121Usa `↑` e `↓` per fare peek alle sessioni adiacenti senza chiudere il pannello, o `→` per collegarti.147Usa `↑` e `↓` per fare peek alle sessioni adiacenti senza chiudere il pannello, o `→` per collegarti.
122 148
123### Attach to a session149### Collegarsi a una sessione
124 150
125Premi `Enter` o `→` su una riga selezionata per collegarti, o premi `Alt+1` fino a `Alt+9` per collegarti direttamente alla N-esima sessione nel gruppo focalizzato. Agent view è sostituito dalla sessione interattiva completa, esattamente come se avessi eseguito `claude` in quella directory. Quando ti colleghi, Claude pubblica un breve riassunto di cosa è successo mentre eri via.151Premi `Enter` o `→` su una riga selezionata per collegarti. Agent view è sostituito dalla sessione interattiva completa, esattamente come se avessi eseguito `claude` in quella directory. Quando ti colleghi, Claude pubblica un breve riassunto di cosa è successo mentre eri via.
126 152
127Mentre collegato, la sessione si comporta come qualsiasi altra sessione di Claude Code: ogni [comando](/it/commands), scorciatoia da tastiera e funzione funziona.153Mentre collegato, la sessione si comporta come qualsiasi altra sessione di Claude Code: ogni [comando](/it/commands), scorciatoia da tastiera e funzione funziona.
128 154
132 158
133Dopo che hai inviato o messo in background una sessione, premere `←` su un prompt vuoto funziona da qualsiasi sessione di Claude Code, non solo quelle a cui ti sei collegato da agent view. Mette in background la sessione corrente e apre agent view con quella sessione pre-selezionata, quindi puoi cambiare sessioni senza lasciare il terminale. Puoi disattivare questa scorciatoia in `/config`.159Dopo che hai inviato o messo in background una sessione, premere `←` su un prompt vuoto funziona da qualsiasi sessione di Claude Code, non solo quelle a cui ti sei collegato da agent view. Mette in background la sessione corrente e apre agent view con quella sessione pre-selezionata, quindi puoi cambiare sessioni senza lasciare il terminale. Puoi disattivare questa scorciatoia in `/config`.
134 160
135### Organize the list161### Organizzare l'elenco
162
163Agent 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](#read-session-state) 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.
164
165All'interno di un gruppo:
136 166
137Agent view raggruppa le sessioni per stato, con sessioni che hanno bisogno di input sopra le sessioni che stanno lavorando o sono fatte. Premi `Ctrl+S` per passare al raggruppamento per directory invece. La tua scelta è salvata tra le esecuzioni. All'interno di un gruppo, fissa una sessione in cima con `Ctrl+T`, riordina con `Shift+↑` e `Shift+↓`, o premi `Enter` su un'intestazione di gruppo per comprimerla. Per rimuovere una sessione, 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.167* Premi `Ctrl+T` per fissare una sessione in cima
168* Premi `Shift+↑` o `Shift+↓` per riordinare le sessioni
169* Premi `Ctrl+R` per rinominare una sessione
170* Premi `Enter` su un'intestazione di gruppo per comprimerla
138 171
139Le sessioni completate più vecchie si ripiegano in una riga "… N more" per mantenere l'elenco breve. I fallimenti e le sessioni con una pull request aperta rimangono sempre visibili.172Per 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.
140 173
141### Filter the list174L'eliminazione rimuove la sessione da agent view e pulisce il suo [worktree](#how-file-edits-are-isolated), inclusi eventuali cambiamenti non committati in esso, quindi esegui il push o il commit del lavoro che vuoi mantenere prima di eliminare. Il transcript della conversazione rimane su disco e rimane disponibile attraverso `claude --resume`.
175
176Le sessioni completate più vecchie si ripiegano in una riga `… N more` per mantenere l'elenco breve. I fallimenti e le sessioni con una pull request aperta rimangono sempre visibili.
177
178### Filtrare le sessioni
142 179
143Digita nell'input di dispatch per filtrare invece di inviare:180Digita nell'input di dispatch per filtrare invece di inviare:
144 181
145| Filtro | Mostra |182| Filtro | Mostra |
146| :---------------------- | :------------------------------------------------------------------------------- |183| :---------------------- | :--------------------------------------------------------------------------------------------------------- |
147| `a:<name>` | Sessioni che eseguono l'agente denominato |184| `a:<name>` | Sessioni che eseguono l'agente denominato |
148| `s:<state>` | Sessioni nello stato dato, come `s:blocked` per sessioni che hanno bisogno di te |185| `s:<state>` | Sessioni nello stato dato, come `s:working`. Accetta anche `s:blocked` per tutto ciò che sta aspettando te |
149| `#<number>` o un URL PR | La sessione che lavora su quella pull request |186| `#<number>` o un URL PR | La sessione che lavora su quella pull request |
150 187
151### Keyboard shortcuts188### Scorciatoie da tastiera
152 189
153Premi `?` in agent view per vedere ogni scorciatoia. Le più comuni:190Premi `?` in agent view per vedere ogni scorciatoia nel contesto. La tabella sottostante le riassume.
154 191
155| Scorciatoia | Azione |192| Scorciatoia | Azione |
156| :-------------------- | :------------------------------------------------------------------- |193| :-------------------- | :------------------------------------------------------------------------------------------- |
157| `↑` / `↓` | Muoviti tra le righe |194| `↑` / `↓` | Muoviti tra le righe |
158| `Enter` | Collegati alla sessione selezionata, o invia se c'è testo nell'input |195| `Enter` | Collegati alla sessione selezionata, o invia se c'è testo nell'input |
159| `Space` | Apri o chiudi il pannello peek per la sessione selezionata |196| `Space` | Apri o chiudi il pannello peek per la sessione selezionata |
160| `Shift+Enter` | Invia e collegati immediatamente |197| `Shift+Enter` | Invia e collegati immediatamente |
161| `→` | Collegati alla sessione selezionata |198| `→` | Collegati alla sessione selezionata |
162| `Alt+1`..`Alt+9` | Collegati alla N-esima sessione nel gruppo focalizzato |199| `Alt+1`..`Alt+9` | Collegati alla sessione 1–9 nel gruppo corrente |
163| `Tab` | Sfoglia tutti i subagents, o applica il suggerimento evidenziato |200| `Tab` | Su un input vuoto, sfoglia tutti i subagents. Altrimenti applica il suggerimento evidenziato |
164| `Ctrl+S` | Cambia raggruppamento tra stato e directory |201| `Ctrl+S` | Cambia raggruppamento tra stato e directory |
165| `Ctrl+T` | Fissa o scollega la sessione selezionata |202| `Ctrl+T` | Fissa o scollega la sessione selezionata |
166| `Ctrl+R` | Rinomina la sessione selezionata |203| `Ctrl+R` | Rinomina la sessione selezionata |
177 214
178### From agent view215### From agent view
179 216
180Digita 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. Puoi rinominarla in seguito con `Ctrl+R`. Incolla un'immagine nel prompt per includere uno screenshot o un diagramma con il compito.217Digita 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`.
218
219Incolla un'immagine nel prompt per includere uno screenshot o un diagramma con il compito.
181 220
182Prefissa o menziona parti del prompt per controllare come la sessione inizia:221Prefissa o menziona parti del prompt per controllare come la sessione inizia:
183 222
190| `#<number>` o un URL di pull request | Se una sessione sta già lavorando su quel PR, selezionala invece di inviare |229| `#<number>` o un URL di pull request | Se una sessione sta già lavorando su quel PR, selezionala invece di inviare |
191| `Shift+Enter` | Invia e collegati immediatamente alla nuova sessione |230| `Shift+Enter` | Invia e collegati immediatamente alla nuova sessione |
192 231
193Digita `/` per inviare una [skill](/it/skills). Confezionare un compito ricorrente come una skill ti permette di avviare lo stesso workflow molte volte da agent view senza riscrivere il prompt. Premi `Tab` su un input vuoto per sfogliare ogni subagent inviabile, o per applicare il suggerimento evidenziato quando i suggerimenti sono mostrati.232Confezionare un compito ricorrente come una [skill](/it/skills) ti permette di avviare lo stesso workflow da agent view ripetutamente senza riscrivere il prompt.
194 233
195Quando lo stesso `@name` corrisponde sia a un subagent che a un repository fratello, il subagent ha la precedenza. La forma della prima parola senza `@` si applica anche a qualsiasi nome di subagent, quindi un prompt che inizia con una parola che corrisponde a uno dei tuoi nomi di subagent invia quel subagent. Usa la forma `@` quando vuoi essere esplicito.234Quando 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.
196 235
197#### Invia a una directory specifica236#### Invia a una directory specifica
198 237
206 245
207### From inside a session246### From inside a session
208 247
209Esegui `/background` o il suo alias `/bg` per scollegar la conversazione corrente e mantenerla in esecuzione. Passa un prompt come `/bg run the test suite and fix any failures` per inviare un'istruzione in più prima di scollegar.248Esegui `/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.
249
250Lo spostamento in background da una sessione interattiva avvia un nuovo processo che riprende dalla conversazione salvata, quindi l'esecuzione di subagent, [monitor](/it/tools-reference#monitor-tool), e comandi in background non si trasferiscono ad esso. Claude ti chiede di confermare prima di spostare in background quando uno qualsiasi di essi è in esecuzione. 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.
210 251
211### From the shell252### From your shell
212 253
213Passa `--bg` per avviare una sessione che va direttamente in background:254Passa `--bg` per avviare una sessione che va direttamente in background:
214 255
232 claude stop 7c5dcf5d stop this session273 claude stop 7c5dcf5d stop this session
233```274```
234 275
235### Come gli edit dei file sono isolati276### How file edits are isolated
236 277
237Ogni sessione in background, che sia avviata da agent view, `/bg`, o `claude --bg`, inizia nella tua directory di lavoro ma è bloccata dalla scrittura di file lì. Quando la sessione ha bisogno di modificare file, Claude la sposta automaticamente in un [git worktree](/it/worktrees) isolato sotto `.claude/worktrees/`, quindi le sessioni parallele possono leggere lo stesso checkout ma ognuna scrive nel suo. Il blocco non si applica quando la sessione è già dentro un worktree, quando la directory di lavoro non è un repository git, o alle scritture al di fuori della directory di lavoro.278Ogni 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](/it/worktrees) isolato sotto `.claude/worktrees/`, quindi le sessioni parallele possono leggere lo stesso checkout ma ognuna scrive nel suo. Claude salta questo quando la sessione è già sotto `.claude/worktrees/`, quando la directory di lavoro non è un repository git, o per le scritture al di fuori della directory di lavoro.
279
280Al 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.
238 281
239Il worktree viene rimosso quando elimini la sessione, quindi unisci o spingi i cambiamenti che vuoi mantenere prima di eliminare. Per trovare il percorso del worktree di una sessione, visualizza l'anteprima della sessione o collegati e controlla la sua directory di lavoro.282Il worktree viene rimosso quando elimini la sessione, quindi unisci o spingi i cambiamenti che vuoi mantenere prima di eliminare. Per trovare il percorso del worktree di una sessione, visualizza l'anteprima della sessione o collegati e controlla la sua directory di lavoro.
240 283
241Per fare in modo che un subagent venga sempre eseguito nel suo proprio worktree indipendentemente da come è stato avviato, imposta [`isolation: worktree`](/it/sub-agents#supported-frontmatter-fields) nel suo frontmatter.284Per fare in modo che un subagent venga sempre eseguito nel suo proprio worktree indipendentemente da come è stato avviato, imposta [`isolation: worktree`](/it/sub-agents#supported-frontmatter-fields) nel suo frontmatter.
242 285
243### Permission mode e settings286### Set the model
287
288Il nome del modello mostrato nell'intestazione di agent view è il default di dispatch. Le nuove sessioni che avvii dall'input utilizzano questo modello, che è la stessa impostazione che [`/model`](/it/model-config) controlla in qualsiasi sessione.
289
290Ogni sessione in background può essere eseguita su un modello diverso. Per sovrascriverlo per una sessione:
291
292* Dalla shell, passa `--model` con `claude --bg`.
293* Collegati a una sessione in esecuzione ed esegui `/model` lì. Il cambiamento persiste se la sessione viene riavviata.
294* Invia un [subagent](/it/sub-agents) il cui frontmatter imposta un campo `model`.
295
296### Permission mode and settings
244 297
245Una sessione inviata legge i suoi [settings](/it/settings) e [permission mode](/it/permissions) dalla directory in cui viene eseguita, come se avessi avviato `claude` lì. L'invio da agent view input non passa un permission mode, quindi la sessione utilizza il `defaultMode` dai settings di quella directory o il `permissionMode` dal frontmatter del [subagent inviato](/it/sub-agents#supported-frontmatter-fields).298Una sessione inviata legge i suoi [settings](/it/settings) e [permission mode](/it/permissions) dalla directory in cui viene eseguita, come se avessi avviato `claude` lì. L'invio da agent view input non passa un permission mode, quindi la sessione utilizza il `defaultMode` dai settings di quella directory o il `permissionMode` dal frontmatter del [subagent inviato](/it/sub-agents#supported-frontmatter-fields).
246 299
247Per impostare il mode dalla shell, passa `--permission-mode` con `claude --bg`. L'uso di `bypassPermissions` o `auto` in questo modo è rifiutato finché non hai accettato quel mode eseguendo `claude` con esso una volta in modo interattivo, poiché questi mode permettono a una sessione che non stai guardando di agire senza approvazione.300Per impostare il mode dalla shell, passa `--permission-mode` con `claude --bg`. L'uso di `bypassPermissions` o `auto` in questo modo è rifiutato finché non hai accettato quel mode eseguendo `claude` con esso una volta in modo interattivo, poiché questi mode permettono a una sessione che non stai guardando di agire senza approvazione.
248 301
249## Manage sessions from the shell302## Gestire le sessioni dalla shell
250 303
251Ogni sessione in background ha un ID breve che puoi usare dalla shell. Questi comandi sono utili per lo scripting o quando non vuoi aprire agent view.304Ogni 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.
252 305
253| Command | Purpose |306| Command | Purpose |
254| :--------------------- | :------------------------------------------------------------ |307| :--------------------- | :--------------------------------------------------------------------------------------------------------- |
255| `claude agents` | Apri agent view |308| `claude agents` | Apri agent view |
256| `claude attach <id>` | Collegati a una sessione in questo terminale |309| `claude attach <id>` | Collegati a una sessione in questo terminale |
257| `claude logs <id>` | Stampa l'output recente della sessione |310| `claude logs <id>` | Stampa l'output recente della sessione |
258| `claude stop <id>` | Ferma una sessione. Accetta anche `claude kill` |311| `claude stop <id>` | Ferma una sessione. Accetta anche `claude kill` |
259| `claude respawn <id>` | Riavvia una sessione fermata con la sua conversazione intatta |312| `claude respawn <id>` | Riavvia una sessione fermata con la sua conversazione intatta |
260| `claude respawn --all` | Riavvia ogni sessione fermata |313| `claude respawn --all` | Riavvia ogni sessione fermata |
261| `claude rm <id>` | Rimuovi una sessione dall'elenco |314| `claude rm <id>` | Rimuovi una sessione dall'elenco. Pulisce il suo worktree se non ci sono modifiche non sottoposte a commit |
315
316## Come sono ospitate le sessioni in background
317
318Ogni 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).
319
320### Il processo supervisor
321
322Le 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.
262 323
263## How background sessions are hosted324Il supervisor e le sue sessioni si autenticano con le stesse credenziali delle tue sessioni interattive e non fanno connessioni di rete aggiuntive oltre l'API del modello.
264 325
265Le sessioni in background sono ospitate da un processo supervisor per utente, separato dal tuo terminale e da agent view. Si avvia automaticamente la prima volta che metti una sessione in background o apri agent view, e non lo gestisci direttamente. Il supervisor e le sue sessioni si autenticano con le stesse credenziali delle tue sessioni interattive e non fanno connessioni di rete aggiuntive oltre l'API del modello.326Ogni 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.
266 327
267Ogni sessione in background è il suo proprio processo di Claude Code, genitore del supervisor piuttosto che del tuo terminale. Una sessione che sta attivamente lavorando, aspettando il tuo input, o ha un terminale collegato mantiene il suo processo in esecuzione. Una volta che una sessione finisce e rimane scollega per circa un'ora, il supervisor ferma il suo processo per liberare risorse. Il transcript e lo stato rimangono su disco, e la prossima volta che ti colleghi, fai peek, o rispondi, 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 metti una sessione in background o apri agent view.328Una volta che una sessione finisce e rimane scollega per circa un'ora, il supervisor ferma il suo processo per liberare risorse. Il transcript e lo stato rimangono su disco, e la prossima volta che ti colleghi, fai peek, o rispondi, 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.
268 329
269Il supervisor osserva il binario di Claude Code installato su disco e si riavvia nella nuova versione dopo che l'[auto-updater](/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.330Il supervisor osserva il binario Claude Code installato su disco e si riavvia nella nuova versione dopo che l'[auto-updater](/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.
270 331
271Lo stato della sessione è archiviato sotto la tua directory di configurazione di Claude Code. Se imposti [`CLAUDE_CONFIG_DIR`](/it/env-vars), il supervisor usa quella directory invece di `~/.claude` e viene eseguito come un'istanza separata con le sue proprie sessioni.332### Dove lo stato è archiviato
333
334Lo stato della sessione è archiviato sotto la tua directory di configurazione Claude Code. Se imposti [`CLAUDE_CONFIG_DIR`](/it/env-vars), il supervisor usa quella directory invece di `~/.claude` e viene eseguito come un'istanza separata con le sue proprie sessioni.
272 335
273| Path | Contents |336| Path | Contents |
274| :------------------------------- | :---------------------------------------------------------------------------------------- |337| :------------------------------- | :---------------------------------------------------------------------------------------- |
276| `~/.claude/daemon/roster.json` | Elenco delle sessioni in background in esecuzione, usato per ricollegarsi dopo un riavvio |339| `~/.claude/daemon/roster.json` | Elenco delle sessioni in background in esecuzione, usato per ricollegarsi dopo un riavvio |
277| `~/.claude/jobs/<id>/state.json` | Stato per sessione mostrato in agent view |340| `~/.claude/jobs/<id>/state.json` | Stato per sessione mostrato in agent view |
278 341
342### Disattiva agent view
343
279Per disattivare completamente gli agenti in background e agent view, imposta l'[impostazione](/it/settings) `disableAgentView` su `true` o imposta la variabile di ambiente `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Gli amministratori possono applicare questo attraverso [impostazioni gestite](/it/permissions#managed-settings).344Per disattivare completamente gli agenti in background e agent view, imposta l'[impostazione](/it/settings) `disableAgentView` su `true` o imposta la variabile di ambiente `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Gli amministratori possono applicare questo attraverso [impostazioni gestite](/it/permissions#managed-settings).
280 345
281## Troubleshooting346## Troubleshooting
282 347
348### `claude agents` elenca subagenti invece di aprire la visualizzazione agente
349
350Se `claude agents` stampa un conteggio seguito dai tuoi subagenti configurati e poi esce, la visualizzazione agente non è disponibile nel tuo ambiente. Le versioni precedenti non aprivano la visualizzazione agente in ogni ambiente, incluso quando connesso tramite Bedrock, Vertex AI o Foundry. Esegui `claude update` per installare la versione più recente.
351
352Se la visualizzazione agente ancora non si apre dopo l'aggiornamento, verifica se è stata [disattivata](#turn-off-agent-view) da un'impostazione o da una variabile di ambiente.
353
283### Agent view opens with no sessions354### Agent view opens with no sessions
284 355
285Agent view è vuoto finché non invii la tua prima sessione. Digita un prompt nell'input in basso e premi `Enter`.356Agent view è vuoto finché non invii la tua prima sessione. Digita un prompt nell'input in basso e premi `Enter`.
286 357
287### Sessions show as stopped after waking your machine358### Cannot open agents because background tasks are running
359
360Se premere `←` per mettere in background la sessione corrente mostra `Cannot open agents — N background task(s) running`, la sessione ha lavoro in corso come un subagente, un workflow o un comando shell in background, e la scorciatoia non lo abbandonerà silenziosamente. Esegui `/tasks` per vedere cosa è in esecuzione, quindi `/bg` per confermare l'abbandono. Vedi [From inside a session](#from-inside-a-session) per sapere cosa viene e cosa non viene trasferito quando metti in background.
361
362### Prompt rejected as too short
363
364L'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`.
365
366### Sessions show as failed after waking your machine
288 367
289Le sessioni in background non sopravvivono al sonno o allo spegnimento. Collegati, fai peek, o rispondi a qualsiasi sessione fermata e si riavvia da dove l'ha lasciata. Per riavviarle tutte contemporaneamente, esegui `claude respawn --all`.368Le sessioni in background non sopravvivono al sonno o allo spegnimento, quindi le sessioni che erano in esecuzione mostrano come non riuscite dopo il risveglio. Collegati, fai peek, o rispondi a qualsiasi sessione e la sessione si riavvia da dove l'ha lasciata. Per riavviarle tutte contemporaneamente, esegui `claude respawn --all`.
290 369
291### A session is slow to respond after attaching370### A session is slow to respond after attaching
292 371
298 377
299## Limitazioni378## Limitazioni
300 379
301Agent view è un'anteprima di ricerca. Le limitazioni attuali di cui essere consapevoli:380Agent view è un'anteprima di ricerca con le seguenti limitazioni:
302 381
303* **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.382* **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.
304* **Le sessioni sono locali**: le sessioni in background vengono eseguite sulla vostra macchina e si fermano se entra in modalità sospensione o si spegne.383* **Le sessioni sono locali**: le sessioni in background vengono eseguite sulla vostra macchina e si fermano se entra in modalità sospensione o si spegne.
305* **I worktrees vengono eliminati con la sessione**: unite o inviate i cambiamenti prima di eliminare una sessione che ha modificato file nel suo proprio worktree.384* **I worktrees vengono eliminati con la sessione**: unite o inviate i cambiamenti prima di eliminare una sessione che ha modificato file nel suo proprio worktree.
306 385
307## Passaggi successivi386## Risorse correlate
308 387
309Ora che comprendi agent view, esplora queste funzioni correlate:388Per altri modi di eseguire Claude in parallelo, vedi:
310 389
311* [Esegui agenti in parallelo](/it/agents): confronta agent view con subagenti, team di agenti e worktrees390* [Esegui agenti in parallelo](/it/agents): confronta agent view con subagenti, team di agenti e worktrees
312* [Subagenti](/it/sub-agents): definisci configurazioni di agenti riutilizzabili con prompt personalizzati, strumenti e isolamento
313* [Team di agenti](/it/agent-teams): coordina più sessioni che si messaggiano l'una con l'altra391* [Team di agenti](/it/agent-teams): coordina più sessioni che si messaggiano l'una con l'altra
314* [Claude Code on the web](/it/claude-code-on-the-web): esegui sessioni in un ambiente cloud gestito invece che localmente392* [Claude Code on the web](/it/claude-code-on-the-web): esegui sessioni in un ambiente cloud gestito invece che localmente
