Modo interativo

​

Atalhos de teclado

​

Controles gerais

​

Edição de texto

​

Limites de palavra em atalhos de edição

​

Tema e exibição

​

Entrada multilinha

​

Comandos rápidos

​

Visualizador de transcrição

​

Entrada de voz

​

Comandos

​

Completar um comando no meio do prompt

• Na renderização em tela cheia: as correspondências aparecem como uma lista enquanto você digita, sem nenhuma linha destacada, portanto Enter ainda envia seu prompt conforme digitado. Pressione Tab para inserir a correspondência superior, ou escolha uma linha com as setas e Enter.
• Fora da tela cheia: o resto da correspondência superior aparece como texto fantasma no seu cursor, com uma contagem como +2 quando mais comandos correspondem. Pressione Tab para inserir a única correspondência, ou para abrir a lista quando várias correspondem, depois escolha uma linha com as setas e Enter.

​

Modo editor Vim

​

Alternância de modo

​

Remapear sequências de teclas no modo INSERT

{
  "editorMode": "vim",
  "vimInsertModeRemaps": { "jj": "<Esc>" }
}

​

Navegação (modo NORMAL)

​

Edição (modo NORMAL)

​

Objetos de texto (modo NORMAL)

​

Modo visual

​

Histórico de comandos

