Pular para o conteúdo principal

​
Atalhos de teclado

Os atalhos de teclado podem variar por plataforma e terminal. Em renderização em tela cheia, pressione ? no visualizador de transcrição para ver os atalhos disponíveis lá.Usuários de macOS: Os atalhos da tecla Option/Alt (Alt+B, Alt+F, Alt+Y, Alt+M, Alt+P) exigem configurar Option como Meta no seu terminal:
  • iTerm2: Configurações → Profiles → Keys → General → defina Left/Right Option key para “Esc+”
  • Apple Terminal: Configurações → Profiles → Keyboard → marque “Use Option as Meta Key”
  • VS Code: defina "terminal.integrated.macOptionIsMeta": true nas configurações do VS Code
Veja Configuração de terminal para detalhes.

​
Controles gerais

​
Edição de texto

​
Tema e exibição

​
Entrada multilinha

Shift+Enter funciona sem configuração em iTerm2, WezTerm, Ghostty, Kitty, Warp, Apple Terminal e Windows Terminal. Para VS Code, Cursor, Devin Desktop, Alacritty e Zed, execute /terminal-setup para instalar o atalho.

​
Comandos rápidos

​
Visualizador de transcrição

Quando o visualizador de transcrição está aberto (alternado com Ctrl+O), estes atalhos estão disponíveis. Em renderização em tela cheia, pressione ? para mostrar o painel de referência de atalho de teclado completo dentro do visualizador. Ctrl+E pode ser reatribuído via transcript:toggleShowAll.

​
Entrada de voz

​
Comandos

Digite / no Claude Code para ver todos os comandos disponíveis, ou digite / seguido de qualquer letra para filtrar. O menu / mostra tudo que você pode invocar: comandos integrados, skills agrupados e criados por usuários, e comandos contribuídos por plugins e servidores MCP. Nem todos os comandos integrados são visíveis para todos os usuários, pois alguns dependem de sua plataforma ou plano. Na renderização em tela cheia, o comando / e as listas de sugestão de arquivo @ também respondem ao mouse: passar o mouse destaca uma linha e clicar a aceita. Veja a referência de comandos para a lista completa de comandos incluídos no Claude Code.

​
Modo editor Vim

Ative edição no estilo vim via /config → Editor mode.

​
Alternância de modo

​
Remapear sequências de teclas no modo INSERT

A configuração vimInsertModeRemaps mapeia uma sequência de duas teclas no modo INSERT para Escape, então um mapeamento como jj o retorna ao modo NORMAL. Requer Claude Code v2.1.208 ou posterior. O seguinte exemplo de ~/.claude/settings.json ativa o modo vim e mapeia jj para Escape:
Cada chave tem exatamente dois caracteres imprimíveis digitados em sequência, e "<Esc>" é o único alvo suportado. Entradas com um comprimento ou alvo diferente são ignoradas. Digitar o primeiro caractere de uma sequência o insere normalmente. Pressionar o segundo caractere dentro de um segundo remove esse caractere pendente e muda para o modo NORMAL, deixando nenhum caractere em sua entrada. Após a janela de um segundo, ou se uma chave diferente seguir, ambos os caracteres permanecem como texto literal, então você ainda pode digitar uma palavra contendo a sequência pausando entre as duas teclas. Claude Code lê essa configuração do seu arquivo de configurações do usuário, da flag --settings e de configurações gerenciadas apenas. Entradas no .claude/settings.json ou .claude/settings.local.json de um projeto são ignoradas, então um repositório verificado não pode remapear seus pressionamentos de tecla.
No modo normal vim, se o cursor estiver no início ou final da entrada e não puder se mover mais, j/k e as setas de navegação navegam pelo histórico de comandos.

​
Edição (modo NORMAL)

​
Objetos de texto (modo NORMAL)

Objetos de texto funcionam com operadores como d, c e y:

​
Modo visual

