- Shift+Enter invia invece di inserire una nuova riga
- Le scorciatoie con il tasto Option non fanno nulla su macOS
- Nessun suono o avviso quando Claude termina
- Esegui Claude Code all’interno di tmux
- Backspace elimina un’intera parola su Windows
- Lo schermo sfarfalla o lo scrollback salta
- Vuoi i tasti Vim nel prompt
Inserire prompt su più righe
Premendo Enter invii il messaggio. Per aggiungere un’interruzione di riga senza inviare, premi Ctrl+J, oppure digita\ e poi premi Enter. Entrambi i metodi funzionano in qualsiasi terminale senza alcuna configurazione.
Nella maggior parte dei terminali puoi anche premere Shift+Enter, ma il supporto varia a seconda dell’emulatore di terminale:
Per VS Code, Cursor, Devin Desktop, Alacritty precedente alla 0.16 e Zed,
/terminal-setup scrive una scorciatoia da tastiera Shift+Enter nel file di configurazione del terminale. Alla prima esecuzione vedi una conferma come Installed VSCode terminal Shift+Enter key binding. Le scorciatoie da tastiera esistenti vengono lasciate invariate; se vedi un messaggio come VSCode terminal Shift+Enter key binding already configured, non è stata apportata alcuna modifica. Esegui /terminal-setup direttamente nel terminale host anziché all’interno di tmux o screen, poiché deve scrivere nella configurazione del terminale host.
In VS Code, Cursor e Devin Desktop, /terminal-setup aggiorna anche due impostazioni dell’editor: imposta terminal.integrated.gpuAcceleration su "off" per evitare testo corrotto nel terminale integrato, e imposta terminal.integrated.mouseWheelScrollSensitivity per uno scorrimento più fluido in modalità a schermo intero. Per annullare la modifica all’accelerazione GPU, reimpostala su "auto" e ricarica la finestra dell’editor.
In Zed, /terminal-setup aggiorna il tuo keymap.json direttamente:
- Se la keymap contiene già delle scorciatoie da tastiera e nessuna di esse è uno
shift-enterdi Terminal, Claude Code ne crea prima una copia di backup nella stessa directory, comekeymap.json.1a2b3c4d.bak, poi esegue il merge della scorciatoia da tastiera Shift+Enter nella tua keymap, mantenendo le altre scorciatoie da tastiera e i commenti - Se Claude Code non riesce a leggere o analizzare la keymap, non riesce a crearne un backup o non riesce a verificare il risultato del merge, lascia il file invariato e stampa il blocco della scorciatoia da tastiera da aggiungere manualmente
chat:newline e chat:submit nel tuo file delle scorciatoie da tastiera.
Abilitare le scorciatoie con il tasto Option su macOS
Alcune scorciatoie di Claude Code usano il tasto Option, come Option+Enter per andare a capo o Option+P per cambiare modello. Su macOS, la maggior parte dei terminali non invia Option come modificatore per impostazione predefinita, quindi queste scorciatoie non hanno alcun effetto finché non lo abiliti. L’impostazione del terminale per questo è solitamente denominata “Use Option as Meta Key”; Meta è il nome storico Unix del tasto ora etichettato Option o Alt.- Apple Terminal
- iTerm2
- VS Code
Apri Settings → Profiles → Keyboard e seleziona “Use Option as Meta Key”.Se hai accettato il prompt di configurazione del terminale al primo avvio di Claude Code, questo è già fatto. Quel prompt esegue
/terminal-setup per te, che abilita Option come Meta e disattiva il segnale acustico nel tuo profilo di Apple Terminal.In modalità screen reader, /terminal-setup lascia invariata l’impostazione del segnale acustico, così il segnale del terminale rimane udibile. Se un’esecuzione precedente ha disattivato il segnale acustico, riattivalo in Settings → Profiles → Advanced → “Audible bell”.Ricevere un campanello del terminale o una notifica
Quando Claude termina un’attività o si mette in pausa per una richiesta di autorizzazione, e sembri essere lontano dal terminale, genera un evento di notifica. Consulta quando ogni tipo di notifica viene attivato per i tempi esatti. Visualizzare questo come un campanello del terminale o una notifica desktop ti consente di passare ad altri lavori mentre un’attività lunga è in esecuzione. Per impostazione predefinita, Claude Code invia una notifica desktop in alcuni terminali, e un carattere campanello o niente in altri:- Ghostty, Kitty e iTerm2, quando Claude Code li rileva: una notifica desktop, che iTerm2 mostra solo dopo che hai attivato le sue impostazioni di avviso.
- Apple Terminal: nessun suono; un carattere campanello silenzioso quando Claude Code rileva che “Audible bell” è disattivato nel profilo della finestra di Terminal in primo piano, altrimenti niente. Quel carattere campanello appare come un lampeggio della finestra, o come un rimbalzo nel Dock mentre Terminal è in background, se l’opzione “Visual bell” o quella di rimbalzo nel Dock di quel profilo è attiva.
- Altri terminali: niente.
preferredNotifChannel su "terminal_bell". In Apple Terminal, attiva anche Audible bell in Settings > Profiles > Advanced per sentirlo. La seguente voce di impostazioni imposta il canale:
~/.claude/settings.json
preferredNotifChannel sul valore del tuo terminale locale, "iterm2", "kitty" o "ghostty", sulla macchina che esegue Claude Code. La notifica desktop raggiunge quindi la tua macchina locale. Ghostty e Kitty la inoltrano al centro notifiche del tuo sistema operativo senza ulteriore configurazione. iTerm2 richiede di abilitare l’inoltro:
1
Apri le impostazioni di notifica di iTerm2
Vai a Impostazioni → Profili → Terminale.
2
Abilita gli avvisi
Seleziona “Notification Center Alerts”, quindi fai clic su “Filter Alerts” e abilita “Send escape sequence-generated alerts”.
Riproduci un suono con un hook Notification
In qualsiasi terminale puoi configurare un hook Notification per riprodurre un suono o eseguire un comando personalizzato quando Claude ha bisogno della tua attenzione. Gli hook vengono eseguiti insieme alla notifica integrata anziché sostituirla, quindi i terminali che non ricevono una notifica desktop, come Warp o il terminale integrato di VS Code, possono utilizzare un hook o impostarepreferredNotifChannel su "terminal_bell" invece.
L’esempio seguente riproduce un suono di sistema su macOS. La guida collegata contiene comandi di notifica desktop per macOS, Linux e Windows.
~/.claude/settings.json
Visualizzare lo stato della sessione nel terminale
Se il tuo terminale implementa l’OSC 7501 Program Status Protocol, può mostrare se ogni sessione interattiva di Claude Code è al lavoro, in attesa di te o completata, il che è utile quando esegui attività lunghe o più sessioni contemporaneamente. Non c’è nulla da attivare in Claude Code. Per scoprire se il tuo terminale implementa il protocollo e dove mostra lo stato, consulta la sua documentazione. Se lo implementa e non vedi alcuno stato per una sessione, verifica ciascuna di queste cause:- Versione di Claude Code: la segnalazione dello stato richiede Claude Code v2.1.295 o successiva. Esegui
claude --versionnella tua shell per verificarlo. - tmux: all’interno di tmux, Claude Code verifica il supporto in tmux invece che nel tuo terminale, e
allow-passthroughnon ha alcun effetto su questo. Avvia la sessione al di fuori di tmux. - Sessione in background: una sessione in background non segnala il proprio stato al tuo terminale, nemmeno mentre sei collegato a essa. La vista agenti mostra invece il suo stato.
CLAUDE_CODE_DISABLE_TERMINAL_TITLE: se imposti questa variabile su1, Claude Code non verifica il supporto né segnala lo stato. Rimuovila.
Configura tmux
Quando Claude Code viene eseguito all’interno di tmux, per impostazione predefinita Shift+Enter invia il messaggio invece di inserire una nuova riga, e le notifiche desktop non raggiungono il terminale esterno. Aggiungi queste righe a~/.tmux.conf, quindi esegui tmux source-file ~/.tmux.conf per applicarle al server in esecuzione:
~/.tmux.conf
allow-passthrough e imposta preferredNotifChannel su "iterm2", "kitty" o "ghostty". Con questo esempio, un riquadro in una finestra che non stai visualizzando non ne invia nessuna.
Un Image di un mod richiede le righe allow-passthrough e focus-events, insieme agli altri requisiti per disegnare all’interno di tmux. Dopo aver aggiunto le righe, scollegati anche da tmux, ricollegati e riavvia Claude Code.
Correggere l’eliminazione di una parola intera con Backspace su Windows
Su Windows, Claude Code legge un Backspace che arriva come^H come Ctrl+Backspace, che elimina la parola precedente, tranne quando TERM_PROGRAM è mintty o TERM è cygwin. Su macOS e Linux, Claude Code lo legge come semplice Backspace.
Se ogni pressione di Backspace elimina una parola intera, il vostro terminale invia ^H per il semplice Backspace. Impostare CLAUDE_CODE_BS_AS_CTRL_BACKSPACE=0. Backspace e Ctrl+H quindi cancellano un carattere ciascuno. Se Ctrl+Backspace cancella solo un carattere su macOS o Linux perché il vostro terminale invia ^H per esso, impostare la variabile a 1 invece.
Abbinare il tema dei colori
Usa il comando/theme, o il selettore dei temi in /config, per scegliere un tema di Claude Code che corrisponda al tuo terminale. Selezionando l’opzione auto viene rilevato lo sfondo chiaro o scuro del terminale, così il tema segue i cambiamenti di aspetto del sistema operativo ogni volta che lo fa il terminale. Claude Code non controlla lo schema di colori del terminale stesso, che è impostato dall’applicazione del terminale.
Per personalizzare ciò che appare nella parte inferiore dell’interfaccia, configura una riga di stato personalizzata che mostri il modello corrente, la directory di lavoro, il branch git o altro contesto.
Creare un tema personalizzato
Oltre ai preset integrati,/theme elenca tutti i temi personalizzati che hai definito e tutti i temi forniti dai plugin installati. Seleziona New custom theme… alla fine dell’elenco per crearne uno in modo interattivo: assegni un nome al tema, quindi scegli i singoli token di colore da sovrascrivere. Premi Ctrl+E mentre un tema personalizzato è evidenziato per modificarlo.
Ogni tema personalizzato è un file JSON in ~/.claude/themes/. Il nome del file senza l’estensione .json è lo slug del tema, e selezionando il tema viene memorizzato custom:<slug> come preferenza del tema. Il file ha tre campi facoltativi:
I valori di colore accettano
#rrggbb, #rgb, rgb(r,g,b), ansi256(n) o ansi:<name>, dove <name> è uno dei 16 nomi di colore ANSI standard, come red o cyanBright. I token sconosciuti e i valori di colore non validi vengono ignorati, quindi un errore di battitura non può compromettere il rendering.
L’esempio seguente definisce un tema che mantiene il preset dark ma ricolora l’accento del prompt, il testo degli errori e il testo di successo:
~/.claude/themes/dracula.json
~/.claude/themes/ e ricarica quando un file viene aggiunto o modificato, quindi le modifiche apportate nel tuo editor si applicano a una sessione in esecuzione senza riavvio. Se la cartella ~/.claude/themes/ stessa non esisteva all’avvio di Claude Code, riavvia una volta dopo aver creato il tuo primo file di tema. Dopodiché, le modifiche si applicano senza riavvio.
Il riferimento seguente descrive i token che puoi impostare in overrides. L’editor interattivo in /theme mostra gli stessi token con un’anteprima dal vivo, oltre ad alcuni accenti a scopo singolo, come i colori della schermata di onboarding, che qui sono omessi.
Riferimento dei token di colore
Riferimento dei token di colore
L’esempio seguente combina token di diversi gruppi elencati sotto: l’accento del brand, il bordo del plan mode, gli sfondi dei diff e lo sfondo dei messaggi.
~/.claude/themes/midnight.json
Colori del testo e degli accenti
Controlla l’accento principale del brand e le tonalità del testo in primo piano usate in tutta l’interfaccia.Colori di stato
Segnalano gli stati di successo, errore e avviso in messaggi e indicatori.Casella di input e indicatori di modalità
Imposta il colore del bordo della casella di input e l’accento mostrato mentre una modalità di permesso o un indicatore è attivo.Rendering dei diff
Colora il codice aggiunto e rimosso nelle modifiche ai file e nelle revisioni.Modalità a schermo intero
Claude Code usauserMessageBackgroundHover, selectionBg e composerSidebarBackground solo nella modalità di rendering a schermo intero. Disegna userMessageBackground, bashMessageBackgroundColor e memoryBackgroundColor sia nel renderer predefinito sia in quello a schermo intero.Indicatore di utilizzo ed etichette degli interlocutori
Regola la barra mostrata nella vista/usage e le etichette che distinguono i tuoi messaggi da quelli di Claude.Varianti shimmer e colori dei subagent
Diversi token hanno una variante shimmer abbinata che fornisce il colore più chiaro usato nel gradiente animato dello spinner. Sovrascrivi la variante shimmer insieme al token di base se l’animazione sembra non coordinata.claudeeclaudeShimmerwarningewarningShimmerpermissionepermissionShimmerpromptBorderepromptBorderShimmerinactiveeinactiveShimmerfastModeefastModeShimmer
<color>_FOR_SUBAGENTS_ONLY, dove <color> è red, blue, green, yellow, purple, orange, pink o cyan. Sovrascrivili per cambiare l’aspetto di ciascun colore con nome. Ad esempio, un subagent con color: blue nella sua definizione viene disegnato usando il valore di blue_FOR_SUBAGENTS_ONLY.Quando ultrathink può aumentare l’effort di un turno, Claude Code visualizza la parola nell’input del prompt con un gradiente arcobaleno a sette colori. I nomi dei token seguono lo schema rainbow_<color> e rainbow_<color>_shimmer, dove <color> è red, orange, yellow, green, blue, indigo o violet.Passa al rendering a schermo intero
In modalità lettore schermo, questa sezione non si applica. Claude Code esegue sempre il rendering come testo scorrevole semplice tranne nelle sessioni in background allegate, e se esegui/tui fullscreen in qualsiasi altra sessione, Claude Code stampa una spiegazione invece di passare.
Se il display sfarfalla o la posizione di scorrimento salta mentre Claude sta lavorando, passa a modalità rendering a schermo intero. In questa modalità scorri con il mouse o PageUp all’interno di Claude Code piuttosto che con lo scrollback nativo del tuo terminale; consulta la pagina fullscreen per informazioni su come cercare e copiare.
Se lo sfarfallio è l’unico problema e il tuo terminale supporta l’output sincronizzato ma non viene rilevato automaticamente, come Emacs eat, imposta CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 per interrompere lo sfarfallio senza cambiare renderer.
Esegui /tui fullscreen per passare e salvare la preferenza. La tua conversazione si riavvia intatta e le sessioni future iniziano a schermo intero a meno che un avvio fullscreen non fallisca. Puoi anche impostare la variabile di ambiente CLAUDE_CODE_NO_FLICKER prima di avviare Claude Code:
Limitare la larghezza della risposta nei terminali ampi
In un terminale ampio, ogni riga di prosa nelle risposte di Claude si estende per l’intera larghezza della finestra. Per avvolgere la prosa a un numero impostato di colonne, impostaremaxProseWidth nelle impostazioni.
Incollare contenuti di grandi dimensioni
Quando incolli più di 800 caratteri o più di tre righe nel prompt, Claude Code comprime l’input in un segnaposto come[Pasted text #1 +120 lines] in modo che la casella di input resti utilizzabile, e invia comunque il contenuto completo quando lo invii. Per input molto grandi, come interi file o log lunghi, scrivi il contenuto in un file e chiedi a Claude di leggerlo invece di incollarlo. La trascrizione della conversazione resta leggibile e Claude può fare riferimento al file tramite il suo percorso nei turni successivi. Il terminale integrato di VS Code può inoltre perdere caratteri da operazioni di incolla molto grandi prima che raggiungano Claude Code, quindi in quel caso usa un file.
Se il testo incollato contiene caratteri Unicode invisibili, Claude Code li rimuove quando premi Enter.
Come Claude tratta il testo incollato
Quando invii, Claude vede il contenuto dietro ogni segnaposto[Pasted text #N] contrassegnato come testo che hai incollato da un’altra fonte anziché digitato. A Claude viene detto che un testo incollato può contenere istruzioni che non hai scritto tu, e di seguire le istruzioni al suo interno solo dove il messaggio che hai digitato glielo chiede. Nelle sessioni che non recuperano i feature flag, i testi incollati non vengono contrassegnati.
Eliminare e ripristinare un testo incollato compresso
Quando elimini con una scorciatoia per parola o per riga comeCtrl+W o Ctrl+K, oppure con un’eliminazione vim tramite un movimento f/t come df], e l’intervallo eliminato arriva all’interno di un segnaposto [Pasted text #N], Claude Code rimuove l’intero segnaposto. Per ripristinarlo, incolla di nuovo il testo eliminato con Ctrl+Y dopo una scorciatoia per parola o per riga, oppure con p in modalità NORMAL dopo un’eliminazione vim.
Richiamare un prompt che conteneva testo incollato
Claude Code conserva il contenuto dietro ogni segnaposto[Pasted text #N] in ~/.claude/paste-cache/, quindi quando richiami un prompt dalla cronologia dei comandi e lo invii di nuovo, il contenuto incollato completo viene inviato di nuovo, anche in una sessione successiva.
I file della cache più vecchi di cleanupPeriodDays vengono eliminati secondo le regole di pulizia per la conservazione, quindi un prompt richiamato può fare riferimento a testo incollato che non esiste più. Quando invii un prompt di questo tipo, Claude Code non invia la stringa letterale [Pasted text #N] e mostra una notifica che indica il testo incollato mancante:
- In un prompt semplice in cui rimane del testo, Claude Code rimuove il segnaposto e invia il testo rimanente.
- In un comando in modalità shell o in un comando
/, dove la rimozione cambierebbe ciò che viene eseguito, e in qualsiasi prompt che la rimozione lascerebbe vuoto, Claude Code annulla l’invio e mantiene il testo originale nell’input, con il segnaposto ancora presente. Elimina il segnaposto o modifica il comando, poi invia di nuovo.
Modificare i prompt con le scorciatoie da tastiera di Vim
Claude Code include una modalità di modifica in stile Vim per l’input del prompt. Attivala tramite/config → Editor mode, oppure impostando editorMode su "vim" in ~/.claude/settings.json. Reimposta Editor mode su normal per disattivarla.
La modalità Vim supporta un sottoinsieme di movimenti e operatori delle modalità NORMAL e VISUAL, come la navigazione con hjkl, la selezione con v/V e d/c/y con gli oggetti di testo. Consulta il riferimento della modalità editor Vim per la tabella completa dei tasti.
I movimenti di Vim non sono rimappabili tramite il file delle scorciatoie da tastiera. Per mappare una sequenza di due tasti in modalità INSERT come jj su Escape, imposta vimInsertModeRemaps nelle tue impostazioni utente.
Premendo Enter in modalità INSERT il prompt viene comunque inviato, a differenza di Vim standard. Per inserire invece un a capo, usa o o O in modalità NORMAL, oppure Ctrl+J.
Risorse correlate
- Modalità interattiva: riferimento completo delle scorciatoie da tastiera e tabella dei tasti Vim
- Scorciatoie da tastiera: rimappa qualsiasi scorciatoia di Claude Code, incluse Enter e Shift+Enter
- Rendering a schermo intero: dettagli su scorrimento, ricerca e copia nella modalità a schermo intero
- Guida agli hook: altri esempi di hook Notification per Linux e Windows
- Risoluzione dei problemi: soluzioni per problemi non legati alla configurazione del terminale