Personalizzare le scorciatoie da tastiera

Personalizzare le scorciatoie da tastiera in Claude Code con un file di configurazione keybindings.

Claude Code supporta scorciatoie da tastiera personalizzabili. Eseguire /keybindings per creare o aprire il file di configurazione in ~/.claude/keybindings.json.

File di configurazione

Il file di configurazione delle scorciatoie da tastiera è un oggetto con un array bindings. Ogni blocco specifica un contesto e una mappa di sequenze di tasti per le azioni.

Campo	Descrizione
`$schema`	URL dello schema JSON opzionale per l'autocompletamento dell'editor
`$docs`	URL della documentazione opzionale
`bindings`	Array di blocchi di binding per contesto

Questo esempio associa Ctrl+E per aprire un editor esterno nel contesto della chat e annulla l'associazione di Ctrl+S:

{
  "$schema": "https://www.schemastore.org/claude-code-keybindings.json",
  "$docs": "https://code.claude.com/docs/en/keybindings",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+e": "chat:externalEditor",
        "ctrl+s": null
      }
    }
  ]
}

Contesti

Ogni blocco di binding specifica un contesto dove si applicano i binding:

Contesto	Descrizione
`Global`	Si applica ovunque nell'app
`Chat`	Area di input della chat principale
`Autocomplete`	Menu di autocompletamento è aperto
`Settings`	Menu delle impostazioni
`Confirmation`	Dialoghi di permesso e conferma
`Tabs`	Componenti di navigazione delle schede
`Help`	Menu della guida è visibile
`Transcript`	Visualizzatore di trascrizione
`HistorySearch`	Modalità di ricerca nella cronologia (Ctrl+R)
`Task`	Un'attività è in esecuzione in primo piano
`ThemePicker`	Dialogo di selezione del tema
`Attachments`	Navigazione degli allegati nei dialoghi di selezione
`Footer`	Navigazione dell'indicatore di piè di pagina (attività, team, diff, artefatti)
`MessageSelector`	Selezione dei messaggi nella finestra di dialogo di riavvolgimento e riepilogo
`DiffDialog`	Navigazione del visualizzatore diff
`DiffPanel`	Il pannello diff è aperto
`ModelPicker`	Livello di sforzo del selezionatore di modelli
`EffortSlider`	Cursore di sforzo aperto da `/effort`
`Select`	Componenti generici di selezione/elenco
`Plugin`	Dialogo dei plugin (sfoglia, scopri, gestisci)
`Agents`	Visualizzazione agente (`claude agents`)
`Scroll`	Scorrimento della conversazione e selezione del testo in modalità a schermo intero

Prima della v2.1.205, un contesto Doctor e un'azione doctor:fix esistevano per la schermata diagnostica /doctor.

Azioni disponibili

Le azioni seguono un formato namespace:action, come chat:submit per inviare un messaggio o app:toggleTodos per mostrare l'elenco delle attività. Ogni contesto ha azioni specifiche disponibili.

Azioni dell'app

Azioni disponibili nel contesto Global:

Azione	Predefinito	Descrizione
`app:interrupt`	Ctrl+C	Annulla l'operazione corrente
`app:exit`	Ctrl+D	Esci da Claude Code. Premi due volte entro 800ms per confermare
`app:redraw`	(non associato)	Forza il ridisegno del terminale
`app:toggleTodos`	Ctrl+T	Attiva/disattiva la visibilità della lista di controllo delle attività di Claude. Questo non è il `/tasks` background-task view
`app:toggleTranscript`	Ctrl+O	Attiva/disattiva il trascritto dettagliato

Azioni della cronologia

Azioni per navigare nella cronologia dei comandi:

Azione	Predefinito	Descrizione
`history:search`	Ctrl+R	Apri ricerca nella cronologia
`history:previous`	Su	Elemento precedente della cronologia
`history:next`	Giù	Elemento successivo della cronologia

Azioni della chat

Azioni disponibili nel contesto Chat:

Azione	Predefinito	Descrizione
`chat:cancel`	Escape	Annulla l'input corrente
`chat:clearInput`	Ctrl+L	Forza un ridisegno completo dello schermo, preservando l'input e la conversazione
`chat:clearScreen`	Cmd+K	Uguale a `chat:clearInput`. Vedi Cancella la conversazione per come Cmd+K si comporta su iTerm2 e Terminal.app
`chat:killAgents`	Ctrl+X Ctrl+K	Interrompi tutti i subagent in background in questa sessione e disattiva le risposte automatiche degli artefatti per il resto della sessione
`chat:cycleMode`	Shift+Tab*	Cicla le modalità di autorizzazione
`chat:modelPicker`	Meta+P	Apri il selezionatore di modelli
`chat:fastMode`	Meta+O	Attiva/disattiva la modalità veloce
`chat:thinkingToggle`	Meta+T	Attiva/disattiva il pensiero esteso
`chat:submit`	Invio	Invia il messaggio
`chat:queueSubmit`	Ctrl+X Invio	Invia il messaggio, contrassegnato per attendere il suo turno: mentre Claude sta lavorando, Claude Code lo mette in coda e non interrompe mai il turno. A differenza di `chat:submit`, invia la bozza anche quando un suggerimento di completamento automatico è evidenziato. Richiede v2.1.247 o successiva
`chat:sendNow`	Ctrl+Invio, Ctrl+X Ctrl+S	Invia i tuoi messaggi in coda e la tua bozza insieme a loro, subito. Quando Claude Code invia quello che hai messo in coda copre cosa succede al turno su cui Claude sta lavorando. Quando nulla è in esecuzione, il tasto invia la bozza, e in shell mode mette in coda solo il comando. I terminali che non segnalano tasti estesi consegnano `Ctrl+Invio` come semplice `Invio`, quindi `Ctrl+X Ctrl+S` è l'associazione che funziona in qualsiasi terminale. Richiede v2.1.275 o successiva
`chat:newline`	Ctrl+J	Inserisci una nuova riga senza inviare
`chat:undo`	Ctrl+_, Ctrl+Shift+-	Annulla l'ultima azione
`chat:externalEditor`	Ctrl+G, Ctrl+X Ctrl+E	Apri nell'editor esterno. Il dispatch input della vista agente segue anche le associazioni a singolo tasto di questa azione
`chat:stash`	Ctrl+S	Nascondi il prompt corrente
`chat:imagePaste`	Ctrl+V (Alt+V su Windows e WSL)	Incolla l'immagine dagli appunti. Su WSL, entrambe le scorciatoie sono associate per impostazione predefinita

*Su Windows senza modalità VT (Node <24.2.0/<22.17.0, Bun <1.2.23), il valore predefinito è Meta+M.

Azioni di completamento automatico

Azioni disponibili nel contesto Autocomplete:

Azione	Predefinito	Descrizione
`autocomplete:accept`	Tab	Accetta il suggerimento
`autocomplete:dismiss`	Escape	Chiudi il menu
`autocomplete:previous`	Su	Suggerimento precedente
`autocomplete:next`	Giù	Suggerimento successivo

Azioni di conferma

Azioni disponibili nel contesto Confirmation:

Azione	Predefinito	Descrizione
`confirm:yes`	Invio	Conferma l'azione
`confirm:no`	Escape	Rifiuta l'azione
`confirm:previous`	Su	Opzione precedente
`confirm:next`	Giù	Opzione successiva
`confirm:nextField`	Tab	Campo successivo
`confirm:previousField`	(non associato)	Campo precedente
`confirm:toggle`	Spazio	Attiva/disattiva la selezione
`confirm:cycleMode`	Shift+Tab*	Cicla le modalità di autorizzazione. Su un prompt di autorizzazione file, chiude un campo commento aperto; senza campo aperto, seleziona l'opzione che consente l'azione per il resto della sessione, quando il prompt offre tale opzione

*Su Windows senza modalità VT (Node <24.2.0/<22.17.0, Bun <1.2.23), il valore predefinito è Meta+M.

Prima della v2.1.257, un'azione confirm:toggleExplanation, associata a Ctrl+E per impostazione predefinita, mostrava una spiegazione generata dal modello del comando su prompt di autorizzazione Bash e PowerShell.

