Pular para o conteúdo principal
Os atalhos de teclado personalizáveis requerem Claude Code v2.1.18 ou posterior. Verifique sua versão com claude --version.
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 keybindings é um objeto com um array bindings. Cada bloco especifica um contexto e um mapa de sequências de teclas para ações.
As alterações no arquivo de keybindings são detectadas automaticamente e aplicadas sem reiniciar Claude Code.
CampoDescrição
$schemaURL opcional do JSON Schema para autocompletar do editor
$docsURL opcional de documentação
bindingsArray de blocos de vinculação por contexto
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:
ContextoDescrição
GlobalAplica-se em qualquer lugar do aplicativo
ChatÁrea principal de entrada de chat
AutocompleteMenu de autocompletar está aberto
SettingsMenu de configurações (dismiss apenas com escape)
ConfirmationDiálogos de permissão e confirmação
TabsComponentes de navegação de abas
HelpMenu de ajuda está visível
TranscriptVisualizador de transcrição
HistorySearchModo de busca de histórico (Ctrl+R)
TaskTarefa em segundo plano está em execução
ThemePickerDiálogo do seletor de tema
AttachmentsNavegação da barra de imagem/anexo
FooterNavegação do indicador de rodapé (tarefas, equipes, diff)
MessageSelectorSeleção de mensagem do diálogo de retrocesso e resumo
DiffDialogNavegação do visualizador de diff
ModelPickerNível de esforço do seletor de modelo
SelectComponentes genéricos de seleção/lista
PluginDiálogo de plugin (procurar, descobrir, gerenciar)

​
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çãoPadrãoDescrição
app:interruptCtrl+CCancelar operação atual
app:exitCtrl+DSair do Claude Code
app:toggleTodosCtrl+TAlternar visibilidade da lista de tarefas
app:toggleTranscriptCtrl+OAlternar transcrição detalhada

​
Ações de histórico

Ações para navegar no histórico de comandos:
AçãoPadrãoDescrição
history:searchCtrl+RAbrir busca de histórico
history:previousUpItem de histórico anterior
history:nextDownPróximo item de histórico

​
Ações de chat

Ações disponíveis no contexto Chat:
AçãoPadrãoDescrição
chat:cancelEscapeCancelar entrada atual
chat:killAgentsCtrl+X Ctrl+KEncerrar todos os agentes em segundo plano
chat:cycleModeShift+Tab*Ciclar modos de permissão
chat:modelPickerCmd+P / Meta+PAbrir seletor de modelo
chat:fastModeMeta+OAlternar modo rápido
chat:thinkingToggleCmd+T / Meta+TAlternar pensamento estendido
chat:submitEnterEnviar mensagem
chat:undoCtrl+_Desfazer última ação
chat:externalEditorCtrl+G, Ctrl+X Ctrl+EAbrir em editor externo
chat:stashCtrl+SGuardar prompt atual
chat:imagePasteCtrl+V (Alt+V no Windows)Colar imagem
*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çãoPadrãoDescrição
autocomplete:acceptTabAceitar sugestão
autocomplete:dismissEscapeDescartar menu
autocomplete:previousUpSugestão anterior
autocomplete:nextDownPróxima sugestão

​
Ações de confirmação

Ações disponíveis no contexto Confirmation:
AçãoPadrãoDescrição
confirm:yesY, EnterConfirmar ação
confirm:noN, EscapeRecusar ação
confirm:previousUpOpção anterior
confirm:nextDownPróxima opção
confirm:nextFieldTabPróximo campo
confirm:previousField(desvinculado)Campo anterior
confirm:cycleModeShift+TabCiclar modos de permissão
confirm:toggleExplanationCtrl+EAlternar explicação de permissão

​
Ações de permissão

Ações disponíveis no contexto Confirmation para diálogos de permissão:
AçãoPadrãoDescrição
permission:toggleDebugCtrl+DAlternar informações de depuração de permissão

​
Ações de transcrição

Ações disponíveis no contexto Transcript:
AçãoPadrãoDescrição
transcript:toggleShowAllCtrl+EAlternar mostrar todo o conteúdo
transcript:exitCtrl+C, EscapeSair da visualização de transcrição

​
Ações de busca de histórico

Ações disponíveis no contexto HistorySearch:
AçãoPadrãoDescrição
historySearch:nextCtrl+RPróxima correspondência
historySearch:acceptEscape, TabAceitar seleção
historySearch:cancelCtrl+CCancelar busca
historySearch:executeEnterExecutar comando selecionado

​
Ações de tarefa

Ações disponíveis no contexto Task:
AçãoPadrãoDescrição
task:backgroundCtrl+BColocar tarefa atual em segundo plano

​
Ações de tema

