Configura il tuo terminale per Claude Code

Correggi Shift+Invio per le nuove righe, ricevi un segnale acustico del terminale quando Claude termina, configura tmux, abbina il tema dei colori e abilita la modalità Vim nella CLI di Claude Code.

Claude Code funziona in qualsiasi terminale senza configurazione. Questa pagina è per quando qualcosa di specifico non si comporta come ti aspetti. Trova il tuo sintomo di seguito. Se tutto ti sembra già corretto, non hai bisogno di questa pagina.

• Shift+Invio invia invece di inserire una nuova riga
• I tasti di scelta rapida Option non funzionano su macOS
• Nessun suono o avviso quando Claude termina
• Esegui Claude Code dentro tmux
• Backspace elimina un'intera parola su Windows
• La visualizzazione sfarfalla o lo scrollback salta
• Vuoi i tasti Vim nel prompt

Questa pagina riguarda come far inviare al tuo terminale i segnali giusti a Claude Code. Per modificare i tasti a cui Claude Code stesso risponde, consulta invece scorciatoie da tastiera.

Inserire prompt su più righe

Premere Invio invia il messaggio. Per aggiungere un'interruzione di riga senza inviare, premere Ctrl+J, oppure digitare \ e quindi premere Invio. Entrambi i metodi funzionano in ogni terminale senza alcuna configurazione.

Nella maggior parte dei terminali è anche possibile premere Maiusc+Invio, ma il supporto varia a seconda dell'emulatore di terminale:

Per VS Code, Cursor, Devin Desktop, Alacritty prima della versione 0.16 e Zed, /terminal-setup scrive una scorciatoia da tastiera Maiusc+Invio nel file di configurazione del terminale. Alla prima esecuzione viene visualizzato un messaggio di conferma come Installed VSCode terminal Shift+Enter key binding. Le associazioni esistenti rimangono in posizione; se viene visualizzato un messaggio come VSCode terminal Shift+Enter key binding already configured, non è stata apportata alcuna modifica. Eseguire /terminal-setup direttamente nel terminale host piuttosto che 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 distorto nel terminale integrato, e imposta terminal.integrated.mouseWheelScrollSensitivity per uno scorrimento più fluido in modalità a schermo intero. Per annullare la modifica dell'accelerazione GPU, impostarla di nuovo su "auto" e ricaricare la finestra dell'editor.

In Zed, /terminal-setup aggiorna il file keymap.json sul posto:

• Se la mappa dei tasti ha già associazioni e nessuna di esse è un Terminale shift-enter, Claude Code prima ne esegue il backup in una copia nella stessa directory, come keymap.json.1a2b3c4d.bak, quindi unisce l'associazione Maiusc+Invio nella mappa dei tasti, mantenendo le altre scorciatoie da tastiera e i commenti
• Se Claude Code non riesce a leggere o analizzare la mappa dei tasti, non riesce a eseguirne il backup, o non riesce a verificare il risultato unito, lascia il file invariato e stampa il blocco di associazione da aggiungere manualmente

Se si sta eseguendo all'interno di tmux, Maiusc+Invio richiede anche la configurazione tmux di seguito anche quando il terminale esterno la supporta.

Per associare l'interruzione di riga a un tasto diverso, o per scambiare il comportamento in modo che Invio inserisca un'interruzione di riga e Maiusc+Invio invii, mappare le azioni chat:newline e chat:submit nel file scorciatoie da tastiera.

Abilita le scorciatoie da tastiera Option su macOS

Alcuni shortcut di Claude Code utilizzano il tasto Option, come Option+Invio per una nuova riga o Option+P per cambiare modelli. Su macOS, la maggior parte dei terminali non invia Option come modificatore per impostazione predefinita, quindi questi shortcut non funzionano finché non li abiliti. L'impostazione del terminale per questo è solitamente etichettata "Use Option as Meta Key"; Meta è il nome storico Unix per il tasto ora etichettato come Option o Alt.