• O histórico de entrada é armazenado por diretório de trabalho
• Executar /clear inicia uma nova sessão: a recuperação então lista os prompts da nova sessão primeiro, com os prompts de sessões anteriores depois deles. 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
• Quando você recupera um prompt que incluía texto colado, Claude Code envia o conteúdo colado completo novamente quando você reenvia. Se o conteúdo foi limpo, Claude Code não envia a string literal [Pasted text #N]; veja Colar conteúdo grande para o que acontece com o prompt
• A expansão de histórico com ! está desabilitada por padrão

​

Busca reversa com Ctrl+R

1. Iniciar pesquisa: pressione Ctrl+R para ativar a busca reversa de histórico
2. Digite a consulta: insira o texto a ser pesquisado em comandos anteriores. O termo de pesquisa é destacado nos resultados correspondentes
3. Navegue pelas correspondências: pressione Ctrl+R novamente para alternar entre correspondências mais antigas
4. Escopo de pesquisa: a pesquisa inline sempre pesquisa prompts de 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

​

Comandos Bash em segundo plano

​

Como o segundo plano funciona

• Solicitar ao Claude Code que execute 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 à chave de prefixo do tmux.

• A saída é escrita em um arquivo e Claude pode recuperá-la usando a ferramenta Read
• As tarefas em segundo plano têm IDs exclusivos para rastreamento e recuperação de saída
• As tarefas em segundo plano são limpas automaticamente quando Claude Code sai. No macOS e Linux, quando você interrompe uma tarefa em segundo plano de /tasks ou Claude Code a interrompe ao sair, os processos que se desvincularam do shell da tarefa, como aqueles iniciados sob setsid ou timeout, também param
• Se você colocar a sessão em segundo plano em vez de sair dela, suas tarefas em segundo plano continuarão sendo executadas na sessão em segundo plano. Veja colocar uma sessão em execução em segundo plano
• As tarefas em segundo plano são automaticamente encerradas se a saída exceder 5GB, com uma nota em stderr explicando o motivo
• No macOS e Linux, Claude Code encerra as tarefas em segundo plano em execução quando o sistema operacional sinaliza pressão de memória crítica, desde que a sessão tenha ficado ociosa por pelo menos 30 minutos e nenhuma volta ou subagente esteja em execução. Requer Claude Code v2.1.193 ou posterior
  • O log de depuração diz por que as tarefas foram interrompidas, ou por que um evento de pressão as deixou em execução
  • Defina CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP como 1 para desativar paradas por pressão de memória
• Comandos em segundo plano pertencentes a um subagente não têm limite de tempo, exceto que um comando pertencente a um subagente em execução em primeiro plano termina quando esse subagente fornece sua resposta final; veja Comandos em segundo plano na referência de ferramentas. Antes da v2.1.218, nem a recolha de pressão de memória nem o limite anterior de 60 minutos em comandos de subagente cobriam comandos movidos para o segundo plano com Ctrl+B

• Ferramentas de compilação (webpack, vite, make)
• Gerenciadores de pacotes (npm, yarn, pnpm)
• Executores de testes (jest, pytest)
• Servidores de desenvolvimento
• Processos de longa duração (docker, terraform)

​

Modo shell com prefixo !

! npm test
! git status
! ls -la

• Adiciona o comando e sua saída ao contexto da conversa
• Mostra progresso e saída em tempo real
• Suporta o mesmo backgrounding 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, como ./src/ ou ~/, para ver uma lista suspensa de arquivos e diretórios correspondentes, depois pressione Tab para aceitar. Use barras para frente 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 de ! digitado

​

Enfileirar mensagens enquanto Claude trabalha

​

Quando Claude Code envia o que você enfileirou

• Mensagens: se você enfileirar uma mensagem enquanto Claude está executando chamadas de ferramentas, Claude Code a passa para Claude assim que essas chamadas de ferramentas terminam, dentro da mesma rodada. Quando a rodada termina com mensagens ainda enfileiradas, elas saem sem outra pressão de tecla, na ordem em que você as digitou
• Comandos e comandos shell: Claude Code os mantém até o final da rodada, depois os executa um de cada vez, mantendo a ordem em que você os enfileirou

• Executando comandos shell, subagentes ou outro trabalho que pode se mover para o background: esse trabalho se move para o background e continua em execução, e Claude lê suas mensagens na mesma rodada
• Apenas escrevendo uma resposta, ou executando algo que não pode se mover para o background: Claude Code interrompe a rodada e envia suas mensagens em seguida. Antes da v2.1.281, a tecla interrompia a rodada em ambos os casos

• /model: uma vez que você confirme o aviso de cache, se Claude Code mostrar um, Claude Code aplica sua alteração à próxima solicitação que faz nessa rodada
• /effort: uma vez que você confirme o aviso de cache, se Claude Code mostrar um, Claude Code aplica sua alteração à próxima solicitação que faz nessa rodada
• /fast: Claude Code mantém a configuração de modo rápido que estava ativa quando a rodada começou, portanto sua alteração de velocidade se aplica a partir de sua próxima rodada. Se seu modelo atual não suportar modo rápido, ativá-lo também alterna seu modelo, e Claude Code usa o novo modelo a partir de sua próxima solicitação nessa rodada

​

Recupere o que você enfileirou

​

Sugestões de prompt

• Pressione Tab ou Seta para a direita para colocar a sugestão na entrada de prompt e depois Enter para enviar
• Comece a digitar para descartá-la

​

Quando Claude Code pula sugestões

• O cache de prompt está frio, para evitar custo desnecessário
• Após a primeira volta de uma conversa, em algumas sessões
• A resposta anterior terminou em um erro
• Enquanto você está no Plan Mode
• Sua conta está próxima ou no limite de uso. Para manter as sugestões ativadas até atingir o limite, defina CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION como true. Antes da v2.1.238, Claude Code as pulava perto do limite mesmo com a variável definida como true
• Em uma equipe de agentes, nas sessões de colegas de equipe por padrão. A sessão do líder mostra sugestões

​

Desativar sugestões de prompt

• Desative Prompt suggestions em /config
• Defina promptSuggestionEnabled como false no seu arquivo de configurações
• Defina a variável de ambiente CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION como false, que tem precedência sobre a configuração:
  export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false
  

​

Códigos de emoji

• Digite um código completo como :heart: e Claude Code o substitui por ❤️ assim que você digita o : de fechamento
• Digite : mais pelo menos dois caracteres de um nome, como :hea, para abrir um popup de sugestão, depois pressione Tab ou Enter para inserir o emoji destacado

​

Verificar ortografia enquanto você digita

​

Pré-requisitos

• Instale aspell, hunspell, ou ispell e certifique-se de que está em seu PATH. Claude Code executa o primeiro dos três que encontra, nessa ordem, em todas as plataformas, incluindo um shim .cmd que um gerenciador de pacotes instala no Windows.
• Para verificar se o programa está em seu PATH, execute aspell --version, hunspell --version, ou ispell -v em seu terminal. Um erro “command not found” significa que ainda não está em seu PATH.

​

Ativar ou desativar a verificação de ortografia

{
  "spellcheck": { "enabled": true }
}

{
  "spellcheck": { "enabled": true }
}

claude --settings spellcheck.json

{
  "spellcheck": { "enabled": true }
}

• checker: aspell, hunspell, ou ispell. Claude Code não volta de um verificador que você nomeia e trata qualquer outro valor como auto.
• language: um nome de dicionário na forma do seu verificador, como en_GB. Claude Code ignora qualquer valor que não seja um nome de dicionário simples, como um caminho ou um nome com espaços, e o verificador usa seu dicionário padrão.
• color: um nome de cor como yellow, ou um valor #rrggbb, #rgb, rgb(r,g,b), ansi256(n), ou ansi:<name>. Claude Code usa a cor de erro do seu tema por padrão e para qualquer valor que não reconheça.

{
  "spellcheck": {
    "enabled": true,
    "checker": "hunspell",
    "language": "en_GB",
    "color": "yellow"
  }
}

​

O que Claude Code sublinha

• Comandos como /help, menções @, URLs, caminhos de arquivo e sinalizadores como --verbose
• Palavras com dígitos, sublinhados ou uma letra maiúscula após a primeira, e texto entre backticks

​

Quando Claude Code não sublinha nada

• Nenhum verificador está instalado, ou o que você nomeou em checker está faltando
• O verificador falha duas vezes seguidas, na inicialização ou posteriormente na sessão. Claude Code o reinicia após a primeira falha e para de verificar após a segunda, até que você reinicie Claude Code
• O verificador leva mais de 15 segundos para responder, três vezes. Cada vez, Claude Code deixa as palavras que estava esperando sem marcar; após a terceira, ele para de verificar até que você reinicie Claude Code

​

Caracteres invisíveis em prompts

​

Revise alterações com /diff

​

Painel de diff

• Renderização em tela cheia
• Um repositório git
• Um terminal com pelo menos 110 colunas de largura
• Claude Code v2.1.260 ou posterior

• Ir para um arquivo: clique em sua linha na lista. Role o painel com a roda do mouse. Quando a lista de arquivos em si é muito longa para caber, role-a com Alt+Up e Alt+Down, ou Ctrl+Up e Ctrl+Down.
• Pergunte a Claude sobre linhas específicas: selecione-as no painel com o mouse. Claude Code anexa a seleção ao seu próximo prompt e mostra uma contagem de linhas na entrada até que você o envie.
  • Para enviar o prompt sem a seleção, mova o cursor para logo após o indicador de contagem de linhas e pressione Backspace para deletá-lo. Requer Claude Code v2.1.271 ou posterior.
• Mostrar os arquivos que o painel deixa de fora: a lista pula arquivos de teste e arquivos gerados, e collapsa alterações de antes desta sessão em uma linha na parte inferior. Clique em qualquer linha de contagem para expandi-la.
• Alterar com o que o painel compara: pressione Ctrl+X B para alternar entre as alterações desta sessão, suas alterações não confirmadas como uma lista, para tudo desde que sua ramificação se dividiu da ramificação padrão. Claude Code lembra a escolha para cada projeto.

​

Visualizador de diff

• Esquerda e Direita: mova-se entre Current e as visualizações de turno.
• Cima e Baixo: selecione um arquivo.
• Enter: abra o diff do arquivo selecionado. Role-o com Cima e Baixo, ou PageUp e PageDown.
• Esc: retorne do diff de um arquivo para a lista, ou feche o visualizador da lista.

​

Perguntas laterais com /btw

/btw what was the name of that config file again?

• 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. Ela vê tudo na conversa até agora, exceto a resposta que Claude ainda está escrevendo.
• 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. Se Claude escrever chamadas de ferramentas como texto mesmo assim, a resposta termina com uma nota de que nada foi executado.
• Resposta única: não há turnos de acompanhamento na sobreposição. Para continuar o thread, faça outra pergunta /btw. Para continuar com acesso total a ferramentas em uma sessão local, pressione f para bifurcar esta pergunta e resposta em um subagentesubagente de fundo.
• Baixo custo: enquanto o cache de prompt da conversa está aquecido, uma pergunta lateral custa pouco além da resposta em si.

​

Lista de tarefas

• 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
• Se você deixar a lista expandida, Claude Code restaura a visualização expandida na próxima vez que você iniciar uma sessão que ainda tenha tarefas, como com --resume ou --continue. Quando a lista de tarefas está vazia, Claude Code a inicia recolhida
• Para ver todas as tarefas ou limpá-las, peça a Claude diretamente: “show me all tasks” ou “clear all tasks”
• As tarefas persistem entre 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

​

Recapitulação da sessão

​

Aguarde o reset de um limite de uso

Usage limit reached · continuing automatically at 3:45pm · esc to cancel

• No reset: a linha lê continuing shortly, depois Usage limit reset · continuing automatically, e Claude Code envia a Claude um prompt fixo para retomar a tarefa de onde parou. Ele não reenvia sua última mensagem.
• Após seu computador dormir: se ele dormiu por mais de cerca de 30 minutos e o limite foi resetado enquanto dormia, a linha lê Your usage limit has reset · press enter to continue. Pressione Enter para continuar. Após um sono mais curto, Claude Code continua automaticamente.
• Antecipadamente: quando você termina de adicionar créditos de uso com /usage-credits, faz login novamente após /upgrade, ou muda de modelo com /model durante a espera, Claude Code verifica se o uso está disponível novamente e continua imediatamente se estiver. Ele não verifica após uma atualização ou compra que você faz em um navegador por conta própria. Em opusplan e outras configurações de modelo que executam o modo de plano em um modelo diferente, Claude Code aguarda o reset.

​

Cancelar a espera

• Você envia um prompt: Claude Code executa seu prompt em vez de aguardar.
• Você sai do Claude Code: a espera não reinicia quando você retoma a sessão.
• A conversa muda de mãos: você muda de conta com /login, limpa ou retrocede a conversa, /resume outra sessão, puxa uma com /teleport, relança com /tui, ou entrega a sessão ao Claude Desktop, uma sessão em segundo plano, ou a nuvem.
• A configuração é desativada, ou o reset passa de 24 horas: isso encerra apenas uma espera que Claude Code iniciou por conta própria. Uma espera que você escolheu de /rate-limit-options continua contando regressivamente.
• A continuação é bloqueada: um hook UserPromptSubmit que bloqueia o prompt de continuação, ou uma falha antes de atingir o modelo, encerra a espera. Claude Code informa que a continuação não foi executada. Envie um prompt para continuar.

​

Inicie uma espera você mesmo

• Sessões de Remote Control e colega de equipe de agente: uma pessoa nesse terminal ainda pode iniciar uma.
• Um reset a mais de 24 horas de distância: um limite semanal pode resetar dias depois.
• Um limite de Opus ou Sonnet enquanto você executa um modelo fora dessa família: seu próximo turno pode não atingir esse limite. opusplan e outras configurações de modelo que executam o modo de plano na família limitada não recebem essa exceção.

• Sessões em segundo plano e execuções -p: a linha do menu não está disponível.
• Chaves de API, provedores de nuvem e faturamento baseado em uso: o uso lá é medido por solicitação, portanto não há reset para aguardar.
• Um gateway LLM sem um login do claude.ai salvo: Claude Code oferece a espera apenas enquanto um login do claude.ai salvo é a credencial ativa.

​

Desative a continuação automática

​

Status de revisão de PR

• Verde: aprovado
• Amarelo: revisão pendente
• Vermelho: alterações solicitadas
• Cinza: rascunho

​

Merge requests do GitLab

• Verde: GitLab relata o merge request como mesclável
• Amarelo: qualquer outro estado aberto
• Cinza: rascunho

• Claude Code v2.1.234 ou posterior
• Um remote de repositório que aponte para seu host GitLab, seja gitlab.com ou uma instância auto-gerenciada
• A glab CLI no seu PATH, autenticada com glab auth login

​

Links de referência de problemas

• Um #123 isolado
• Um caminho GitLab aninhado como group/subgroup/project#123
• Qualquer referência dentro de um intervalo de código ou bloco de código

​

Veja também

• Skills - Prompts e fluxos de trabalho personalizados
• Checkpointing - Retroceder edições do Claude e restaurar estados anteriores
• Referência CLI - Sinalizadores e opções de linha de comando
• Configurações - Opções de configuração
• Gerenciamento de memória - Gerenciando arquivos CLAUDE.md