Referência do Modo Interativo do Claude Code

Problema: A maioria dos utilizadores do Claude Code escreve um prompt, carrega Enter, espera e repete. Esse ciclo ignora uma pilha de funcionalidades integradas. Uma combinação de duas teclas consegue matar um sub-agente descontrolado. Um canal lateral permite fazer uma pergunta rápida ao Claude sem tocar no histórico. Um editor vim a sério existe dentro do campo de entrada. Um modo bash corre comandos de shell e devolve o resultado para a mesma conversa. Nada disto está num único lugar, por isso a maioria da velocidade fica por aproveitar.

Vitória rápida: Abre qualquer sessão do Claude Code e carrega em Ctrl+F. Volta a carregar dentro de três segundos para confirmar. Todos os agentes em segundo plano param. Se alguma vez um sub-agente queimou tokens enquanto olhavas, esse atalho paga-se a si próprio. Ou usa /btw a meio de uma resposta para deslizar uma pergunta sem reescrever o histórico da conversa.

# Mata todos os agentes em segundo plano instantaneamente
Ctrl+F
 
# Faz uma pergunta lateral enquanto o Claude está a trabalhar
/btw what file was that error in?
 
# Ativa o modo vim para edição modal completa
/vim

O modo interativo é mais do que uma caixa de chat. É uma aplicação de terminal completa com modos, atalhos, comandos rápidos e auxiliares de fluxo de trabalho que raramente aparecem em tutoriais. Se os teus dias passam pelo Claude Code, estas funcionalidades decidem se a interface te atrapalha ou sai do caminho. Nunca trabalhaste no terminal? Começa pelo modelo de desenvolvimento terminal-first para ter uma ideia de como o Claude Code executa código.

/btw: Perguntas Laterais que Não Tocam no Histórico

/btw é a adição mais recente e resolve uma dor real. Fazes uma pergunta ao Claude, e a troca fica fora do histórico da conversa. A resposta nunca cai na janela de contexto. O que o Claude "sabe" sobre a tua sessão não muda.

O truque: /btw dispara enquanto o Claude ainda está a produzir uma resposta. Não tens de esperar que o stream termine. Escreve /btw, pergunta, obtém uma resposta, e a resposta principal continua a fluir.

# Enquanto o Claude está a meio de uma resposta:
/btw which test file covers the auth middleware?
 
# Esclarecimento rápido sem poluir o contexto:
/btw what's the difference between useEffect and useLayoutEffect?
 
# Verificar algo sem descarrilar a tarefa atual:
/btw did we already update the error types in types.ts?

Pensa no /btw como o oposto de um sub-agente. Um sub-agente tem todas as ferramentas mas começa do zero. /btw tem a conversa inteira mas nenhuma ferramenta. Responde com base no que o Claude já vê na tua sessão. Sem leituras, sem pesquisas, sem execução de código. Uma resposta rápida tirada do contexto que já está em jogo.

Limitações principais:

• Uma resposta por chamada. Sem seguimentos dentro de um único thread /btw.
• Zero acesso a ferramentas. As respostas vêm apenas do contexto.
• Barato. A cache de prompts é reutilizada, por isso o custo em tokens fica reduzido.
• Fecha com Space, Enter ou Escape e volta ao trabalho.

A funcionalidade surgiu de um projeto lateral de Erik Schluntz na equipa do Claude Code. O líder do Claude Code, Thariq Shihipar, anunciou-a a 11 de março de 2026. O tweet ultrapassou 2,2 milhões de visualizações. Meses de pedidos para uma forma de "fazer uma pergunta sem descarrilar o contexto" tinham ficado sem resposta. Esta é a resposta.

/btw brilha em trabalhos de longa duração. Quando o Claude está a refatorar um módulo grande e surge uma pergunta, não há necessidade de cancelar a execução, perguntar e re-promtar do zero. Usa /btw e continua.

Atalhos de Teclado que Realmente Importam

Dezenas de atalhos vêm com o Claude Code. Em vez de um despejo alfabético, aqui estão os agrupados pelo momento em que realmente os queres.

Utilizadores de macOS: Qualquer coisa que use Alt (como Alt+P, Alt+T, Alt+B, Alt+F) precisa de Option configurado como Meta no teu terminal. No iTerm2, abre Definições, Perfis, Teclas e define Left/Right Option para "Esc+". No Terminal.app, marca "Use Option as Meta Key" em Perfis, Teclado. Corre /terminal-setup se não tiveres a certeza do que tens.

Controlo de Sessão

Dois Esc Esc é o movimento furtivo. Reverte código e conversa para um ponto anterior, ou constrói um resumo a partir de uma mensagem escolhida. Muito melhor que Ctrl+C quando o objetivo é desfazer, não parar.

Entrada e Navegação

Ctrl+G abre o que estiver no $EDITOR. Um salva-vidas para prompts com vários parágrafos que ficam apertados numa entrada de linha única. Escreve num editor a sério, guarda, fecha e envia. Já estás a moldar um CLAUDE.md para contexto do projeto? Prompts densos merecem o mesmo tratamento com editor.

