Modalità interattiva

Riferimento completo per le scorciatoie da tastiera, le modalità di input e le funzioni interattive nelle sessioni di Claude Code.

Scorciatoie da tastiera

Controlli generali

Modifica del testo

Limiti delle parole nelle scorciatoie di modifica

Le scorciatoie delle parole Alt+B, Alt+F, Alt+D, Option+Delete, e Ctrl+Backspace trattano una parola come una sequenza di lettere e cifre, quindi la punteggiatura come _, ., e / separa le parole. Con src/utils/foo.ts nel prompt, i pressioni ripetuti di Alt+B si fermano all'inizio di ts, foo, utils, e src.

Ctrl+W è diverso: ignora la punteggiatura e elimina indietro fino allo spazio bianco precedente, quindi un pressione rimuove tutto src/utils/foo.ts.

Nel testo scritto senza spazi, come il cinese o il giapponese, le scorciatoie delle parole si muovono o eliminano comunque una parola alla volta.

Queste convenzioni di readline si applicano in Claude Code v2.1.261 e versioni successive. L'impostazione keybindingFlavor che le ha attivate nelle versioni precedenti è deprecata e non ha effetto.

Non puoi rimappare queste scorciatoie nel file di configurazione delle scorciatoie da tastiera, che non ha azioni per loro.

Tema e visualizzazione

Input multilinea

Comandi rapidi

Visualizzatore della trascrizione

Quando il visualizzatore della trascrizione è aperto (attivato con Ctrl+O), queste scorciatoie sono disponibili. Esegui /tui senza argomenti per verificare quale renderer è attivo. Ctrl+E può essere rimappato tramite transcript:toggleShowAll.

Input vocale

Comandi

Digita / in Claude Code per visualizzare i comandi disponibili, oppure digita / seguito da qualsiasi lettera per filtrare. Il menu / elenca i comandi integrati, le skills raggruppate e create dagli utenti, e i comandi forniti da plugins e server MCP. Non tutti i comandi integrati sono visibili a ogni utente poiché alcuni dipendono dalla tua piattaforma o dal tuo piano, e alcuni comandi disponibili sono nascosti dal menu per scelta progettuale e vengono eseguiti quando digiti il loro nome completo.

Nel rendering a schermo intero, il comando / e gli elenchi di suggerimenti file @ rispondono anche al mouse: passare il mouse evidenzia una riga e fare clic la accetta.

Consulta il riferimento dei comandi per l'elenco completo dei comandi inclusi in Claude Code.

Completare un comando a metà del prompt

Il completamento dei comandi funziona anche a metà di un prompt: digita / dopo uno spazio, quindi le prime lettere di un nome, come in esegui i test, quindi /com. Solo i comandi i cui nomi iniziano con quelle lettere corrispondono, quindi un percorso di file come /tmp/notes.md non mantiene un elenco aperto. Claude Code esegue un comando solo quando il comando inizia il tuo messaggio.

• Nel rendering a schermo intero: i risultati si aprono come un elenco mentre digiti, senza alcuna riga evidenziata, quindi Invio invia comunque il tuo prompt così come digitato. Premi Tab per inserire il risultato principale, oppure seleziona una riga con i tasti freccia e Invio.
• Al di fuori dello schermo intero: il resto del risultato principale appare come testo fantasma al tuo cursore, con un conteggio come +2 quando più comandi corrispondono. Premi Tab per inserire l'unico risultato, oppure per aprire l'elenco quando più risultati corrispondono, quindi seleziona una riga con i tasti freccia e Invio.

In entrambi i renderer, premi Tab su un / nudo a metà prompt per elencare ogni comando.

Una skill di plugin corrisponde anche al suo nome nudo, quindi /deploy trova una skill denominata myplugin:deploy-app. Quando inserisci il risultato, Claude Code scrive il /myplugin:deploy-app completo.

Modalità editor Vim

Abilita la modifica in stile vim tramite /config → Editor mode.

Claude Code mantiene la modalità vim e la posizione del cursore quando attivi il visualizzatore di trascrizioni con Ctrl+O o apri e chiudi un pannello come /config. Se lasci il prompt in modalità NORMAL, rimane in modalità NORMAL quando ritorni, con il cursore dove l'hai lasciato.

Cambio di modalità

Rimappa sequenze di tasti in modalità INSERT

L'impostazione vimInsertModeRemaps mappa una sequenza di due tasti in modalità INSERT su Escape, quindi una mappatura come jj ti riporta in modalità NORMAL. Richiede Claude Code v2.1.208 o successivo.

Il seguente esempio di ~/.claude/settings.json attiva la modalità vim e mappa jj su Escape:

{
  "editorMode": "vim",
  "vimInsertModeRemaps": { "jj": "<Esc>" }
}

Ogni chiave è esattamente due caratteri stampabili digitati in sequenza, e "<Esc>" è l'unico target supportato. Le voci con una lunghezza o un target diverso vengono ignorate.

Digitare il primo carattere di una sequenza lo inserisce normalmente. Premere il secondo carattere entro un secondo rimuove quel carattere in sospeso e passa alla modalità NORMAL, lasciando nessuno dei due caratteri nel tuo input. Dopo la finestra di un secondo, o se segue un tasto diverso, entrambi i caratteri rimangono come testo letterale, quindi puoi comunque digitare una parola contenente la sequenza facendo una pausa tra i due tasti.

Claude Code legge questa impostazione dal tuo file di impostazioni utente, dal flag --settings e dalle impostazioni gestite solo. Le voci nel .claude/settings.json o .claude/settings.local.json di un progetto vengono ignorate, quindi un repository estratto non può rimappare le tue scorciatoie da tastiera.

Navigazione (modalità NORMAL)

Modifica (modalità NORMAL)

Oggetti di testo (modalità NORMAL)

Gli oggetti di testo funzionano con operatori come d, c e y:

Modalità visuale

Premi v per la selezione per caratteri o V per la selezione per righe. I movimenti estendono la selezione e gli operatori agiscono su di essa direttamente.

La modalità visuale a blocchi con Ctrl+V non è supportata.

