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)
`AbovePrompt`	La fascia sopra il prompt, o un pulsante al suo interno, ha il focus della tastiera
`AbovePromptInput`	Un campo di input nella fascia sopra il prompt o nel riquadro di un mod ha il focus della tastiera
`AbovePromptSelect`	Una selezione nella fascia sopra il prompt o nel riquadro di un mod ha il focus della tastiera
`Pane`	Un riquadro disegnato da un mod ha il focus della tastiera
`PaneField`	Un campo di input o una selezione nel riquadro di un mod ha il focus della tastiera
`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

Impostazioni

Permessi e sandboxing

Ambienti

Modello e risposte

Interfaccia

Personalizzare le scorciatoie da tastiera

File di configurazione

Contesti

Azioni disponibili

Azioni dell’app

Azioni della cronologia

Azioni della chat

​File di configurazione

​Contesti

​Azioni disponibili

​Azioni dell’app

​Azioni della cronologia

​Azioni della chat

File di configurazione

Contesti

Azioni disponibili

Azioni dell’app

Azioni della cronologia

Azioni della chat