Pressione v para seleção por caractere ou V para seleção por linha. Os movimentos estendem a seleção e os operadores atuam diretamente sobre ela. O modo visual por bloco com Ctrl+V não é suportado.

​
Histórico de comandos

Claude Code mantém histórico de comandos para a sessão atual:
  • O histórico de entrada é armazenado por diretório de trabalho
  • O histórico de entrada é redefinido quando você executa /clear para iniciar uma nova sessão. A conversa da sessão anterior é preservada e pode ser retomada.
  • Enviar o mesmo prompt duas vezes seguidas registra uma entrada de histórico, então pressionar Seta para cima vai para o prompt anterior distinto
  • Use as setas Para cima/Para baixo para navegar (veja atalhos de teclado acima)
  • Expansão de histórico com ! está desabilitada por padrão

​
Pesquisa reversa com Ctrl+R

Pressione Ctrl+R para pesquisar interativamente através do seu histórico de comandos:
  1. Iniciar pesquisa: pressione Ctrl+R para ativar pesquisa de histórico reverso
  2. Digitar consulta: insira texto para pesquisar em comandos anteriores. O termo de pesquisa é destacado nos resultados correspondentes
  3. Navegar correspondências: pressione Ctrl+R novamente para ciclar através de correspondências mais antigas
  4. Mudar escopo: a pesquisa padrão é de prompts de todos os projetos. Pressione Ctrl+S para alternar o escopo entre esta sessão, este projeto e todos os projetos
  5. Aceitar correspondência:
    • Pressione Tab ou Esc para aceitar a correspondência atual e continuar editando
    • Pressione Enter para aceitar e executar o comando imediatamente
  6. Cancelar pesquisa:
    • Pressione Ctrl+C para cancelar e restaurar sua entrada original
    • Pressione Backspace em pesquisa vazia para cancelar
A pesquisa carrega os 100 prompts únicos mais recentes no escopo selecionado, com duplicatas recolhidas para a ocorrência mais recente. Os prompts correspondentes são exibidos com o termo de pesquisa destacado, para que você possa encontrar e reutilizar entradas anteriores. Aceitar uma correspondência ou cancelar a pesquisa entra em vigor imediatamente, mesmo enquanto Claude Code ainda está carregando o histórico. Antes da v2.1.202, aceitar ou cancelar durante esse carregamento poderia relatar um erro interno.

​
Comandos bash em segundo plano

Claude Code suporta execução de comandos bash em segundo plano, permitindo que você continue trabalhando enquanto processos de longa duração são executados.

​
Como o segundo plano funciona

Quando Claude Code executa um comando em segundo plano, ele executa o comando de forma assíncrona e retorna imediatamente um ID de tarefa em segundo plano. Claude Code pode responder a novos prompts enquanto o comando continua sendo executado em segundo plano. Para executar comandos em segundo plano, você pode:
  • Solicitar ao Claude Code para executar um comando em segundo plano
  • Pressionar Ctrl+B para mover uma invocação regular da ferramenta Bash para o segundo plano. Usuários de Tmux devem pressionar Ctrl+B duas vezes devido à tecla de prefixo do tmux.
Recursos principais:
  • A saída é escrita em um arquivo e Claude pode recuperá-la usando a ferramenta Read
  • Tarefas em segundo plano têm IDs únicos para rastreamento e recuperação de saída
  • Tarefas em segundo plano são limpas automaticamente quando Claude Code sai. Colocar a sessão em segundo plano em vez de sair entrega-as à sessão em segundo plano, onde continuam sendo executadas. Veja colocar uma sessão em execução em segundo plano
  • Tarefas em segundo plano são automaticamente encerradas se a saída exceder 5GB, com uma nota em stderr explicando o motivo
  • A partir da v2.1.193, em macOS e Linux, tarefas em segundo plano em execução são encerradas quando o sistema operacional sinaliza pressão de memória, desde que a sessão tenha ficado ociosa por pelo menos 30 minutos sem nenhuma volta ou subagente em execução. Defina CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP para 1 para desativar isso
