Il rendering a schermo intero è un’anteprima di ricerca opt-in e richiede Claude Code v2.1.88 o successivo. Abilitarlo con CLAUDE_CODE_NO_FLICKER=1. 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
Imposta la variabile di ambiente CLAUDE_CODE_NO_FLICKER quando avvii Claude Code:
CLAUDE_CODE_NO_FLICKER=1 claude
~/.zshrc o ~/.bashrc:
export CLAUDE_CODE_NO_FLICKER=1
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 quindi / per cercare, o Ctrl+o quindi [ per scrivere la conversazione nello scrollback nativo in modo che Cmd+f funzioni di nuovo | 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:// e https:// semplici si aprono nel browser. Nella maggior parte dei terminali questo sostituisce il Cmd-clic o il Ctrl-clic nativo, che l’acquisizione del mouse intercetta. Nel terminale integrato di VS Code e nei terminali basati su xterm.js simili, continua a usare Cmd-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.
Il testo selezionato viene copiato negli appunti automaticamente al rilascio del mouse. Per disattivarlo, attiva/disattiva Copia alla selezione in /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.
Scorri la conversazione
Il rendering a schermo intero gestisce lo scorrimento all’interno dell’app. Usa questi 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.
Lo scorrimento verso l’alto mette in pausa il follow automatico in modo che il nuovo output non ti riporti al fondo. Premi Ctrl+End o scorri verso il basso per riprendere il follow.
Queste azioni sono riassegnabili. Vedi Scorciatoie da tastiera per personalizzarle. I nomi delle azioni sono scroll:pageUp, scroll:pageDown, scroll:top e scroll:bottom. Le azioni aggiuntive senza binding predefinito includono scroll:lineUp, scroll:lineDown, scroll:halfPageUp, scroll:halfPageDown, scroll:fullPageUp e scroll:fullPageDown.
Regola la velocità di scorrimento della rotella
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:
export CLAUDE_CODE_SCROLL_SPEED=3
3 corrisponde al valore predefinito in vim e applicazioni simili. L’impostazione accetta valori da 1 a 20.
Cerca e rivedi la conversazione
Premi Ctrl+o per entrare in modalità trascrizione. Con il rendering a schermo intero attivo, 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 |
Esc, q o Ctrl+o | Esci dalla modalità trascrizione |
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, quindi Cmd+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 con Esc o q, che ti riporta al rendering a schermo intero. Il prossimo Ctrl+o ricomincia da capo.v: scrive la conversazione in un file temporaneo e lo apre in $VISUAL o $EDITOR.
Premi Esc, q o Ctrl+o per tornare al prompt.
Usa con tmux
Il rendering a schermo intero funziona all’interno di tmux, con due 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:
Senza la modalità mouse, gli eventi della rotella vanno a tmux invece che a Claude Code. Lo scorrimento da tastiera con 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.
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. Claude Code stampa un toast dopo ogni copia dicendoti quale percorso ha utilizzato.
Se fai affidamento sulla selezione nativa del terminale, imposta CLAUDE_CODE_DISABLE_MOUSE=1 per rinunciare all’acquisizione del mouse mantenendo il rendering senza sfarfallio e la memoria piatta:
CLAUDE_CODE_NO_FLICKER=1 CLAUDE_CODE_DISABLE_MOUSE=1 claude
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, annulla l’impostazione della variabile di ambiente o imposta CLAUDE_CODE_NO_FLICKER=0.
