Modo interativo

Referência completa para atalhos de teclado, modos de entrada e recursos interativos em sessões do Claude Code.

Atalhos de teclado

Controles gerais

Edição de texto

Limites de palavra em atalhos de edição

Os atalhos de palavra Alt+B, Alt+F, Alt+D, Option+Delete e Ctrl+Backspace tratam uma palavra como uma sequência de letras e dígitos, então pontuação como _, . e / separa palavras. Com src/utils/foo.ts no prompt, pressionamentos repetidos de Alt+B param no início de ts, foo, utils e src.

Ctrl+W é diferente: ignora pontuação e deleta de volta até o espaço em branco anterior, então um pressionamento remove tudo de src/utils/foo.ts.

Em texto escrito sem espaços, como chinês ou japonês, os atalhos de palavra ainda se movem ou deletam uma palavra por vez.

Essas convenções readline se aplicam no Claude Code v2.1.261 e posterior. A configuração keybindingFlavor que as ativou em versões anteriores está descontinuada e não tem efeito.

Você não pode remapear esses atalhos no arquivo de configuração de atalhos de teclado, que não tem ações para eles.

Tema e exibição

Entrada multilinha

Comandos rápidos

Visualizador de transcrição

Quando o visualizador de transcrição está aberto (alternado com Ctrl+O), esses atalhos estão disponíveis. Execute /tui sem argumento para verificar qual renderizador está ativo. Ctrl+E pode ser remapeado via transcript:toggleShowAll.

Entrada de voz

Comandos

Digite / no Claude Code para ver os comandos disponíveis para você, ou digite / seguido de qualquer letra para filtrar. O menu / lista comandos integrados, skills agrupadas e criadas 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 da sua plataforma ou plano, e alguns comandos disponíveis estão ocultos do menu por design e são executados quando você digita seu nome completo.

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.

Consulte a referência de comandos para obter a lista completa de comandos incluídos no Claude Code.

Completar um comando no meio do prompt

A conclusão de comando também funciona no meio de um prompt: digite / após um espaço, depois as primeiras letras de um nome, como em executar os testes, depois /com. Apenas comandos cujos nomes começam com essas letras correspondem, portanto um caminho de arquivo como /tmp/notes.md não mantém uma lista aberta. Claude Code executa um comando apenas quando o comando inicia sua mensagem.

• 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.

Em ambos os renderizadores, pressione Tab em um / nu no meio do prompt para listar todos os comandos.

Uma skill de plugin corresponde também ao seu nome nu, portanto /deploy encontra uma skill nomeada myplugin:deploy-app. Quando você insere a correspondência, Claude Code escreve o /myplugin:deploy-app completo.

Modo editor Vim

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

Claude Code mantém seu modo vim e posição do cursor quando você alterna o visualizador de transcrição com Ctrl+O ou abre e fecha um painel como /config. Se você deixar o prompt em modo NORMAL, ele ainda estará em modo NORMAL quando você retornar, com o cursor onde você o deixou.

Alternância de modo

Remapear sequências de teclas no modo INSERT

A configuração vimInsertModeRemaps mapeia uma sequência de dois caracteres 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 exemplo ~/.claude/settings.json a seguir ativa o modo vim e mapeia jj para Escape:

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

Cada chave é 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 fazendo uma pausa entre os dois caracteres.

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.

Navegação (modo NORMAL)

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 sobre ela diretamente.

O modo visual por bloco com Ctrl+V não é suportado.

Histórico de comandos

Claude Code mantém um histórico dos prompts que você digita, e a recuperação com seta para cima alcança prompts de sessões anteriores do mesmo projeto:

• 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

Pressione Ctrl+R para pesquisar interativamente através do seu histórico de comandos. Na renderização em tela cheia, Ctrl+R abre um diálogo de pesquisa: digite para filtrar, pressione Seta para cima e Seta para baixo para se mover através das correspondências, e pressione Ctrl+S para alternar o escopo através desta sessão, este projeto e todos os projetos. Pressione Enter ou Tab para colocar uma correspondência na entrada do prompt, ou Esc para cancelar. Os passos abaixo descrevem a pesquisa inline do renderizador clássico:

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