Para desabilitar toda a funcionalidade de tarefa em segundo plano, defina a variável de ambiente CLAUDE_CODE_DISABLE_BACKGROUND_TASKS para 1. Veja Variáveis de ambiente para detalhes. Comandos comuns em segundo plano:
  • Ferramentas de compilação (webpack, vite, make)
  • Gerenciadores de pacotes (npm, yarn, pnpm)
  • Executores de teste (jest, pytest)
  • Servidores de desenvolvimento
  • Processos de longa duração (docker, terraform)

​
Modo shell com prefixo !

Execute comandos shell diretamente sem passar por Claude prefixando sua entrada com !:
Modo shell:
  • Adiciona o comando e sua saída ao contexto de conversa
  • Mostra progresso e saída em tempo real
  • Suporta o mesmo segundo plano Ctrl+B para comandos de longa duração
  • Não requer que Claude interprete ou aprove o comando
  • Suporta preenchimento automático baseado em histórico: digite um comando parcial e pressione Tab para completar a partir de comandos ! anteriores no projeto atual
  • Suporta preenchimento automático de caminho de arquivo ao vivo a partir da v2.1.193 em todas as plataformas: digite um token contendo uma barra invertida, como ./src/ ou ~/, para ver uma lista suspensa de arquivos e diretórios correspondentes, depois pressione Tab para aceitar. Use barras invertidas no Windows também; a lista suspensa é acionada por /, não \
  • Saia com Escape, Backspace ou Ctrl+U em um prompt vazio
  • Colar texto que começa com ! em um prompt vazio entra no modo shell automaticamente, correspondendo ao comportamento digitado !
A partir da v2.1.186, Claude responde à saída do comando automaticamente assim que ela chega à transcrição, para que você possa executar ! npm test e obter uma explicação das falhas sem um segundo prompt. A resposta custa o mesmo que enviar um prompt normal. Para restaurar o comportamento anterior onde a saída é adicionada ao contexto sem uma resposta, defina respondToBashCommands para false em settings.json. Antes da v2.1.186, o modo shell sempre adicionava saída ao contexto sem uma resposta. Isto é útil para operações rápidas de shell mantendo contexto de conversa.

​
Sugestões de prompt

Quando você abre uma sessão pela primeira vez, um comando de exemplo acinzentado aparece na entrada de prompt para ajudá-lo a começar. Claude Code escolhe isto do histórico git do seu projeto, então reflete arquivos nos quais você trabalhou recentemente. Após Claude responder, as sugestões continuam aparecendo com base no seu histórico de conversa, como uma etapa de acompanhamento de uma solicitação de várias partes ou uma continuação natural do seu fluxo de trabalho.
  • Pressione Tab ou Right arrow para colocar a sugestão na entrada de prompt, depois Enter para enviar
  • Comece a digitar para descartá-la
A sugestão é executada como uma solicitação em segundo plano que reutiliza o cache de prompt da conversa pai, então o custo adicional é mínimo. Claude Code pula a geração de sugestão quando o cache está frio para evitar custo desnecessário. As sugestões são automaticamente puladas após a primeira volta de uma conversa e em plan mode. No modo de impressão, elas estão desativadas por padrão. Passe --prompt-suggestions com --output-format stream-json --verbose para emitir uma mensagem prompt_suggestion após cada volta. Para desabilitar sugestões de prompt inteiramente, defina a variável de ambiente ou alterne a configuração em /config:

​
Perguntas laterais com /btw