I dialoghi utilizzano confirm:yes e confirm:no per accettare e annullare anche quando non pongono una domanda sì-o-no. Se associ una lettera semplice come y o n in questo contesto, la lettera agisce anche su dialoghi che non la mostrano mai come tasto. Un dialogo che mostra y e n come suoi tasti legge quelle lettere stesso e non ha bisogno di alcuna associazione.

Nella maggior parte dei dialoghi, premere Ctrl+C o Ctrl+D due volte chiude il dialogo invece di uscire da Claude Code. L'hint dopo il primo pressione dice se il secondo pressione chiude il dialogo o esce. Entrambi i tasti sono riservati e non possono essere riassociati.

Questo esempio associa y a confirm:yes e n a confirm:no:

{
  "bindings": [
    {
      "context": "Confirmation",
      "bindings": {
        "y": "confirm:yes",
        "n": "confirm:no"
      }
    }
  ]
}

Con queste associazioni, y e n continuano a digitare come lettere mentre un campo di testo ha il focus.

Prima della v2.1.280, y era anche associato a confirm:yes e n a confirm:no per impostazione predefinita. Se hai creato il tuo keybindings.json con /keybindings prima della v2.1.280, il file elenca entrambe le associazioni e rimangono in vigore finché non elimini quelle due righe.

Azioni di autorizzazione

Azioni disponibili nel contesto Confirmation per i dialoghi di autorizzazione:

Azione	Predefinito	Descrizione
`permission:toggleDebug`	(non associato)	Attiva/disattiva le informazioni di debug dell'autorizzazione. Il valore predefinito precedente di Ctrl+D è stato rimosso nella v2.1.146 perché oscurava `app:exit`

Azioni del trascritto

Azioni disponibili nel contesto Transcript:

Azione	Predefinito	Descrizione
`transcript:toggleShowAll`	Ctrl+E	Attiva/disattiva mostra tutto il contenuto
`transcript:exit`	q, Ctrl+C, Escape	Esci dalla vista trascritto

transcript:toggleShowAll si applica solo nel renderer classico; nel rendering a schermo intero, il visualizzatore di trascritti non offre un'opzione di mostra tutto.

Azioni di ricerca nella cronologia

Azioni disponibili nel contesto HistorySearch:

Azione	Predefinito	Descrizione
`historySearch:next`	Ctrl+R	Corrispondenza successiva
`historySearch:accept`	Escape, Tab	Accetta la selezione
`historySearch:cancel`	Ctrl+C	Annulla la ricerca
`historySearch:execute`	Invio	Esegui il comando selezionato
`historySearch:cycleScope`	Ctrl+S	Cicla l'ambito: sessione, progetto, ovunque

I valori predefiniti di historySearch:next, historySearch:accept, historySearch:cancel e historySearch:execute si applicano alla ricerca nella cronologia inline nel renderer classico, che ricerca sempre i prompt da tutti i progetti. historySearch:cycleScope ha effetto solo nel rendering a schermo intero, dove Ctrl+R apre una finestra di dialogo di ricerca e Ctrl+S cicla il suo ambito. I tasti della finestra di dialogo sono fissi e non possono essere riassociati: Invio o Tab posiziona la corrispondenza evidenziata nell'input del prompt e Esc annulla.

Azioni delle attività

Azioni disponibili nel contesto Task:

Azione	Predefinito	Descrizione
`task:background`	Ctrl+B, Ctrl+X Ctrl+B	Metti l'attività corrente in background. L'accordo Ctrl+X Ctrl+B evita il conflitto del prefisso tmux

Azioni del tema

Azioni disponibili nel contesto ThemePicker:

Azione	Predefinito	Descrizione
`theme:toggleSyntaxHighlighting`	Ctrl+T	Attiva/disattiva l'evidenziazione della sintassi

Azioni della guida

Azioni disponibili nel contesto Help:

Azione	Predefinito	Descrizione
`help:dismiss`	Escape	Chiudi il menu della guida

Azioni delle schede

Azioni disponibili nel contesto Tabs:

Azione	Predefinito	Descrizione
`tabs:next`	Tab, Destra	Scheda successiva
`tabs:previous`	Shift+Tab, Sinistra	Scheda precedente

In una finestra di dialogo con schede, tabs:next e tabs:previous cambiano le schede mentre la riga delle schede ha il focus. In alcuni dialoghi, come /help e /sandbox, i tasti di cambio scheda funzionano anche dall'interno del contenuto della scheda.

Su e Giù spostano il focus tra la riga delle schede e il contenuto della scheda, e un elenco nel contenuto risponde ai tasti solo mentre ha il focus.

Azioni degli allegati

Azioni disponibili nel contesto Attachments:

Azione	Predefinito	Descrizione
`attachments:next`	Destra	Allegato successivo
`attachments:previous`	Sinistra	Allegato precedente
`attachments:remove`	Backspace, Canc	Rimuovi l'allegato selezionato
`attachments:exit`	Giù, Escape	Esci dalla navigazione degli allegati

Azioni disponibili nel contesto Footer:

Azione	Predefinito	Descrizione
`footer:next`	Destra	Elemento del piè di pagina successivo
`footer:previous`	Sinistra	Elemento del piè di pagina precedente
`footer:up`	Su	Naviga verso l'alto nel piè di pagina (deseleziona in alto)
`footer:down`	Giù	Naviga verso il basso nel piè di pagina
`footer:openSelected`	Invio	Apri l'elemento del piè di pagina selezionato
`footer:clearSelection`	Escape	Cancella la selezione del piè di pagina
`footer:dismiss`	(non associato)	Rimosso nella v2.1.281. Un `keybindings.json` che nomina ancora l'azione rimane valido e l'associazione non fa nulla. Prima della v2.1.281, Backspace e Canc chiudevano il collegamento dell'artefatto selezionato dal piè di pagina

Mentre un elemento del piè di pagina è selezionato, come una riga nel pannello dell'agente sotto il prompt, Invio lo apre anche quando riassoci Invio nel contesto Chat a chat:queueSubmit o chat:newline.

Le associazioni Chat sui tasti che il contesto Footer non associa, come Shift+Tab per chat:cycleMode, continuano a funzionare mentre un elemento è selezionato.

Azioni del selezionatore di messaggi

Nel messaggio elenco del menu di rewind, ti muovi attraverso i messaggi e ne scegli uno con le azioni di selezione e i loro tasti predefiniti. Le tue associazioni Select per quelle azioni si applicano anche lì. Il contesto MessageSelector non ha azioni o associazioni predefinite proprie. Usalo per cambiare un tasto per questo elenco solo, associando un'azione Select come select:accept in un blocco MessageSelector.

Questo esempio associa o per scegliere il messaggio evidenziato nel menu di rewind, senza cambiare nessun altro elenco:

{
  "bindings": [
    {
      "context": "MessageSelector",
      "bindings": {
        "o": "select:accept"
      }
    }
  ]
}

Prima della v2.1.283, questo elenco ignorava le associazioni Select e aveva le sue azioni: messageSelector:up, messageSelector:down, messageSelector:top, messageSelector:bottom e messageSelector:select. Se il tuo keybindings.json associa uno di quei nomi, l'associazione continua a funzionare in questo elenco come l'azione Select che fa la stessa cosa. Home e End saltano a entrambe le estremità dell'elenco; prima della v2.1.283, tasti come Shift+K e Shift+J lo facevano per impostazione predefinita.

Azioni diff

Azioni disponibili nel contesto DiffDialog:

Azione	Predefinito	Descrizione
`diff:dismiss`	Escape	Chiudi il visualizzatore diff; dalla vista dettagli, ritorna all'elenco dei file
`diff:previousSource`	Sinistra	Sorgente diff precedente
`diff:nextSource`	Destra	Sorgente diff successiva
`diff:previousFile`	Su, K	File precedente nell'elenco dei file; scorri verso l'alto di una riga nella vista dettagli
`diff:nextFile`	Giù, J	File successivo nell'elenco dei file; scorri verso il basso di una riga nella vista dettagli
`diff:back`	(non associato)	Torna indietro nel visualizzatore diff. Escape esegue l'azione indietro tramite `diff:dismiss`. Il valore predefinito precedente di Sinistra nella vista dettagli è stato rimosso nella v2.1.203