A pesquisa inline verifica seu histórico de prompt completo, mais recente primeiro, com duplicatas recolhidas para a ocorrência mais recente. O diálogo em tela cheia pesquisa todo o seu histórico de prompt no escopo selecionado, mais recente primeiro, com duplicatas recolhidas para a ocorrência mais recente: os prompts mais recentes aparecem imediatamente, e correspondências de prompts mais antigos preenchem conforme Claude Code carrega o resto. 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 efeito imediatamente, mesmo enquanto Claude Code ainda está carregando o histórico.

Comandos Bash em segundo plano

Claude Code suporta a 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 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.

Recursos principais:

• 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

Para desabilitar toda a funcionalidade de tarefas em segundo plano, defina a variável de ambiente CLAUDE_CODE_DISABLE_BACKGROUND_TASKS como 1. Veja Variáveis de ambiente para detalhes.

Comandos comuns colocados em segundo plano:

• 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 `!`

Execute comandos shell diretamente sem passar por Claude prefixando sua entrada com !:

! npm test
! git status
! ls -la

Modo shell:

• 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

A menos que sua sessão seja uma daquelas listadas em modo de sandbox estrito, os comandos que você digita no modo shell são executados fora da sandbox mesmo quando você ativou sandboxing, porque a sandbox se aplica aos comandos que Claude executa.

Claude responde automaticamente à saída do comando 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 como false em settings.json. Antes da v2.1.186, o modo shell sempre adicionava saída ao contexto sem uma resposta.

Enfileirar mensagens enquanto Claude trabalha

Digite uma mensagem e pressione Enter enquanto Claude está trabalhando. Claude Code enfileira a mensagem em vez de interromper a rodada, e lista as entradas enfileiradas acima da caixa de entrada até enviá-las. Você pode enfileirar ! comandos shell e a maioria dos comandos da mesma forma, com exceção dos comandos, como /status, que Claude Code executa assim que você os envia.

Mensagens enviadas e enfileiradas aparecem em cinza até Claude começar a responder a elas, para que você possa saber quais mensagens Claude ainda não começou.

Quando Claude Code envia o que você enfileirou

Quando uma entrada enfileirada é enviada por Claude Code depende do 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

Para enviar o que você enfileirou sem esperar, pressione Ctrl+Enter. Suas mensagens enfileiradas saem imediatamente, com seu rascunho enfileirado atrás delas se você tiver digitado um. Requer Claude Code v2.1.275 ou posterior.

Se você enfileirou um comando ! shell à frente de suas mensagens, a tecla interrompe a rodada. Caso contrário, o que acontece com a rodada depende do que Claude está fazendo quando você pressiona a tecla:

• 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

Em modo shell, a tecla apenas enfileira seu comando. Em terminais que não relatam teclas estendidas, Ctrl+Enter chega como Enter simples e enfileira o rascunho em vez disso; Ctrl+X Ctrl+S funciona em qualquer terminal. Ambas as teclas são vinculações da ação chat:sendNow.

Pressione Esc para interromper a rodada sem enviar seu rascunho. Claude Code mantém o que você enfileirou e o envia imediatamente.

Claude Code executa alguns comandos assim que você os envia em vez de enfileirá-los, entre eles /model, /effort e /fast. Cada um dos três altera uma configuração: o modelo, o nível de esforço ou o modo rápido. Se Claude Code aplica a nova configuração à rodada em que Claude já está trabalhando, ou apenas a partir de sua próxima rodada, difere por comando:

• /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

Pressione Up a partir da primeira linha da caixa de entrada para recuperar as mensagens e comandos enfileirados. Claude Code os remove da fila e os coloca na caixa de entrada, um por linha, à frente de qualquer texto que você tenha digitado. Edite o texto e pressione Enter para enfileirá-lo novamente como uma entrada, ou limpe a caixa de entrada para descartá-lo.

Claude Code recupera comandos shell enfileirados apenas quando a caixa de entrada está vazia e você não tem nada mais enfileirado, e alterna a caixa de entrada para modo shell quando o faz. Caso contrário, os deixa na fila, listados com seu prefixo !, e os executa após o término da rodada.

Sugestões de prompt

Quando você abre uma sessão pela primeira vez, Claude Code mostra um comando de exemplo esmaecido na entrada de prompt para ajudá-lo a começar. Ele escolhe isso do histórico git do seu projeto, portanto o exemplo reflete arquivos nos quais você trabalhou recentemente.

