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 crítica de memória do sistema, desde que a sessão tenha ficado ociosa por pelo menos 30 minutos e nenhum turno ou subagente esteja em execução
  • 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 do sistema
• Comandos em segundo plano em uma sessão local na qual você trabalha a partir de um terminal, do aplicativo desktop ou da extensão do VS Code não têm limite de tempo. Em uma sessão executada sem supervisão, como uma execução com -p ou uma sessão na nuvem, Claude Code interrompe um comando em segundo plano ao atingir seu limite de tempo
• Um comando em segundo plano que um subagente em primeiro plano iniciou termina quando a execução desse subagente termina, independentemente de ter terminado, falhado ou sido interrompido; veja Quando um comando em segundo plano para na referência de ferramentas

• 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: 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 ferramenta, Claude Code a passa para Claude assim que essas chamadas de ferramenta terminam, dentro do mesmo turno. Quando o turno 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 do turno, 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 no mesmo turno
• Apenas escrevendo uma resposta, ou executando algo que não pode se mover para o background: Claude Code interrompe o turno e envia suas mensagens em seguida. Antes da v2.1.281, a tecla interrompia o turno 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 requisição que faz nesse turno
• /effort: uma vez que você confirme o aviso de cache, se Claude Code mostrar um, Claude Code aplica sua alteração à próxima requisição que faz nesse turno
• /fast: Claude Code mantém a configuração de modo rápido que estava ativa quando o turno começou, portanto sua alteração de velocidade se aplica a partir de seu próximo turno. 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 requisição nesse turno

​

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
  

​

Sugestões do You should know

✦ Heads up · There was a change to how folder sharing starts in June, which may have bumped usage metrics artificially.
  1: Learn more   2: Knew this already   0: Dismiss

• Uma sessão que não busca as feature flags das quais o mod depende, como uma com DISABLE_TELEMETRY definida
• Uma primeira sessão após uma instalação ou atualização cujas flags ainda não chegaram

/plugin enable cc-plugin-you-should-know@builtin

​

Custo das verificações

​

Responder a uma nota

• Learn more: abre uma explicação curta abaixo da nota, com suas próprias opções:
  • Understood: fecha a explicação e marca o tópico como conhecido
  • Chat in main session: cita a nota na sua entrada de prompt para que você possa adicionar uma pergunta e enviá-la a Claude
  • Dismiss: fecha a explicação sem marcar o tópico como conhecido
• Knew this already: fecha a nota e marca o tópico como conhecido.
• Dismiss: fecha a nota.

​

Desativar o You should know

• No prompt do Claude Code, execute /plugin disable cc-plugin-you-should-know@builtin, ou desative-o na aba Installed de /plugin
• Depois de escolher Dismiss em uma nota sem abrir Learn more primeiro, escolha Turn off suggestions na linha Dismissed., que desaparece após 20 segundos

​

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

• Renderização em tela cheia: o painel de diff abre ao lado da conversa. Ele permanece aberto e se atualiza enquanto você continua trabalhando.
• Renderizador clássico: a caixa de diálogo de diff abre acima do prompt, e você a fecha quando terminar de ler.

​

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.287 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.
• Perguntar a Claude sobre as alterações de um arquivo: clique em ask, à direita do nome do arquivo acima de seu diff. Claude Code anexa o diff desse arquivo ao seu próximo prompt, e o botão exibe asked ✓ até que você envie esse prompt. Perguntar sobre um segundo arquivo substitui o primeiro.
• Mostrar as edições de um turno: clique no seletor source no cabeçalho do painel, depois escolha um turno com Up e Down e pressione Enter. Os turnos são rotulados T1, T2 e assim por diante. O seletor aparece assim que Claude tiver editado arquivos, e Current retorna você à árvore de trabalho.
• Mostrar os arquivos que o painel deixa de fora: a lista pula arquivos de teste e arquivos gerados, e recolhe 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 sem commit como uma lista, e tudo desde que seu branch se separou do branch padrão. Claude Code lembra a escolha para cada repositório.

​

Caixa de diálogo de diff

• 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 a caixa de diálogo a partir da lista.
• Tab: mova-se para o seletor source, depois escolha Current ou uma visualização de turno com Cima e Baixo e pressione Enter. No diff de um arquivo, Tab move para o botão ask. Pressione Enter para anexar o diff desse arquivo ao seu próximo prompt.

​

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 · limit resets 3:45pm
Continuing automatically at 3:45pm · esc to cancel

• No reset: a segunda linha muda para Continuing shortly · esc to cancel. Em seguida, Usage limit reset · continuing automatically aparece na conversa, e Claude Code solicita a Claude que retome 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 primeira linha diz Your usage limit has reset e a segunda diz Press enter to continue. Pressione Enter para continuar. Após um sono mais curto, ou um que terminou antes do reset, 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 envia seu prompt em vez de aguardar. Se seu prompt também atingir o limite, ele permanece na conversa e Claude Code inicia a espera novamente.
• 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
• Qualquer referência em uma resposta com mais de cerca de 1.000 linhas ou 100.000 caracteres

​

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