Controlos de Modelo e Pensamento

Alt+T merece destaque. Num trabalho de raciocínio difícil, ativar o pensamento alargado a meio de sessão muda a forma como o Claude ataca o problema. Sem nova sessão, sem editar configuração. Alterna quando o trabalho quer análise mais profunda.

Edição de Texto na Entrada

Estes funcionam na linha de prompt antes de enviar:

Queres ir mais longe na personalização de atalhos? O sistema de keybindings permite remapear cada atalho a partir de um único ficheiro JSON.

Entrada Multilinha

A entrada padrão é de linha única, mas quatro truques escrevem prompts multilinha sem saltar para Ctrl+G:

• Backslash + Enter: Termina uma linha com \, depois carrega Enter. O prompt continua na linha seguinte.
• Option+Enter (macOS) ou Shift+Enter: Insere uma nova linha sem enviar.
• Ctrl+J: Insere uma nova linha dentro da entrada.
• Modo de colagem: Colar texto multilinha da área de transferência ativa automaticamente o multilinha.

Para prompts muito longos, Ctrl+G com um editor completo ainda ganha. Para duas ou três linhas rápidas, \ + Enter é o caminho mais rápido.

Comandos Rápidos: /, ! e @

Três caracteres de prefixo ativam modos de entrada diferentes sem um comando de barra com nome.

/ para Comandos de Barra e Skills

Carrega / para ver todos os comandos disponíveis e skills personalizadas no teu projeto. A lista filtra à medida que escreves. É a porta para tudo, desde /compact (comprimir contexto) a /diff (ver alterações recentes) a /theme (mudar realce de sintaxe).

! para Modo Bash

Começa uma linha com ! e qualquer coisa a seguir corre como um comando de shell com contexto completo da conversa. Isto é diferente do Claude correr bash em teu nome. Quando escreves ! git log --oneline -5, o shell corre o comando naquele momento, e o resultado entra na conversa.

# Corre comandos git sem sair da sessão
! git status
 
# Verifica conteúdo de ficheiros
! cat src/config.ts
 
# Corre testes
! npm test
 
# Autocompletar com Tab funciona no histórico do !
! npm <Tab>

O modo bash mantém o contexto da conversa. Se o Claude sugeriu um comando e queres ajustá-lo, escreve ! e vai. O resultado volta diretamente para o contexto do Claude, por isso um seguimento como "agora corrige os erros daquela execução de testes" funciona porque o Claude viu a execução.

@ para Menções de Caminho de Ficheiro

Começa um token com @ e um caminho para apontar para um ficheiro específico no teu prompt. Diz ao Claude exatamente onde procurar, fixando a intenção. O autocompletar com Tab funciona em caminhos depois de @.

A Referência de Comandos de Barra

Uma pilha generosa de comandos de barra integrados vem com o produto. Aqui estão agrupados por função, com notas curtas sobre quando cada um merece ser usado.

Gestão de Sessão

Sessões longas vivem ou morrem com /compact. Quando a janela de contexto enche, /compact condensa a conversa num resumo e devolve o espaço. Para trabalho prolongado, usa-o antes do limite, não depois de o compressor automático entrar em ação.

Informação e Estado

Configuração

Ferramentas e Integrações

Colaboração

Conta

O Novo Comando /btw

Abordado no início. Esta é a grande adição do lançamento de março de 2026.

Uma nota sobre descontinuações: /review desapareceu. Se era o teu caminho para revisão de código, o comando /simplify substitui-o e corre uma revisão paralela com três agentes.

Modo Vim: Edição Modal Completa na Entrada