Depois que Claude responde, Claude Code pode sugerir seu próximo prompt com base no histórico da 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 Seta para a direita para colocar a sugestão na entrada de prompt e depois Enter para enviar
• Comece a digitar para descartá-la

Claude Code gera cada uma dessas sugestões de próximo prompt com uma solicitação em segundo plano para o mesmo modelo que sua sessão está usando. A solicitação conta para os limites de uso do seu plano ou seus custos de API. Como reutiliza o cache de prompt da conversa, é principalmente leituras de cache mais alguns tokens de saída, portanto o custo adicional é pequeno.

Quando Claude Code pula sugestões

No modo interativo, Claude Code deixa as sugestões de prompt desativadas por padrão e oculta o toggle Prompt suggestions em /config em uma sessão que não busca sinalizadores de recurso, como uma em um provedor de terceiros ou através de um gateway de aplicativos Claude, e em uma primeira sessão após uma instalação ou atualização cujos sinalizadores ainda não chegaram.

Claude Code também pula sugestões individuais em várias situações, incluindo:

• 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

No modo de impressão, Claude Code não gera sugestões por padrão. Passe --prompt-suggestions com -p "<prompt>" --output-format stream-json --verbose para que Claude Code emita uma mensagem prompt_suggestion após cada volta que gera uma. O gerador pula conversas muito curtas e caches de prompt frios aqui também, portanto uma única consulta -p curta pode não emitir nenhuma.

Desativar sugestões de prompt

Para desativar completamente as sugestões de prompt, use qualquer uma das seguintes opções:

• 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
  

Para desativar as sugestões de prompt em toda uma organização, defina promptSuggestionEnabled como false em configurações gerenciadas. Também defina CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION como false sob a chave env gerenciada para que os usuários não possam reativá-las com sua própria variável de ambiente.

Códigos de emoji

Digite um : seguido por um código de emoji no campo de entrada do prompt para inserir o emoji. Requer Claude Code v2.1.217 ou posterior.

• 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

O código deve começar a entrada ou seguir um espaço, portanto um : dentro de uma palavra ou URL não abre sugestões.

Para desativar o recurso, defina emojiCompletionEnabled como false em settings.json. Isso desativa tanto o popup de sugestão quanto a substituição inline.

Verificar ortografia enquanto você digita

Claude Code pode sublinhar palavras com erros de ortografia na entrada do prompt enquanto você digita. Ele verifica apenas o texto na caixa de entrada, nunca as respostas do Claude ou seus arquivos. Ele também não verifica nada enquanto a caixa de entrada está em modo shell, busca de histórico Ctrl+R, ou ditado por voz.

A verificação de ortografia está desativada por padrão, e Claude Code não verifica nada em modo leitor de tela. Requer Claude Code v2.1.235 ou posterior.

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

Claude Code lê a configuração spellcheck de três lugares e a ignora no .claude/settings.json e .claude/settings.local.json de um projeto. Ative-a em qualquer um que você use:

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

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

claude --settings spellcheck.json

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

Para verificar se a verificação de ortografia está ativada, digite uma palavra com erro de ortografia e um espaço. Claude Code sublinha a palavra. Se não fizer isso, consulte Quando Claude Code não sublinha nada. Para desativar a verificação de ortografia novamente, defina enabled como false no mesmo lugar ou remova spellcheck.

Para escolher qual dos três programas Claude Code executa, qual dicionário ele usa ou a cor do sublinhado, adicione qualquer um desses campos ao lado de enabled, no mesmo lugar:

• 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.

Por exemplo, essa configuração spellcheck executa hunspell com seu dicionário en_GB e sublinha palavras em amarelo. Funciona da mesma forma em ~/.claude/settings.json, no arquivo que você passa para --settings e nas configurações gerenciadas:

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

Se mais de um dos três lugares tiver uma configuração spellcheck, Claude Code usa apenas um deles: configurações gerenciadas primeiro, depois --settings, depois configurações do usuário. Ele não combina campos de dois lugares. Por exemplo, quando --settings define spellcheck, um language em suas configurações do usuário não tem efeito.

O que Claude Code sublinha

Pouco depois que você pausa de digitar, Claude Code sublinha as palavras que o dicionário não conhece. Ele deixa a palavra que você ainda está digitando sozinha até que você se mova além dela, e nunca altera seu texto. Ele também pula texto que parece código:

• 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

Claude Code também pula texto em chinês, japonês, coreano, tailandês, laosiano, khmer e birmanês.

Claude Code não tem sua própria lista de palavras: uma palavra está com erro de ortografia quando seu verificador diz que está. Para impedir que Claude Code sublinhe uma palavra, adicione a palavra ao dicionário pessoal do seu verificador, seguindo a documentação do próprio verificador. Claude Code pega a nova palavra após reiniciá-lo.

Quando Claude Code não sublinha nada

Claude Code não sublinha nada quando não consegue manter um verificador em execução:

• 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

Para descobrir qual desses aconteceu, inicie claude --debug com a verificação de ortografia ativada e digite uma palavra. Em seguida, procure pelas linhas [spellcheck] no log de depuração em ~/.claude/debug/<session-id>.txt. Uma linha nomeia o programa que Claude Code iniciou ou lista os que procurou e não encontrou. Linhas posteriores dizem por que parou. Um erro de dicionário ausente lá significa que o verificador não tem dicionário para seu valor language, ou nenhum padrão quando language não está definido. Instale um ou defina language para um dicionário que você tenha.

Caracteres invisíveis em prompts

O texto colado pode conter caracteres Unicode que um terminal desenha como nada, como caracteres de tag, controles bidirecionais e espaços de largura zero, portanto um prompt pode conter texto que você nunca vê. Para evitar que o texto copiado carregue instruções que seu terminal não desenha, Claude Code remove esses caracteres quando você pressiona Enter, antes de enviar qualquer coisa. Ele limpa tanto o prompt quanto o conteúdo de qualquer referência de texto colado que o prompt inclui. Claude Code mantém os juntadores que scripts persa e índico escrevem e os seletores dentro de sequências de emoji.

Se Claude Code removeu algo, esse Enter não envia nada. O prompt limpo volta para a caixa de entrada com um aviso como Removed 3 invisible characters · review and press Enter to send, e pressionar Enter novamente envia o texto conforme mostrado.

Quando você passa um prompt na linha de comando, como em claude "fix the login bug", ou canaliza um para uma sessão interativa, Claude Code não espera por um segundo Enter. Ele remove os caracteres, mostra um aviso e envia o prompt limpo. Se o prompt limpo começaria com /, Claude Code o coloca na caixa de entrada para você revisar e enviar.

Revise alterações com /diff

Execute /diff para revisar as alterações em sua árvore de trabalho sem sair do Claude Code. Você vê as edições que Claude fez até agora junto com qualquer outra coisa que você não tenha confirmado.

Nas alterações que /diff lê do git, um submódulo aparece como uma única entrada, e apenas quando o commit para o qual aponta muda; edições de arquivos dentro do submódulo não aparecem lá.

Na renderização em tela cheia, /diff abre o painel de diff ao lado da conversa, que permanece aberto e se atualiza enquanto você continua trabalhando. No renderizador clássico, /diff abre o visualizador de diff no lugar do prompt, e você o fecha quando terminar de ler.

Painel de diff

O painel de diff lista os arquivos alterados com suas contagens de linhas adicionadas e removidas, e mostra o diff de cada arquivo sob a lista. Claude Code o atualiza cada vez que Claude edita um arquivo ou executa um comando shell. Para fechá-lo, execute /diff novamente ou clique no ✕ em seu cabeçalho.

Para usar o painel você precisa:

• 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

Quando o painel não consegue abrir, /diff abre o visualizador de diff em seu lugar ou informa o motivo.

O painel também abre por conta própria assim que Claude começa a editar arquivos, se seu terminal tiver pelo menos 144 colunas de largura. Depois que você o abrir com /diff, as sessões posteriores o abrem assim que Claude edita um arquivo em qualquer terminal com largura suficiente para ajustá-lo. Feche o painel e ele permanecerá fechado, nesta sessão e nas posteriores, até que você execute /diff novamente.

Enquanto o painel está aberto, você pode:

• 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.

Para vincular teclas a essas ações, consulte Ações do painel de diff.

Visualizador de diff