L'elenco dei file risponde anche alle azioni di selezione, attraverso i loro tasti predefiniti e le tue associazioni Select. select:previous e select:next si spostano al file precedente e successivo, e Invio apre il diff del file selezionato tramite select:accept. Per cambiare uno di quei tasti per l'elenco dei file solo, associa l'azione Select in un blocco DiffDialog.

Prima della v2.1.283, l'elenco dei file ignorava le associazioni Select, e Invio apriva il diff del file selezionato tramite un'azione diff:viewDetails separata. Se il tuo keybindings.json associa diff:viewDetails, l'associazione continua a funzionare nell'elenco dei file come select:accept.

La vista dettagli diff associa anche i tasti in stile pager alle azioni di scorrimento standard. Queste associazioni fanno parte del contesto DiffDialog e si applicano solo nella vista dettagli; i valori predefiniti del contesto Scroll elencati in Azioni di scorrimento rimangono invariati.

Azione	Predefinito	Descrizione
`scroll:pageUp`	PagSu	Scorri verso l'alto di mezza finestra
`scroll:pageDown`	PagGiù	Scorri verso il basso di mezza finestra
`scroll:fullPageUp`	Shift+Spazio, B	Scorri verso l'alto di una finestra completa
`scroll:fullPageDown`	Spazio	Scorri verso il basso di una finestra completa
`scroll:top`	G, Home	Salta in alto
`scroll:bottom`	Shift+G, Fine	Salta in basso

Azioni del pannello diff

Azioni per il pannello diff che /diff apre nel rendering a schermo intero. app:cycleDiffBase è nel contesto DiffPanel, che è attivo mentre il pannello è aperto; gli altri sono Global. Il pannello richiede Claude Code v2.1.260 o successiva.

Azione	Predefinito	Descrizione
`app:toggleReplTab`	(non associato)	Apri o chiudi il pannello diff, come eseguire `/diff`
`app:cycleDiffBase`	Ctrl+X B	Cicla la base di confronto del pannello: questa sessione, non committato, quindi ramo
`app:diffFileListUp`	Ctrl+Su, Meta+Su	Scorri l'elenco dei file del pannello verso l'alto quando trabocca
`app:diffFileListDown`	Ctrl+Giù, Meta+Giù	Scorri l'elenco dei file del pannello verso il basso quando trabocca
`app:toggleDiffNoiseFilter`	(non associato)	Mostra o nascondi i file di test e generati nel pannello
`app:toggleDiffPreSession`	(non associato)	Espandi o comprimi le modifiche da prima di questa sessione

Azioni del selezionatore di modelli

Azioni disponibili nel contesto ModelPicker:

Azione	Predefinito	Descrizione
`modelPicker:decreaseEffort`	Sinistra	Diminuisci il livello di sforzo
`modelPicker:increaseEffort`	Destra	Aumenta il livello di sforzo
`modelPicker:thisSessionOnly`	s	Applica il modello evidenziato solo a questa sessione

Azioni del cursore di sforzo

Azioni disponibili nel contesto EffortSlider, il cursore che si apre quando esegui /effort senza argomenti. I tasti Invio ed Escape del cursore non possono essere riassociati.

Azione	Predefinito	Descrizione
`effortSlider:decreaseEffort`	Sinistra	Sposta il cursore al livello di sforzo successivo inferiore. Richiede v2.1.284 o successiva
`effortSlider:increaseEffort`	Destra	Sposta il cursore al livello di sforzo successivo superiore. Richiede v2.1.284 o successiva
`effortSlider:toggleUltracode`	Tab	Attiva/disattiva ultracode per questa sessione, quando il cursore lo offre. Richiede v2.1.284 o successiva
`effortSlider:thisSessionOnly`	s	Applica il livello di sforzo focalizzato solo a questa sessione. Richiede v2.1.257 o successiva

Azioni di selezione

Azioni disponibili nel contesto Select:

Azione	Predefinito	Descrizione
`select:next`	Giù, J, Ctrl+N	Opzione successiva
`select:previous`	Su, K, Ctrl+P	Opzione precedente
`select:pageUp`	PagSu	Sposta verso l'alto di una pagina di opzioni
`select:pageDown`	PagGiù	Sposta verso il basso di una pagina di opzioni
`select:first`	Home	Prima opzione
`select:last`	Fine	Ultima opzione
`select:accept`	Invio	Accetta la selezione
`select:cancel`	Escape	Annulla la selezione

Nei pannelli elenco come /skills e /mcp, Claude Code applica le tue associazioni select:pageUp, select:pageDown, select:first e select:last. Nella maggior parte degli altri elenchi, come il selezionatore /model, si applicano le tue associazioni select:first e select:last. PagSu e PagGiù scorrono le opzioni in quegli elenchi indipendentemente dalle tue associazioni.

Prima della v2.1.280, quegli altri elenchi ignoravano Home, Fine e le tue associazioni select:first e select:last.

Azioni dei plugin

Azioni disponibili nel contesto Plugin:

Azione	Predefinito	Descrizione
`plugin:toggle`	Spazio	Attiva/disattiva la selezione del plugin
`plugin:install`	I	Installa i plugin selezionati
`plugin:favorite`	F	Contrassegna il plugin selezionato come preferito in modo che si ordini vicino alla parte superiore della scheda Installato

Azioni delle impostazioni

Azioni disponibili nel contesto Settings. Le azioni select:accept e confirm:no vengono riutilizzate dai contesti Select e Confirmation con comportamento specifico delle impostazioni: le modifiche si applicano a ogni impostazione non appena la modifichi, quindi Escape chiude il pannello con le tue modifiche salvate piuttosto che rifiutare.

Azione	Predefinito	Descrizione
`settings:search`	/	Entra in modalità di ricerca
`settings:retry`	R	Riprova a caricare i dati di utilizzo in caso di errore
`select:accept`	Invio, Spazio	Modifica l'impostazione selezionata o apri il suo sottomenu
`confirm:no`	Escape	Chiudi il pannello. Le modifiche sono già salvate

Azioni degli agenti

Azioni disponibili nel contesto Agents, che si applica nella vista agente, aperta con claude agents. Richiede v2.1.257 o successiva.

Azione	Predefinito	Descrizione
`agents:switchView`	Ctrl+S	Cambia il raggruppamento della sessione tra stato e directory
`agents:togglePin`	Ctrl+T	Fissa o scollega la sessione selezionata

Mentre la vista agente è aperta, Claude Code utilizza l'associazione Agents per qualsiasi tasto che il contesto Agents associa, e ignora un'associazione Chat o Global sulla stessa chiave. Ad esempio, premere Ctrl+S nella vista agente cambia il raggruppamento della sessione piuttosto che attivare il valore predefinito chat:stash.

La scorciatoia dell'editor esterno dell'input di dispatch non è un'azione Agents. La vista agente segue l'associazione chat:externalEditor del contesto Chat, Ctrl+G per impostazione predefinita.

Le associazioni si attivano su singoli tasti nella vista agente, quindi l'accordo Ctrl+X Ctrl+E associato a chat:externalEditor non apre l'editor lì.

Azioni vocali

Azioni disponibili nel contesto Chat quando la dettatura vocale è abilitata:

Azione	Predefinito	Descrizione
`voice:pushToTalk`	Spazio	Dettare un prompt. Tieni premuto o tocca a seconda della modalità `/voice`

Azioni di scorrimento

Azioni disponibili nel contesto Scroll quando il rendering a schermo intero è abilitato:

Azione	Predefinito	Descrizione
`scroll:lineUp`	`wheelup`	Scorri verso l'alto di una riga. Lo scorrimento della rotella del mouse attiva questa azione
`scroll:lineDown`	`wheeldown`	Scorri verso il basso di una riga. Lo scorrimento della rotella del mouse attiva questa azione
`scroll:pageUp`	PagSu	Scorri verso l'alto di mezza altezza della finestra
`scroll:pageDown`	PagGiù	Scorri verso il basso di mezza altezza della finestra
`scroll:top`	Ctrl+Home	Salta all'inizio della conversazione
`scroll:bottom`	Ctrl+Fine	Salta al messaggio più recente e riabilita il follow automatico
`scroll:halfPageUp`	(non associato)	Scorri verso l'alto di mezza altezza della finestra. Stesso comportamento di `scroll:pageUp`, fornito per riassociazioni in stile vi
`scroll:halfPageDown`	(non associato)	Scorri verso il basso di mezza altezza della finestra. Stesso comportamento di `scroll:pageDown`, fornito per riassociazioni in stile vi
`scroll:fullPageUp`	(non associato)	Scorri verso l'alto dell'intera altezza della finestra
`scroll:fullPageDown`	(non associato)	Scorri verso il basso dell'intera altezza della finestra
`selection:copy`	Ctrl+Shift+C / Cmd+C	Copia il testo selezionato negli appunti
`selection:clear`	(non associato)	Cancella la selezione di testo attiva. Richiede v2.1.234 o successiva
`selection:extendLeft`	Shift+Sinistra	Estendi la selezione attiva di una colonna a sinistra
`selection:extendRight`	Shift+Destra	Estendi la selezione attiva di una colonna a destra
`selection:extendUp`	Shift+Su	Estendi la selezione attiva di una riga verso l'alto. Scorri la finestra quando la selezione raggiunge il bordo superiore
`selection:extendDown`	Shift+Giù	Estendi la selezione attiva di una riga verso il basso. Scorri la finestra quando la selezione raggiunge il bordo inferiore
`selection:extendLineStart`	Shift+Home	Estendi la selezione attiva all'inizio della riga
`selection:extendLineEnd`	Shift+Fine	Estendi la selezione attiva alla fine della riga

Sintassi delle sequenze di tasti

Modificatori

Utilizzare i tasti modificatori con il separatore +:

ctrl o control - Tasto Control
shift - Tasto Shift
alt, opt, option, o meta - Tasto Alt su Windows e Linux, tasto Option su macOS
cmd, command, super, o win - Tasto Command su macOS, tasto Windows su Windows, tasto Super su Linux

Il gruppo cmd viene rilevato solo nei terminali che segnalano il modificatore Super, come quelli che supportano il protocollo della tastiera Kitty o la modalità modifyOtherKeys di xterm. La maggior parte dei terminali non lo invia, quindi utilizzare ctrl o meta per i binding che si desidera funzionino ovunque.

Ad esempio:

ctrl+k          Ctrl + K
shift+tab       Shift + Tab
meta+p          Option + P su macOS, Alt + P altrove
ctrl+shift+c    Più modificatori

Lettere maiuscole

Claude Code analizza i nomi dei tasti in modo insensibile alle maiuscole, quindi K è lo stesso binding di k e ctrl+K è lo stesso di ctrl+k. Per associare Shift e una lettera, scrivere shift+k.

Layout di tastiera non US

Scrivere i nomi dei tasti dei scorciatoie Ctrl come caratteri latini anche quando il layout di tastiera attivo digita altri caratteri.

Il modo in cui Claude Code associa il tasto premuto a un binding dipende dal tipo di layout:

Sotto un layout non latino come il cirillico, Claude Code associa i scorciatoie Ctrl in base alla posizione del tasto nel layout US quando il terminale utilizza il protocollo della tastiera Kitty e segnala quella posizione. In tale terminale, con un layout russo attivo, premendo Ctrl e il tasto fisico W si attiva ctrl+w. In un terminale che non segnala la posizione, Claude Code associa quello che il terminale invia per la pressione del tasto: un codice di controllo ASCII attiva il scorciatoio latino, e una pressione del tasto che arriva come carattere cirillico non corrisponde a nessun binding
Sotto layout che riorganizzano le lettere latine, come AZERTY, Claude Code associa la lettera che il tasto digita, quindi premendo Ctrl e il tasto etichettato A si attiva ctrl+a

Prima della v2.1.247, premere un scorciatoio Ctrl sotto un layout non latino non attivava il suo binding nei terminali che utilizzano il protocollo della tastiera Kitty, come Ghostty, Kitty, WezTerm e iTerm2.

Accordi

Gli accordi sono sequenze di tasti separate da spazi:

ctrl+k ctrl+s   Premi Ctrl+K, rilascia, quindi Ctrl+S

Premere ogni sequenza di tasti entro 3 secondi da quella precedente. Se si attende più a lungo, Claude Code annulla l'accordo e mostra un breve avviso che lo comunica.

Tasti speciali

escape o esc - Tasto Escape
enter o return - Tasto Invio
tab - Tasto Tab
space - Barra spaziatrice
up, down, left, right - Tasti freccia
pageup, pagedown - Tasti Pagina Su e Pagina Giù
home, end - Tasti Home e Fine
backspace, delete - Tasti Canc
wheelup, wheeldown - Eventi di scorrimento della rotella del mouse

Annulla l'associazione delle scorciatoie predefinite

Impostare un'azione su null per annullare l'associazione di una scorciatoia predefinita:

{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+s": null
      }
    }
  ]
}

Questo funziona anche per i binding degli accordi. Annullare l'associazione di ogni accordo che condivide un prefisso libera quel prefisso per l'uso come binding a tasto singolo. Un accordo in qualsiasi contesto attivo mantiene il suo prefisso riservato, quindi è necessario annullare l'associazione di ogni accordo nel contesto che lo definisce.

Claude Code associa questi accordi predefiniti sul prefisso ctrl+x: ctrl+x ctrl+k, ctrl+x ctrl+e, ctrl+x enter, ctrl+x ctrl+a, ctrl+x ctrl+s, e ctrl+x tab in Chat, ctrl+x ctrl+b in Task, e ctrl+x b in DiffPanel. L'accordo ctrl+x enter richiede v2.1.247 o successivo, ctrl+x b, ctrl+x ctrl+a, e ctrl+x tab richiedono v2.1.260 o successivo, e ctrl+x ctrl+s richiede v2.1.275 o successivo.

Per reclamare ctrl+x stesso come binding a tasto singolo, annullare l'associazione di tutti loro:

{
  "bindings": [
    {
      "context": "Task",
      "bindings": {
        "ctrl+x ctrl+b": null
      }
    },
    {
      "context": "DiffPanel",
      "bindings": {
        "ctrl+x b": null
      }
    },
    {
      "context": "Chat",
      "bindings": {
        "ctrl+x ctrl+k": null,
        "ctrl+x ctrl+e": null,
        "ctrl+x enter": null,
        "ctrl+x ctrl+a": null,
        "ctrl+x ctrl+s": null,
        "ctrl+x tab": null,
        "ctrl+x": "chat:newline"
      }
    }
  ]
}

Se annulli l'associazione di alcuni ma non di tutti gli accordi su un prefisso, premere il prefisso entra comunque in modalità di attesa degli accordi per i binding rimanenti.

Scorciatoie riservate

Queste scorciatoie non possono essere riassociate:

Scorciatoia	Motivo
Ctrl+C	Interrupt/annullamento hardcoded
Ctrl+D	Uscita hardcoded
Ctrl+M	Claude Code lo riceve sempre come Invio
Ctrl+[	Claude Code lo riceve sempre come Escape. Nei terminali che utilizzano il protocollo Kitty keyboard, questo richiede v2.1.242 o successivo
Ctrl+I	Claude Code lo riceve sempre come Tab
Ctrl+H	Invia il byte ASCII backspace. Come Claude Code lo legge su Windows dipende dal vostro terminale e dalla variabile di ambiente `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE`
Caps Lock	Non consegnato alle applicazioni terminali

Conflitti del terminale

Alcune scorciatoie potrebbero entrare in conflitto con i multiplexer di terminale:

Scorciatoia	Conflitto
Ctrl+B	Prefisso tmux (premere due volte per inviare)
Ctrl+A	Prefisso GNU screen
Ctrl+Z	Sospensione del processo Unix (SIGTSTP)

Campi di testo

Se associate un carattere, una cifra o uno spazio semplice, potete comunque digitare quel carattere in un campo di testo all'interno di una finestra di dialogo o di un pannello. Uno di questi campi è la risposta Other a una domanda che Claude pone. Mentre il campo ha il focus, un tasto stampabile che premete senza Ctrl, Alt o Cmd va al campo, e Claude Code non lo confronta con le vostre associazioni.

Questi tasti eseguono comunque le loro associazioni mentre il campo ha il focus:

Tasti che non digitano un carattere, come Enter, Escape, Tab e i tasti freccia
Qualsiasi tasto premuto con Ctrl, Alt o Cmd
Il secondo tasto di un accordo già in corso

Al prompt principale, Claude Code confronta ogni tasto rispetto ai contesti attivi, come Chat, e digita il tasto solo quando nessuna associazione lo cattura.

Interazione con la modalità Vim

Quando la modalità vim è abilitata tramite /config → Editor mode, le scorciatoie da tastiera e la modalità vim operano indipendentemente:

Modalità Vim gestisce l'input a livello di input di testo (movimento del cursore, modalità, movimenti)
Scorciatoie da tastiera gestiscono le azioni a livello di componente (attiva/disattiva attività, invia, ecc.)
Il tasto Escape in modalità vim passa da INSERT a NORMAL; non attiva chat:cancel
La maggior parte delle scorciatoie Ctrl+tasto passano attraverso la modalità vim al sistema di scorciatoie da tastiera
I tasti 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, utilizzare l'impostazione vimInsertModeRemaps
In modalità vim NORMAL, ? mostra il menu della guida (comportamento vim)
In modalità vim NORMAL, / apre la ricerca nella cronologia, lo stesso di Ctrl+R in modalità standard

Convalida

Claude Code convalida i tuoi scorciatoie da tastiera e scrive un avviso nel log di debug per:

Errori di analisi (JSON non valido o struttura non valida)
Nomi di contesto non validi
Valori di azione non validi, come un'azione che non è una stringa o null
Nomi di azione sconosciuti, come un errore di battitura di un'azione registrata. Claude Code salta il binding e mantiene in vigore qualsiasi binding predefinito per quel tasto. Prima della v2.1.246, un binding con un nome di azione sconosciuto disabilitava silenziosamente quel tasto
Conflitti di scorciatoie riservate
Binding duplicati nello stesso contesto

Avvia Claude Code con --debug per visualizzare i dettagli.

keybindings.md +94 −73

22| `$docs` | URL della documentazione opzionale |22| `$docs` | URL della documentazione opzionale |

23| `bindings` | Array di blocchi di binding per contesto |23| `bindings` | Array di blocchi di binding per contesto |

24 24

~~25Questo esempio associa `Ctrl+E` per aprire un editor esterno nel contesto della chat e annulla l'associazione di `Ctrl+U`:~~25Questo esempio associa `Ctrl+E` per aprire un editor esterno nel contesto della chat e annulla l'associazione di `Ctrl+S`:

26 26

27```json theme={null}27```json theme={null}

28{28{

29 "$schema": "https://www.schemastore.org/claude-code-keybindings.json",29 "$schema": "https://www.schemastore.org/claude-code-keybindings.json",

~~30 "$docs": "https://code.claude.com/docs/it/keybindings",~~30 "$docs": "https://code.claude.com/docs/en/keybindings",

31 "bindings": [31 "bindings": [

32 {32 {

33 "context": "Chat",33 "context": "Chat",

34 "bindings": {34 "bindings": {

35 "ctrl+e": "chat:externalEditor",35 "ctrl+e": "chat:externalEditor",

~~36 "ctrl+u": null~~36 "ctrl+s": null

37 }37 }

38 }38 }

39 ]39 ]

57| `Help` | Menu della guida è visibile |57| `Help` | Menu della guida è visibile |

58| `Transcript` | Visualizzatore di trascrizione |58| `Transcript` | Visualizzatore di trascrizione |

59| `HistorySearch` | Modalità di ricerca nella cronologia (Ctrl+R) |59| `HistorySearch` | Modalità di ricerca nella cronologia (Ctrl+R) |

61| `ThemePicker` | Dialogo di selezione del tema |61| `ThemePicker` | Dialogo di selezione del tema |

62| `Attachments` | Navigazione degli allegati nei dialoghi di selezione |62| `Attachments` | Navigazione degli allegati nei dialoghi di selezione |

63| `Footer` | Navigazione dell'indicatore di piè di pagina (attività, team, diff, artefatti) |63| `Footer` | Navigazione dell'indicatore di piè di pagina (attività, team, diff, artefatti) |

~~93| `app:toggleTodos` | Ctrl+T | Attiva/disattiva la visibilità dell'elenco delle attività di Claude. Questo non è il [`/tasks`](/docs/it/commands) background-task view |~~93| `app:toggleTodos` | Ctrl+T | Attiva/disattiva la visibilità della lista di controllo delle attività di Claude. Questo non è il [`/tasks`](/docs/it/commands) background-task view |

95 95

96<h3 id="history-actions">96<h3 id="history-actions">

97 Azioni della cronologia97 Azioni della cronologia

103| :- | :- | :- |103| :- | :- | :- |

105| `history:previous` | Su | Elemento della cronologia precedente |105| `history:previous` | Su | Elemento precedente della cronologia |

106| `history:next` | Giù | Elemento della cronologia successivo |106| `history:next` | Giù | Elemento successivo della cronologia |

107 107

108<h3 id="chat-actions">108<h3 id="chat-actions">

109 Azioni della chat109 Azioni della chat

115| :- | :- | :- |115| :- | :- | :- |

118| `chat:clearScreen` | Cmd+K | Uguale a `chat:clearInput`. Vedi [Cancella la conversazione](/docs/it/fullscreen#clear-the-conversation) per come Cmd+K si comporta su iTerm2 e Terminal.app |118| `chat:clearScreen` | Cmd+K | Uguale a `chat:clearInput`. Vedi [Cancella la conversazione](/docs/it/fullscreen#clear-the-conversation) per come Cmd+K si comporta su iTerm2 e Terminal.app |

119| `chat:killAgents` | Ctrl+X Ctrl+K | Termina tutti gli [agenti in background](/docs/it/sub-agents#run-subagents-in-foreground-or-background) in esecuzione in questa sessione e disattiva le [risposte automatiche degli artefatti](/docs/it/artifacts#let-claude-reply-to-comments-on-its-own) per il resto della sessione |119| `chat:killAgents` | Ctrl+X Ctrl+K | Interrompi tutti i [subagent in background](/docs/it/sub-agents#run-subagents-in-foreground-or-background) in questa sessione e disattiva le [risposte automatiche degli artefatti](/docs/it/artifacts#let-claude-reply-to-comments-on-its-own) per il resto della sessione |

125| `chat:queueSubmit` | Ctrl+X Invio | Invia il messaggio, contrassegnato per attendere il suo turno: mentre Claude sta lavorando, Claude Code lo [mette in coda](/docs/it/interactive-mode#queue-messages-while-claude-works) e non interrompe mai il turno. A differenza di `chat:submit`, invia la bozza anche mentre i suggerimenti di autocompletamento sono aperti. Richiede v2.1.247 o successiva |125| `chat:queueSubmit` | Ctrl+X Invio | Invia il messaggio, contrassegnato per attendere il suo turno: mentre Claude sta lavorando, Claude Code lo [mette in coda](/docs/it/interactive-mode#queue-messages-while-claude-works) e non interrompe mai il turno. A differenza di `chat:submit`, invia la bozza anche quando un suggerimento di completamento automatico è evidenziato. Richiede v2.1.247 o successiva |

126| `chat:sendNow` | Ctrl+Invio, Ctrl+X Ctrl+S | Invia i tuoi [messaggi in coda](/docs/it/interactive-mode#queue-messages-while-claude-works) e la tua bozza con essi subito. [Quando Claude Code invia quello che hai messo in coda](/docs/it/interactive-mode#when-claude-code-sends-what-you-queued) copre cosa succede al turno su cui Claude sta lavorando. Quando non è in esecuzione nulla, il tasto invia la bozza, e nella [modalità shell](/docs/it/interactive-mode#shell-mode-with-prefix) mette in coda solo il comando. I terminali che non segnalano tasti estesi consegnano `Ctrl+Invio` come semplice `Invio`, quindi `Ctrl+X Ctrl+S` è il binding che funziona in qualsiasi terminale. Richiede v2.1.275 o successiva |126| `chat:sendNow` | Ctrl+Invio, Ctrl+X Ctrl+S | Invia i tuoi [messaggi in coda](/docs/it/interactive-mode#queue-messages-while-claude-works) e la tua bozza insieme a loro, subito. [Quando Claude Code invia quello che hai messo in coda](/docs/it/interactive-mode#when-claude-code-sends-what-you-queued) copre cosa succede al turno su cui Claude sta lavorando. Quando nulla è in esecuzione, il tasto invia la bozza, e in [shell mode](/docs/it/interactive-mode#shell-mode-with-prefix) mette in coda solo il comando. I terminali che non segnalano tasti estesi consegnano `Ctrl+Invio` come semplice `Invio`, quindi `Ctrl+X Ctrl+S` è l'associazione che funziona in qualsiasi terminale. Richiede v2.1.275 o successiva |

129| `chat:externalEditor` | Ctrl+G, Ctrl+X Ctrl+E | Apri nell'editor esterno. Il [dispatch input della visualizzazione dell'agente](/docs/it/agent-view#keyboard-shortcuts) segue anche i binding a singola pressione di tasto di questa azione |129| `chat:externalEditor` | Ctrl+G, Ctrl+X Ctrl+E | Apri nell'editor esterno. Il [dispatch input della vista agente](/docs/it/agent-view#keyboard-shortcuts) segue anche le associazioni a singolo tasto di questa azione |

132 132

133\*Su Windows senza modalità VT (Node \<24.2.0/\<22.17.0, Bun \<1.2.23), il valore predefinito è Meta+M.133\*Su Windows senza modalità VT (Node \<24.2.0/\<22.17.0, Bun \<1.2.23), il valore predefinito è Meta+M.

134 134

135<h3 id="autocomplete-actions">135<h3 id="autocomplete-actions">

136 Azioni di autocompletamento136 Azioni di completamento automatico

137</h3>137</h3>

138 138

139Azioni disponibili nel contesto `Autocomplete`:139Azioni disponibili nel contesto `Autocomplete`:

160| `confirm:nextField` | Tab | Campo successivo |160| `confirm:nextField` | Tab | Campo successivo |

163| `confirm:cycleMode` | Shift+Tab\* | Cicla le modalità di permesso. Su un prompt di permesso file, chiude un [campo commento](/docs/it/permissions#add-a-comment-when-you-answer-a-permission-prompt) aperto; senza campo aperto, seleziona l'opzione che consente l'azione per il resto della sessione, quando il prompt offre tale opzione |163| `confirm:cycleMode` | Shift+Tab\* | Cicla le modalità di autorizzazione. Su un prompt di autorizzazione file, chiude un [campo commento](/docs/it/permissions#add-a-comment-when-you-answer-a-permission-prompt) aperto; senza campo aperto, seleziona l'opzione che consente l'azione per il resto della sessione, quando il prompt offre tale opzione |

164 164

165\*Su Windows senza modalità VT (Node \<24.2.0/\<22.17.0, Bun \<1.2.23), il valore predefinito è Meta+M.165\*Su Windows senza modalità VT (Node \<24.2.0/\<22.17.0, Bun \<1.2.23), il valore predefinito è Meta+M.

166 166

167Prima della v2.1.257, un'azione `confirm:toggleExplanation`, associata a `Ctrl+E` per impostazione predefinita, mostrava una spiegazione generata dal modello del comando sui prompt di permesso Bash e PowerShell.167Prima della v2.1.257, un'azione `confirm:toggleExplanation`, associata a `Ctrl+E` per impostazione predefinita, mostrava una spiegazione generata dal modello del comando su prompt di autorizzazione Bash e PowerShell.

168

169I dialoghi utilizzano `confirm:yes` e `confirm:no` per accettare e annullare anche quando non pongono una domanda sì-o-no. Se associ una lettera semplice come `y` o `n` in questo contesto, la lettera agisce anche su dialoghi che non la mostrano mai come tasto. Un dialogo che mostra `y` e `n` come suoi tasti legge quelle lettere stesso e non ha bisogno di alcuna associazione.

168 170

169I dialoghi utilizzano `confirm:yes` e `confirm:no` per accettare e annullare anche quando non pongono una domanda sì o no. Se associ una lettera semplice come `y` o `n` in questo contesto, la lettera agisce anche su dialoghi che non la mostrano mai come tasto. Un dialogo che mostra `y` e `n` come suoi tasti legge quelle lettere stesso e non ha bisogno di alcun binding.171Nella maggior parte dei dialoghi, premere `Ctrl+C` o `Ctrl+D` due volte chiude il dialogo invece di uscire da Claude Code. L'hint dopo il primo pressione dice se il secondo pressione chiude il dialogo o esce. Entrambi i tasti sono [riservati](#reserved-shortcuts) e non possono essere riassociati.

170 172

171Questo esempio associa `y` a `confirm:yes` e `n` a `confirm:no`:173Questo esempio associa `y` a `confirm:yes` e `n` a `confirm:no`:

172 174

184}186}

185```187```

186 188

187Con questi binding, `y` e `n` continuano a digitarsi come lettere mentre un [campo di testo](#text-fields) ha il focus.189Con queste associazioni, `y` e `n` continuano a digitare come lettere mentre un [campo di testo](#text-fields) ha il focus.

188 190

189Prima della v2.1.280, `y` era anche associato a `confirm:yes` e `n` a `confirm:no` per impostazione predefinita. Se hai creato il tuo `keybindings.json` con `/keybindings` prima della v2.1.280, il file elenca entrambi i binding e rimangono in vigore finché non elimini quelle due righe.191Prima della v2.1.280, `y` era anche associato a `confirm:yes` e `n` a `confirm:no` per impostazione predefinita. Se hai creato il tuo `keybindings.json` con `/keybindings` prima della v2.1.280, il file elenca entrambe le associazioni e rimangono in vigore finché non elimini quelle due righe.

190 192

191<h3 id="permission-actions">193<h3 id="permission-actions">

192 Azioni di permesso194 Azioni di autorizzazione

193</h3>195</h3>

194 196

195Azioni disponibili nel contesto `Confirmation` per i dialoghi di permesso:197Azioni disponibili nel contesto `Confirmation` per i dialoghi di autorizzazione:

196 198

198| :- | :- | :- |200| :- | :- | :- |

199| `permission:toggleDebug` | (non associato) | Attiva/disattiva le informazioni di debug del permesso. Il valore predefinito precedente di Ctrl+D è stato rimosso nella v2.1.146 perché oscurava `app:exit` |201| `permission:toggleDebug` | (non associato) | Attiva/disattiva le informazioni di debug dell'autorizzazione. Il valore predefinito precedente di Ctrl+D è stato rimosso nella v2.1.146 perché oscurava `app:exit` |

200 202

201<h3 id="transcript-actions">203<h3 id="transcript-actions">

202 Azioni di trascrizione204 Azioni del trascritto

203</h3>205</h3>

204 206

205Azioni disponibili nel contesto `Transcript`:207Azioni disponibili nel contesto `Transcript`:

206 208

208| :- | :- | :- |210| :- | :- | :- |

211 213

212`transcript:toggleShowAll` si applica solo nel renderer classico; nel [rendering a schermo intero](/docs/it/fullscreen), il visualizzatore di trascrizione non offre un'opzione di visualizzazione completa.214`transcript:toggleShowAll` si applica solo nel renderer classico; nel [rendering a schermo intero](/docs/it/fullscreen), il visualizzatore di trascritti non offre un'opzione di mostra tutto.

213 215

214<h3 id="history-search-actions">216<h3 id="history-search-actions">

215 Azioni di ricerca nella cronologia217 Azioni di ricerca nella cronologia

235 237

237| :- | :- | :- |239| :- | :- | :- |

239 241

240<h3 id="theme-actions">242<h3 id="theme-actions">

241 Azioni del tema243 Azioni del tema

270 272

273In una finestra di dialogo con schede, `tabs:next` e `tabs:previous` cambiano le schede mentre la riga delle schede ha il focus. In alcuni dialoghi, come `/help` e `/sandbox`, i tasti di cambio scheda funzionano anche dall'interno del contenuto della scheda.

274

275`Su` e `Giù` spostano il focus tra la riga delle schede e il contenuto della scheda, e un elenco nel contenuto risponde ai tasti solo mentre ha il focus.

276

271<h3 id="attachments-actions">277<h3 id="attachments-actions">

272 Azioni degli allegati278 Azioni degli allegati

273</h3>279</h3>

295| `footer:down` | Giù | Naviga verso il basso nel piè di pagina |301| `footer:down` | Giù | Naviga verso il basso nel piè di pagina |

298| `footer:dismiss` | Backspace, Canc | Chiudi il collegamento [artefatto](/docs/it/artifacts) selezionato dal piè di pagina; l'artefatto pubblicato stesso non è interessato. Su altre righe del piè di pagina, questi tasti non hanno effetto. Richiede v2.1.217 o successiva |304| `footer:dismiss` | (non associato) | Rimosso nella v2.1.281. Un `keybindings.json` che nomina ancora l'azione rimane valido e l'associazione non fa nulla. Prima della v2.1.281, Backspace e Canc chiudevano il collegamento dell'artefatto selezionato dal piè di pagina |

299 305

300Mentre un elemento del piè di pagina è selezionato, come una riga nel pannello dell'agente sotto il prompt, `Invio` lo apre anche quando riassoci `Invio` nel contesto `Chat` a `chat:queueSubmit` o `chat:newline`.306Mentre un elemento del piè di pagina è selezionato, come una riga nel pannello dell'agente sotto il prompt, `Invio` lo apre anche quando riassoci `Invio` nel contesto `Chat` a `chat:queueSubmit` o `chat:newline`.

301 307

302I binding `Chat` su tasti che il contesto `Footer` non associa, come `Shift+Tab` per `chat:cycleMode`, continuano a funzionare mentre un elemento è selezionato.308Le associazioni `Chat` sui tasti che il contesto `Footer` non associa, come `Shift+Tab` per `chat:cycleMode`, continuano a funzionare mentre un elemento è selezionato.

303 309

304<h3 id="message-selector-actions">310<h3 id="message-selector-actions">

305 Azioni del selezionatore di messaggi311 Azioni del selezionatore di messaggi

306</h3>312</h3>

307 313

308Azioni disponibili nel contesto `MessageSelector`:314Nel messaggio elenco del [menu di rewind](/docs/it/checkpointing), ti muovi attraverso i messaggi e ne scegli uno con le [azioni di selezione](#select-actions) e i loro tasti predefiniti. Le tue associazioni `Select` per quelle azioni si applicano anche lì. Il contesto `MessageSelector` non ha azioni o associazioni predefinite proprie. Usalo per cambiare un tasto per questo elenco solo, associando un'azione Select come `select:accept` in un blocco `MessageSelector`.

309 315

310| Azione | Predefinito | Descrizione |316Questo esempio associa `o` per scegliere il messaggio evidenziato nel menu di rewind, senza cambiare nessun altro elenco:

311| :- | :- | :- |317

312| `messageSelector:up` | Su, K, Ctrl+P | Sposta verso l'alto nell'elenco |318```json theme={null}

313| `messageSelector:down` | Giù, J, Ctrl+N | Sposta verso il basso nell'elenco |319{

314| `messageSelector:top` | Ctrl+Su, Shift+Su, Meta+Su, Shift+K | Salta all'inizio |320 "bindings": [

315| `messageSelector:bottom` | Ctrl+Giù, Shift+Giù, Meta+Giù, Shift+J | Salta alla fine |321 {

316| `messageSelector:select` | Invio | Seleziona il messaggio |322 "context": "MessageSelector",

323 "bindings": {

324 "o": "select:accept"

325 }

326 }

327 ]

328}

329```

330

331Prima della v2.1.283, questo elenco ignorava le associazioni `Select` e aveva le sue azioni: `messageSelector:up`, `messageSelector:down`, `messageSelector:top`, `messageSelector:bottom` e `messageSelector:select`. Se il tuo `keybindings.json` associa uno di quei nomi, l'associazione continua a funzionare in questo elenco come l'azione Select che fa la stessa cosa. `Home` e `End` saltano a entrambe le estremità dell'elenco; prima della v2.1.283, tasti come `Shift+K` e `Shift+J` lo facevano per impostazione predefinita.

317 332

318<h3 id="diff-actions">333<h3 id="diff-actions">

319 Azioni diff334 Azioni diff

323 338

325| :- | :- | :- |340| :- | :- | :- |

329| `diff:previousFile` | Su, K | File precedente nell'elenco dei file; scorri verso l'alto di una riga nella visualizzazione dei dettagli |344| `diff:previousFile` | Su, K | File precedente nell'elenco dei file; scorri verso l'alto di una riga nella vista dettagli |

332| `diff:back` | (non associato) | Torna indietro nel visualizzatore diff. Escape esegue l'azione indietro tramite `diff:dismiss`. Il valore predefinito precedente di Sinistra nella visualizzazione dei dettagli è stato rimosso nella v2.1.203 |347

348L'elenco dei file risponde anche alle [azioni di selezione](#select-actions), attraverso i loro tasti predefiniti e le tue associazioni `Select`. `select:previous` e `select:next` si spostano al file precedente e successivo, e `Invio` apre il diff del file selezionato tramite `select:accept`. Per cambiare uno di quei tasti per l'elenco dei file solo, associa l'azione Select in un blocco `DiffDialog`.

349

350Prima della v2.1.283, l'elenco dei file ignorava le associazioni `Select`, e `Invio` apriva il diff del file selezionato tramite un'azione `diff:viewDetails` separata. Se il tuo `keybindings.json` associa `diff:viewDetails`, l'associazione continua a funzionare nell'elenco dei file come `select:accept`.

333 351

334La visualizzazione dei dettagli diff associa anche i tasti in stile pager alle [azioni di scorrimento](#scroll-actions) standard. Questi binding fanno parte del contesto `DiffDialog` e si applicano solo nella visualizzazione dei dettagli; i valori predefiniti del contesto `Scroll` elencati in [Azioni di scorrimento](#scroll-actions) rimangono invariati.352La vista dettagli diff associa anche i tasti in stile pager alle [azioni di scorrimento](#scroll-actions) standard. Queste associazioni fanno parte del contesto `DiffDialog` e si applicano solo nella vista dettagli; i valori predefiniti del contesto `Scroll` elencati in [Azioni di scorrimento](#scroll-actions) rimangono invariati.

335 353

337| :- | :- | :- |355| :- | :- | :- |

344 362

345<h3 id="diff-panel-actions">363<h3 id="diff-panel-actions">

346 Azioni del pannello diff364 Azioni del pannello diff

373 Azioni del cursore di sforzo391 Azioni del cursore di sforzo

374</h3>392</h3>

375 393

376Azioni disponibili nel contesto `EffortSlider`, il cursore che si apre quando esegui `/effort` senza argomenti. I tasti Sinistra, Destra, Invio ed Escape del cursore non possono essere riassociati.394Azioni disponibili nel contesto `EffortSlider`, il cursore che si apre quando esegui `/effort` senza argomenti. I tasti Invio ed Escape del cursore non possono essere riassociati.

377 395

379| :- | :- | :- |397| :- | :- | :- |

398| `effortSlider:decreaseEffort` | Sinistra | Sposta il cursore al livello di sforzo successivo inferiore. Richiede v2.1.284 o successiva |

399| `effortSlider:increaseEffort` | Destra | Sposta il cursore al livello di sforzo successivo superiore. Richiede v2.1.284 o successiva |

400| `effortSlider:toggleUltracode` | Tab | Attiva/disattiva [ultracode](/docs/it/workflows#let-claude-decide-with-ultracode) per questa sessione, quando il cursore lo [offre](/docs/it/model-config#when-ultracode-is-available). Richiede v2.1.284 o successiva |

380| `effortSlider:thisSessionOnly` | s | Applica il [livello di sforzo](/docs/it/model-config#adjust-effort-level) focalizzato solo a questa sessione. Richiede v2.1.257 o successiva |401| `effortSlider:thisSessionOnly` | s | Applica il [livello di sforzo](/docs/it/model-config#adjust-effort-level) focalizzato solo a questa sessione. Richiede v2.1.257 o successiva |

381 402

382<h3 id="select-actions">403<h3 id="select-actions">

398 419

399Claude Code applica i tuoi binding `select:pageUp`, `select:pageDown`, `select:first` e `select:last` nel menu `/skills`. Nella maggior parte degli altri elenchi, come il selezionatore `/model`, i tuoi binding `select:first` e `select:last` si applicano. PagSu e PagGiù scorrono le opzioni in quegli elenchi indipendentemente dai tuoi binding.420Nei pannelli elenco come `/skills` e `/mcp`, Claude Code applica le tue associazioni `select:pageUp`, `select:pageDown`, `select:first` e `select:last`. Nella maggior parte degli altri elenchi, come il selezionatore `/model`, si applicano le tue associazioni `select:first` e `select:last`. PagSu e PagGiù scorrono le opzioni in quegli elenchi indipendentemente dalle tue associazioni.

400 421

401Prima della v2.1.280, quegli altri elenchi ignoravano Home, Fine e i tuoi binding `select:first` e `select:last`.422Prima della v2.1.280, quegli altri elenchi ignoravano Home, Fine e le tue associazioni `select:first` e `select:last`.

402 423

403<h3 id="plugin-actions">424<h3 id="plugin-actions">

404 Azioni dei plugin425 Azioni dei plugin

410| :- | :- | :- |431| :- | :- | :- |

412| `plugin:install` | I | Installa i plugin selezionati |433| `plugin:install` | I | Installa i plugin selezionati |

413| `plugin:favorite` | F | Aggiungi ai preferiti il plugin selezionato in modo che si ordini vicino alla parte superiore della scheda Installati |434| `plugin:favorite` | F | Contrassegna il plugin selezionato come preferito in modo che si ordini vicino alla parte superiore della scheda Installato |

414 435

415<h3 id="settings-actions">436<h3 id="settings-actions">

416 Azioni delle impostazioni437 Azioni delle impostazioni

417</h3>438</h3>

418 439

419Azioni disponibili nel contesto `Settings`. Le azioni `select:accept` e `confirm:no` vengono riutilizzate dai contesti [Select](#select-actions) e [Confirmation](#confirmation-actions) con comportamento specifico delle impostazioni: le modifiche si applicano a ogni impostazione non appena la modifichi, quindi Escape chiude il pannello con le modifiche salvate piuttosto che rifiutarle.440Azioni disponibili nel contesto `Settings`. Le azioni `select:accept` e `confirm:no` vengono riutilizzate dai contesti [Select](#select-actions) e [Confirmation](#confirmation-actions) con comportamento specifico delle impostazioni: le modifiche si applicano a ogni impostazione non appena la modifichi, quindi Escape chiude il pannello con le tue modifiche salvate piuttosto che rifiutare.

420 441

422| :- | :- | :- |443| :- | :- | :- |

429 Azioni degli agenti450 Azioni degli agenti

430</h3>451</h3>

431 452

432Azioni disponibili nel contesto `Agents`, che si applica nella [visualizzazione dell'agente](/docs/it/agent-view), aperta con `claude agents`. Richiede v2.1.257 o successiva.453Azioni disponibili nel contesto `Agents`, che si applica nella [vista agente](/docs/it/agent-view), aperta con `claude agents`. Richiede v2.1.257 o successiva.

433 454

435| :- | :- | :- |456| :- | :- | :- |

438 459

439Mentre la visualizzazione dell'agente è aperta, Claude Code utilizza il binding `Agents` per qualsiasi tasto che il contesto `Agents` associa, e ignora un binding `Chat` o `Global` sulla stessa chiave. Ad esempio, premendo Ctrl+S nella visualizzazione dell'agente si cambia il raggruppamento della sessione piuttosto che attivare il valore predefinito `chat:stash`.460Mentre la vista agente è aperta, Claude Code utilizza l'associazione `Agents` per qualsiasi tasto che il contesto `Agents` associa, e ignora un'associazione `Chat` o `Global` sulla stessa chiave. Ad esempio, premere Ctrl+S nella vista agente cambia il raggruppamento della sessione piuttosto che attivare il valore predefinito `chat:stash`.

440 461

441La scorciatoia dell'editor esterno dell'input di dispatch non è un'azione `Agents`. La visualizzazione dell'agente segue il binding `chat:externalEditor` del contesto `Chat`, Ctrl+G per impostazione predefinita.462La scorciatoia dell'editor esterno dell'input di dispatch non è un'azione `Agents`. La vista agente segue l'associazione `chat:externalEditor` del contesto `Chat`, Ctrl+G per impostazione predefinita.

442 463

443I binding si attivano su singole pressioni di tasto nella visualizzazione dell'agente, quindi l'accordo Ctrl+X Ctrl+E associato a `chat:externalEditor` non apre l'editor lì.464Le associazioni si attivano su singoli tasti nella vista agente, quindi l'accordo Ctrl+X Ctrl+E associato a `chat:externalEditor` non apre l'editor lì.

444 465

445<h3 id="voice-actions">466<h3 id="voice-actions">

446 Azioni vocali467 Azioni vocali

450 471

452| :- | :- | :- |473| :- | :- | :- |

454 475

455<h3 id="scroll-actions">476<h3 id="scroll-actions">

456 Azioni di scorrimento477 Azioni di scorrimento

460 481

462| :- | :- | :- |483| :- | :- | :- |

469| `scroll:halfPageUp` | (non associato) | Scorri verso l'alto della metà dell'altezza del viewport. Stesso comportamento di `scroll:pageUp`, fornito per i rebind in stile vi |490| `scroll:halfPageUp` | (non associato) | Scorri verso l'alto di mezza altezza della finestra. Stesso comportamento di `scroll:pageUp`, fornito per riassociazioni in stile vi |

470| `scroll:halfPageDown` | (non associato) | Scorri verso il basso della metà dell'altezza del viewport. Stesso comportamento di `scroll:pageDown`, fornito per i rebind in stile vi |491| `scroll:halfPageDown` | (non associato) | Scorri verso il basso di mezza altezza della finestra. Stesso comportamento di `scroll:pageDown`, fornito per riassociazioni in stile vi |

481 502

668 Convalida689 Convalida

669</h2>690</h2>

670 691

671Claude Code convalida i tuoi keybindings e mostra avvisi per:692Claude Code convalida i tuoi scorciatoie da tastiera e scrive un avviso nel log di debug per:

672 693

673* Errori di analisi (JSON non valido o struttura non valida)694* Errori di analisi (JSON non valido o struttura non valida)

674* Nomi di contesto non validi695* Nomi di contesto non validi

677* Conflitti di scorciatoie riservate698* Conflitti di scorciatoie riservate

678* Binding duplicati nello stesso contesto699* Binding duplicati nello stesso contesto

679 700

680Claude Code segnala avvisi quando il file viene caricato e scrive ognuno nel log di debug. Avvia Claude Code con [`--debug`](/docs/it/cli-reference#cli-flags) per visualizzare i dettagli.701Avvia Claude Code con [`--debug`](/docs/it/cli-reference#cli-flags) per visualizzare i dettagli.

keybindings.md 2026-09-28 22:59 UTC to 2026-09-29 21:59 UTC

Personalizzare le scorciatoie da tastiera

File di configurazione

Contesti

Azioni disponibili

Azioni dell'app

Azioni della cronologia

Azioni della chat

Azioni di completamento automatico

Azioni di conferma

Azioni di autorizzazione

Azioni del trascritto

Azioni di ricerca nella cronologia

Azioni delle attività

Azioni del tema

Azioni della guida

Azioni delle schede

Azioni degli allegati

Azioni del piè di pagina

Azioni del selezionatore di messaggi

Azioni diff

Azioni del pannello diff

Azioni del selezionatore di modelli

Azioni del cursore di sforzo

Azioni di selezione

Azioni dei plugin

Azioni delle impostazioni

Azioni degli agenti

Azioni vocali

Azioni di scorrimento

Sintassi delle sequenze di tasti

Modificatori

Lettere maiuscole

Layout di tastiera non US

Accordi

Tasti speciali

Annulla l'associazione delle scorciatoie predefinite

Scorciatoie riservate

Conflitti del terminale

Campi di testo

Interazione con la modalità Vim

Convalida