Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Le scorciatoie da tastiera personalizzabili richiedono Claude Code v2.1.18 o versioni successive. Controllare la versione con claude --version.
/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 |
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) |
MessageSelector | Selezione dei messaggi nella finestra di dialogo di riavvolgimento e riepilogo |
DiffDialog | Navigazione del visualizzatore diff |
ModelPicker | Livello di sforzo del selezionatore di modelli |
Select | Componenti generici di selezione/elenco |
Plugin | Dialogo dei plugin (sfoglia, scopri, gestisci) |
Scroll | Scorrimento della conversazione e selezione del testo in modalità a schermo intero |
Doctor | 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 |
app:redraw | (non associato) | Forza il ridisegno del terminale |
app:toggleTodos | Ctrl+T | Attiva/disattiva la visibilità dell’elenco delle attività |
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. Nel rendering a schermo intero, premi due volte entro due secondi per eseguire /clear |
chat:clearScreen | Cmd+K | Nel rendering a schermo intero, premi due volte entro due secondi per eseguire /clear |
chat:killAgents | Ctrl+X Ctrl+K | Termina tutti gli agenti in background in esecuzione in questa 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: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 |
chat:stash | Ctrl+S | Nascondi il prompt corrente |
chat:imagePaste | Ctrl+V (Alt+V su Windows) | Incolla immagine |
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 | Y, Invio | Conferma l’azione |
confirm:no | N, 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 |
confirm:toggleExplanation | Ctrl+E | Attiva/disattiva la spiegazione del permesso |
Azioni di permesso
Azioni disponibili nel contesto Confirmation per i dialoghi di permesso:
| Azione | Predefinito | Descrizione |
|---|
permission:toggleDebug | Ctrl+D | Attiva/disattiva le informazioni di debug del permesso |
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 |
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 |
Azioni delle attività
Azioni disponibili nel contesto Task:
| Azione | Predefinito | Descrizione |
|---|
task:background | Ctrl+B | Attività in background corrente |
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 |
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 |
diff:previousSource | Sinistra | Sorgente diff precedente |
diff:nextSource | Destra | Sorgente diff successiva |
diff:previousFile | Su | File precedente nel diff |
diff:nextFile | Giù | File successivo nel diff |
diff:viewDetails | Invio | Visualizza i dettagli del diff |
diff:back | (specifico del contesto) | Torna indietro nel visualizzatore diff |
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:setAsDefault | d | Imposta il modello evidenziato come predefinito per le nuove sessioni |
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:accept | Invio | Accetta la selezione |
select:cancel | Escape | Annulla la selezione |
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:
| Azione | Predefinito | Descrizione |
|---|
settings:search | / | Entra in modalità di ricerca |
settings:retry | R | Riprova a caricare i dati di utilizzo (in caso di errore) |
settings:close | Invio | Salva le modifiche e chiudi il pannello di configurazione. Escape scarta le modifiche e chiude |
Azioni del Doctor
Azioni disponibili nel contesto Doctor:
| Azione | Predefinito | Descrizione |
|---|
doctor:fix | F | Invia il rapporto diagnostico a Claude per correggere i problemi segnalati. Attivo solo quando vengono trovati problemi |
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 | (non associato) | Scorri verso l’alto di una riga. Lo scorrimento con la rotella del mouse attiva questa azione |
scroll:lineDown | (non associato) | 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 |
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 +:
ctrl o control - Tasto Controlshift - Tasto Shiftalt, opt, option, o meta - Tasto Alt su Windows e Linux, tasto Option su macOScmd, 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
Una lettera maiuscola autonoma implica Shift. Ad esempio, K è equivalente a shift+k. Questo è utile per i binding in stile vim dove i tasti maiuscoli e minuscoli hanno significati diversi.
Le lettere maiuscole con modificatori (ad es. ctrl+K) sono trattate come stilistiche e non implicano Shift: ctrl+K è lo stesso di ctrl+k.
Accordi
Gli accordi sono sequenze di tasti separate da spazi:
ctrl+k ctrl+s Premi Ctrl+K, rilascia, quindi Ctrl+S
Tasti speciali
escape o esc - Tasto Escapeenter o return - Tasto Inviotab - Tasto Tabspace - Barra spaziatriceup, down, left, right - Tasti frecciabackspace, delete - Tasti Canc
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
}
}
]
}
{
"bindings": [
{
"context": "Chat",
"bindings": {
"ctrl+x ctrl+k": null,
"ctrl+x ctrl+e": null,
"ctrl+x": "chat:newline"
}
}
]
}
Scorciatoie riservate
Queste scorciatoie non possono essere riassociate:
| Scorciatoia | Motivo |
|---|
| Ctrl+C | Interrupt/annullamento hardcoded |
| Ctrl+D | Uscita hardcoded |
| Ctrl+M | Identico a Invio nei terminali (entrambi inviano CR) |
| 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) |
Interazione con la modalità Vim
Quando la modalità vim è abilitata tramite /config → Editor mode, i keybindings e la modalità vim operano indipendentemente:
- Modalità Vim gestisce l’input a livello di input di testo (movimento del cursore, modalità, movimenti)
- Keybindings gestisce 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 keybinding
- In modalità vim NORMAL,
? mostra il menu della guida (comportamento vim)
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
- Conflitti di scorciatoie riservate
- Conflitti di multiplexer di terminale
- Binding duplicati nello stesso contesto
Eseguire /doctor per visualizzare eventuali avvisi di keybinding.
