Atalhos de teclado no Claude Code: guia prático

Atalhos de teclado no Claude Code só ajudam quando terminal, sistema operacional, editor e ferramentas de acessibilidade deixam a tecla chegar ao lugar certo. Um atalho que funciona no macOS pode falhar no Windows Terminal. Uma combinação que parece livre em Claude Code pode ser capturada por VS Code, tmux, IME, leitor de tela ou pelo próprio sistema. Por isso, uma boa documentação de atalhos começa por verificação, não por memorização.

Esta atualização de 2 de junho de 2026 cobre como descobrir os atalhos atuais do Claude Code, como lidar com conflitos de terminal e editor, quando usar custom slash commands em vez de atalhos do OS, como documentar keybindings.json com segurança, como montar uma cheat sheet de onboarding, como considerar acessibilidade, diferenças entre Windows e macOS, e quais prompts usar para pedir que Claude Code atualize a documentação sem inventar teclas.

Detalhes de atalhos mudam. Confira sempre os valores exatos na sua sessão e nas fontes oficiais: Claude Code keybindings, interactive mode, commands, slash commands e IDE integrations. Para hábitos relacionados, veja também dicas de produtividade com Claude Code e o guia de command palette.

Comece descobrindo o estado atual

O primeiro passo útil não é decorar uma tecla. É abrir o keymap atual. Claude Code oferece /keybindings para ver e editar atalhos, e customizações ficam em ~/.claude/keybindings.json. O comando /doctor também é essencial porque o terminal faz parte do caminho. Se o terminal não envia uma tecla ao Claude Code, ajustar Claude Code sozinho não resolve.

No Windows PowerShell, comece assim.

claude --version
claude

# Execute dentro do Claude Code:
# /status
# /keybindings
# /doctor

No macOS e Linux, registre a versão do Claude Code, app de terminal, OS, uso de VS Code e tmux. Sem esse contexto, uma tabela de atalhos vira informação difícil de auditar.

flowchart TD
  A["Tecla pressionada"] --> B["Atalho reservado pelo OS"]
  B --> C["Tratamento do terminal"]
  C --> D["Claude Code keybindings"]
  D --> E["Ação de chat, edição ou visualização"]
  C --> F["Conflito com tmux, IME ou editor"]

O que aprender primeiro

Claude Code tem muitos atalhos, mas onboarding deve começar pelos que evitam erros diários: interromper, enviar, escrever em várias linhas, limpar tela, histórico, editor externo e todos. Os exemplos devem ser confirmados com /keybindings.

Objetivo	Exemplos para confirmar	Atenção prática
Interromper trabalho	Ctrl+C	Não mude memória de emergência sem motivo forte
Enviar entrada	Enter	Prompts longos precisam de hábito multilinha
Entrada multilinha	Shift+Enter, Ctrl+J	Alguns terminais exigem /terminal-setup
Limpar tela	Ctrl+L	Limpa a visualização, não o histórico
Abrir histórico	Ctrl+R, Ctrl+O	Confira texto não enviado antes de trocar contexto
Editor externo	Ctrl+X Ctrl+E, às vezes Ctrl+G	Melhor para prompts longos e reviews
Ver todos	Ctrl+T	Confirme que não foi alterado localmente

Para uma pessoa nova, é melhor ensinar /keybindings, /doctor, multiline, editor externo e interrupção segura do que entregar uma lista enorme. Isso reduz erros logo no primeiro dia.

Windows, macOS, VS Code e terminal

No macOS, Option pode agir como Meta, mas a preferência do terminal pode usar Option para caracteres especiais. No Windows, Ctrl, Alt e a tecla Windows variam entre terminais e apps. No Linux, o window manager pode capturar combinações antes do terminal.

VS Code adiciona foco. Se o foco está no terminal integrado, a tecla pode ir para Claude Code. Se está no editor, pode acionar um comando do VS Code. A cheat sheet precisa dizer “com foco em Claude Code” ou “com foco no editor VS Code”.

Três decisões de equipe ajudam:

• Escolher o terminal padrão de onboarding, como Windows Terminal ou iTerm2.
• Definir se multiline será Shift+Enter ou Ctrl+J.
• Documentar como mover foco entre VS Code, terminal integrado e Claude Code.

Acessibilidade deve estar na mesma conversa. Usuários com leitor de tela, IME, desktop remoto ou teclado adaptado podem não usar combinações complexas. Mantenha menus, slash commands, editor externo e checklists como caminhos alternativos. Veja também acessibilidade com Claude Code.

Mantenha keybindings.json pequeno

Custom keybindings são úteis, mas mudanças demais tornam a documentação oficial e as explicações da equipe inconsistentes. Comece pequeno: desative um conflito claro ou crie um caminho seguro para uma ação frequente.

Este exemplo mínimo de ~/.claude/keybindings.json segue a estrutura documentada. Ele mapeia Ctrl+E para o editor externo e desativa Ctrl+U no Chat. Se seu terminal ou shell já usa Ctrl+E, escolha outra tecla.

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

