Personalizar atalhos de teclado

Personalize atalhos de teclado no Claude Code com um arquivo de configuração de keybindings.

Claude Code suporta atalhos de teclado personalizáveis. Execute /keybindings para criar ou abrir seu arquivo de configuração em ~/.claude/keybindings.json.

Arquivo de configuração

O arquivo de configuração de atalhos de teclado é um objeto com um array bindings. Cada bloco especifica um contexto e um mapa de sequências de teclas para ações.

Este exemplo vincula Ctrl+E para abrir um editor externo no contexto de chat e desvincula Ctrl+U:

{
  "$schema": "https://www.schemastore.org/claude-code-keybindings.json",
  "$docs": "https://code.claude.com/docs/pt/keybindings",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+e": "chat:externalEditor",
        "ctrl+u": null
      }
    }
  ]
}

Contextos

Cada bloco de vinculação especifica um contexto onde as vinculações se aplicam:

Ações disponíveis

As ações seguem um formato namespace:action, como chat:submit para enviar uma mensagem ou app:toggleTodos para mostrar a lista de tarefas. Cada contexto tem ações específicas disponíveis.

Ações do aplicativo

Ações disponíveis no contexto Global:

Ações de histórico

Ações para navegar no histórico de comandos:

Ações de chat

Ações disponíveis no contexto Chat:

*No Windows sem modo VT (Node <24.2.0/<22.17.0, Bun <1.2.23), o padrão é Meta+M.

Ações de autocompletar

Ações disponíveis no contexto Autocomplete:

Ações de confirmação

Ações disponíveis no contexto Confirmation:

Ações de permissão

Ações disponíveis no contexto Confirmation para diálogos de permissão:

Ações de transcrição

Ações disponíveis no contexto Transcript:

Ações de busca de histórico

Ações disponíveis no contexto HistorySearch:

Ações de tarefa

Ações disponíveis no contexto Task:

Ações de tema

Ações disponíveis no contexto ThemePicker:

Ações de ajuda

Ações disponíveis no contexto Help:

Ações de abas

Ações disponíveis no contexto Tabs:

Ações de anexos

Ações disponíveis no contexto Attachments:

Ações de rodapé

Ações disponíveis no contexto Footer:

Ações do seletor de mensagem

Ações disponíveis no contexto MessageSelector:

Ações de diff

Ações disponíveis no contexto DiffDialog:

A visualização de detalhes do diff também vincula atalhos de teclado no estilo pager às ações de rolagem padrão. Essas vinculações fazem parte do contexto DiffDialog e se aplicam apenas na visualização de detalhes; os padrões do contexto Scroll listados em Ações de rolagem permanecem inalterados.

Ações do seletor de modelo

Ações disponíveis no contexto ModelPicker:

Ações de seleção

Ações disponíveis no contexto Select:

Ações de plugin

Ações disponíveis no contexto Plugin:

Ações de configurações

Ações disponíveis no contexto Settings:

Ações de doctor

Ações disponíveis no contexto Doctor:

Ações de voz

Ações disponíveis no contexto Chat quando a ditação por voz está ativada:

Ações de rolagem

Ações disponíveis no contexto Scroll quando a renderização em tela cheia está ativada:

Sintaxe de sequência de teclas

Modificadores

Use teclas modificadoras com o separador +:

• ctrl ou control - Tecla Control
• shift - Tecla Shift
• alt, opt, option, ou meta - Tecla Alt no Windows e Linux, tecla Option no macOS
• cmd, command, super, ou win - Tecla Command no macOS, tecla Windows no Windows, tecla Super no Linux

O grupo cmd é detectado apenas em terminais que relatam o modificador Super, como aqueles que suportam o protocolo de teclado Kitty ou o modo modifyOtherKeys do xterm. A maioria dos terminais não o envia, portanto use ctrl ou meta para atalhos de teclado que você deseja que funcionem em qualquer lugar.

Por exemplo:

ctrl+k          Ctrl + K
shift+tab       Shift + Tab
meta+p          Option + P no macOS, Alt + P em outros lugares
ctrl+shift+c    Múltiplos modificadores

Letras maiúsculas

Uma letra maiúscula isolada implica Shift. Por exemplo, K é equivalente a shift+k. Isso é útil para atalhos de teclado no estilo vim, onde as teclas maiúsculas e minúsculas têm significados diferentes.

Letras maiúsculas com modificadores (por exemplo, ctrl+K) são tratadas como estilísticas e não implicam Shift: ctrl+K é o mesmo que ctrl+k.

Acordes

Acordes são sequências de sequências de teclas separadas por espaços:

ctrl+k ctrl+s   Pressione Ctrl+K, solte, depois Ctrl+S

Teclas especiais

• escape ou esc - Tecla Escape
• enter ou return - Tecla Enter
• tab - Tecla Tab
• space - Barra de espaço
• up, down, left, right - Teclas de seta
• backspace, delete - Teclas de exclusão

Desvinculação de atalhos padrão

Defina uma ação como null para desvinculá-la de um atalho padrão:

{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+s": null
      }
    }
  ]
}

Isso também funciona para vinculações de acordes. Desvinculando cada acorde que compartilha um prefixo libera esse prefixo para uso como uma vinculação de tecla única:

{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+x ctrl+k": null,
        "ctrl+x ctrl+e": null,
        "ctrl+x": "chat:newline"
      }
    }
  ]
}

Se você desvinculá alguns, mas não todos os acordes em um prefixo, pressionar o prefixo ainda entra no modo de espera de acorde para as vinculações restantes.

Atalhos reservados

Estes atalhos não podem ser revinculados:

Conflitos de terminal

Alguns atalhos podem entrar em conflito com multiplexadores de terminal:

Interação com modo vim

Quando o modo vim está ativado via /config → Editor mode, atalhos de teclado e modo vim operam independentemente:

• Modo vim manipula entrada no nível de entrada de texto (movimento do cursor, modos, motions)
• Atalhos de teclado manipulam ações no nível de componente (alternar tarefas, enviar, etc.)
• A tecla Escape no modo vim muda INSERT para NORMAL; ela não dispara chat:cancel
• A maioria dos atalhos Ctrl+key passam pelo modo vim para o sistema de atalhos de teclado
• No modo NORMAL do vim, ? mostra o menu de ajuda (comportamento vim)
• No modo NORMAL do vim, / abre a busca de histórico, o mesmo que Ctrl+R no modo padrão

Validação

Claude Code valida seus atalhos de teclado e mostra avisos para:

• Erros de análise (JSON inválido ou estrutura)
• Nomes de contexto inválidos
• Conflitos de atalho reservado
• Conflitos de multiplexador de terminal
• Vinculações duplicadas no mesmo contexto

Execute /doctor para ver quaisquer avisos de atalhos de teclado.