Cronologia dei comandi

Claude Code mantiene una cronologia dei prompt che digitate, e il richiamo con freccia Su raggiunge i prompt delle sessioni precedenti dello stesso progetto:

• La cronologia degli input è archiviata per directory di lavoro
• Eseguendo /clear si avvia una nuova sessione: il richiamo elenca quindi i prompt della nuova sessione per primi, seguiti dai prompt delle sessioni precedenti. La conversazione della sessione precedente viene preservata e può essere ripresa.
• L'invio dello stesso prompt due volte di seguito registra una voce di cronologia, quindi premendo Su si passa al prompt distinto precedente
• Quando richiamate un prompt che includeva testo incollato, Claude Code invia di nuovo il contenuto incollato completo quando lo reinviate. Se il contenuto è stato nel frattempo pulito, Claude Code non invia la stringa letterale [Pasted text #N]; vedere Incollare contenuto di grandi dimensioni per sapere cosa accade al prompt
• L'espansione della cronologia con ! è disabilitata per impostazione predefinita

Ricerca inversa con Ctrl+R

Premete Ctrl+R per cercare in modo interattivo nella cronologia dei comandi. Nel rendering a schermo intero, Ctrl+R apre una finestra di dialogo di ricerca: digitate per filtrare, premete Su e Giù per spostarvi tra i risultati e premete Ctrl+S per ciclo l'ambito attraverso questa sessione, questo progetto e tutti i progetti. Premete Invio o Tab per posizionare una corrispondenza nell'input del prompt, oppure Esc per annullare. I passaggi seguenti descrivono la ricerca inline del renderer classico:

1. Avvia ricerca: premete Ctrl+R per attivare la ricerca inversa della cronologia
2. Digita query: inserite il testo da cercare nei comandi precedenti. Il termine di ricerca è evidenziato nei risultati corrispondenti
3. Naviga tra i risultati: premete di nuovo Ctrl+R per ciclo tra i risultati più vecchi
4. Ambito di ricerca: la ricerca inline cerca sempre i prompt da tutti i progetti
5. Accetta corrispondenza:
   • Premete Tab o Esc per accettare la corrispondenza corrente e continuare la modifica
   • Premete Invio per accettare ed eseguire il comando immediatamente
6. Annulla ricerca:
   • Premete Ctrl+C per annullare e ripristinare l'input originale
   • Premete Backspace su una ricerca vuota per annullare

La ricerca inline scansiona la cronologia completa dei prompt, dal più recente al più vecchio, con i duplicati compressi all'occorrenza più recente. La finestra di dialogo a schermo intero cerca l'intera cronologia dei prompt nell'ambito selezionato, dal più recente al più vecchio, con i duplicati compressi all'occorrenza più recente: i prompt più recenti appaiono immediatamente e i risultati dai prompt più vecchi si riempiono mentre Claude Code carica il resto. I prompt corrispondenti vengono visualizzati con il termine di ricerca evidenziato, in modo da poter trovare e riutilizzare gli input precedenti.

L'accettazione di una corrispondenza o l'annullamento della ricerca hanno effetto immediato, anche mentre Claude Code sta ancora caricando la cronologia.

Comandi Bash in background

Claude Code supporta l'esecuzione di comandi Bash in background, permettendovi di continuare a lavorare mentre i processi a lunga esecuzione vengono eseguiti.

Come funziona il backgrounding

Quando Claude Code esegue un comando in background, lo esegue in modo asincrono e restituisce immediatamente un ID di attività in background. Claude Code può rispondere a nuovi prompt mentre il comando continua a essere eseguito in background.

Per eseguire comandi in background, potete:

• Chiedere a Claude Code di eseguire un comando in background
• Premere Ctrl+B per spostare una normale invocazione dello strumento Bash in background. Gli utenti di Tmux devono premere Ctrl+B due volte a causa della chiave di prefisso di tmux.

Caratteristiche principali:

• L'output viene scritto in un file e Claude può recuperarlo utilizzando lo strumento Read
• Le attività in background hanno ID univoci per il tracciamento e il recupero dell'output
• Le attività in background vengono pulite automaticamente quando Claude Code esce. Su macOS e Linux, quando interrompete un'attività in background da /tasks o Claude Code la interrompe all'uscita, i processi che si sono staccati dalla shell dell'attività, come quelli avviati con setsid o timeout, si fermano anche loro
• Se mettete in background la sessione invece di uscire, le vostre attività in background continuano a essere eseguite nella sessione in background. Vedere mettere in background una sessione in esecuzione
• Le attività in background vengono terminate automaticamente se l'output supera 5GB, con una nota in stderr che spiega il motivo
• Su macOS e Linux, Claude Code termina le attività in background in esecuzione quando il sistema operativo segnala pressione della memoria, a condizione che la sessione sia stata inattiva per almeno 30 minuti e nessun turno o subagent sia in esecuzione. Richiede Claude Code v2.1.193 o successivo
  • Il log di debug spiega perché le attività sono state interrotte, o perché un evento di pressione le ha lasciate in esecuzione
  • Impostare CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP a 1 per disattivare gli arresti dovuti alla pressione della memoria
• I comandi in background di proprietà di un subagent non hanno limite di tempo, tranne che un comando di proprietà di un subagent in esecuzione in foreground termina quando quel subagent fornisce la sua risposta finale; vedere Comandi in background nel riferimento degli strumenti. Prima della v2.1.218, né il reap della pressione della memoria né il precedente limite di 60 minuti sui comandi del subagent coprivano i comandi spostati in background con Ctrl+B

Per disabilitare tutta la funzionalità di attività in background, impostare la variabile di ambiente CLAUDE_CODE_DISABLE_BACKGROUND_TASKS a 1. Vedere Variabili di ambiente per i dettagli.

Comandi comuni messi in background:

• Strumenti di build (webpack, vite, make)
• Gestori di pacchetti (npm, yarn, pnpm)
• Test runner (jest, pytest)
• Server di sviluppo
• Processi a lunga esecuzione (docker, terraform)

Modalità shell con prefisso `!`

Eseguite comandi shell direttamente senza passare per Claude aggiungendo il prefisso ! al vostro input:

! npm test
! git status
! ls -la

Modalità shell:

• Aggiunge il comando e il suo output al contesto della conversazione
• Mostra il progresso e l'output in tempo reale
• Supporta lo stesso backgrounding Ctrl+B per i comandi a lunga esecuzione
• Non richiede a Claude di interpretare o approvare il comando
• Supporta l'autocompletamento basato sulla cronologia: digitate un comando parziale e premete Tab per completare dai comandi ! precedenti nel progetto corrente
• Supporta l'autocompletamento del percorso file live a partire dalla v2.1.193 su tutte le piattaforme: digitate un token contenente una barra, come ./src/ o ~/, per vedere un elenco a discesa dei file e delle directory corrispondenti, quindi premete Tab per accettare. Utilizzate le barre in avanti anche su Windows; l'elenco a discesa viene attivato da /, non da \
• Uscite con Escape, Backspace, o Ctrl+U su un prompt vuoto
• Incollare testo che inizia con ! in un prompt vuoto entra automaticamente in modalità shell, corrispondendo al comportamento di ! digitato

A meno che la vostra sessione non sia una di quelle elencate in modalità sandbox rigorosa, i comandi che digitate in modalità shell vengono eseguiti al di fuori della sandbox anche quando avete abilitato il sandboxing, perché la sandbox si applica ai comandi che Claude esegue.

Claude risponde automaticamente all'output del comando una volta che arriva nella trascrizione, quindi potete eseguire ! npm test e ottenere una spiegazione degli errori senza un secondo prompt. La risposta costa lo stesso di inviare un prompt normale. Per ripristinare il comportamento precedente in cui l'output viene aggiunto al contesto senza una risposta, impostare respondToBashCommands a false in settings.json. Prima della v2.1.186, la modalità shell aggiungeva sempre l'output al contesto senza una risposta.

Accodare messaggi mentre Claude lavora

Digitate un messaggio e premete Enter mentre Claude sta lavorando. Claude Code accoda il messaggio invece di interrompere il turno, e elenca le voci in coda sopra la casella di input finché non le invia. Potete accodare i comandi ! shell e la maggior parte dei comandi allo stesso modo, ad eccezione dei comandi, come /status, che Claude Code esegue non appena li inviate.

I messaggi inviati e accodati vengono visualizzati in grigio finché Claude non inizia a rispondere, quindi potete capire quali messaggi Claude non ha ancora iniziato.

Quando Claude Code invia ciò che avete accodato

Quando una voce in coda raggiunge Claude dipende da ciò che avete accodato.

• Messaggi: se accodate un messaggio mentre Claude sta eseguendo chiamate di strumenti, Claude Code lo passa a Claude non appena quelle chiamate di strumenti terminano, all'interno dello stesso turno. Quando il turno termina con messaggi ancora in coda, vengono inviati senza un altro pressione di tasto, nell'ordine in cui li avete digitati
• Comandi e comandi shell: Claude Code li mantiene finché il turno non termina, quindi li esegue uno alla volta, mantenendo l'ordine in cui li avete accodati

Per inviare ciò che avete accodato senza aspettare, premete Ctrl+Enter. I vostri messaggi in coda vengono inviati subito, con la vostra bozza accodata dietro di essi se ne avevate digitata una. Richiede Claude Code v2.1.275 o successivo.

Se avete accodato un comando shell ! davanti ai vostri messaggi, il tasto interrompe il turno. Altrimenti, ciò che accade al turno dipende da ciò che Claude sta facendo quando premete il tasto:

• Esecuzione di comandi shell, subagenti o altro lavoro che può spostarsi sullo sfondo: quel lavoro si sposta sullo sfondo e continua a essere eseguito, e Claude legge i vostri messaggi nello stesso turno
• Solo la scrittura di una risposta, o l'esecuzione di qualcosa che non può spostarsi sullo sfondo: Claude Code interrompe il turno e invia i vostri messaggi dopo. Prima della v2.1.281, il tasto interrompeva il turno in entrambi i casi

In modalità shell, il tasto accoda solo il vostro comando. Nei terminali che non segnalano tasti estesi, Ctrl+Enter arriva come semplice Enter e accoda la bozza invece; Ctrl+X Ctrl+S funziona in qualsiasi terminale. Entrambi i tasti sono associazioni dell'azione chat:sendNow.

Premete Esc per interrompere il turno senza inviare la vostra bozza. Claude Code mantiene ciò che avete accodato e lo invia subito.

Claude Code esegue alcuni comandi non appena li inviate invece di accodarli, tra cui /model, /effort e /fast. Ognuno dei tre cambia un'impostazione: il modello, il livello di sforzo o la modalità veloce. Se Claude Code applica la nuova impostazione al turno su cui Claude sta già lavorando, o solo dal vostro turno successivo, differisce per comando:

• /model: una volta confermato l'avviso di cache, se Claude Code ne mostra uno, Claude Code applica il vostro cambio alla prossima richiesta che effettua in quel turno
• /effort: una volta confermato l'avviso di cache, se Claude Code ne mostra uno, Claude Code applica il vostro cambio alla prossima richiesta che effettua in quel turno
• /fast: Claude Code mantiene l'impostazione della modalità veloce che era attiva quando il turno è iniziato, quindi il vostro cambio di velocità si applica dal vostro turno successivo. Se il vostro modello attuale non supporta la modalità veloce, attivarla cambia anche il vostro modello, e Claude Code utilizza il nuovo modello dalla sua prossima richiesta in quel turno

Riprendete ciò che avete accodato

Premete Up dalla prima riga della casella di input per riprendere i messaggi e i comandi in coda. Claude Code li rimuove dalla coda e li mette nella casella di input, uno per riga, davanti a qualsiasi testo che avevate digitato. Modificate il testo e premete Enter per accodarlo di nuovo come una voce, o cancellate la casella di input per scartarlo.

Claude Code riprende i comandi shell in coda solo quando la casella di input è vuota e non avete nient'altro in coda, e cambia la casella di input alla modalità shell quando lo fa. Altrimenti li lascia in coda, elencati con il loro prefisso !, e li esegue dopo che il turno termina.

Suggerimenti di prompt

Quando aprite una sessione per la prima volta, Claude Code mostra un comando di esempio attenuato nell'input del prompt per aiutarvi a iniziare. Lo seleziona dalla cronologia git del vostro progetto, quindi l'esempio riflette i file su cui avete lavorato di recente.

Dopo che Claude risponde, Claude Code può suggerire il vostro prossimo prompt in base alla cronologia della conversazione, come un passaggio successivo da una richiesta in più parti o una continuazione naturale del vostro flusso di lavoro.

• Premete Tab o Freccia destra per inserire il suggerimento nell'input del prompt, quindi Invio per inviare
• Iniziate a digitare per chiudere il suggerimento

Claude Code genera ciascuno di questi suggerimenti di prompt successivo con una richiesta in background al medesimo modello che la vostra sessione sta utilizzando. La richiesta conta verso i limiti di utilizzo del vostro piano o i vostri costi API. Poiché riutilizza la cache del prompt della conversazione, è principalmente costituita da letture della cache più alcuni token di output, quindi il costo aggiuntivo è minimo.

Quando Claude Code salta i suggerimenti

In modalità interattiva, Claude Code lascia i suggerimenti di prompt disattivati per impostazione predefinita e nasconde l'interruttore Prompt suggestions in /config in una sessione che non recupera i flag delle funzionalità, come una su un provider di terze parti o attraverso un gateway di app Claude, e in una prima sessione dopo un'installazione o un aggiornamento i cui flag non sono ancora arrivati.

Claude Code salta anche i singoli suggerimenti in diverse situazioni, tra cui:

• La cache del prompt è fredda, per evitare costi inutili
• Dopo il primo turno di una conversazione, in alcune sessioni
• La risposta precedente è terminata con un errore
• Mentre siete in plan mode
• Il vostro account è vicino o al limite di utilizzo. Per mantenere i suggerimenti attivi fino a quando non raggiungete il limite, impostate CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION su true. Prima della v2.1.238, Claude Code li saltava vicino al limite anche con la variabile impostata su true
• In un agent team, nelle sessioni dei compagni di squadra per impostazione predefinita. La sessione del lead mostra i suggerimenti

In modalità stampa, Claude Code non genera suggerimenti per impostazione predefinita. Passate --prompt-suggestions con -p "<prompt>" --output-format stream-json --verbose per fare in modo che Claude Code emetta un messaggio prompt_suggestion dopo ogni turno che ne genera uno. Il generatore salta anche le conversazioni molto brevi e le cache di prompt fredde qui, quindi una singola query -p breve potrebbe non emetterne nessuna.

Disattivare i suggerimenti di prompt

Per disattivare completamente i suggerimenti di prompt, utilizzate uno dei seguenti metodi:

• Disattivate Prompt suggestions in /config
• Impostate promptSuggestionEnabled su false nel vostro file di impostazioni
• Impostate la variabile di ambiente CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION su false, che ha la precedenza sull'impostazione:

  export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false
  

Per disattivare i suggerimenti di prompt in tutta un'organizzazione, impostate promptSuggestionEnabled su false nelle impostazioni gestite. Impostate anche CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION su false sotto la chiave env gestita in modo che gli utenti non possano riattivarli con la propria variabile di ambiente.

Scorciatoie emoji

Digita un : seguito da una scorciatoia emoji nell'input del prompt per inserire l'emoji. Richiede Claude Code v2.1.217 o versione successiva.

• Digita una scorciatoia completa come :heart: e Claude Code la sostituisce con ❤️ non appena digiti i due punti di chiusura :
• Digita : più almeno due caratteri di un nome, come :hea, per aprire un popup di suggerimento, quindi premi Tab o Enter per inserire l'emoji evidenziato

La scorciatoia deve iniziare l'input o seguire uno spazio, quindi un : all'interno di una parola o URL non apre i suggerimenti.

Per disattivare la funzione, imposta emojiCompletionEnabled su false in settings.json. Questo disabilita sia il popup di suggerimento che la sostituzione inline.

Controlla l'ortografia mentre digiti

Claude Code può sottolineare le parole scritte male nell'input del prompt mentre digiti. Controlla solo il testo nella casella di input, mai le risposte di Claude o i tuoi file. Non controlla nulla nemmeno quando la casella di input è in modalità shell, ricerca della cronologia Ctrl+R, o dettatura vocale.

Il controllo ortografico è disattivato per impostazione predefinita e Claude Code non controlla nulla in modalità lettore di schermo. Richiede Claude Code v2.1.235 o successivo.

Prerequisiti

• Installa aspell, hunspell, o ispell e assicurati che sia nel tuo PATH. Claude Code esegue il primo dei tre che trova, in quell'ordine, su ogni piattaforma, incluso uno shim .cmd che un gestore di pacchetti installa su Windows.
• Per verificare che il programma sia nel tuo PATH, esegui aspell --version, hunspell --version, o ispell -v nel tuo terminale. Un errore "command not found" significa che non è ancora nel tuo PATH.

Attiva o disattiva il controllo ortografico

Claude Code legge l'impostazione spellcheck da tre posizioni e la ignora nel file .claude/settings.json e .claude/settings.local.json di un progetto. Attivala da quella che utilizzi:

{
"spellcheck": { "enabled": true }
}

{
"spellcheck": { "enabled": true }
}

claude --settings spellcheck.json

{
"spellcheck": { "enabled": true }
}

Per verificare che il controllo ortografico sia attivo, digita una parola scritta male e uno spazio. Claude Code sottolinea la parola. Se non lo fa, vedi Quando Claude Code non sottolinea nulla. Per disattivare di nuovo il controllo ortografico, imposta enabled a false nello stesso posto, o rimuovi spellcheck.

Per scegliere quale dei tre programmi Claude Code esegue, quale dizionario utilizza, o il colore della sottolineatura, aggiungi uno di questi campi accanto a enabled, nello stesso posto:

• checker: aspell, hunspell, o ispell. Claude Code non ritorna a un checker che nomini e tratta qualsiasi altro valore come auto.
• language: un nome di dizionario nella forma del tuo checker, come en_GB. Claude Code ignora qualsiasi valore che non sia un nome di dizionario semplice, come un percorso o un nome con spazi, e il checker utilizza il suo dizionario predefinito.
• color: un nome di colore come yellow, o un valore #rrggbb, #rgb, rgb(r,g,b), ansi256(n), o ansi:<name>. Claude Code utilizza il colore di errore del tuo tema per impostazione predefinita e per qualsiasi valore che non riconosce.

Ad esempio, questa impostazione spellcheck esegue hunspell con il suo dizionario en_GB e sottolinea le parole in giallo. Funziona allo stesso modo in ~/.claude/settings.json, nel file che passi a --settings, e nelle impostazioni gestite:

{
  "spellcheck": {
    "enabled": true,
    "checker": "hunspell",
    "language": "en_GB",
    "color": "yellow"
  }
}

Se più di uno dei tre posti ha un'impostazione spellcheck, Claude Code utilizza solo uno di essi: prima le impostazioni gestite, poi --settings, poi le impostazioni utente. Non combina campi da due posti. Ad esempio, quando --settings imposta spellcheck, un language nelle tue impostazioni utente non ha effetto.

Cosa sottolinea Claude Code

Poco dopo che smetti di digitare, Claude Code sottolinea le parole che il dizionario non conosce. Lascia sola la parola che stai ancora digitando finché non la superi, e non cambia mai il tuo testo. Salta anche il testo che sembra codice:

• Comandi come /help, menzioni @, URL, percorsi di file e flag come --verbose
• Parole con cifre, trattini bassi, o una lettera maiuscola dopo la prima, e testo tra backtick

Claude Code salta anche il testo cinese, giapponese, coreano, tailandese, laotiano, khmer e birmano.

Claude Code non ha una propria lista di parole: una parola è scritta male quando il tuo checker dice così. Per impedire a Claude Code di sottolineare una parola, aggiungi la parola al dizionario personale del tuo checker, seguendo la documentazione del checker. Claude Code rileva la nuova parola dopo averlo riavviato.

Quando Claude Code non sottolinea nulla

Claude Code non sottolinea nulla quando non riesce a mantenere un checker in esecuzione:

• Nessun checker è installato, o quello che hai nominato in checker manca
• Il checker fallisce due volte di seguito, all'avvio o più tardi nella sessione. Claude Code lo riavvia dopo il primo fallimento e smette di controllare dopo il secondo, finché non riavvii Claude Code
• Il checker impiega più di 15 secondi per rispondere, tre volte. Ogni volta, Claude Code lascia le parole su cui stava aspettando non marcate; dopo la terza, smette di controllare finché non riavvii Claude Code

Per scoprire quale di questi è accaduto, avvia claude --debug con il controllo ortografico attivo e digita una parola. Quindi cerca le righe [spellcheck] nel log di debug in ~/.claude/debug/<session-id>.txt. Una riga nomina il programma che Claude Code ha avviato, o elenca quelli che ha cercato e non ha trovato. Le righe successive dicono perché ha smesso. Un errore di dizionario mancante lì significa che il checker non ha un dizionario per il tuo valore language, o nessuno predefinito quando language non è impostato. Installane uno, o imposta language a un dizionario che hai.

Caratteri invisibili nei prompt

Il testo incollato può contenere caratteri Unicode che un terminale disegna come nulla, come caratteri di tag, controlli bidirezionali e spazi a larghezza zero, quindi un prompt può contenere testo che non vedete mai. Per evitare che il testo copiato contenga istruzioni che il terminale non disegna, Claude Code rimuove questi caratteri quando premete Invio, prima di inviare qualsiasi cosa. Pulisce sia il prompt che il contenuto di qualsiasi riferimento di testo incollato che il prompt include. Claude Code mantiene i caratteri di unione che gli script persiani e indici scrivono e i selettori all'interno delle sequenze emoji.

Se Claude Code ha rimosso qualcosa, quel tasto Invio non invia nulla. Il prompt pulito ritorna nella casella di input con un avviso come Removed 3 invisible characters · review and press Enter to send, e premendo Invio di nuovo si invia il testo come mostrato.

Quando passate un prompt sulla riga di comando, come in claude "fix the login bug", o ne incanalate uno in una sessione interattiva, Claude Code non aspetta un secondo Invio. Rimuove i caratteri, mostra un avviso e invia il prompt pulito. Se il prompt pulito inizierebbe con /, Claude Code lo mette nella casella di input affinché lo rivediate e lo inviate.

Esamina le modifiche con /diff

Esegui /diff per rivedere le modifiche nel tuo albero di lavoro senza lasciare Claude Code. Vedrai le modifiche che Claude ha apportato finora insieme a qualsiasi altra cosa che non hai ancora committato.

Nelle modifiche che /diff legge da git, un submodule appare come una singola voce, e solo quando cambia il commit a cui punta; le modifiche ai file all'interno del submodule non appaiono lì.

Nel rendering a schermo intero, /diff apre il pannello diff accanto alla conversazione, che rimane aperto e si aggiorna mentre continui a lavorare. Nel renderer classico, /diff apre il visualizzatore diff al posto del prompt, e lo chiudi quando hai finito di leggere.

Diff panel

Il pannello diff elenca i file modificati con i conteggi delle righe aggiunte e rimosse, e mostra il diff di ogni file sotto l'elenco. Claude Code lo aggiorna ogni volta che Claude modifica un file o esegue un comando shell. Per chiuderlo, esegui /diff di nuovo o fai clic sulla ✕ nell'intestazione.

Per utilizzare il pannello hai bisogno di:

• Rendering a schermo intero
• Un repository git
• Un terminale largo almeno 110 colonne
• Claude Code v2.1.260 o successivo

Quando il pannello non può aprirsi, /diff apre il visualizzatore diff invece o ti dice il motivo.

Il pannello si apre anche automaticamente una volta che Claude inizia a modificare i file, se il tuo terminale è largo almeno 144 colonne. Dopo averlo aperto tu stesso con /diff, le sessioni successive lo aprono non appena Claude modifica un file in qualsiasi terminale abbastanza largo per contenerlo. Chiudi il pannello e rimane chiuso, in questa sessione e nelle successive, finché non esegui /diff di nuovo.

Mentre il pannello è aperto, puoi:

• Saltare a un file: fai clic sulla sua riga nell'elenco. Scorri il pannello con la rotella del mouse. Quando l'elenco dei file stesso è troppo lungo per stare, scorri con Alt+Up e Alt+Down, o Ctrl+Up e Ctrl+Down.
• Chiedere a Claude informazioni su righe specifiche: selezionale nel pannello con il mouse. Claude Code allega la selezione al tuo prossimo prompt e mostra un conteggio delle righe nell'input finché non lo invii.
  • Per inviare il prompt senza la selezione, sposta il cursore subito dopo l'indicatore di conteggio delle righe e premi Backspace per eliminarlo. Richiede Claude Code v2.1.271 o successivo.
• Mostrare i file che il pannello omette: l'elenco salta i file di test e i file generati, e comprime le modifiche da prima di questa sessione in una riga in fondo. Fai clic su una riga di conteggio per espanderla.
• Cambiare ciò che il pannello confronta: premi Ctrl+X B per passare dalle modifiche di questa sessione, alle tue modifiche non committate come un elenco, a tutto ciò che è accaduto da quando il tuo ramo si è diviso dal ramo predefinito. Claude Code ricorda la scelta per ogni progetto.

Per associare i tasti a queste azioni, vedi Azioni del pannello diff.

Diff viewer

Il visualizzatore diff prende il posto del prompt finché non lo chiudi. La sua vista Current mostra le tue modifiche non committate da git, o, quando non ce ne sono, ciò che il tuo ramo aggiunge in cima al ramo predefinito. Il visualizzatore ha anche una vista di turno per ogni prompt dopo il quale Claude ha modificato i file, mostrando solo quelle modifiche. Claude Code costruisce le viste di turno dalle modifiche dei file di Claude piuttosto che da git, quindi una modifica che Claude apporta tramite un comando shell appare solo sotto Current.

Usa questi tasti nel visualizzatore:

• Sinistra e Destra: spostati tra Current e le viste di turno.
• Su e Giù: seleziona un file.
• Invio: apri il diff del file selezionato. Scorri con Su e Giù, o PaginaSu e PaginaGiù.
• Esc: ritorna dal diff di un file all'elenco, o chiudi il visualizzatore dall'elenco.

Per riassociare questi tasti, vedi Azioni diff.

Domande laterali con /btw

Usa /btw per fare una domanda sul tuo lavoro attuale senza aggiungerla alla cronologia della conversazione.

/btw what was the name of that config file again?

Claude risponde a una domanda laterale da ciò che è già nella conversazione: i tuoi messaggi, le sue risposte e i risultati degli strumenti che ha raccolto. Potete chiedere informazioni sul codice che Claude ha già letto, sulle decisioni che ha preso in precedenza, o su qualsiasi altra cosa della sessione. Una domanda laterale successiva vede anche le vostre domande laterali precedenti: Claude Code riproduce i 20 scambi più recenti con ogni richiesta, finché non li cancellate. La domanda e la risposta non entrano mai nella cronologia della conversazione. Nel terminale, appaiono in un overlay dismissibile. Il terminale mantiene il thread in memoria: premete x per cancellare gli scambi precedenti, e scompariranno quando uscite da Claude Code.

Nel pannello di chat dell'estensione VS Code, /btw apre un pannello piuttosto che l'overlay descritto in questa sezione, e potete fare domande di follow-up direttamente nel pannello. Il thread del pannello sopravvive ai ricaricamenti della finestra, secondo la pianificazione di conservazione descritta in quella pagina. Avete bisogno dell'estensione alla versione v2.1.227 o successiva. Le versioni precedenti dell'estensione non offrono /btw.

• Disponibile mentre Claude sta lavorando: potete eseguire /btw anche mentre Claude sta elaborando una risposta. La domanda laterale viene eseguita in modo indipendente e non interrompe il turno principale. Vede tutto ciò che è nella conversazione finora, tranne la risposta che Claude sta ancora scrivendo.
• Nessun accesso agli strumenti: le domande laterali rispondono solo da ciò che è già nel contesto. Claude non può leggere file, eseguire comandi o cercare quando risponde a una domanda laterale. Se Claude scrive comunque le chiamate agli strumenti come testo, la risposta termina con una nota che nulla è stato eseguito.
• Risposta singola: non ci sono turni di follow-up nell'overlay. Per continuare il thread, fate un'altra domanda /btw. Per continuare con accesso completo agli strumenti in una sessione locale, premete f per eseguire il fork di questa domanda e risposta in un subagent in background.
• Costo basso: mentre la prompt cache della conversazione è attiva, una domanda laterale costa poco oltre la risposta stessa.

Le vostre cinque domande laterali precedenti più recenti appaiono come un elenco attenuato sopra la risposta attuale, con un conteggio di quelle più vecchie. Rimangono fuori dalla cronologia della conversazione.

Per tornare all'overlay dopo averlo dismissito, eseguite /btw senza una domanda. L'overlay si riapre sul vostro scambio più recente. Prima della v2.1.212, /btw senza una domanda stampava un messaggio di utilizzo.

Una volta che la risposta appare, l'overlay accetta questi tasti.

In una sessione in background collegata, Left si scollega e vi restituisce alla vista agente, anche mentre la risposta sta ancora arrivando. La domanda laterale continua a essere eseguita mentre siete assenti. La prossima volta che vi collegate alla sessione, l'overlay si riapre con la domanda laterale, o con la sua risposta. Prima della v2.1.257, Left non si scollegava lì.

/btw vede la vostra conversazione completa ma non ha strumenti. Un subagent ha strumenti e inizia dal prompt che riceve, o, per un fork, da una copia di questa conversazione. Usate /btw per chiedere informazioni su ciò che Claude già conosce da questa sessione; usate un subagent per andare a scoprire qualcosa di nuovo.

Elenco attività

L'elenco attività è la lista di controllo di Claude: elementi che Claude ha creato per pianificare il lavoro multi-step, con indicatori che mostrano cosa è in sospeso, in corso o completato. È separato dalla visualizzazione delle attività in background. Per visualizzare shell in esecuzione e subagent, utilizzare /tasks invece.

L'elenco si riempie solo nelle sessioni che dispongono degli strumenti di tracciamento delle attività, che Claude Code fornisce per impostazione predefinita su modelli Claude 3.x, Opus 4 fino a 4.7, Sonnet 4 fino a 4.6 e Haiku 4.5. Su qualsiasi altro modello, incluso un ID modello che Claude Code non riconosce, l'elenco rimane vuoto a meno che non optiate per CLAUDE_CODE_ENABLE_TODO_TOOLS=1 o uno degli altri modi in Disponibilità dello strumento Task. Quando la sessione dispone degli strumenti, l'elenco attività funziona come segue:

• Premere Ctrl+T per attivare/disattivare la visualizzazione dell'elenco attività. La visualizzazione mostra fino a cinque attività alla volta. Quando Claude non ha ancora creato elementi della lista di controllo, l'attivazione non ha effetto visibile perché non c'è nulla da visualizzare
• Se lasciate l'elenco espanso, Claude Code ripristina la visualizzazione espansa la prossima volta che avviate una sessione che contiene ancora attività, ad esempio con --resume o --continue. Quando l'elenco attività è vuoto, Claude Code lo avvia compresso
• Per visualizzare tutte le attività o cancellarle, chiedete direttamente a Claude: "mostrami tutte le attività" o "cancella tutte le attività"
• Le attività persistono attraverso le compattazioni di contesto, aiutando Claude a rimanere organizzato su progetti più grandi
• Per condividere un elenco attività tra sessioni, impostare CLAUDE_CODE_TASK_LIST_ID per utilizzare una directory denominata in ~/.claude/tasks/: CLAUDE_CODE_TASK_LIST_ID=my-project claude

Riepilogo della sessione

Quando tornate al terminale dopo esservi allontanati, Claude Code mostra un riepilogo di una riga di ciò che è accaduto nella sessione finora. Il riepilogo viene generato in background una volta che sono trascorsi almeno tre minuti dall'ultimo turno completato e il terminale non è a fuoco, quindi è pronto quando tornate indietro. I riepiloghi appaiono solo una volta che la sessione ha almeno tre turni e mai due volte di seguito.

Eseguite /recap per generare un riepilogo su richiesta. Claude Code limita sia i riepiloghi automatici che l'output di /recap a 400 caratteri. Per disattivare i riepiloghi automatici, aprite /config e disattivate Session recap.

Il riepilogo della sessione è attivato per impostazione predefinita per ogni piano e provider. Il riepilogo viene sempre saltato in modalità non interattiva.

Attendere il ripristino di un limite di utilizzo

Quando un limite di utilizzo di claude.ai interrompe Claude a metà attività, Claude Code rimane nella sessione aperta e continua l'attività automaticamente dopo il ripristino del limite. La continuazione automatica è attivata per impostazione predefinita nelle sessioni interattive con accesso tramite un abbonamento claude.ai. Richiede Claude Code v2.1.234 o versione successiva.

Mentre Claude Code attende, una riga in fondo alla sessione mostra quando continuerà:

Usage limit reached · continuing automatically at 3:45pm · esc to cancel

Mantenere la sessione aperta. Ciò che accade dopo dipende da come termina l'attesa:

• Al ripristino: la riga legge continuing shortly, quindi Usage limit reset · continuing automatically, e Claude Code invia a Claude un prompt fisso per riprendere l'attività da dove si era fermata. Non rinvia il vostro ultimo messaggio.
• Dopo che il computer è andato in sospensione: se è andato in sospensione per più di circa 30 minuti e il limite si è ripristinato mentre era in sospensione, la riga legge Your usage limit has reset · press enter to continue. Premere Invio per continuare. Dopo una sospensione più breve, Claude Code continua automaticamente.
• Anticipatamente: quando completate l'aggiunta di crediti di utilizzo con /usage-credits, effettuate di nuovo l'accesso dopo /upgrade, o cambiate modello con /model durante l'attesa, Claude Code verifica se l'utilizzo è di nuovo disponibile e continua immediatamente se lo è. Non verifica dopo un aggiornamento o un acquisto che effettuate in un browser da soli. In opusplan e altre impostazioni di modello che eseguono la modalità plan su un modello diverso, Claude Code attende il ripristino.

L'attività continuata viene eseguita come qualsiasi altro turno. Claude Code continua a chiedere autorizzazioni come al solito, quindi l'attività può fermarsi su un prompt mentre siete assenti. Se raggiunge di nuovo il limite, Claude Code riattiva l'attesa automaticamente al massimo due volte di seguito, quindi si ferma e mostra Automatic continue stopped after repeated usage-limit hits · /rate-limit-options to try again.

Annullare l'attesa

Premere Esc a un prompt vuoto, o Ctrl+C, mentre la riga è visibile, oppure eseguire /rate-limit-options e selezionare Don't continue automatically. Claude Code conferma con una riga che inizia con Automatic continue cancelled.

Dopo un annullamento, nulla continua finché non inviate un prompt o non selezionate la riga che inizia con Wait here, then continue automatically da /rate-limit-options di nuovo. Claude Code non avvia un'attesa da solo per quella finestra di ripristino; la finestra di ripristino successiva ricomincia da capo.

L'attesa termina anche senza continuare l'attività in questi casi:

• Inviate un prompt: Claude Code esegue il vostro prompt invece di attendere.
• Uscite da Claude Code: l'attesa non si riavvia quando riprendete la sessione.
• La conversazione cambia proprietario: cambiate account con /login, cancellate o riavvolgete la conversazione, /resume un'altra sessione, ne tirate una con /teleport, riavviate con /tui, o consegnate la sessione a Claude Desktop, una sessione in background, o il cloud.
• L'impostazione si disattiva, o il ripristino supera le 24 ore: questo termina solo un'attesa che Claude Code ha avviato da solo. Un'attesa che avete selezionato da /rate-limit-options continua il conto alla rovescia.
• La continuazione è bloccata: un hook UserPromptSubmit che blocca il prompt di continuazione, o un errore prima che raggiunga il modello, termina l'attesa. Claude Code vi comunica che la continuazione non è stata eseguita. Inviate un prompt per continuare.

Avviare un'attesa da soli

Claude Code non avvia l'attesa da solo in questi casi:

• Sessioni di Remote Control e team di agenti: una persona a quel terminale può comunque avviarne una.
• Un ripristino a più di 24 ore di distanza: un limite settimanale può ripristinarsi giorni dopo.
• Un limite Opus o Sonnet mentre eseguite un modello al di fuori di quella famiglia: il vostro turno successivo potrebbe non raggiungere quel limite. opusplan e altre impostazioni di modello che eseguono la modalità plan sulla famiglia limitata non ottengono questa eccezione.

In questi casi, e ogni volta che la continuazione automatica è disattivata, Claude Code apre il menu delle opzioni di limite di utilizzo una volta per finestra di ripristino quando raggiungete un limite al vostro terminale. Selezionate la riga che inizia con Wait here, then continue automatically per avviare l'attesa. In una sessione Remote Control o team di agenti, eseguite /rate-limit-options da soli per aprire il menu.

Claude Code non offre affatto l'attesa in questi casi:

• Sessioni in background e esecuzioni -p: la riga del menu non è disponibile.
• Chiavi API, provider cloud e fatturazione basata sull'utilizzo: l'utilizzo lì viene misurato per richiesta, quindi non c'è alcun ripristino per cui attendere.
• Un gateway LLM senza un accesso claude.ai salvato: Claude Code offre l'attesa solo mentre un accesso claude.ai salvato è la credenziale attiva.

Disattivare la continuazione automatica

In /config, disattivate Continue automatically at usage limit, oppure impostate autoContinueAtUsageLimit su false nelle vostre impostazioni utente. /config autoContinueAtUsageLimit=false funziona anche, incluso con -p, ma la forma key=value non può riattivarlo, perché l'impostazione concede l'esecuzione incustodita. Quali file di impostazioni Claude Code legge per questa chiave è nel riferimento delle impostazioni.

Stato della revisione PR

Quando si lavora su un ramo con una pull request aperta, Claude Code visualizza un collegamento PR cliccabile nel footer, ad esempio "PR #446". Il collegamento ha una sottolineatura colorata che indica lo stato della revisione:

• Verde: approvato
• Giallo: revisione in sospeso
• Rosso: modifiche richieste
• Grigio: bozza

Il badge scompare una volta che la pull request viene unita o chiusa.

Cmd+click (macOS) o Ctrl+click (Windows/Linux) sul collegamento per aprire la pull request nel vostro browser.

Lo stato si aggiorna non appena un git push, o un comando gh pr che modifica la pull request, come gh pr create o gh pr merge, ha successo nella sessione.

Claude Code visualizza il badge come un collegamento ipertestuale anche quando non riesce a rilevare il supporto dei collegamenti ipertestuali nel vostro terminale, il che accade comunemente su SSH o in tmux. Impostare FORCE_HYPERLINK=0 per visualizzare il badge come testo semplice.

Quando impostate CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, Claude Code non controlla lo stato della pull request o della merge request.

Merge request GitLab

Quando lavorate su un ramo con una merge request GitLab aperta, Claude Code mostra un badge MR !N cliccabile nello slot del footer che altrimenti contiene il collegamento GitHub PR. !N è la sintassi di riferimento di GitLab per il numero di merge request N. La sottolineatura colorata mostra lo stato della merge request:

• Verde: GitLab segnala la merge request come unibile
• Giallo: qualsiasi altro stato aperto
• Grigio: bozza

Il badge scompare una volta che la merge request viene unita o chiusa.

Si aggiorna non appena un git push, o un comando glab mr che modifica la merge request, come glab mr create o glab mr merge, ha successo nella sessione.

Per ottenere il badge, avete bisogno di:

• Claude Code v2.1.234 o successivo
• Un remote del repository che punta al vostro host GitLab, sia gitlab.com che un'istanza auto-gestita
• La glab CLI nel vostro PATH, autenticata con glab auth login

Claude Code ignora le variabili di ambiente del token di glab, come GITLAB_TOKEN, quando controlla lo stato, quindi non ottenete alcun badge da un token esportato da solo. Claude Code cerca anche glab e il suo login una volta per sessione, quindi riavviate Claude Code dopo aver installato glab o aver eseguito glab auth login.

Link di riferimento ai problemi

Quando Claude menziona un problema come owner/repo#123, potete fare clic sul riferimento per aprirlo, purché il vostro terminale supporti i hyperlink. Se Claude Code non rileva il supporto dei hyperlink nel vostro terminale, impostate FORCE_HYPERLINK su 1 per attivare i link, oppure su 0 per mantenere i riferimenti come testo semplice.

Ottenete un link solo per il modulo a due parti owner/repo#123. Questi rimangono come testo semplice:

• Un #123 isolato
• Un percorso GitLab annidato come group/subgroup/project#123
• Qualsiasi riferimento all'interno di uno span di codice o di un blocco di codice

Claude Code costruisce il link per l'host del repository che identifica dal vostro git remote, non per il repository che il riferimento nomina:

Vedere anche

• Skills - Prompt personalizzati e flussi di lavoro
• Checkpointing - Riavvolgi le modifiche di Claude e ripristina gli stati precedenti
• Riferimento CLI - Flag e opzioni della riga di comando
• Impostazioni - Opzioni di configurazione
• Gestione della memoria - Gestione dei file CLAUDE.md