MODULO 1.6

⌨️ Atalhos de Teclado e Navegacao

Domine os atalhos de teclado do Claude Code para navegar, editar, controlar e acelerar suas sessoes. Quem domina os atalhos trabalha duas vezes mais rapido.

6
Topicos
25
Minutos
Basico
Nivel
Teoria + Pratica
Tipo
1

🧭 Navegacao na Sessao

Quando uma sessao do Claude Code fica longa, com muitas respostas e blocos de codigo, saber navegar rapidamente e essencial. Em vez de ficar rolando infinitamente com o scroll do mouse, use atalhos para pular entre respostas, buscar conteudo especifico e encontrar informacoes rapidamente.

🎯 Conceito Principal

O Claude Code roda dentro do seu terminal, entao os atalhos de navegacao dependem do emulador de terminal que voce usa. Porem, existem atalhos universais que funcionam em praticamente todos os terminais modernos.

  • Scroll basico: Use Shift+PageUp e Shift+PageDown para rolar uma pagina inteira. Em muitos terminais, Ctrl+Shift+Up/Down rola linha a linha
  • Busca no terminal: Ctrl+Shift+F na maioria dos terminais abre a busca de texto. Procure por nomes de funcoes, erros ou qualquer texto na saida
  • Limpar tela: Ctrl+L limpa a tela sem encerrar a sessao. O historico permanece acessivel via scroll
  • Tmux/Screen: Se voce usa tmux, Ctrl+b [ entra no modo de copia/navegacao, permitindo scroll com vim keys (j/k/Ctrl+f/Ctrl+b)

Atalhos de Navegacao por Terminal

Acao iTerm2/macOS Windows Terminal Linux (GNOME)
Scroll up Cmd+Up / Fn+Up Ctrl+Shift+Up Shift+PageUp
Scroll down Cmd+Down / Fn+Down Ctrl+Shift+Down Shift+PageDown
Buscar texto Cmd+F Ctrl+Shift+F Ctrl+Shift+F
Limpar tela Cmd+K Ctrl+L Ctrl+L

💡 Dica Pratica

Se voce usa sessoes longas, considere usar o tmux para gerenciar sua sessao Claude Code. Com tmux, voce pode dividir a tela, manter sessoes em background e navegar no historico com vim keys, o que e muito mais rapido do que o scroll padrao.

Outra opcao: use /clear dentro do Claude Code periodicamente para limpar o contexto visual. Isso nao afeta o conhecimento da sessao, apenas limpa a tela.

2

✏️ Edicao de Prompt

Digitar prompts longos no terminal pode ser trabalhoso sem os atalhos certos. Os atalhos de edicao de linha do readline (usados pelo bash, zsh e pelo Claude Code) permitem mover o cursor, deletar palavras e editar texto com velocidade profissional. Dominar esses atalhos elimina a frustacao de ter que reescrever prompts inteiros por causa de um erro no meio.

🎯 Conceito Principal

O Claude Code usa uma interface de input baseada em readline/line-editor, o que significa que os atalhos classicos de Emacs funcionam para navegar e editar o texto do prompt antes de enviar. Esses sao os mesmos atalhos que voce ja usa no bash/zsh.

  • Ctrl+A / Ctrl+E: Mover o cursor para o inicio / final da linha. Essencial para editar prompts longos sem usar as setas
  • Ctrl+W: Deletar a palavra anterior ao cursor (backspace por palavra). Muito mais rapido que segurar backspace
  • Ctrl+U: Deletar tudo do cursor ate o inicio da linha. Limpa o prompt rapidamente para reescrever
  • Ctrl+K: Deletar tudo do cursor ate o final da linha. Complemento do Ctrl+U
  • Alt+B / Alt+F: Mover o cursor uma palavra para tras / frente. Navegacao rapida entre palavras do prompt

Atalhos de Edicao Essenciais

Atalho Acao Quando Usar
Ctrl+A Inicio da linha Adicionar texto no comeco do prompt
Ctrl+E Final da linha Voltar ao final apos editar o meio
Ctrl+W Deletar palavra anterior Corrigir a ultima palavra digitada
Ctrl+U Deletar ate o inicio Limpar tudo e reescrever
Ctrl+K Deletar ate o final Manter inicio e mudar final
Alt+B Palavra anterior Navegar entre palavras
Alt+F Proxima palavra Navegar entre palavras

💡 Dica Pratica

O combo mais util no dia a dia e Ctrl+U para limpar o prompt quando voce muda de ideia no meio da digitacao. Em vez de segurar backspace por 5 segundos, um unico atalho limpa tudo instantaneamente.

No macOS com iTerm2, Alt+B/F pode nao funcionar por padrao. Va em Preferences > Profiles > Keys e mude "Left Option key" para "Esc+" para habilitar os atalhos com Alt.

3

🛑 Controle de Execucao

Saber interromper, cancelar e controlar a execucao do Claude Code e tao importante quanto saber pedir coisas. Quando o Claude esta gerando uma resposta muito longa, executando um comando errado ou seguindo um caminho que voce nao quer, voce precisa agir rapido. Estes atalhos sao sua rede de seguranca.

🎯 Conceito Principal

O Claude Code oferece diferentes niveis de interrupcao, desde cancelar a geracao atual ate sair completamente da sessao. Entender a diferenca entre eles e crucial para manter o controle.

  • Escape: Cancela a geracao em andamento. O Claude para de responder, mas a sessao continua ativa. Use quando a resposta esta indo na direcao errada
  • Ctrl+C (uma vez): Interrompe a operacao atual. Se o Claude esta executando um comando ou gerando texto, ele para. Voce pode continuar a conversa normalmente
  • Ctrl+C (duas vezes): Sai da sessao do Claude Code completamente. Use quando quiser encerrar e voltar ao shell normal
  • Ctrl+D: Envia EOF (End of File), equivalente a sair da sessao. Funciona quando o prompt esta vazio

⌨️ Cenarios de Uso

# Cenario 1: Claude esta gerando resposta muito longa
> Explique toda a arquitetura do Linux kernel...
# O Claude comeca a gerar 5000 palavras...
# Pressione Escape → Claude para de gerar
> Resuma em 5 linhas apenas

# Cenario 2: Claude executando comando demorado
Claude quer executar: find / -name "*.log" -mtime -30
# Voce aprovou mas esta demorando muito...
# Pressione Ctrl+C → Comando cancelado

# Cenario 3: Quer sair da sessao
> (prompt vazio)
# Pressione Ctrl+C duas vezes ou Ctrl+D → Sessao encerrada

💡 Dica Pratica

O Escape e seu melhor amigo. Use-o liberalmente. Se o Claude comecar a gerar algo que nao e o que voce quer, pressione Escape imediatamente. Nao espere a resposta terminar para refazer o prompt - isso desperdicaria tokens e tempo.

Apos cancelar com Escape, voce pode refinar o prompt. O Claude mantem o contexto da conversa, entao basta pedir de forma mais especifica e ele corrige o rumo.

4

🕐 Historico de Comandos

Assim como o bash mantem um historico de comandos que voce pode navegar com as setas, o Claude Code tambem permite navegar por prompts anteriores. Reusar e adaptar prompts que ja funcionaram e uma das formas mais eficientes de trabalhar, evitando redigitar instrucoes complexas.

🎯 Conceito Principal

O Claude Code armazena o historico de prompts da sessao atual e permite navegar por eles. Isso funciona de forma similar ao historico do bash, mas dentro do contexto da sessao Claude.

  • Seta para cima (Up): Volta ao prompt anterior. Continue pressionando para navegar prompts mais antigos da sessao
  • Seta para baixo (Down): Avanca para o proximo prompt (mais recente). Use apos navegar para tras
  • Reusar com edicao: Navegue ate um prompt anterior, edite-o com os atalhos de edicao (Ctrl+A, Ctrl+E, Alt+B, etc.) e pressione Enter para enviar a versao modificada
  • Sessoes persistentes: Use claude --resume para retomar uma sessao anterior completa com todo o contexto e historico de prompts

⌨️ Fluxo de Trabalho com Historico

# Prompt original
> Refatore a funcao processData em src/utils.py para usar async/await

# ... Claude responde e aplica mudancas ...

# Agora quer fazer o mesmo para outra funcao:
# Pressione Seta para cima (recupera prompt anterior)
> Refatore a funcao processData em src/utils.py para usar async/await
# Edite com Ctrl+W para mudar o nome da funcao:
> Refatore a funcao validateInput em src/utils.py para usar async/await

# Resumir sessao anterior
$ claude --resume
# Mostra lista de sessoes recentes para escolher

💡 Dica Pratica

Desenvolva o habito de reusar prompts que funcionaram. Se voce encontrou uma formula de prompt que gera resultados excelentes (ex: "refatore X para usar Y mantendo os testes passando"), use a seta para cima e adapte em vez de reescrever do zero.

Para prompts muito complexos que voce usa frequentemente, considere salva-los como aliases no shell (modulo 1.7) ou como snippets num arquivo de referencia. Isso e mais eficiente do que depender do historico de sessao.

5

📝 Multi-line Input

Prompts eficazes frequentemente exigem multiplas linhas: instrucoes detalhadas, listas de requisitos, exemplos de codigo ou templates estruturados. O Claude Code suporta entrada multi-line de varias formas, permitindo que voce componha prompts complexos sem sacrificar a formatacao.

🎯 Conceito Principal

No Claude Code, Enter envia o prompt. Para inserir uma nova linha sem enviar, voce precisa usar metodos alternativos. Existem varias formas de compor prompts multi-line.

  • Shift+Enter: Insere uma nova linha no prompt sem enviar. Este e o metodo principal para entrada multi-line no Claude Code
  • Colar blocos (Ctrl+V / Cmd+V): Quando voce cola texto multi-line do clipboard, as quebras de linha sao preservadas automaticamente. O Claude recebe o bloco completo
  • Backslash continuation: Em alguns contextos, voce pode usar \ no final da linha para indicar continuacao, similar ao shell
  • Pipe com heredoc: Para prompts muito grandes, use o modo pipe: claude -p << 'EOF' ... EOF

⌨️ Exemplos de Entrada Multi-line

# Usando Shift+Enter para multiplas linhas no prompt interativo
> Crie uma funcao Python que: [Shift+Enter]
1. Receba uma lista de URLs [Shift+Enter]
2. Faca requisicoes async para cada uma [Shift+Enter]
3. Retorne um dict com URL: status_code [Enter para enviar]

# Usando heredoc para prompts complexos via pipe
$ claude -p << 'EOF'
Refatore o arquivo src/auth.py seguindo estas regras:
- Use dataclasses em vez de dicts
- Adicione type hints em todas as funcoes
- Substitua print() por logging
- Mantenha os testes existentes passando
EOF

💡 Dica Pratica

Para prompts realmente complexos, considere escrever o prompt num arquivo de texto e depois enviar via pipe: cat meu_prompt.txt | claude -p. Isso permite usar seu editor de texto favorito (vim, VS Code) para compor o prompt com calma, com syntax highlighting e sem medo de enviar por engano.

Outra tecnica: mantenha um diretorio ~/.prompts/ com seus prompts mais usados em arquivos .txt, e execute-os com cat ~/.prompts/code-review.txt | claude -p.

6

🔧 Atalhos Customizados com keybindings.json

Alem dos atalhos padrao, o Claude Code permite personalizar keybindings atraves de um arquivo de configuracao. Isso significa que voce pode criar atalhos para acoes frequentes, mapear teclas de acordo com sua preferencia e ate criar "chord bindings" (sequencias de teclas) para fluxos de trabalho avancados.

🎯 Conceito Principal

O arquivo ~/.claude/keybindings.json permite definir atalhos personalizados para o Claude Code. Voce pode mapear qualquer combinacao de teclas para acoes internas, slash commands ou macros de texto.

  • Localizacao do arquivo: ~/.claude/keybindings.json - crie-o se nao existir. O Claude Code carrega automaticamente
  • Formato: JSON com array de objetos, cada um com "key" (a combinacao de teclas) e "command" (a acao a executar)
  • Chord bindings: Sequencias como Ctrl+K Ctrl+C (pressionar Ctrl+K seguido de Ctrl+C) para acoes avancadas
  • Integracao com terminal: Os keybindings do Claude Code coexistem com os do terminal. Evite conflitos testando antes de definir novos atalhos

⌨️ Exemplo de keybindings.json

// ~/.claude/keybindings.json
[
{
"key": "ctrl+shift+r",
"command": "/review"
},
{
"key": "ctrl+shift+t",
"command": "/test"
},
{
"key": "ctrl+shift+c",
"command": "/commit"
},
{
"key": "ctrl+shift+h",
"command": "/help"
}
]

💡 Dica Pratica

Comece com poucos keybindings e adicione conforme necessidade. Os mais uteis sao atalhos para slash commands que voce usa frequentemente: /review, /commit, /clear.

Evite conflitos com atalhos do terminal. Teste cada novo keybinding para garantir que nao sobrescreve algo importante. Use Ctrl+Shift+ como prefixo para minimizar conflitos, pois essa combinacao raramente e usada por terminais.

🏋️ Exercicio Pratico

Este exercicio e uma sessao cronometrada de 10 minutos para praticar todos os atalhos. O objetivo e internalizar os movimentos ate que se tornem memoria muscular. Configure um timer e vamos la.

🏋️

Exercicio: Sessao Cronometrada de Atalhos

Tempo estimado: 10 minutos (cronometrado)

1

Configurar o timer (Minuto 0)

Abra um timer de 10 minutos e inicie uma sessao Claude Code:

$ cd ~/projects/qualquer-projeto && claude
2

Praticar edicao de prompt (Minutos 0-3)

Digite um prompt longo e pratique:

# Digite: "Explique a arquitetura deste projeto em detalhes"
# Use Ctrl+A para ir ao inicio
# Use Ctrl+E para ir ao final
# Use Ctrl+W para deletar "detalhes"
# Use Alt+B para voltar 2 palavras
# Use Ctrl+U para limpar tudo
# Redigite e envie com Enter
3

Praticar controle de execucao (Minutos 3-5)

Faca uma pergunta longa e interrompa:

> Explique cada arquivo deste projeto em detalhes
# Aguarde 3 segundos e pressione Escape
> Resuma em 3 linhas
4

Praticar historico (Minutos 5-7)

Navegue pelo historico de prompts:

# Pressione Seta para cima para recuperar prompts anteriores
# Edite o prompt e envie a versao modificada
# Repita 3 vezes com variacoes
5

Praticar multi-line (Minutos 7-9)

Compose um prompt multi-line:

> Crie uma funcao que: [Shift+Enter]
- Receba um diretorio [Shift+Enter]
- Liste todos os arquivos .py [Shift+Enter]
- Conte as linhas de cada um [Enter]
6

Limpar e sair (Minuto 10)

Pratique limpar e encerrar:

# Use Ctrl+L para limpar a tela
# Use Ctrl+C duas vezes ou Ctrl+D para sair

Criterios de Sucesso

Usou Ctrl+A, Ctrl+E, Ctrl+W sem hesitar
Interrompeu geracao com Escape
Navegou historico com setas
Criou prompt multi-line com Shift+Enter

📋 Resumo do Modulo

Navegacao depende do terminal - Use Shift+PageUp/Down, Ctrl+Shift+F para busca, e considere tmux para sessoes longas.
Atalhos readline aceleram edicao - Ctrl+A/E para inicio/fim, Ctrl+W para deletar palavra, Ctrl+U para limpar linha.
Escape e Ctrl+C controlam execucao - Escape cancela geracao, Ctrl+C interrompe, Ctrl+C duplo sai da sessao.
Historico permite reusar prompts - Setas Up/Down navegam prompts anteriores. --resume retoma sessoes completas.
Multi-line com Shift+Enter ou heredoc - Compose prompts complexos com multiplas linhas sem enviar acidentalmente.
Keybindings personalizaveis - Configure ~/.claude/keybindings.json para atalhos customizados de slash commands.

Proximo Modulo:

1.7 - Criando Aliases e Scripts