Per Ghostty, Kitty e altri terminali, cerca un'impostazione Option-as-Alt o Option-as-Meta nel file di configurazione del terminale.

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 solo in Ghostty, Kitty e iTerm2. In altri terminali, imposta preferredNotifChannel su "terminal_bell" per far suonare il campanello del terminale, oppure configura un hook Notification per un suono personalizzato o un comando. La seguente voce di impostazioni attiva il campanello del terminale:

{
  "preferredNotifChannel": "terminal_bell"
}

La notifica desktop raggiunge la tua macchina locale tramite SSH, quindi una sessione remota può comunque avvisarti. Ghostty e Kitty la inoltrano al centro notifiche del tuo sistema operativo senza ulteriore configurazione. iTerm2 richiede di abilitare l'inoltro:

Se le notifiche non vengono ancora visualizzate, conferma che la tua applicazione terminale disponga dell'autorizzazione per le notifiche nelle impostazioni del sistema operativo, e se stai eseguendo tmux, abilita il passthrough.

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 impostare preferredNotifChannel 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.

{
  "hooks": {
    "Notification": [
      {
        "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" }]
      }
    ]
  }
}

Configurare tmux

Quando Claude Code viene eseguito all'interno di tmux, per impostazione predefinita Shift+Invio invia il messaggio invece di inserire una nuova riga, e le notifiche desktop e la barra di avanzamento non raggiungono mai il terminale esterno. Aggiungere queste righe a ~/.tmux.conf, quindi eseguire tmux source-file ~/.tmux.conf per applicarle al server in esecuzione:

set -g allow-passthrough on
set -s extended-keys on
set -as terminal-features 'xterm*:extkeys'

La riga allow-passthrough consente alle notifiche e agli aggiornamenti di avanzamento di raggiungere il terminale esterno invece di essere inghiottiti da tmux. Le righe extended-keys consentono a tmux di distinguere Shift+Invio da Invio semplice in modo che la scorciatoia della nuova riga funzioni.

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.

Abbina il tema dei colori

Usa il comando /theme, oppure il selezionatore di tema in /config, per scegliere un tema Claude Code che corrisponda al tuo terminale. Selezionando l'opzione auto, il sistema rileva lo sfondo chiaro o scuro del tuo terminale, quindi il tema segue i cambiamenti dell'aspetto del sistema operativo ogni volta che il tuo terminale lo fa. Claude Code non controlla lo schema di colori del terminale stesso, che è impostato dall'applicazione del terminale.

Per personalizzare ciò che appare in fondo all'interfaccia, configura una barra di stato personalizzata che mostra il modello corrente, la directory di lavoro, il ramo git, o altri contesti.

Crea 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 Nuovo tema personalizzato… alla fine dell'elenco per crearne uno in modo interattivo: dai 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 selezionare il tema memorizza 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ò interrompere il rendering.

L'esempio seguente definisce un tema che mantiene il preset scuro ma ricolo il prompt accent, il testo di errore e il testo di successo:

{
  "name": "Dracula",
  "base": "dark",
  "overrides": {
    "claude": "#bd93f9",
    "error": "#ff5555",
    "success": "#50fa7b"
  }
}

Claude Code monitora ~/.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 un riavvio. Se la cartella ~/.claude/themes/ stessa non esisteva quando Claude Code è stato avviato, riavvia una volta dopo aver creato il tuo primo file di tema. Dopo di che, le modifiche si applicano senza un riavvio.

Il riferimento di seguito copre i token che puoi impostare in overrides. L'editor interattivo in /theme mostra gli stessi token con un'anteprima dal vivo, più alcuni accent monouso come i colori della schermata di onboarding che sono omessi qui.

{
"name": "Midnight",
"base": "dark",
"overrides": {
"claude": "#a78bfa",
"planMode": "#38bdf8",
"diffAdded": "#14532d",
"diffRemoved": "#7f1d1d",
"userMessageBackground": "#1e1b4b"
}
}

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:

CLAUDE_CODE_NO_FLICKER=1 claude

$env:CLAUDE_CODE_NO_FLICKER = "1"; claude

{
"env": {
"CLAUDE_CODE_NO_FLICKER": "1"
}
}

Incollare contenuti di grandi dimensioni

