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+U:
{
"$schema": "https://www.schemastore.org/claude-code-keybindings.json",
"$docs": "https://code.claude.com/docs/it/keybindings",
"bindings": [
{
"context": "Chat",
"bindings": {
"ctrl+e": "chat:externalEditor",
"ctrl+u": 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 |
Attività in background in esecuzione |
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à dell'elenco delle attività di Claude. Questo non è il /tasks background-task view |
app:toggleTranscript |
Ctrl+O | Attiva/disattiva la trascrizione dettagliata |
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 della cronologia precedente |
history:next |
Giù | Elemento della cronologia successivo |
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 a schermo intero, 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 | Termina tutti gli agenti in background in esecuzione in questa sessione e disattiva le risposte automatiche degli artefatti per il resto della sessione |
chat:cycleMode |
Shift+Tab* | Cicla le modalità di permesso |
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 mentre i suggerimenti di autocompletamento sono aperti. Richiede v2.1.247 o successiva |
chat:sendNow |
Ctrl+Invio, Ctrl+X Ctrl+S | Invia i tuoi messaggi in coda e la tua bozza con essi subito. Quando Claude Code invia quello che hai messo in coda copre cosa succede al turno su cui Claude sta lavorando. Quando non è in esecuzione nulla, il tasto invia la bozza, e nella modalità shell 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 |
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 visualizzazione dell'agente segue anche i binding a singola pressione di tasto di questa azione |
chat:stash |
Ctrl+S | Nascondi il prompt corrente |
chat:imagePaste |
Ctrl+V (Alt+V su Windows e WSL) | Incolla 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 autocompletamento
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 permesso. Su un prompt di permesso 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 sui prompt di permesso 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 alcun binding.
Questo esempio associa y a confirm:yes e n a confirm:no:
{
"bindings": [
{
"context": "Confirmation",
"bindings": {
"y": "confirm:yes",
"n": "confirm:no"
}
}
]
}
Con questi binding, y e n continuano a digitarsi 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 entrambi i binding e rimangono in vigore finché non elimini quelle due righe.
Azioni di permesso
Azioni disponibili nel contesto Confirmation per i dialoghi di permesso:
| Azione | Predefinito | Descrizione |
|---|---|---|
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 |
Azioni di trascrizione
Azioni disponibili nel contesto Transcript:
| Azione | Predefinito | Descrizione |
|---|---|---|
transcript:toggleShowAll |
Ctrl+E | Attiva/disattiva la visualizzazione di tutto il contenuto |
transcript:exit |
q, Ctrl+C, Escape | Esci dalla visualizzazione della trascrizione |
transcript:toggleShowAll si applica solo nel renderer classico; nel rendering a schermo intero, il visualizzatore di trascrizione non offre un'opzione di visualizzazione completa.
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 | Attività in background corrente. 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 |
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 del piè di pagina
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 |
Backspace, Canc | Chiudi il collegamento artefatto 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 |
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.
I binding Chat su 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
Azioni disponibili nel contesto MessageSelector:
| Azione | Predefinito | Descrizione |
|---|---|---|
messageSelector:up |
Su, K, Ctrl+P | Sposta verso l'alto nell'elenco |
messageSelector:down |
Giù, J, Ctrl+N | Sposta verso il basso nell'elenco |
messageSelector:top |
Ctrl+Su, Shift+Su, Meta+Su, Shift+K | Salta all'inizio |
messageSelector:bottom |
Ctrl+Giù, Shift+Giù, Meta+Giù, Shift+J | Salta alla fine |
messageSelector:select |
Invio | Seleziona il messaggio |
Azioni diff
Azioni disponibili nel contesto DiffDialog:
| Azione | Predefinito | Descrizione |
|---|---|---|
diff:dismiss |
Escape | Chiudi il visualizzatore diff; dalla visualizzazione dei dettagli, torna 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 visualizzazione dei dettagli |
diff:nextFile |
Giù, J | File successivo nell'elenco dei file; scorri verso il basso di una riga nella visualizzazione dei dettagli |
diff:viewDetails |
Invio | Visualizza i dettagli del diff |
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 |
La visualizzazione dei dettagli diff associa anche i tasti in stile pager alle azioni di scorrimento 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 rimangono invariati.
| Azione | Predefinito | Descrizione |
|---|---|---|
scroll:pageUp |
PagSu | Scorri verso l'alto della metà del viewport |
scroll:pageDown |
PagGiù | Scorri verso il basso della metà del viewport |
scroll:fullPageUp |
Shift+Spazio, B | Scorri verso l'alto di un viewport completo |
scroll:fullPageDown |
Spazio | Scorri verso il basso di un viewport completo |
scroll:top |
G, Home | Salta all'inizio |
scroll:bottom |
Shift+G, Fine | Salta alla fine |
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 Sinistra, Destra, Invio ed Escape del cursore non possono essere riassociati.
| Azione | Predefinito | Descrizione |
|---|---|---|
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 |
Claude 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.
Prima della v2.1.280, quegli altri elenchi ignoravano Home, Fine e i tuoi binding 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 | Aggiungi ai preferiti il plugin selezionato in modo che si ordini vicino alla parte superiore della scheda Installati |
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 modifiche salvate piuttosto che rifiutarle.
| 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 visualizzazione dell'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 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.
La 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.
I 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ì.
Azioni vocali
Azioni disponibili nel contesto Chat quando la dettatura vocale è abilitata:
| Azione | Predefinito | Descrizione |
|---|---|---|
voice:pushToTalk |
Spazio | 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 con la rotella del mouse attiva questa azione |
scroll:lineDown |
wheeldown |
Scorri verso il basso di una riga. Lo scorrimento con la rotella del mouse attiva questa azione |
scroll:pageUp |
PagSu | Scorri verso l'alto della metà dell'altezza del viewport |
scroll:pageDown |
PagGiù | Scorri verso il basso della metà dell'altezza del viewport |
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 della metà dell'altezza del viewport. Stesso comportamento di scroll:pageUp, fornito per i rebind in stile vi |
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 |
scroll:fullPageUp |
(non associato) | Scorri verso l'alto dell'intera altezza del viewport |
scroll:fullPageDown |
(non associato) | Scorri verso il basso dell'intera altezza del viewport |
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 il viewport quando la selezione raggiunge il bordo superiore |
selection:extendDown |
Shift+Giù | Estendi la selezione attiva di una riga verso il basso. Scorri il viewport 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 +:
ctrlocontrol- Tasto Controlshift- Tasto Shiftalt,opt,option, ometa- Tasto Alt su Windows e Linux, tasto Option su macOScmd,command,super, owin- 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
escapeoesc- Tasto Escapeenteroreturn- Tasto Inviotab- Tasto Tabspace- Barra spaziatriceup,down,left,right- Tasti frecciapageup,pagedown- Tasti Pagina Su e Pagina Giùhome,end- Tasti Home e Finebackspace,delete- Tasti Cancwheelup,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
jjsu Escape, utilizzare l'impostazionevimInsertModeRemaps - 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 keybindings e mostra avvisi 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
Claude Code segnala avvisi quando il file viene caricato e scrive ognuno nel log di debug. Avvia Claude Code con --debug per visualizzare i dettagli.