Cada binding customizado precisa de motivo. Não altere atalhos de interrupção, como Ctrl+C, sem teste real. Antes de virar padrão de equipe, teste em Windows, macOS, terminal integrado do VS Code e tmux.

Este PowerShell verifica se já existe arquivo customizado.

$path = Join-Path $HOME ".claude\keybindings.json"

if (Test-Path $path) {
  Get-Item $path | Select-Object FullName, LastWriteTime
} else {
  "No custom keybindings.json found."
}

Use slash commands para workflows

Nem todo fluxo deve virar atalho do OS. Um atalho deve mover a interface ou acionar uma ação pequena. Um workflow de review, teste, documentação ou publicação deve ser slash command ou skill, porque os passos ficam visíveis e revisáveis.

Uma revisão de documentação de atalhos pode ser uma skill do projeto.

$dir = ".claude\skills\shortcut-review"
New-Item -ItemType Directory -Force $dir | Out-Null

@'
---
description: Review Claude Code shortcut docs for this repository.
---

Check the current Claude Code shortcuts before editing docs.

1. Ask the user to run `/keybindings` and `/doctor`.
2. Compare Windows, macOS, VS Code, and terminal notes.
3. Do not invent exact keybindings that are not documented.
4. Keep destructive workflows behind explicit prompts.
5. End with changed files, checks, and residual risk.
'@ | Set-Content -Encoding utf8 "$dir\SKILL.md"

Se a skill editar arquivos, executar Git ou chamar comandos externos, conecte-a ao guia de permissões do Claude Code para manter aprovações explícitas.

Casos de uso concretos

O primeiro caso é onboarding. Nos primeiros 30 minutos, a pessoa deve executar /keybindings, executar /doctor, testar multiline, abrir editor externo, limpar tela, ver histórico e interromper com segurança.

O segundo caso é review longo. Segurança, acessibilidade, CTA, testes e risco residual não cabem bem em uma linha improvisada. Abra o editor externo, escreva escopo, proibições, comandos de verificação e formato de saída. A checklist de code review com Claude Code ajuda.

O terceiro caso é implementação com VS Code. Você envia uma seleção para Claude Code, recebe plano ou patch, revisa diff no VS Code e roda testes no terminal. A cheat sheet deve indicar qual app tem foco.

O quarto caso é operação acessível. Leitor de tela, IME, desktop remoto e teclado customizado podem quebrar combinações complexas. Slash commands, menus, editor externo e checklists são caminhos necessários.

Falhas comuns e prompt seguro

A falha mais perigosa é remapear Ctrl+C porque parece disponível. Interrupção e parada de emergência devem ser previsíveis. A segunda é esquecer tmux e atalhos do terminal. Ctrl+B, Ctrl+Shift+T e combinações com Alt muitas vezes não chegam ao Claude Code. A terceira é documentação velha. A quarta é colocar commit, push, deploy ou mudanças de monetização atrás de uma tecla única.

Use este prompt para pedir atualização da documentação.

You are updating our Claude Code keyboard shortcut guide.

Scope:
- Read only the target article and related docs.
- Preserve slug, heroImage, and existing internal links unless broken.
- Verify current shortcut facts against official Claude Code docs.
- Treat exact keybindings as version-sensitive.

Required content:
- How to open /keybindings and run /doctor.
- Windows, macOS, VS Code, terminal, tmux, and IME conflicts.
- keybindings.json example with a small safe change.
- 3 or more practical use cases.
- Concrete failure modes and accessibility notes.
- Final verification note with commands run and residual risk.

Do not:
- Invent undocumented shortcut details.
- Map destructive actions to one key.
- Remove monetization CTA, product links, or training links.

E esta cheat sheet serve para onboarding.

# Claude Code shortcuts onboarding

Update date: 2026-06-02
Before memorizing keys, run:

1. `/status`
2. `/keybindings`
3. `/doctor`

Daily keys to confirm:

| Situation | What to check |
| --- | --- |
| Stop current work | Confirm the interrupt key in `/keybindings` |
| Long prompt | Use external editor before sending |
| Multiline prompt | Test Shift+Enter and Ctrl+J |
| Screen is noisy | Use the clear-screen shortcut |
| Need old context | Open conversation history |
| VS Code workflow | Note which app has focus first |

Rule:
If your terminal, OS, or screen reader uses the same key,
do not force the Claude Code shortcut. Choose a safer route.

CTA e resultado prático

Para prática individual, comece pela cheat sheet gratuita de Claude Code. Para prompts e templates reutilizáveis, veja os produtos ClaudeCodeLab. Para padronizar terminal, CLAUDE.md, permissões e review em equipe, use treinamento e consultoria Claude Code.

No teste prático de Masa, o ganho veio menos de criar novos atalhos e mais de verificar /keybindings e /doctor primeiro. Em Windows Terminal e no terminal integrado do VS Code, confirmar multiline e editor externo reduziu envios acidentais de prompts longos. O risco restante é drift de versão: Claude Code, terminais e integrações IDE mudam, então cada refresh precisa rever documentação oficial e keymap local.