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. Le sessioni continuano a girare in background senza un terminale collegato.

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

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

Questa pagina copre:

Quick start
Monitor sessions with agent view, inclusi icone di stato, peek e reply, collegamento, organizzazione e scorciatoie da tastiera
Dispatch new agents da agent view, da dentro una sessione, o dalla shell
Manage sessions from the shell
How background sessions are hosted dal processo supervisor

Quick start

Questa procedura apre agent view, invia una sessione, risponde dal pannello peek e si collega per la conversazione completa.

Open agent view

Dalla tua shell, esegui:

claude agents

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.

Dispatch a session

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 è fatta. Ripeti per eseguire quante sessioni in parallelo vuoi.

Peek and reply

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.

Attach and detach

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.

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

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

Monitor sessions with 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 quanto tempo fa è cambiata l'ultima volta.

L'elenco è globale per la tua macchina e include ogni sessione in background indipendentemente da quale progetto o worktree su cui sta lavorando. Le sessioni interattive che hai aperto in altri terminali non appaiono finché non le metti in background, e i subagents in esecuzione dentro una sessione non sono elencati come righe separate.

Pinned
  ✽ clawd walk cycle          Write assets/sprites/clawd-walk.png           3m

Ready for review
  ∙ jump physics              github.com/anthropics/example/pull/2048       2h

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

Working
  ✽ collision detection       Edit src/physics/CollisionSystem.ts           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

L'icona ti dice lo stato della sessione:

Icon	State	What it means
Animated	Working	Claude sta attivamente eseguendo strumenti o generando una risposta
Yellow	Needs input	Claude sta aspettando il tuo input, solitamente una decisione di permesso o una risposta
Dimmed	Idle	La sessione sta aspettando input ma non è bloccata su una domanda specifica
Green	Completed	Il compito è terminato con successo
Red	Failed	Il compito è terminato con un errore
Grey	Stopped	La sessione è stata fermata con `Ctrl+X` o `claude stop`

La 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 che dorme tra le iterazioni, con la riga che mostra il conteggio delle esecuzioni e un conto alla rovescia per la prossima iterazione.

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.

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

Il riassunto di una riga è generato dal tuo modello di classe Haiku configurato in modo che la riga possa dirti cosa sta facendo la sessione, cosa ha bisogno, o cosa ha prodotto senza aprire il transcript. Ogni riassunto è una breve richiesta di classe Haiku attraverso il tuo provider normale, fatturato e gestito secondo gli stessi termini di utilizzo dei dati della sessione stessa.

Quando una sessione apre una pull request, la riga mostra il link PR e un indicatore di stato per i suoi controlli CI. Per la maggior parte dei compiti questa riga è come raccogli il lavoro: rivedi e unisci la pull request quando i suoi controlli passano.

Peek and reply

Premi Space su una riga selezionata per aprire il pannello peek. Mostra cosa la sessione ha bisogno da te, il suo output più recente, e qualsiasi pull request che ha aperto. La maggior parte delle volte questo è sufficiente, e non hai mai bisogno di aprire il transcript completo.

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

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

Attach to a session

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

Mentre collegato, la sessione si comporta come qualsiasi altra sessione di Claude Code: ogni comando, scorciatoia da tastiera e funzione funziona.

Premi ← su un prompt vuoto per scollegar e tornare a agent view. Se una finestra di dialogo ha il focus e non risponde a ←, premi Ctrl+Z per scollegar immediatamente.

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

Una volta che hai usato agent view, premere ← su un prompt vuoto funziona da qualsiasi sessione di Claude Code, non solo quelle a cui ti sei collegato. Apre agent view con la tua sessione corrente pre-selezionata, quindi puoi cambiare sessioni senza lasciare il terminale.

Organize the list

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

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

Filter the list

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

Filter	Shows
`a:<name>`	Sessioni che eseguono l'agente denominato
`s:<state>`	Sessioni nello stato dato, come `s:blocked` per sessioni che hanno bisogno di te
`#<number>` o un URL PR	La sessione che lavora su quella pull request

Keyboard shortcuts

Premi ? in agent view per vedere ogni scorciatoia. Le più comuni:

Shortcut	Action
`↑` / `↓`	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`	Invia e collegati immediatamente
`→`	Collegati alla sessione selezionata
`Alt+1`..`Alt+9`	Collegati alla N-esima sessione nel gruppo focalizzato
`Tab`	Sfoglia tutti i subagents, o 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 `$EDITOR`
`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
`Ctrl+C`	Cancella l'input; premi due volte per uscire
`?`	Mostra tutte le scorciatoie

Dispatch new agents

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

From 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. Puoi rinominarla in seguito con Ctrl+R. Incolla un'immagine nel prompt per includere uno screenshot o un diagramma con il compito.

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

Input	Effect
`<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 sotto la directory da cui hai aperto agent view per eseguire la sessione lì
`/<skill>`	Suggerisci skills da inviare come prompt
`#<number>` o un URL di pull request	Se una sessione sta già lavorando su quel PR, selezionala invece di inviare
`Shift+Enter`	Invia e collegati immediatamente alla nuova sessione

Digita / per inviare una skill. 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.

Dispatch to a specific directory

Una nuova sessione viene eseguita nella directory da cui hai aperto agent view. Per indirizzare una directory diversa:

Apri claude agents in quella directory.
Apri claude agents in una directory padre che contiene diversi repository e menzionane uno con @<repo> nel prompt per eseguire la sessione lì.
Dalla shell, cd nella directory e esegui claude --bg "<prompt>".

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

Isolate file edits in a worktree

Le sessioni inviate da agent view condividono la tua directory di lavoro per impostazione predefinita, quindi due agenti che modificano gli stessi file possono entrare in conflitto. Per prevenire questo, Claude Code blocca una sessione inviata da agent view dalla scrittura di file finché non si sposta in un git worktree isolato. Claude gestisce questo automaticamente quando ha bisogno di modificare file. Il worktree è creato sotto .claude/worktrees/ dentro la directory del progetto e rimosso quando elimini la sessione. Eliminare una sessione elimina anche il suo worktree, quindi unisci o spingi i cambiamenti che vuoi mantenere prima di eliminare.

Per fare in modo che un subagent venga sempre eseguito nel suo proprio worktree indipendentemente da come è stato avviato, imposta isolation: worktree nel suo frontmatter.

From inside a session

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

From the shell

Passa --bg per avviare una sessione che va direttamente in background:

claude --bg "investigate the flaky SettingsChangeDetector test"

Per eseguire un subagent specifico come agente principale della sessione, combina --bg con --agent:

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

Dopo aver messo in background, Claude stampa l'ID breve della sessione e i comandi per gestirla:

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

Manage sessions from the shell

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

Command	Purpose
`claude agents`	Apri agent view
`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 fermata con la sua conversazione intatta
`claude respawn --all`	Riavvia ogni sessione fermata
`claude rm <id>`	Rimuovi una sessione dall'elenco

How background sessions are hosted

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

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

Il supervisor osserva il binario di Claude Code installato su disco e si riavvia nella nuova versione dopo che l'auto-updater 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.

Lo stato della sessione è archiviato sotto la tua directory di configurazione di 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.

Path	Contents
`~/.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

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

Agent view opens with no sessions

Agent view è vuoto finché non invii la tua prima sessione. Digita un prompt nell'input in basso e premi Enter.

Sessions show as stopped after waking your machine

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

A session is slow to respond after attaching

Una volta che una sessione è finita e rimane scollega per circa un'ora, il supervisor ferma il suo processo per liberare risorse. Collegarsi avvia un processo fresco da dove l'ha lasciato, il che richiede un momento. Le sessioni che stanno lavorando o aspettando te non sono mai fermate in questo modo.

`.claude/worktrees/` is filling up

I worktrees sono rimossi quando elimini la sessione che li ha creati. Se una sessione è terminata senza pulire, elenca le voci rimaste con git worktree list nella directory del progetto e rimuovi ognuna con git worktree remove <path>. Vedi Clean up worktrees.

Limitations

Agent view è un'anteprima di ricerca. Le limitazioni attuali di cui essere consapevoli:

I limiti di velocità si applicano: le sessioni in background consumano il tuo utilizzo di abbonamento come le sessioni interattive, quindi eseguire dieci agenti in parallelo usa la quota dieci volte più velocemente.
Le sessioni sono locali: le sessioni in background vengono eseguite sulla tua macchina e si fermano se dorme o si spegne.
I worktrees vengono eliminati con la sessione: unisci o spingi i cambiamenti prima di eliminare una sessione che ha modificato file nel suo proprio worktree.

Passaggi successivi

Ora che comprendi agent view, esplora queste funzioni correlate:

Esegui agenti in parallelo: confronta agent view con subagenti, team di agenti e worktrees
Subagenti: definisci configurazioni di agenti riutilizzabili con prompt personalizzati, strumenti e isolamento
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

agent-view.md +295 −0 created

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

5# Gestire più agenti con agent view

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.

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.

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.

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

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

17</Note>

19Questa pagina copre:

21* [Quick start](#quick-start)

22* [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 shell

24* [Manage sessions from the shell](#manage-sessions-from-the-shell)

25* [How background sessions are hosted](#how-background-sessions-are-hosted) dal processo supervisor

27## Quick start

29Questa procedura apre agent view, invia una sessione, risponde dal pannello peek e si collega per la conversazione completa.

31<Steps>

32 <Step title="Open agent view">

33 Dalla tua shell, esegui:

35 ```bash theme={null}

36 claude agents

37 ```

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.

40 </Step>

42 <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 è fatta. Ripeti per eseguire quante sessioni in parallelo vuoi.

44 </Step>

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

48 </Step>

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

52 </Step>

53</Steps>

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

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.

59## Monitor sessions with agent view

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.

63L'elenco è globale per la tua macchina e include ogni sessione in background indipendentemente da quale progetto o worktree su cui sta lavorando. 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.

65```text theme={null}

66Pinned

67 ✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m

69Ready for review

70 ∙ jump physics github.com/anthropics/example/pull/2048 2h

72Needs input

73 ✻ power-up design needs input: double jump or wall climb? 1m

75Working

76 ✽ collision detection Edit src/physics/CollisionSystem.ts 2m

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

79Completed

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

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

82 … 6 more

83```

85L'icona ti dice lo stato della sessione:

87| Icon | State | What it means |

88| :------- | :---------- | :--------------------------------------------------------------------------------------- |

89| Animated | Working | Claude sta attivamente eseguendo strumenti o generando una risposta |

90| Yellow | Needs input | Claude sta aspettando il tuo input, solitamente una decisione di permesso o una risposta |

91| Dimmed | Idle | La sessione sta aspettando input ma non è bloccata su una domanda specifica |

92| Green | Completed | Il compito è terminato con successo |

93| Red | Failed | Il compito è terminato con un errore |

94| Grey | Stopped | La sessione è stata fermata con `Ctrl+X` o `claude stop` |

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.

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.

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

101

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. Ogni riassunto è 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.

103

104Quando una sessione apre una pull request, la riga mostra il link PR e un indicatore di stato per i suoi controlli CI. Per la maggior parte dei compiti questa riga è come raccogli il lavoro: rivedi e unisci la pull request quando i suoi controlli passano.

105

106### Peek and reply

107

108Premi `Space` su una riga selezionata per aprire il pannello peek. Mostra cosa la sessione ha bisogno da te, il suo output più recente, e qualsiasi pull request che ha aperto. La maggior parte delle volte questo è sufficiente, e non hai mai bisogno di aprire il transcript completo.

109

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

111

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

113

114### Attach to a session

115

116Premi `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.

117

118Mentre collegato, la sessione si comporta come qualsiasi altra sessione di Claude Code: ogni [comando](/it/commands), scorciatoia da tastiera e funzione funziona.

119

120Premi `←` su un prompt vuoto per scollegar e tornare a agent view. Se una finestra di dialogo ha il focus e non risponde a `←`, premi `Ctrl+Z` per scollegar immediatamente.

121

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

123

124Una volta che hai usato agent view, premere `←` su un prompt vuoto funziona da qualsiasi sessione di Claude Code, non solo quelle a cui ti sei collegato. Apre agent view con la tua sessione corrente pre-selezionata, quindi puoi cambiare sessioni senza lasciare il terminale.

125

126### Organize the list

127

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

129

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

131

132### Filter the list

133

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

135

136| Filter | Shows |

137| :---------------------- | :------------------------------------------------------------------------------- |

138| `a:<name>` | Sessioni che eseguono l'agente denominato |

139| `s:<state>` | Sessioni nello stato dato, come `s:blocked` per sessioni che hanno bisogno di te |

140| `#<number>` o un URL PR | La sessione che lavora su quella pull request |

141

142### Keyboard shortcuts

143

144Premi `?` in agent view per vedere ogni scorciatoia. Le più comuni:

145

146| Shortcut | Action |

147| :-------------------- | :------------------------------------------------------------------- |

148| `↑` / `↓` | Muoviti tra le righe |

149| `Enter` | Collegati alla sessione selezionata, o invia se c'è testo nell'input |

150| `Space` | Apri o chiudi il pannello peek per la sessione selezionata |

151| `Shift+Enter` | Invia e collegati immediatamente |

152| `→` | Collegati alla sessione selezionata |

153| `Alt+1`..`Alt+9` | Collegati alla N-esima sessione nel gruppo focalizzato |

154| `Tab` | Sfoglia tutti i subagents, o applica il suggerimento evidenziato |

155| `Ctrl+S` | Cambia raggruppamento tra stato e directory |

156| `Ctrl+T` | Fissa o scollega la sessione selezionata |

157| `Ctrl+R` | Rinomina la sessione selezionata |

158| `Ctrl+G` | Apri il prompt di dispatch nel tuo `$EDITOR` |

159| `Ctrl+X` | Ferma la sessione; premi di nuovo entro due secondi per eliminarla |

160| `Shift+↑` / `Shift+↓` | Riordina la sessione selezionata |

161| `Esc` | Chiudi il pannello peek, cancella l'input, o esci |

162| `Ctrl+C` | Cancella l'input; premi due volte per uscire |

163| `?` | Mostra tutte le scorciatoie |

164

165## Dispatch new agents

166

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

168

169### From agent view

170

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

172

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

174

175| Input | Effect |

176| :----------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

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

179| `@<repo>` | Menziona un repository sotto la directory da cui hai aperto agent view per eseguire la sessione lì |

180| `/<skill>` | Suggerisci [skills](/it/skills) da inviare come prompt |

181| `#<number>` o un URL di pull request | Se una sessione sta già lavorando su quel PR, selezionala invece di inviare |

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

183

184Digita `/` 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.

185

186#### Dispatch to a specific directory

187

188Una nuova sessione viene eseguita nella directory da cui hai aperto agent view. Per indirizzare una directory diversa:

189

190* Apri `claude agents` in quella directory.

191* Apri `claude agents` in una directory padre che contiene diversi repository e menzionane uno con `@<repo>` nel prompt per eseguire la sessione lì.

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

193

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

195

196#### Isolate file edits in a worktree

197

198Le sessioni inviate da agent view condividono la tua directory di lavoro per impostazione predefinita, quindi due agenti che modificano gli stessi file possono entrare in conflitto. Per prevenire questo, Claude Code blocca una sessione inviata da agent view dalla scrittura di file finché non si sposta in un [git worktree](/it/worktrees) isolato. Claude gestisce questo automaticamente quando ha bisogno di modificare file. Il worktree è creato sotto `.claude/worktrees/` dentro la directory del progetto e rimosso quando elimini la sessione. Eliminare una sessione elimina anche il suo worktree, quindi unisci o spingi i cambiamenti che vuoi mantenere prima di eliminare.

199

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

201

202### From inside a session

203

204Esegui `/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.

205

206### From the shell

207

208Passa `--bg` per avviare una sessione che va direttamente in background:

209

210```bash theme={null}

211claude --bg "investigate the flaky SettingsChangeDetector test"

212```

213

214Per eseguire un subagent specifico come agente principale della sessione, combina `--bg` con `--agent`:

215

216```bash theme={null}

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

218```

219

220Dopo aver messo in background, Claude stampa l'ID breve della sessione e i comandi per gestirla:

221

222```text theme={null}

223backgrounded · 7c5dcf5d

224 claude agents list sessions

225 claude attach 7c5dcf5d open in this terminal

226 claude logs 7c5dcf5d show recent output

227 claude stop 7c5dcf5d stop this session

228```

229

230## Manage sessions from the shell

231

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

233

234| Command | Purpose |

235| :--------------------- | :------------------------------------------------------------ |

236| `claude agents` | Apri agent view |

237| `claude attach <id>` | Collegati a una sessione in questo terminale |

238| `claude logs <id>` | Stampa l'output recente della sessione |

239| `claude stop <id>` | Ferma una sessione. Accetta anche `claude kill` |

240| `claude respawn <id>` | Riavvia una sessione fermata con la sua conversazione intatta |

241| `claude respawn --all` | Riavvia ogni sessione fermata |

242| `claude rm <id>` | Rimuovi una sessione dall'elenco |

243

244## How background sessions are hosted

245

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

247

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

249

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

251

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

253

254| Path | Contents |

255| :------------------------------- | :---------------------------------------------------------------------------------------- |

256| `~/.claude/daemon.log` | Log del supervisor |

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

258| `~/.claude/jobs/<id>/state.json` | Stato per sessione mostrato in agent view |

259

260Per 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).

261

262## Troubleshooting

263

264### Agent view opens with no sessions

265

266Agent view è vuoto finché non invii la tua prima sessione. Digita un prompt nell'input in basso e premi `Enter`.

267

268### Sessions show as stopped after waking your machine

269

270Le 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`.

271

272### A session is slow to respond after attaching

273

274Una volta che una sessione è finita e rimane scollega per circa un'ora, il supervisor ferma il suo processo per liberare risorse. Collegarsi avvia un processo fresco da dove l'ha lasciato, il che richiede un momento. Le sessioni che stanno lavorando o aspettando te non sono mai fermate in questo modo.

275

276### `.claude/worktrees/` is filling up

277

278I worktrees sono rimossi quando elimini la sessione che li ha creati. Se una sessione è terminata senza pulire, elenca le voci rimaste con `git worktree list` nella directory del progetto e rimuovi ognuna con `git worktree remove <path>`. Vedi [Clean up worktrees](/it/worktrees#clean-up-worktrees).

279

280## Limitations

281

282Agent view è un'anteprima di ricerca. Le limitazioni attuali di cui essere consapevoli:

283

284* **I limiti di velocità si applicano**: le sessioni in background consumano il tuo utilizzo di abbonamento come le sessioni interattive, quindi eseguire dieci agenti in parallelo usa la quota dieci volte più velocemente.

285* **Le sessioni sono locali**: le sessioni in background vengono eseguite sulla tua macchina e si fermano se dorme o si spegne.

286* **I worktrees vengono eliminati con la sessione**: unisci o spingi i cambiamenti prima di eliminare una sessione che ha modificato file nel suo proprio worktree.

287

288## Passaggi successivi

289

290Ora che comprendi agent view, esplora queste funzioni correlate:

291

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

293* [Subagenti](/it/sub-agents): definisci configurazioni di agenti riutilizzabili con prompt personalizzati, strumenti e isolamento

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

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

agent-view.md 2026-05-10 23:03 UTC to 2026-05-11 23:00 UTC

Gestire più agenti con agent view

Quick start

Open agent view

Dispatch a session

Peek and reply

Attach and detach

Monitor sessions with agent view

Peek and reply

Attach to a session

Organize the list

Filter the list

Keyboard shortcuts

Dispatch new agents

From agent view

Dispatch to a specific directory

Isolate file edits in a worktree

From inside a session

From the shell

Manage sessions from the shell

How background sessions are hosted

Troubleshooting

Agent view opens with no sessions

Sessions show as stopped after waking your machine

A session is slow to respond after attaching

.claude/worktrees/ is filling up

Limitations

Passaggi successivi

`.claude/worktrees/` is filling up