Escreve /vim e o prompt muda para keybindings do vim. Não é um emulador simplificado. Tens mudança de modos (Normal e Insert), navegação (h/j/k/l, w/b/e, 0/$, saltos de caractere f/F/t/T), operadores de edição (d, c, y, p) e objetos de texto (iw, aw, i", a().

Para quem vive no vim ou neovim, a mudança de contexto entre editor e prompt desaparece. A mesma memória muscular que usas no código conduz agora os teus prompts.

Operações vim disponíveis:

Corre /vim de novo para desativar. A definição mantém-se entre prompts dentro de uma sessão mas reinicia ao começar uma nova.

Tarefas em Segundo Plano com Ctrl+B

Uma resposta longa não precisa dos teus olhos. Carrega Ctrl+B para empurrar a tarefa atual para o segundo plano. (Utilizadores de Tmux: carrega Ctrl+B duas vezes, já que o tmux já reclama o prefixo.) O Claude continua a trabalhar. O prompt volta para que possa começar outro trabalho, ou correr um comando de shell.

Comportamento das tarefas em segundo plano:

• O resultado fica em buffer enquanto está escondido e imprime quando voltas.
• Várias tarefas podem correr lado a lado.
• Ctrl+F mata todos os agentes em segundo plano quando algo falha.
• A lista de tarefas (Ctrl+T) mostra o estado do segundo plano.

Um par limpo com o modelo terminal-first onde jogas a papel de agendador entre fluxos paralelos de trabalho. Manda uma grande refatoração para o fundo, pega numa correção de bug na frente e volta quando a refatoração terminar.

Bons momentos para colocar uma tarefa em segundo plano:

• Geração de código longa que se sabe que demora minutos
• Execuções de suite de testes enquanto o trabalho real acontece noutro prompt
• Trabalhos de pesquisa onde o Claude está a abrir muitos ficheiros
• Qualquer coisa onde ver o stream não acrescenta valor nenhum

Sugestões de Prompts

As sugestões de prompts são geradas automaticamente a partir do teu histórico de git e da conversa em curso. Vês-las abaixo da entrada, e Tab aceita uma.

Funcionam bem depois de operações git. Se acabou de entrar um commit, o Claude pode sugerir "escreve testes para as alterações do último commit." Com uma árvore suja, pode oferecer "revê o diff atual por problemas." As sugestões reutilizam a cache, por isso o custo extra por sessão é mínimo.

Também melhoram à medida que converses. No início, baseiam-se no estado do git. Depois de alguns turnos, tiram da conversa e oferecem próximos passos lógicos com base no que já está a acontecer.

Histórico de Comandos

Cada prompt que escreves vai para o histórico de comandos por diretório. As setas Cima e Baixo percorrem os prompts antigos, ou Ctrl+R corre uma pesquisa incremental inversa (escreve um fragmento e puxa prompts passados correspondentes).

Duas coisas a saber:

1. O histórico é por diretório. Cada projeto mantém a sua própria lista. Isso evita fuga de prompts entre projetos.
2. /clear reinicia o histórico. Limpar a conversa apaga também o histórico de comandos para esse diretório. Queres manter os prompts antigos? Usa /compact em vez de /clear.

Lista de Tarefas

Ctrl+T alterna o overlay da lista de tarefas. Acompanha trabalho com múltiplos passos numa sessão, mostrando o que está feito, o que está em execução e o que está em fila. A lista de tarefas sobrevive a compressões de contexto, por isso mesmo depois de uma passagem de resumo, o rastreamento de tarefas mantém-se.

Para fluxos de trabalho de equipa, define a variável de ambiente CLAUDE_CODE_TASK_LIST_ID para que várias sessões do Claude Code partilhem uma lista de tarefas. Útil quando sessões paralelas dividem o mesmo projeto e um painel de progresso ajuda.

Estado de Revisão de PR

A trabalhar numa branch com um pull request aberto? O Claude Code imprime o estado do PR no rodapé. Um sublinhado colorido no link do PR mostra o estado de revisão de relance:

Atualiza automaticamente de 60 em 60 segundos. Sem ter de mudar para o browser para verificar se um PR está aprovado. Vês-lo no terminal enquanto o trabalho continua. Requer o CLI gh instalado e com sessão iniciada (gh auth login).

Combinar Funcionalidades para Fluxos de Trabalho Reais

Estas peças ficam mais fortes quando se combinam. Aqui estão padrões que encaixam bem.

Trabalho profundo com tarefas em segundo plano e /btw: Manda uma grande implementação para o segundo plano com Ctrl+B. Enquanto corre, usa /btw para perguntas rápidas sobre a base de código que de outra forma poluiriam o contexto da tarefa principal. Verifica o progresso com Ctrl+T.

Iteração rápida com modo bash e modo rápido: Ativa o modo rápido para respostas rápidas, corre testes entre iterações com !, e usa Ctrl+R para puxar prompts antigos que queres ajustar e re-executar. O ciclo inteiro entre prompt, teste e ajuste fica mais curto.

Trabalho cuidadoso com modo de planeamento e entrada vim: Entra no modo de planeamento para análise, escreve prompts precisos em modo vim para conforto de edição, lê o plano, sai do modo de planeamento e passa a execução ao Claude. Para instruções muito longas, Ctrl+G abre o editor completo.

Coordenação multi-agente com lista de tarefas e agentes: /agents lista sub-agentes em execução, Ctrl+T acompanha as suas tarefas, Ctrl+F mata os que derivam, e /btw pergunta sobre eles sem quebrar o thread principal.

Próximos Passos

• Percorre o sistema de keybindings para remapear qualquer atalho para a memória muscular que já tens
• Lê sobre o modo de planeamento para separar pensamento de execução
• Absorve o modelo terminal-first para ver como estas funcionalidades se encaixam
• Experimenta o modo de voz para uma mistura de entrada escrita e falada
• Verifica /simplify e /batch para fluxos de trabalho multi-agente agrupados
• Lê o guia de gestão de contexto para manter sessões longas eficientes

O modo interativo marca a linha entre uma ferramenta para escrever código e um ambiente de desenvolvimento completo. Perguntas laterais via /btw, edição modal com modo vim, trabalhos em segundo plano, alternâncias de modo rápido. Nenhum destes é polimento opcional. Juntos moldam a interface que mantém sessões longas fora do território de desgaste. Pega nos atalhos que encaixam no teu fluxo, deixa os que não encaixam, e volta a esta página sempre que um ponto de fricção parece merecer uma tecla. Normalmente merece.