Ações disponíveis no contexto ThemePicker:
AçãoPadrãoDescrição
theme:toggleSyntaxHighlightingCtrl+TAlternar destaque de sintaxe

​
Ações de ajuda

Ações disponíveis no contexto Help:
AçãoPadrãoDescrição
help:dismissEscapeFechar menu de ajuda

​
Ações de abas

Ações disponíveis no contexto Tabs:
AçãoPadrãoDescrição
tabs:nextTab, RightPróxima aba
tabs:previousShift+Tab, LeftAba anterior

​
Ações de anexos

Ações disponíveis no contexto Attachments:
AçãoPadrãoDescrição
attachments:nextRightPróximo anexo
attachments:previousLeftAnexo anterior
attachments:removeBackspace, DeleteRemover anexo selecionado
attachments:exitDown, EscapeSair da barra de anexos

​
Ações de rodapé

Ações disponíveis no contexto Footer:
AçãoPadrãoDescrição
footer:nextRightPróximo item do rodapé
footer:previousLeftItem anterior do rodapé
footer:openSelectedEnterAbrir item do rodapé selecionado
footer:clearSelectionEscapeLimpar seleção do rodapé

​
Ações do seletor de mensagem

Ações disponíveis no contexto MessageSelector:
AçãoPadrãoDescrição
messageSelector:upUp, K, Ctrl+PMover para cima na lista
messageSelector:downDown, J, Ctrl+NMover para baixo na lista
messageSelector:topCtrl+Up, Shift+Up, Meta+Up, Shift+KPular para o topo
messageSelector:bottomCtrl+Down, Shift+Down, Meta+Down, Shift+JPular para o final
messageSelector:selectEnterSelecionar mensagem

​
Ações de diff

Ações disponíveis no contexto DiffDialog:
AçãoPadrãoDescrição
diff:dismissEscapeFechar visualizador de diff
diff:previousSourceLeftFonte de diff anterior
diff:nextSourceRightPróxima fonte de diff
diff:previousFileUpArquivo anterior no diff
diff:nextFileDownPróximo arquivo no diff
diff:viewDetailsEnterVisualizar detalhes do diff
diff:back(específico do contexto)Voltar no visualizador de diff

​
Ações do seletor de modelo

Ações disponíveis no contexto ModelPicker:
AçãoPadrãoDescrição
modelPicker:decreaseEffortLeftDiminuir nível de esforço
modelPicker:increaseEffortRightAumentar nível de esforço

​
Ações de seleção

Ações disponíveis no contexto Select:
AçãoPadrãoDescrição
select:nextDown, J, Ctrl+NPróxima opção
select:previousUp, K, Ctrl+POpção anterior
select:acceptEnterAceitar seleção
select:cancelEscapeCancelar seleção

​
Ações de plugin

Ações disponíveis no contexto Plugin:
AçãoPadrãoDescrição
plugin:toggleSpaceAlternar seleção de plugin
plugin:installIInstalar plugins selecionados

​
Ações de configurações

Ações disponíveis no contexto Settings:
AçãoPadrãoDescrição
settings:search/Entrar no modo de busca
settings:retryRTentar novamente carregar dados de uso (em caso de erro)

​
Ações de voz

Ações disponíveis no contexto Chat quando a ditação por voz está ativada:
AçãoPadrãoDescrição
voice:pushToTalkSpaceMantenha pressionado para ditar um prompt

​
Sintaxe de sequência de teclas

​
Modificadores

Use teclas modificadoras com o separador +:
  • ctrl ou control - Tecla Control
  • alt, opt, ou option - Tecla Alt/Option
  • shift - Tecla Shift
  • meta, cmd, ou command - Tecla Meta/Command
Por exemplo: 
ctrl+k          Tecla única com modificador
shift+tab       Shift + Tab
meta+p          Command/Meta + P
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 vinculações 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
      }
    }
  ]
}

​
Atalhos reservados

Estes atalhos não podem ser revinculados:
AtalhoMotivo
Ctrl+CInterrupção/cancelamento codificado
Ctrl+DSaída codificada
Ctrl+MIdêntico a Enter em terminais (ambos enviam CR)

​
Conflitos de terminal

Alguns atalhos podem entrar em conflito com multiplexadores de terminal:
AtalhoConflito
Ctrl+BPrefixo tmux (pressione duas vezes para enviar)
Ctrl+APrefixo GNU screen
Ctrl+ZSuspensão de processo Unix (SIGTSTP)

​
Interação com modo vim

Quando o modo vim está ativado (/vim), keybindings e modo vim operam independentemente:
  • Modo vim manipula entrada no nível de entrada de texto (movimento do cursor, modos, motions)
  • Keybindings 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 keybindings
  • No modo NORMAL do vim, ? mostra o menu de ajuda (comportamento vim)

​
Validação

Claude Code valida seus keybindings 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 keybindings.