Personalizzare le scorciatoie da tastiera

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.

Le modifiche al file keybindings vengono rilevate automaticamente e applicate senza riavviare Claude Code.

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)	Associare un tasto a questa azione non ha alcun effetto, e un `keybindings.json` che la nomina rimane valido. Prima della v2.1.281, Backspace e Canc erano associati a essa e 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, /mcp e /tasks, 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. Prima della v2.1.283, l’elenco degli strumenti /mcp scorreva con tasti PageUp e PageDown fissi indipendentemente dalle tue associazioni.

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

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)
Modificatori scritti male, come ctl+k. Claude Code elimina la parte che non riconosce e applica il binding al tasto rimanente, k in questo esempio.
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.
Conflitti di scorciatoie riservate
Binding duplicati nello stesso contesto

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

​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

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