O visualizador de diff ocupa o lugar do prompt até que você o feche. Sua visualização Current mostra suas alterações não confirmadas do git, ou, quando não há nenhuma, o que sua ramificação adiciona na ramificação padrão. O visualizador também tem uma visualização de turno para cada prompt após o qual Claude editou arquivos, mostrando apenas essas edições. Claude Code constrói as visualizações de turno a partir das edições de arquivo do Claude em vez do git, portanto uma alteração que Claude faz através de um comando shell aparece apenas em Current.

Use essas teclas no visualizador:

• 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.

Para reatribuir essas teclas, consulte Ações de diff.

Perguntas laterais com /btw

Use /btw para fazer uma pergunta sobre seu trabalho atual sem adicionar ao histórico de conversa.

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

Claude responde uma pergunta lateral a partir do que já está na conversa: suas mensagens, suas respostas e os resultados de ferramentas que coletou. Você pode perguntar sobre código que Claude já leu, decisões que tomou anteriormente ou qualquer outra coisa da sessão. Uma pergunta lateral posterior também vê suas perguntas laterais anteriores: Claude Code reproduz as 20 trocas mais recentes com cada pergunta, até você limpá-las. A pergunta e a resposta nunca entram no histórico de conversa. No terminal, elas aparecem em uma sobreposição dispensável. O terminal mantém o thread na memória: pressione x para limpar as trocas anteriores, e desaparece quando você sai do Claude Code.

Na extensão do VS Code do painel de chat, /btw abre um painel em vez da sobreposição que esta seção descreve, e você faz perguntas de acompanhamento direto no painel. O thread do painel sobrevive a recarregamentos de janela, no cronograma de retenção que essa página descreve. Você precisa da extensão na versão 2.1.227 ou posterior. Versões anteriores da extensão não oferecem /btw.

• 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.

Suas cinco perguntas laterais anteriores mais recentes aparecem como uma lista esmaecida acima da resposta atual, com uma contagem de qualquer uma mais antiga. Elas ficam fora do histórico de conversa.

Para retornar à sobreposição após dispensá-la, execute /btw sem uma pergunta. A sobreposição reabre em sua troca mais recente. Antes da v2.1.212, /btw sem uma pergunta imprimia uma mensagem de uso em vez disso.

Assim que a resposta aparecer, a sobreposição aceita essas teclas.

Em uma sessão de fundo anexada, Left desanexa e retorna você à visualização de agente, mesmo enquanto a resposta ainda está chegando. A pergunta lateral continua em execução enquanto você está ausente. Na próxima vez que você anexar à sessão, a sobreposição reabre com a pergunta lateral ou com sua resposta. Antes da v2.1.257, Left não desanexava lá.

/btw vê sua conversa completa mas não tem ferramentas. Um subagentesubagente tem ferramentas e começa a partir do prompt que recebe, ou, para uma bifurcação, a partir de uma cópia desta conversa. Use /btw para perguntar sobre o que Claude já sabe desta sessão; use um subagentesubagente 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 concluído. É separada da visualização de tarefa em segundo plano. Para ver shells em execução e subagentes, use /tasks em vez disso.

A lista é preenchida apenas em sessões que possuem as ferramentas de rastreamento de tarefas, que Claude Code fornece por padrão em modelos Claude 3.x, Opus 4 até 4.7, Sonnet 4 até 4.6 e Haiku 4.5. Em qualquer outro modelo, incluindo um ID de modelo que Claude Code não reconhece, a lista permanece vazia a menos que você opte por participar com CLAUDE_CODE_ENABLE_TODO_TOOLS=1 ou uma das outras maneiras em Disponibilidade da ferramenta de tarefas. Quando a sessão possui as ferramentas, a lista de tarefas funciona da seguinte forma:

• 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

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 o último turno concluído e o terminal esteja sem foco, para que esteja pronto quando você voltar. Os resumos aparecem apenas uma vez que a sessão tenha pelo menos três turnos, e nunca duas vezes seguidas.

Execute /recap para gerar um resumo sob demanda. Claude Code limita tanto os resumos automáticos quanto a saída de /recap a 400 caracteres. Para desativar os resumos automáticos, abra /config e desative Session recap.

A recapitulação da sessão está ativada por padrão para todos os planos e provedores. O resumo é sempre ignorado no modo não interativo.

Aguarde o reset de um limite de uso

Quando um limite de uso do claude.ai interrompe Claude no meio de uma tarefa, Claude Code aguarda na sessão aberta e continua a tarefa automaticamente após o reset do limite. A continuação automática está ativada por padrão em sessões interativas conectadas com uma assinatura do claude.ai. Requer Claude Code v2.1.234 ou posterior.

