Agent view, aperto conDocumentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
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 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.- Quick start: dai a Claude un compito su cui lavorare in background, controlla come sta andando e intervieni quando necessario
- 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 tua shell
- Manage sessions from the shell
- How background sessions are hosted dal processo supervisor
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.Open agent view
Dalla tua shell, esegui: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.Dispatch a session
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 che otterresti eseguendo claude in quella directory.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 and reply
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.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.Bring an existing session in
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.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.
Monitorare le sessioni con agent view
Eseguiclaude 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 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. I subagents e i teammates che una sessione genera non sono elencati come righe separate.
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 una domanda specifica o una decisione di permesso da te |
| 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 |
| Forma | Cosa significa |
|---|---|
✻ o animato ✽ | Il processo della sessione è vivo e risponde immediatamente |
∙ | Il processo è uscito. Puoi ancora fare peek, rispondere o collegarti, e 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 |
claude respawn --all.
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 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 della sessione stessa.Stato della pull request
Quando 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.| Colore del punto | 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 |
Peek and reply
PremiSpace 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.
Collegarsi a una sessione
PremiEnter 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.
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.
Dopo 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.
Organizzare l’elenco
Agent view raggruppa le sessioni in modo che quelle che hanno bisogno di input siano in cima, conReady 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+Tper fissare una sessione in cima - Premi
Shift+↑oShift+↓per riordinare le sessioni - Premi
Ctrl+Rper rinominare una sessione - Premi
Entersu un’intestazione di gruppo per comprimerla
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.
L’eliminazione rimuove la sessione da agent view e pulisce il suo worktree, 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.
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.
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 | La sessione che lavora su quella pull request |
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 | Invia e collegati immediatamente |
→ | Collegati alla sessione selezionata |
Alt+1..Alt+9 | Collegati alla sessione 1–9 nel gruppo corrente |
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 $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 |
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.From agent view
Digita un prompt nell’input in basso di agent view e premiEnter per avviare una nuova sessione in background. La sessione è denominata automaticamente dal prompt; rinominala 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 |
@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:- Apri
claude agentsin quella directory. - Apri
claude agentsin una directory padre che contiene diversi repository e menzionane uno con@<repo>nel prompt per eseguire la sessione lì. - Dalla shell,
cdnella directory e eseguiclaude --bg "<prompt>".
From inside a session
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.
Lo spostamento in background da una sessione interattiva avvia un nuovo processo che riprende dalla conversazione salvata, quindi l’esecuzione di subagent, monitor, 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.
From your shell
Passa--bg per avviare una sessione che va direttamente in background:
--bg con --agent:
How file edits are isolated
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. 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.
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.
Il 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.
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.
Set the model
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 è la stessa impostazione che/model controlla in qualsiasi sessione. Per sovrascriverlo per l’intera sessione di agent view, passa --model quando apri agent view. Vedi Permission mode, model, and effort.
Ogni sessione in background può essere eseguita su un modello diverso. Per sovrascriverlo per una sessione:
- Dalla shell, passa
--modelconclaude --bg. - Collegati a una sessione in esecuzione ed esegui
/modellì. Il cambiamento persiste se la sessione viene riavviata. - Invia un subagent il cui frontmatter imposta un campo
model.
Permission mode, model, and effort
Una sessione inviata legge i suoi settings e permission mode dalla directory in cui viene eseguita, come se avessi avviatoclaude lì.
Per impostare i default per ogni sessione che invii da agent view, passa uno qualsiasi di --permission-mode, --model, o --effort quando lo apri:
defaultMode dai settings di quella directory o il permissionMode dal frontmatter del subagent inviato, e il modello mostrato nell’intestazione di agent view.
L’uso di bypassPermissions o auto è 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. Lo stesso si applica sia che tu passi il mode a claude agents che a claude --bg --permission-mode.
Settings, plugins, and MCP servers
Agent view accetta gli stessi flag di configurazione diclaude per caricare settings, plugins, MCP servers, 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 MCP server che carichi in questo modo è disponibile anche in quelle sessioni.
| Flag | Effect |
|---|---|
--settings <file-or-json> | Sovrascrivi settings 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 MCP servers da un file di configurazione o stringa JSON |
--strict-mcp-config | Usa solo i MCP servers da --mcp-config, ignorando altre configurazioni MCP |
--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.
L’esempio seguente apre agent view con un override di settings e una directory extra:
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 conclaude --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.
| 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. Pulisce il suo worktree se non ci sono modifiche non sottoposte a commit |
Come sono ospitate le sessioni in background
Ogni 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 eseguendoclaude direttamente è legata a quel terminale e termina quando si chiude, a meno che tu non la invii in background.
Il processo supervisor
Le 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. 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 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. 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 ne hai bisogno. Il supervisor osserva il binario 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.Dove lo stato è archiviato
Lo stato della sessione è archiviato sotto la tua directory di configurazione Claude Code. Se impostiCLAUDE_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 |
Disattiva agent view
Per disattivare completamente gli agenti in background e agent view, imposta l’impostazionedisableAgentView 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 la visualizzazione agente
Se 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.
Se la visualizzazione agente ancora non si apre dopo l’aggiornamento, verifica se è stata disattivata da un’impostazione o da una variabile di ambiente.
Agent view opens with no sessions
Agent view è vuoto finché non invii la tua prima sessione. Digita un prompt nell’input in basso e premiEnter.
Cannot open agents because background tasks are running
Se 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 per sapere cosa viene e cosa non viene trasferito quando metti in background.
Prompt rejected as too short
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 suggerimentoToo short in modo che una pressione accidentale non avvii una sessione. Descrivi cosa vuoi che la sessione faccia, come investigate the flaky checkout test.
Sessions show as failed after waking your machine
Le 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, eseguiclaude 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.
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 e si fermano se entra in modalità sospensione o si spegne.
- 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.
Risorse correlate
Per altri modi di eseguire Claude in parallelo, vedi:- Esegui agenti in parallelo: confronta agent view con subagenti, team di agenti e worktrees
- 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
