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.

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:

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:

Azioni della cronologia

Azioni per navigare nella cronologia dei comandi:

Azioni della chat

Azioni disponibili nel contesto Chat:

*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:

Azioni di conferma

Azioni disponibili nel contesto Confirmation:

Azioni di permesso

Azioni disponibili nel contesto Confirmation per i dialoghi di permesso:

Azioni di trascrizione

Azioni disponibili nel contesto Transcript:

Azioni di ricerca nella cronologia

Azioni disponibili nel contesto HistorySearch:

Azioni delle attività

Azioni disponibili nel contesto Task:

Azioni del tema

Azioni disponibili nel contesto ThemePicker:

Azioni della guida

Azioni disponibili nel contesto Help:

Azioni delle schede

Azioni disponibili nel contesto Tabs:

Azioni degli allegati

Azioni disponibili nel contesto Attachments:

Azioni del piè di pagina

Azioni disponibili nel contesto Footer:

Azioni del selezionatore di messaggi

Azioni disponibili nel contesto MessageSelector:

Azioni diff

Azioni disponibili nel contesto DiffDialog:

Azioni del selezionatore di modelli

Azioni disponibili nel contesto ModelPicker:

Azioni di selezione

Azioni disponibili nel contesto Select:

Azioni dei plugin

Azioni disponibili nel contesto Plugin:

Azioni delle impostazioni

Azioni disponibili nel contesto Settings:

Azioni del Doctor

Azioni disponibili nel contesto Doctor:

Azioni vocali

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

Azioni di scorrimento

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

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

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 Escape
• enter o return - Tasto Invio
• tab - Tasto Tab
• space - Barra spaziatrice
• up, down, left, right - Tasti freccia
• backspace, 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
      }
    }
  ]
}

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:

{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+x ctrl+k": null,
        "ctrl+x ctrl+e": 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:

Conflitti del terminale

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

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.