Quando incollate 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 rimanga utilizzabile e invia comunque il contenuto completo quando inviate. Per input molto grandi come interi file o log lunghi, scrivete il contenuto in un file e chiedete a Claude di leggerlo invece di incollare. La trascrizione della conversazione rimane leggibile e Claude può fare riferimento al file per percorso nei turni successivi. Il terminale integrato di VS Code può anche perdere caratteri da incollamenti molto grandi prima che raggiungano Claude Code, quindi utilizzate un file lì.

Se l'incollamento contiene caratteri Unicode invisibili, Claude Code li rimuove quando premete Invio e rimette il prompt pulito nella casella di input affinché lo inviate con un altro Invio.

Come Claude tratta il testo incollato

Quando inviate, Claude vede il contenuto dietro ogni segnaposto [Pasted text #N] contrassegnato come testo che avete incollato da qualche parte piuttosto che digitato. Claude è informato che un incollamento può contenere istruzioni che non avete scritto e deve seguire le istruzioni al suo interno solo dove il messaggio che avete digitato lo chiede. Nelle sessioni che non recuperano i flag delle funzionalità, gli incollamenti non sono contrassegnati.

Eliminare e ripristinare un incollamento compresso

Quando eliminate con una scorciatoia da tastiera di parola o riga come Ctrl+W o Ctrl+K, o con un'eliminazione vim attraverso un movimento f/t come df], e l'intervallo eliminato raggiunge l'interno di un segnaposto [Pasted text #N], Claude Code rimuove il segnaposto completamente. Per ripristinarlo, incollate l'eliminazione con Ctrl+Y dopo una scorciatoia da tastiera di parola o riga, o con p in NORMAL mode dopo un'eliminazione vim.

Richiamare un prompt che aveva testo incollato

Claude Code mantiene il contenuto dietro ogni segnaposto [Pasted text #N] in ~/.claude/paste-cache/, quindi quando richiamate un prompt dalla cronologia dei comandi e lo reinviate, il contenuto incollato completo viene inviato di nuovo, incluso in una sessione successiva.

I file della cache più vecchi di cleanupPeriodDays vengono eliminati secondo le regole di scansione di conservazione, quindi un prompt richiamato può fare riferimento a testo incollato che non esiste più. Quando inviate un prompt di questo tipo, Claude Code non invia mai la stringa letterale [Pasted text #N] e mostra una notifica che nomina l'incollamento mancante:

• In un prompt semplice con testo rimanente, Claude Code rimuove il segnaposto e invia il testo rimanente.
• In un comando shell mode o in un comando /, dove la rimozione cambierebbe ciò che viene eseguito, e in qualsiasi prompt la cui rimozione lascia vuoto, Claude Code annulla l'invio e mantiene il testo originale nell'input, con il segnaposto ancora in esso. Eliminate il segnaposto o modificate il comando, quindi reinviate.

Modificare i prompt con le scorciatoie da tastiera di Vim

Claude Code include una modalità di editing in stile Vim per l'input del prompt. Abilitatela tramite /config → Editor mode, oppure impostando editorMode su "vim" in ~/.claude/settings.json. Impostate Editor mode di nuovo su normal per disabilitarla.

La modalità Vim supporta un sottoinsieme di movimenti e operatori in modalità NORMAL e VISUAL, come la navigazione hjkl, la selezione v/V, e d/c/y con text object. Consultate la tabella completa delle scorciatoie da tastiera 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 in modalità INSERT a due tasti come jj su Escape, impostate vimInsertModeRemaps nelle impostazioni utente.

Premere Invio continua a inviare il vostro prompt in modalità INSERT, a differenza del Vim standard. Utilizzate o oppure O in modalità NORMAL, o Ctrl+J, per inserire una nuova riga.

Related resources

• Interactive mode: riferimento completo delle scorciatoie da tastiera e la tabella dei tasti Vim
• Keybindings: rimappa qualsiasi scorciatoia di Claude Code, inclusi Invio e Shift+Invio
• Fullscreen rendering: dettagli su scorrimento, ricerca e copia in modalità fullscreen
• Hooks guide: altri esempi di hook Notification per Linux e Windows
• Troubleshooting: correzioni per problemi al di fuori della configurazione del terminale