Documentation 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.
Il rendering a schermo intero è un’anteprima di ricerca opt-in e richiede Claude Code v2.1.89 o successivo. Eseguire
/tui fullscreen per passare nella conversazione corrente, oppure impostare CLAUDE_CODE_NO_FLICKER=1 nelle versioni precedenti a v2.1.110. Il comportamento potrebbe cambiare in base al feedback.vim o htop, e renderizza solo i messaggi attualmente visibili. Questo riduce la quantità di dati inviati al terminale ad ogni aggiornamento.
La differenza è più evidente negli emulatori di terminale dove il throughput di rendering è il collo di bottiglia, come il terminale integrato di VS Code, tmux e iTerm2. Se la posizione di scorrimento del terminale salta in alto mentre Claude sta lavorando, o lo schermo lampeggia mentre l’output dello strumento viene trasmesso, questa modalità affronta questi problemi.
Il termine schermo intero descrive come Claude Code si impadronisce della superficie di disegno del terminale, come fa
vim. Non ha nulla a che fare con la massimizzazione della finestra del terminale e funziona a qualsiasi dimensione della finestra.Abilita il rendering a schermo intero
Eseguire/tui fullscreen all’interno di qualsiasi conversazione di Claude Code. La CLI salva l’impostazione tui e si riavvia in modalità schermo intero con la conversazione intatta, quindi è possibile passare a metà sessione senza perdere il contesto. Eseguire /tui senza argomenti per stampare quale renderer è attivo.
È inoltre possibile impostare la variabile di ambiente CLAUDE_CODE_NO_FLICKER prima di avviare Claude Code:
tui e la variabile di ambiente sono equivalenti. Il comando /tui cancella CLAUDE_CODE_NO_FLICKER dal processo riavviato in modo che l’impostazione che scrive abbia effetto.
Cosa cambia
Il rendering a schermo intero cambia il modo in cui la CLI disegna sul terminale. La casella di input rimane fissa in fondo allo schermo invece di muoversi mentre l’output viene trasmesso. Se l’input rimane fermo mentre Claude sta lavorando, il rendering a schermo intero è attivo. Solo i messaggi visibili vengono mantenuti nell’albero di rendering, quindi la memoria rimane costante indipendentemente dalla lunghezza della conversazione. Poiché la conversazione vive nel buffer dello schermo alternativo invece dello scrollback del terminale, alcune cose funzionano diversamente:| Prima | Ora | Dettagli |
|---|---|---|
Cmd+f o ricerca tmux per trovare testo | Ctrl+o per la modalità trascrizione, quindi / per cercare o [ per scrivere nello scrollback | Cerca e rivedi la conversazione |
| Clic e trascinamento nativo del terminale per selezionare e copiare | Selezione in-app, copia automatica al rilascio del mouse | Usa il mouse |
Cmd-clic per aprire un URL | Fai clic sull’URL | Usa il mouse |
Usa il mouse
Il rendering a schermo intero acquisisce gli eventi del mouse e li gestisce all’interno di Claude Code:- Fai clic nella casella di input del prompt per posizionare il cursore in qualsiasi punto del testo che stai digitando.
- Fai clic su un risultato dello strumento compresso per espanderlo e vedere l’output completo. Fai clic di nuovo per comprimerlo. La chiamata dello strumento e il suo risultato si espandono insieme. Solo i messaggi che hanno più da mostrare sono cliccabili.
- Fai clic su un URL o un percorso di file per aprirlo. I percorsi di file nell’output dello strumento, come quelli stampati dopo un Edit o Write, si aprono nell’applicazione predefinita. Gli URL
http://ehttps://semplici si aprono nel browser. Nella maggior parte dei terminali questo sostituisce ilCmd-clic o ilCtrl-clic nativo, che l’acquisizione del mouse intercetta. Nel terminale integrato di VS Code e nei terminali basati su xterm.js simili, continua a usareCmd-clic. Claude Code si rimette al gestore di link del terminale per evitare di aprire i link due volte. - Fai clic e trascinamento per selezionare il testo in qualsiasi punto della conversazione. Il doppio clic seleziona una parola, corrispondendo ai confini delle parole di iTerm2 in modo che un percorso di file si selezioni come un’unità. Il triplo clic seleziona la riga.
- Scorri con la rotella del mouse per muoverti attraverso la conversazione.
/config. Con questa opzione disattivata, premi Ctrl+Shift+c per copiare manualmente. Sui terminali che supportano il protocollo della tastiera kitty, come kitty, WezTerm, Ghostty e iTerm2, funziona anche Cmd+c. Se hai una selezione attiva, Ctrl+c copia invece di annullare.
Con una selezione attiva, tieni premuto Shift e premi i tasti freccia per estenderla dalla tastiera. Shift+↑ e Shift+↓ scorrono il viewport quando la selezione raggiunge il bordo superiore o inferiore. Shift+Home e Shift+End estendono all’inizio o alla fine della riga corrente.
Scorri la conversazione
Il rendering a schermo intero gestisce lo scorrimento all’interno dell’app. Usa queste scorciatoie per navigare:| Scorciatoia | Azione |
|---|---|
PgUp / PgDn | Scorri su o giù di mezzo schermo |
Ctrl+Home | Salta all’inizio della conversazione |
Ctrl+End | Salta al messaggio più recente e riabilita il follow automatico |
| Rotella del mouse | Scorri di poche righe alla volta |
PgUp, PgDn, Home o End, come le tastiere MacBook, tieni premuto Fn con i tasti freccia: Fn+↑ invia PgUp, Fn+↓ invia PgDn, Fn+← invia Home e Fn+→ invia End. Questo rende Ctrl+Fn+→ la scorciatoia per saltare al fondo. Se ti sembra scomodo, scorri verso il basso con la rotella del mouse per riprendere il follow, o riassegna scroll:bottom a qualcosa di raggiungibile.
Queste azioni sono riassegnabili. Vedi Azioni di scorrimento per l’elenco completo dei nomi delle azioni, incluse le varianti di mezza pagina e pagina intera che non hanno binding predefinito.
Follow automatico
Lo scorrimento verso l’alto mette in pausa il follow automatico in modo che il nuovo output non ti riporti al fondo. PremiCtrl+End o scorri verso il basso per riprendere il follow.
Per disattivare completamente il follow automatico in modo che la vista rimanga dove la lasci, apri /config e imposta Auto-scroll su off. Con auto-scroll disabilitato, la vista non salta mai al fondo da sola. I prompt di autorizzazione e altri dialoghi che richiedono una risposta scorrono comunque in vista indipendentemente da questa impostazione.
Scorrimento con la rotella del mouse
Lo scorrimento con la rotella del mouse richiede che il terminale inoltri gli eventi del mouse a Claude Code. La maggior parte dei terminali lo fa ogni volta che un’applicazione lo richiede. iTerm2 lo rende un’impostazione per profilo: se la rotella non fa nulla maPgUp e PgDn funzionano, apri Impostazioni → Profili → Terminale e attiva Abilita segnalazione mouse. La stessa impostazione è richiesta anche per il clic per espandere e la selezione di testo per funzionare.
Se lo scorrimento con la rotella del mouse sembra lento, il terminale potrebbe inviare un evento di scorrimento per ogni tacca fisica senza moltiplicatore. Alcuni terminali, come Ghostty e iTerm2 con scorrimento più veloce abilitato, amplificano già gli eventi della rotella. Altri, incluso il terminale integrato di VS Code, inviano esattamente un evento per tacca. Claude Code non può rilevare quale.
Imposta CLAUDE_CODE_SCROLL_SPEED per moltiplicare la distanza di scorrimento di base:
3 corrisponde al valore predefinito in vim e applicazioni simili. L’impostazione accetta valori da 1 a 20.
Per regolare la velocità di scorrimento in modo interattivo, esegui /scroll-speed. La finestra di dialogo mostra un righello che puoi scorrere mentre è aperta in modo da poter sentire il cambiamento immediatamente. Premi ← e → per regolare, r per ripristinare il valore predefinito rilevato automaticamente e Invio per salvare. Il comando scrive lo stesso valore che la variabile di ambiente CLAUDE_CODE_SCROLL_SPEED imposta, persistito in ~/.claude/settings.json. Il comando non è disponibile nel terminale dell’IDE JetBrains.
Scorrimento nel terminale dell’IDE JetBrains
Nel terminale dell’IDE JetBrains, Claude Code applica la propria gestione dello scorrimento e ignoraCLAUDE_CODE_SCROLL_SPEED. Il terminale invia eventi di scorrimento a una velocità molto più elevata rispetto ad altri emulatori, quindi un moltiplicatore sintonizzato altrove va oltre qui.
Nel 2025.2, il terminale ha anche bug di scorrimento con la rotella che producono tasti freccia spuri e eventi di direzione sbagliata. Claude Code rileva questi in fase di esecuzione e li mitiga automaticamente, quindi lo scorrimento con trackpad e rotella del mouse funzionano senza configurazione. Per la migliore esperienza di scorrimento, esegui l’aggiornamento a 2025.3 o versioni successive. Claude Code mostra un suggerimento la prima volta che scorri se rileva il bug.
Cerca e rivedi la conversazione
Ctrl+o attiva/disattiva tra il prompt normale e la modalità trascrizione. Per una vista più silenziosa che mostra solo l’ultimo prompt, un riassunto di una riga delle chiamate dello strumento con diffstat di modifica e la risposta finale, esegui /focus. L’impostazione persiste tra le sessioni. Esegui /focus di nuovo per disattivarla.
La modalità trascrizione guadagna navigazione e ricerca in stile less:
| Tasto | Azione |
|---|---|
/ | Apri la ricerca. Digita per trovare corrispondenze, Enter per accettare, Esc per annullare e ripristinare la posizione di scorrimento |
n / N | Salta alla corrispondenza successiva o precedente. Funziona dopo aver chiuso la barra di ricerca |
j / k o ↑ / ↓ | Scorri una riga |
g / G o Home / End | Salta all’inizio o alla fine |
Ctrl+u / Ctrl+d | Scorri mezza pagina |
Ctrl+b / Ctrl+f o Space / b | Scorri una pagina intera |
Ctrl+o, Esc, o q | Esci dalla modalità trascrizione e torna al prompt |
Cmd+f del terminale e la ricerca tmux non vedono la conversazione perché vive nel buffer dello schermo alternativo, non nello scrollback nativo. Per restituire il contenuto al terminale, premi Ctrl+o per entrare prima in modalità trascrizione, quindi:
[: scrive la conversazione completa nel buffer dello scrollback nativo del terminale, con tutto l’output dello strumento espanso. La conversazione è ora testo ordinario nel terminale, quindiCmd+f, la modalità copia tmux e qualsiasi altro strumento nativo può cercarla o selezionarla. Le sessioni lunghe potrebbero fare una pausa per un momento mentre questo accade. Questo dura fino a quando non esci dalla modalità trascrizione conEscoq, che ti riporta al rendering a schermo intero. Il prossimoCtrl+oricomincia da capo.v: scrive la conversazione in un file temporaneo e lo apre in$VISUALo$EDITOR.
Esc o q per tornare al prompt.
Cancella la conversazione
PremiCtrl+L due volte entro due secondi per eseguire /clear e avviare una nuova conversazione. Il primo pressione ridisegna lo schermo e mostra un suggerimento; il secondo pressione cancella la conversazione. Su macOS, il doppio pressione di Cmd+K esegue anche /clear.
Usa con tmux
Il rendering a schermo intero funziona all’interno di tmux, con tre avvertenze. Lo scorrimento con la rotella del mouse richiede la modalità mouse di tmux. Se il tuo~/.tmux.conf non lo abilita già, aggiungi questa riga e ricarica la configurazione:
PgUp e PgDn funziona comunque. Claude Code stampa un suggerimento una tantum all’avvio se rileva tmux con la modalità mouse disattivata.
Il rendering a schermo intero è incompatibile con la modalità di integrazione tmux di iTerm2, che è la modalità in cui entri con tmux -CC. In modalità integrazione, iTerm2 renderizza ogni riquadro tmux come una divisione nativa piuttosto che lasciare che tmux disegni sul terminale. Il buffer dello schermo alternativo e il tracciamento del mouse non funzionano correttamente lì: la rotella del mouse non fa nulla e il doppio clic può corrompere lo stato del terminale. Non abilitare il rendering a schermo intero nelle sessioni tmux -CC. Il tmux regolare all’interno di iTerm2, senza -CC, funziona bene.
tmux non supporta l’output sincronizzato, quindi potresti vedere più sfarfallio durante i ridisegni rispetto a quando esegui Claude Code direttamente nel tuo terminale. Se lo sfarfallio è evidente, specialmente su SSH, esegui Claude Code nella sua propria scheda terminale al di fuori di tmux.
Mantieni la selezione di testo nativa
L’acquisizione del mouse è il punto di attrito più comune, specialmente su SSH o all’interno di tmux. Quando Claude Code acquisisce gli eventi del mouse, la copia nativa al rilascio della selezione del terminale smette di funzionare. La selezione che fai con clic e trascinamento esiste all’interno di Claude Code, non nel buffer di selezione del terminale, quindi la modalità copia tmux, i suggerimenti Kitty e strumenti simili non la vedono. Claude Code tenta di scrivere la selezione negli appunti, ma il percorso che utilizza dipende dalla configurazione. All’interno di tmux scrive nel buffer di incolla tmux. Su SSH ricade alle sequenze di escape OSC 52, che alcuni terminali bloccano per impostazione predefinita. iTerm2 le blocca finché non attivi Impostazioni → Generale → Selezione → Le applicazioni nel terminale possono accedere agli appunti. Eseguire/terminal-setup in iTerm2 abilita questo per te. Claude Code stampa un toast dopo ogni copia dicendoti quale percorso ha utilizzato.
Per una selezione nativa una tantum, tenere premuto il modificatore di bypass del terminale mentre si fa clic e si trascina: Option in iTerm2, o Shift nella maggior parte dei terminali Linux e Windows. Il modificatore dice al terminale di gestire la selezione stesso invece di inoltrare gli eventi del mouse a Claude Code, quindi Cmd+C e gli altri scorciatoie di copia del terminale funzionano su di essa.
Se fai affidamento sulla selezione nativa tutto il tempo, imposta CLAUDE_CODE_DISABLE_MOUSE=1 per rinunciare all’acquisizione del mouse mantenendo il rendering senza sfarfallio e la memoria piatta:
PgUp, PgDn, Ctrl+Home e Ctrl+End funziona ancora, e il terminale gestisce la selezione in modo nativo. Perdi il clic per posizionare il cursore, il clic per espandere l’output dello strumento, il clic su URL e lo scorrimento della rotella all’interno di Claude Code.
Anteprima di ricerca
Il rendering a schermo intero è una funzione di anteprima di ricerca. È stato testato su emulatori di terminale comuni, ma potresti incontrare problemi di rendering su terminali meno comuni o configurazioni insolite. Se riscontri un problema, esegui/feedback all’interno di Claude Code per segnalarlo, o apri un problema nel repository GitHub di claude-code. Includi il nome e la versione dell’emulatore del terminale.
Per disattivare il rendering a schermo intero, esegui /tui default, o annulla l’impostazione di CLAUDE_CODE_NO_FLICKER se l’hai abilitata in quel modo. Per forzare il renderer classico indipendentemente dall’impostazione tui salvata, imposta CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1. Il renderer classico mantiene la conversazione nello scrollback nativo del tuo terminale, quindi Cmd+f e la modalità di copia di tmux funzionano come al solito.