Use /btw para fazer uma pergunta rápida sobre seu trabalho atual sem adicionar ao histórico de conversa. Isto é útil quando você quer uma resposta rápida mas não quer bagunçar o contexto principal ou desviar Claude de uma tarefa de longa duração.
Perguntas laterais têm visibilidade completa da conversa atual, então você pode perguntar sobre código que Claude já leu, decisões que tomou anteriormente, ou qualquer outra coisa da sessão. A pergunta e resposta são efêmeras: aparecem em uma sobreposição descartável e nunca entram no histórico de conversa.
  • Disponível enquanto Claude está trabalhando: você pode executar /btw mesmo enquanto Claude está processando uma resposta. A pergunta lateral é executada independentemente e não interrompe a volta principal.
  • Sem acesso a ferramentas: perguntas laterais respondem apenas a partir do que já está em contexto. Claude não pode ler arquivos, executar comandos ou pesquisar ao responder uma pergunta lateral.
  • Resposta única: não há voltas de acompanhamento na sobreposição. Para continuar a thread, divida-a em sua própria sessão com f.
  • Custo baixo: a pergunta lateral reutiliza o cache de prompt da conversa pai, então o custo adicional é mínimo.
Perguntas laterais anteriores da mesma sessão aparecem como uma lista esmaecida acima da resposta atual. Elas ficam fora do histórico de conversa mas permanecem visíveis na sobreposição até você limpá-las. Assim que a resposta aparecer, a sobreposição aceita estas teclas. /btw é o inverso de um subagent: vê sua conversa completa mas não tem ferramentas, enquanto um subagent tem ferramentas completas mas começa com contexto vazio. Use /btw para perguntar sobre o que Claude já sabe desta sessão; use um subagent para descobrir algo novo.

​
Lista de tarefas

A lista de tarefas é a lista de verificação de Claude: itens que Claude criou para planejar trabalho em várias etapas, com indicadores mostrando o que está pendente, em progresso ou completo. É separada da visualização de tarefa em segundo plano. Para ver shells em execução e subagentes, use /tasks em vez disso.
  • Pressione Ctrl+T para alternar a visualização da lista de tarefas. A exibição mostra até cinco tarefas por vez. Quando Claude ainda não criou nenhum item de lista de verificação, o alternador não tem efeito visível porque não há nada para exibir
  • Para ver todas as tarefas ou limpá-las, peça ao Claude diretamente: “show me all tasks” ou “clear all tasks”
  • As tarefas persistem através de compactações de contexto, ajudando Claude a se manter organizado em projetos maiores
  • Para compartilhar uma lista de tarefas entre sessões, defina CLAUDE_CODE_TASK_LIST_ID para usar um diretório nomeado em ~/.claude/tasks/: CLAUDE_CODE_TASK_LIST_ID=my-project claude

​
Resumo de sessão

Quando você retorna ao terminal após se afastar, Claude Code mostra um resumo de uma linha do que aconteceu na sessão até agora. O resumo é gerado em segundo plano uma vez que pelo menos três minutos tenham passado desde a última volta concluída e o terminal esteja desfocado, então está pronto quando você volta. Os resumos aparecem apenas uma vez que a sessão tenha pelo menos três voltas, e nunca duas vezes seguidas. Execute /recap para gerar um resumo sob demanda. Para desativar resumos automáticos, abra /config e desabilite Session recap. O resumo de sessão está ativado por padrão para todos os planos e provedores. O resumo é sempre pulado em modo não interativo.

​
Status de revisão de PR

Ao trabalhar em uma branch com um pull request aberto, Claude Code exibe um link de PR clicável no rodapé, como “PR #446”. O link tem um sublinhado colorido indicando o estado de revisão:
  • Verde: aprovado
  • Amarelo: revisão pendente
  • Vermelho: mudanças solicitadas
  • Cinza: rascunho
O badge desaparece assim que o pull request é mesclado ou fechado. Cmd+click (macOS) ou Ctrl+click (Windows/Linux) no link para abrir o pull request no seu navegador. O status é atualizado a cada 60 segundos e imediatamente após um comando gh pr ou git push ser executado na sessão.
O status de PR requer que o CLI gh esteja instalado e autenticado (gh auth login).

​
Veja também