Enquanto Claude Code aguarda, uma linha na parte inferior da sessão mostra quando ele continuará:

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

Mantenha a sessão aberta. O que acontece a seguir depende de como a espera termina:

• 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.

A tarefa continuada é executada como qualquer outro turno. Claude Code ainda solicita permissões como de costume, portanto a tarefa pode parar em um prompt enquanto você está ausente. Se atingir o limite novamente, Claude Code reativa a espera automaticamente no máximo duas vezes seguidas, depois para e mostra Automatic continue stopped after repeated usage-limit hits · /rate-limit-options to try again.

Cancelar a espera

Pressione Esc em um prompt vazio, ou Ctrl+C, enquanto a linha é exibida, ou execute /rate-limit-options e escolha Don't continue automatically. Claude Code confirma com uma linha que começa com Automatic continue cancelled.

Após um cancelamento, nada continua até você enviar um prompt ou escolher a linha que começa com Wait here, then continue automatically de /rate-limit-options novamente. Claude Code não inicia uma espera por conta própria novamente para essa janela de reset; a próxima janela de reset começa do zero.

A espera também termina sem continuar a tarefa nestes casos:

• 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

Claude Code não inicia a espera por conta própria nestes casos:

• 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.

Nesses casos, e sempre que a continuação automática está desativada, Claude Code abre o menu de opções de limite de uso uma vez por janela de reset quando você atinge um limite em seu próprio terminal. Escolha a linha que começa com Wait here, then continue automatically para iniciar a espera. Em uma sessão de Remote Control ou colega de equipe de agente, execute /rate-limit-options você mesmo para abrir o menu.

Claude Code não oferece a espera em absoluto nestes casos:

• 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

Em /config, desative Continue automatically at usage limit, ou defina autoContinueAtUsageLimit como false em suas configurações de usuário. /config autoContinueAtUsageLimit=false também funciona, inclusive com -p, mas o formulário key=value não pode ativá-lo novamente, porque a configuração concede execução autônoma. Quais arquivos de configuração Claude Code lê para essa chave está na referência de configurações.

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 da revisão:

• Verde: aprovado
• Amarelo: revisão pendente
• Vermelho: alterações 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 assim que um git push, ou um comando gh pr que altera o pull request, como gh pr create ou gh pr merge, é executado com sucesso na sessão.

Claude Code renderiza o badge como um hiperlink mesmo quando não consegue detectar suporte a hiperlinks no seu terminal, o que geralmente acontece via SSH ou em tmux. Defina FORCE_HYPERLINK=0 para renderizar o badge como texto simples.

Quando você define CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, Claude Code não verifica o status do pull request ou merge request.

Merge requests do GitLab

Quando você trabalha em uma branch com um merge request aberto do GitLab, Claude Code mostra um badge MR !N clicável no slot do rodapé que de outra forma conteria o link do PR do GitHub. !N é a própria sintaxe de referência do GitLab para o número N do merge request. O sublinhado colorido mostra o estado do merge request:

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

O badge desaparece assim que o merge request é mesclado ou fechado.

Ele é atualizado assim que um git push, ou um comando glab mr que altera o merge request, como glab mr create ou glab mr merge, é executado com sucesso na sessão.

Para obter o badge, você precisa de:

• 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

Claude Code ignora as variáveis de ambiente de token do glab, como GITLAB_TOKEN, quando verifica o status, portanto você não obtém nenhum badge apenas de um token exportado. Claude Code também procura por glab e por seu login uma vez por sessão, portanto reinicie Claude Code depois de instalar glab ou executar glab auth login.

Links de referência de problemas

Quando Claude menciona um problema como owner/repo#123, você pode clicar na referência para abri-lo, desde que seu terminal suporte hiperlinks. Se Claude Code não detectar suporte a hiperlinks em seu terminal, defina FORCE_HYPERLINK como 1 para ativar os links, ou como 0 para manter as referências como texto simples.

Você obtém um link apenas para o formulário de duas partes owner/repo#123. Estes permanecem como texto simples:

• 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

Claude Code constrói o link para o host do repositório que identifica a partir de seu git remote, não para o repositório que a referência nomeia:

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