Skip to content

Controle e Modos: A "Mesa de Som" em suas Mãos durante a Sessão

📚 Navegação da Série: O capítulo anterior 34 Manual de Referência da CLI: Comandos e Todas as Flags ajudou você a verificar todos os interruptores disponíveis "antes de iniciar o Claude". Este capítulo aborda o momento "após a sessão ter sido iniciada" — durante a sua interação de ida e volta com o Claude, você tem nas mãos um painel de controle completo: como alternar os modos de funcionamento com um único toque, como fazer com que ele proponha uma solução antes de agir, como gastar para obter respostas mais rápidas, e como editar sua entrada usando gestos do Vim. O Capítulo 20 abordou as rédeas das permissões, e este capítulo apresenta o conjunto completo de alavancas de controle em suas mãos.

Pessoal, ao longo do nosso caminho, já aprendemos a digitar comandos, escrever arquivos CLAUDE.md e configurar permissões, então as coisas devem estar correndo bem.

No entanto, olhando para trás, a maior parte do tempo desperdiçado no primeiro mês não foi por "não saber usar", mas sim por "não saber controlar" — a sessão estava rodando, mas só sabíamos fazer uma coisa: digitar, pressionar Enter e esperar. Se a resposta dele saía dos trilhos, esperávamos tolamente que ele terminasse; se ele começava a alterar arquivos logo de cara, não conseguíamos impedi-lo; e em tarefas que deveriam começar com uma proposta de solução, deixávamos que ele entrasse e fizesse alterações desordenadas diretamente.

Para simplificar, a interface interativa do Claude Code é muito mais do que apenas "caixa de entrada + Enter". Por baixo dela, esconde-se um conjunto completo de "controles internos da sessão": uma tecla para alternar o modo de trabalho, uma tecla para resgatá-lo quando ele se perde, um comando para fazê-lo planejar antes de agir, e interruptores para comprar velocidade. Já vimos alguns desses atalhos no Capítulo 14 e detalhamos a parte de permissões no Capítulo 20, mas "como de fato controlar ele durante a sessão" ainda não tinha sido apresentado de forma centralizada.

Podemos dizer o seguinte: los capítulos anteriores ensinaram "como fazer o Claude trabalhar", enquanto este capítulo ensina "como controlar ele em tempo real durante o trabalho" — como se estivesse sentado diante de uma mesa de som, onde você não apenas pressiona o play, mas tem acesso a cada potenciômetro.

Ao ler este capítulo, você obterá:

  • Um panorama completo dos "controles internos da sessão" — qual tecla interrompe, qual alterna modos e qual muda o modelo, tudo organizado de forma clara.
  • O funcionamento completo do ciclo de modos de permissão com Shift+Tab: como entrar no ciclo com auto / bypassPermissions / dontAsk além dos três modos padrão, e quem tem prioridade na ordem (complementando o Capítulo 20, sem repetir as regras de permissão).
  • O Plan Mode (Modo de Planejamento) não é apenas "um modo de permissão", mas sim um fluxo de trabalho completo de "propor solução primeiro, agir após sua revisão" — quando usá-lo e o que significa cada opção na aprovação.
  • O que exatamente você está comprando com o modo rápido (fast mode), se vale a pena e qual a diferença em relação ao "nível de esforço".
  • Como ativar o modo de edição do Vim, alguns de seus gestos mais úteis e uma prática guiada para você testar.

01 Construindo a Estrutura Geral: Três Categorias de Interruptores na Sessão

Antes de memorizar os atalhos, classifique os "controles internos da sessão" mentalmente. Eles não são um monte de teclas aleatórias, mas sim responsáveis por três tarefas diferentes. Classificar ajuda a memorizar e associar.

Analogia: Sentado diante de uma mesa de som. Aquela enorme mesa de estúdio cheia de potenciômetros e botões pode parecer intimidadora, mas na verdade se divide em três categorias: uma controla o volume de cada canal (potenciômetros), outra controla a gravação (reproduzir, parar, voltar para determinado trecho) e outra controla o timbre (botões de equalização). Você não precisa decorar todos, apenas saber onde esticar a mão quando quiser fazer algo. O controle de sessão do Claude Code funciona da mesma forma, com três categorias de interruptores, cada uma cuidando de uma área.

No Claude Code, essas três categorias são:

  • Controle da "Autonomia dele" — ou seja, o modo de permissão: pressione Shift+Tab para alternar entre default / acceptEdits / plan, decidindo se ele deve perguntar antes de agir (tema principal do Capítulo 20).
  • Controle da "Execução dele" — interrupção e redirecionamento: Esc para frear, Esc Esc para dar ré e voltar, Ctrl+C para interromper ou limpar a entrada, e Ctrl+B para enviar a tarefa para o segundo plano.
  • Controle da "Resposta dele" — modelo e velocidade: Option+P para trocar de modelo, Option+T para ligar/desligar o pensamento estendido (thinking) e /fast para ligar/desligar o modo rápido.

Colocando tudo lado a lado em uma tabela, fica fácil ver o que cada um controla:

O que você quer fazerTecla para pressionarCategoria
Fazer ele perguntar menos / mais antes de agirShift+Tab para alternar modosControle da Autonomia
Ele saiu do caminho, mandar parar para redirecionarEscControle da Execução
Voltar toda a conversa para o ponto anteriorEsc Esc (com a entrada vazia)Controle da Execução
Interromper a operação atual / Limpar a caixa de entradaCtrl+CControle da Execução
Enviar um comando longo para segundo plano e fazer outra coisaCtrl+BControle da Execução
Mudar temporariamente de modelo para responderOption+P (no Win/Linux é Alt+P)Controle da Resposta
Fazer ele pensar mais / não pensar tanto tempoOption+TControle da Resposta
Pagar para ter um Opus mais rápido/fast ou Option+O (macOS) / Alt+O (Win/Linux)Controle da Resposta

⚠️ Nota para usuários de macOS: A maioria dos atalhos que começam com Option+ na tabela (Option+P, Option+T, Option+O) exige que você configure a tecla Option como Meta no seu terminal para funcionar — no iTerm2, vá em "Configurações → Perfis → Teclas" e defina a Option esquerda/direita como "Esc+"; no Apple Terminal, em "Configurações → Perfis → Teclado", marque "Usar Option como tecla Meta". Há uma exceção oficial: a partir da v2.1.132, o atalho Option+T (alternar pensamento estendido) funciona no Mac sem necessidade de configuração.

Você não precisa decorar esta tabela, mas deve ter a consciência de "a qual categoria isso pertence" — se quiser "que ele pergunte menos", não pressione Esc; se quiser "mandar parar", não pressione Shift+Tab. Separando bem, você não se perderá.

💡 Resumo em uma frase: Os controles de sessão dividem-se em três categorias: controle da autonomia (Shift+Tab), controle da execução (Esc / Ctrl+C / Ctrl+B) e controle da resposta (Option+P / /fast). Não se preocupe se esquecer a tecla exata, lembre-se apenas de onde esticar a mão.


02 Controle da Execução: Esc é o Freio, Esc Esc é a Ré

Dentre as três categorias, a mais importante para praticar e dominar é a "Execução", pois é a mais usada para corrigir rotas. Vamos detalhar os atalhos mais comuns, explicando quando pressioná-los e o que acontece.

Esc: Ele saiu do caminho, pise no freio

O Esc faz apenas uma coisa: interrompe o que o Claude está fazendo no momento — seja gerando uma resposta ou executando uma ferramenta pela metade. Ao pressioná-lo, ele para imediatamente, devolve o cursor para você e aguarda suas novas instruções.

O ponto chave é esta explicação tranquilizadora da documentação oficial:

Interrompe a resposta atual ou a execução da ferramenta no meio do caminho para que você possa redirecioná-lo. O Claude retém o trabalho concluído até o momento.

Ou seja, Esc não é um "Desfazer", é um "Pausar + Devolver o volante". A parte que ele já fez (como arquivos lidos ou metade de uma função escrita) é preservada; você apenas interrompe as ações seguintes para mudar a direção e deixá-lo continuar.

O cenário mais comum de uso do Esc: você pede para ele alterar uma pequena funcionalidade, mas ele entende errado e começa a reescrever freneticamente de cinco a seis arquivos. Esperar que ele termine para corrigi-lo seria um desperdício de tempo e de tokens de saída. O correto a fazer é — assim que notar que a direção está errada, pressione Esc imediatamente e adicione: "Pare, eu só quero alterar aquela única função no login.js, não mexa no resto", e ele mudará de rumo na hora. Em uso intensivo diário, você provavelmente usará essa tecla dezenas de vezes.

Esc Esc: Voltar a conversa para o ponto anterior

Pressionar Esc duas vezes seguidas tem dois comportamentos diferentes, dependendo se há texto digitado na caixa de entrada:

  • Com texto na caixa de entrada: O clique duplo no Esc limpa o texto e salva esse rascunho no histórico (você pode recuperá-lo pressionando depois).
  • Com a caixa de entrada vazia: O clique duplo no Esc abre o menu de rollback (reversão) — permitindo que você restaure a conversa a partir de um nó anterior ou resuma o código e a conversa.

O segundo caso é como "dar ré": voltar toda a conversa para um estado anterior. Isso pertence à categoria de pontos de controle (checkpoints), que detalharemos no Capítulo 37. Por hora, guarde esta ação: quando a entrada estiver vazia, pressionar Esc duas vezes abre o menu para "voltar ao ponto de salvamento anterior". É muito útil para refazer passos — se você sentir que "as últimas rodadas levaram as coisas para o buraco", use Esc Esc para voltar ao ponto limpo antes do erro e recomeçar.

Ctrl+C e Ctrl+D: Pare de usá-los como teclas de saída aleatórias

Esses dois são muito fáceis de confundir para iniciantes. Vamos definir as regras claramente:

  • Ctrl+C: Se houver uma operação rodando, ela é interrompida; se não houver operação rodando, o primeiro clique limpa a caixa de entrada, e um segundo clique sai do Claude Code.
  • Ctrl+D: Sai diretamente da sessão do Claude Code (sinal EOF).

Aqui há uma pequena armadilha comum: para limpar parte do texto digitado na caixa de entrada, o usuário pressiona Ctrl+C por impulso, nada acontece, pressiona de novo — e acaba fechando a sessão. Isso ocorre porque o segundo Ctrl+C em uma entrada vazia fecha o programa. Portanto, para limpar a caixa de entrada, prefira usar Ctrl+U (deleta do cursor até o início da linha) ou simplesmente Esc Esc, evitando pressionar Ctrl+C repetidamente.

Ctrl+B: Envie comandos longos para segundo plano, não fique esperando

Este também salva vidas. Quando o Claude executa um comando demorado (instalar dependências, rodar builds, iniciar servidores de desenvolvimento), você não precisa ficar esperando — pressione Ctrl+B para enviá-lo para segundo plano. O Claude liberará o prompt imediatamente para responder a novas instruções suas, enquanto o comando continua rodando em segundo plano, gravando saídas em arquivos e permitindo que o Claude as leia de volta quando necessário.

Nota para quem usa tmux: O prefixo padrão do tmux também é Ctrl+B. Portanto, dentro de uma sessão do tmux, você deve pressionar duas vezes o atalho para enviar a tarefa para segundo plano. Lembre-se disso para não cair nessa armadilha.

TeclaFunção em uma fraseDetalhe mais fácil de esquecer
EscParar + Redirecionar, mantendo o que foi feitoNão desfaz, apenas pausa e devolve o controle
Esc EscAbre o menu de rollback (entrada vazia)Com texto na entrada, apenas limpa o rascunho
Ctrl+CInterrompe / Limpa entrada / Sai ao repetirSegundo clique na entrada vazia fecha a sessão
Ctrl+DSai diretamente da sessãoFecha na hora, não use para interromper tarefas
Ctrl+BEnvia comando longo para segundo planoRequer pressionar duas vezes dentro do tmux

💡 Resumo em uma frase: Esc é o freio (para puxar de volta se desviar), Esc Esc é a ré (para voltar ao ponto anterior), evite pressionar Ctrl+C repetidamente (o segundo clique sai do programa) e use Ctrl+B para mandar comandos longos para segundo plano. Ao transformar esses comandos em memória muscular, você evitará esperas e saídas acidentais na sessão.


03 Controle da Autonomia: Versão Completa do Ciclo de Modos Shift+Tab

O espectro de permissões "do mais rigoroso ao mais flexível" já foi detalhado no Capítulo 20default pergunta tudo passo a passo, acceptEdits edita código sem perguntar, plan apenas lê e não altera, auto conta com a proteção do classificador, bypassPermissions executa totalmente sem restrições, e dontAsk aceita apenas pré-aprovações. Esta seção não repetirá o que cada um deles faz (consulte o Capítulo 20 se esquecer), mas complementará um detalhe que não foi aprofundado: como funciona o ciclo do Shift+Tab.

Primeiro, estabeleça a base: ao pressionar Shift+Tab na sessão, você navega entre três modos padrão:

text
default → acceptEdits → plan → (pressione novamente para voltar ao default)

Para saber qual é o modo atual, observe a barra de status. Por exemplo, ao alternar para acceptEdits, a barra de status exibirá ⏵⏵ accept edits on. Este é o ciclo padrão, contendo apenas essas três opções.

Então, onde estão auto, bypassPermissions e dontAsk? Eles não fazem parte do ciclo padrão e só aparecem se certas condições forem atendidas ou se forem passados como argumentos na inicialização. As regras oficiais explicadas de forma simples são:

  • auto (Modo Automático): Só aparece no ciclo se a sua conta atender a todos os requisitos do auto mode. Ao navegar para ele pela primeira vez, um prompt de adesão (opt-in) será exibido. Se você aceitar, ele passará a fazer parte do ciclo; se selecionar "Não, não perguntar novamente", ele será removido do ciclo.
  • bypassPermissions (Pular todas as verificações): Só aparece se você iniciar o Claude Code com --permission-mode bypassPermissions, --dangerously-skip-permissions ou --allow-dangerously-skip-permissions. Note que a variante --allow- apenas adiciona o modo ao ciclo, mas não o ativa imediatamente.
  • dontAsk (Apenas pré-aprovações): Nunca entra no ciclo. Só pode ser especificado ao iniciar com --permission-mode dontAsk.

Além disso, as regras oficiais especificam a posição de inserção no ciclo, para você não se perder ao alternar:

Os modos opcionais habilitados são inseridos após o modo plan, com bypassPermissions tendo prioridade e auto por último. Se você habilitar ambos, passará por bypassPermissions antes de chegar a auto.

Traduzindo isso para a experiência prática ao pressionar as teclas: se ambos estiverem ativos, o ciclo do Shift+Tab será o seguinte —

text
default → acceptEdits → plan → bypassPermissions → auto → (retorna ao default)

O auto sempre fica por último, com o bypassPermissions logo antes dele. Lembrando essa sequência, você saberá exatamente quantas vezes pressionar para chegar ao modo desejado, sem precisar chutar.

O hábito prático recomendado é o mesmo do Capítulo 20na grande maioria das vezes, alterne manualmente com Shift+Tab apenas entre os três modos padrão: ao lidar com um projeto novo, mude para plan para ele analisar e propor um plano; quando confiar na direção, mude para acceptEdits para deixá-lo alterar arquivos; e se quiser mais rigor, volte para default. O modo bypassPermissions deve ser reservado apenas para contêineres isolados usando argumentos de inicialização, e nunca adicionado ao ciclo diário — essa linha vermelha foi traçada no Capítulo 20 e não mudará.

💡 Resumo em uma frase: O Shift+Tab alterna por padrão apenas entre default / acceptEdits / plan; os modos auto / bypassPermissions exigem condições ou argumentos de inicialização para entrar no ciclo, seguindo a ordem "depois de plan, com bypassPermissions primeiro e auto no final". Conhecendo essa ordem, fica fácil alternar.


04 Plan Mode: Mais que um Modo, um Fluxo de Trabalho de "Planejar Antes de Agir"

Na seção anterior, tratamos o plan apenas como um dos modos do ciclo, mas ele merece uma seção dedicada — pois o verdadeiro valor do Plan Mode não está no fato de ser apenas um "modo somente leitura", mas no fluxo de trabalho completo de "propor soluções primeiro, agir depois que você revisar" que ele possibilita. Este é um dos controles mais usados e mais recomendados para iniciantes criarem o hábito de usar desde cedo.

Analogia: O diretor diz "vamos passar a cena primeiro". Antes de rodar a gravação oficial, o diretor frequentemente pede aos atores que ensaiem a cena — posições, falas e ritmo são testados, mas sem ligar a câmera ou gastar película. Se tudo estiver correto, ele diz: "Câmera, gravando". O Plan Mode é esse "ensaio": o Claude projeta todo o cenário mentalmente, lê arquivos, executa comandos shell para explorar o ambiente e escreve um plano detalhado, mas sem alterar uma única linha de código do seu projeto. Após sua revisão e aprovação, ele inicia a gravação e faz as alterações.

A documentação define o comportamento com clareza:

O Plan mode instrui o Claude a pesquisar e propor alterações sem aplicá-las. O Claude lê arquivos, executa comandos shell para explorar e redige planos, mas não edita seu código-fonte.

Como entrar e sair

Existem duas formas de entrar no Plan Mode:

  • Usar Shift+Tab para navegar até plan — aplica-se a toda a sessão, até que você mude de modo.
  • Adicionar /plan no início de um prompt — faz com que apenas aquela instrução específica siga o modo de planejamento. Ideal para: "só nesta tarefa eu quero ver o plano primeiro".
text
/plan mude o login do usuário de session para JWT, não faça alterações ainda, apenas diga como planeja fazer

Quer sair do modo no meio do caminho sem aprovar o plano? Basta usar o Shift+Tab para navegar para outro modo.

O plano está pronto, o que significam as opções de aprovação?

Esta é a etapa que dá o verdadeiro tom de "fluxo de trabalho" ao Plan Mode, e onde os iniciantes costumam ficar confusos. Quando o Claude conclui o plano, ele pausa e pergunta "como proceder", apresentando opções como:

  • Aprovar e iniciar em auto mode — você confia plenamente na direção proposta e deixa ele executar tudo automaticamente até o fim.
  • Aprovar e aceitar edições — muda para o modo acceptEdits, permitindo alterações no código sem confirmação, mas pausando para comandos perigosos.
  • Aprovar e revisar manualmente cada edição — volta para o modo default, exigindo confirmação passo a passo.
  • Continuar planejando e fornecer feedback — o plano ainda não está ideal e você fornece observações para que ele o ajuste.

Entendeu? O ato de aprovar o plano já "define o modo de permissão para a execução das alterações". Ele sai do Plan Mode, altera a sessão diretamente para o modo selecionado e começa a agir. É por isso que o Plan Mode não é um modo isolado, mas sim o ponto central que conecta "exploração → plano → escolha da autonomia → execução".

Há também dois detalhes oficiais muito práticos:

  • Editar o plano diretamente com Ctrl+G: Se o plano foi proposto, mas você deseja ajustar alguns pontos pessoalmente (como "remover esta etapa e inverter a ordem destas duas"), pressione Ctrl+G para abrir o plano no seu editor de texto padrão. Salve as alterações e o Claude seguirá o plano modificado.
  • Aprovação gera nome de sessão automático: A menos que você já tenha nomeado a sessão com --name ou /rename, ao aprovar um plano ele nomeará a sessão automaticamente com base no conteúdo do plano, facilitando a busca posterior via /resume.

Um exemplo típico de uso

Simplificando: ao lidar com qualquer projeto com o qual você não tenha familiaridade, a primeira coisa a fazer é entrar no Plan Mode e pedir para ele analisar a estrutura e propor um plano. Imagine que você herdou um código antigo de outra pessoa com dezenas de milhares de linhas. Em vez de deixá-lo alterar arquivos direto com acceptEdits — o que provavelmente seria um desastre —, mude para plan com Shift+Tab e envie: "Analise este projeto, descreva a estrutura geral e sugira por onde começar as alterações". Ele fará a leitura e entregará um relatório de estrutura com recomendações de mudanças. Só depois de compreender a proposta, você deve conceder permissão para alterar o código. Crie esse hábito o quanto antes.

💡 Resumo em uma frase: O Plan Mode funciona como um ensaio antes da gravação — ele explora e monta um plano sem alterar o código; a aprovação do plano define o modo de permissão seguinte (auto / acceptEdits / revisão manual), e você pode usar Ctrl+G para editar o plano diretamente. Em projetos desconhecidos, comece sempre com /plan para maior segurança.


05 Modo Rápido (fast mode): Pagar por Velocidade, Não por Qualidade

⚠️ Recurso de Visualização de Pesquisa (Research Preview), sujeito a alterações: O fast mode está atualmente em fase de visualização de pesquisa, e seus recursos, preços e disponibilidade podem mudar a qualquer momento; além disso, requer a versão v2.1.36 ou superior do Claude Code.

Depois de entender como "controlar a direção", vamos falar sobre um interruptor para "controlar a velocidade" — o modo rápido. Primeiro, vamos desfazer o mal-entendido mais comum:

O modo rápido não substitui o modelo por um mais forte. Ele apenas altera a "forma de execução" do mesmo Claude Opus. A documentação oficial explica diretamente:

O modo rápido não é um modelo diferente. Ele usa o Claude Opus, mas com uma configuração de API diferente que prioriza a velocidade em detrimento da eficiência de custo. Você obtém a mesma qualidade e recursos, apenas com respostas mais rápidas.

Quanto mais rápido e quanto mais caro? Segundo os dados oficiais: até 2.5x mais rápido, com o custo de tokens individuais mais elevado. Ele só é suportado no Opus 4.8 / 4.7 / 4.6, e não está disponível para Sonnet ou Haiku (⚠️ o modo rápido para Opus 4.6 foi descontinuado; recomenda-se usar o 4.7 ou 4.8).

Como ativar

Basta executar o seguinte comando:

text
/fast

Digite /fast e pressione Tab para ligar ou desligar. Ao ativar:

  • Se você estiver usando outro modelo, ele mudará automaticamente para o Opus.
  • Você verá a indicação Fast mode ON e um ícone aparecerá ao lado da caixa de entrada.
  • A qualquer momento, você pode digitar /fast para verificar o estado atual.

Um detalhe que pode parecer contraintuitivo: ao desativar o modo rápido, você continuará usando o Opus — o modelo não voltará automaticamente para o que você usava antes. Para trocar de modelo, use o comando /model.

Vale a pena? Depende se você precisa de velocidade ou quer economizar no momento

Quando vale a pena ativar? A regra prática é simples e bate com a experiência real — avalie se a "latência" ou o "custo" é o fator crítico para a tarefa atual:

CenárioAtivar o modo rápido?Motivo
Depuração em tempo real, iterações rápidas, prazos apertados✅ SimVocê está esperando pela resposta, cada segundo conta; prioridade à velocidade
Tarefas autônomas longas, processamento em lote, CI/CD❌ NãoNão há ninguém esperando ativamente, a velocidade não é crítica; prioridade à economia
Tarefas com orçamento limitado❌ NãoO custo por token é maior, o que pode pesar no acumulado

Há também um detalhe essencial para economizar, bastante enfatizado na documentação e fácil de esquecer:

Para obter a melhor eficiência de custo, ative o modo rápido no início da sessão, em vez de alternar no meio da conversa.

Por quê? Porque ao ativar o modo rápido pela primeira vez na sessão, você será cobrado pela taxa do modo rápido para processar todo o contexto acumulado até ali. Quanto maior a conversa antes da ativação, mais cara será essa primeira chamada. Portanto, se for usar, ative logo no início, e não depois de acumular um grande histórico. Deixar para ativar no meio de uma longa conversa é um erro clássico que encarece a fatura inesperadamente.

Não confunda com o "Nível de Esforço" (Effort Level)

Por fim, não confunda o modo rápido com o ajuste do nível de esforço. Ambos influenciam o tempo de resposta, mas funcionam de formas completamente diferentes:

ConfiguraçãoO que fazEfeito colateral
Modo RápidoMesma qualidade de modelo, latência reduzidaCusto mais elevado
Reduzir Nível de EsforçoFaz o modelo pensar menos para responder antesPode reduzir a qualidade em tarefas complexas

Resumindo: o modo rápido não sacrifica a qualidade, apenas custa mais; reduzir o nível de esforço faz o modelo pensar menos, podendo afetar a qualidade. Os dois recursos podem ser combinados — "modo rápido + nível de esforço baixo" para velocidade máxima em tarefas simples.

⚠️ Atenção para usuários de assinaturas: Para usuários Pro/Max/Team/Enterprise, o modo rápido consome créditos de uso adicionais e não está incluído nos limites de cota da assinatura. Ou seja, ele é cobrado separadamente desde o primeiro token. Tenha isso em mente antes de ativar.

💡 Resumo em uma frase: O modo rápido oferece a velocidade do mesmo Opus (até 2.5x mais rápido) por um custo maior; use /fast para ligar/desligar, ativando sempre no início da sessão se for usar (ativar no meio custa mais); ligue quando estiver com pressa e desligue em tarefas longas, sem confundir com o "nível de esforço".


06 Modo de Edição do Vim: Gestos Avançados na sua Caixa de Entrada

O último controle da lista refere-se a "como você edita o texto que digita" — o modo Vim. Se você nunca usou o Vim, pode passar os olhos rapidamente e pular esta seção, ela não afetará seu uso do Claude Code; mas se você já domina o Vim, ativar este modo tornará a digitação muito mais natural.

Por padrão, a caixa de entrada do Claude Code é um campo de texto comum (digitação direta, navegação por setas). Ao ativar o modo Vim, ela passa a ter os dois estados característicos:

  • Modo INSERT (Inserção): Funciona como uma caixa de entrada comum, onde digitar insere caracteres.
  • Modo NORMAL (Comando): As teclas deixam de inserir caracteres e passam a funcionar como comandos — h/j/k/l movem o cursor, dd apaga uma linha, w pula para a próxima palavra, 0 vai para o início da linha, $ vai para o fim da linha... Toda a mecânica clássica do Vim é aplicada aqui.

Como ativar

Abra o menu /config, navegue até "Editor mode" e selecione "vim". Uma vez ativado:

  • Pressione Esc para entrar no modo NORMAL (onde as teclas funcionam como comandos).
  • Pressione i / a / o etc. para voltar ao modo INSERT e começar a digitar.

Aqui estão alguns dos comandos mais úteis dentro da caixa de entrada para ilustrar o funcionamento:

Teclas no modo NORMALAção
ddApaga a linha inteira (útil para reescrever um prompt)
cwAltera a palavra sob o cursor
0 / $Pula para o início / fim da linha
uDesfaz a última alteração
i / aEntra em modo de inserção antes / depois do cursor

Um detalhe que os usuários do Vim vão gostar: no modo NORMAL, se o cursor já estiver no topo ou na base do texto e não puder mais ser movido para cima/baixo, pressionar j/k ou as setas navegará pelo histórico de comandos. Isso une a navegação interna de texto com o histórico de forma fluida.

Sendo sincero, este modo é apenas um diferencial. Ele é excelente para quem já usa o Vim editar prompts longos com facilidade; mas para iniciantes não há necessidade de ativação — o campo de texto padrão combinado com alguns atalhos da seção 02 (Ctrl+U para apagar até o início da linha, Ctrl+W para apagar palavras) já resolvem muito bem. Portanto: se você já usa o Vim, ative; caso contrário, não se preocupe com isso, não é obrigatório.

💡 Resumo em uma frase: O modo Vim traz os estados NORMAL/INSERT e os gestos de teclado tradicionais do Vim para a caixa de entrada, ativado via /config → Editor mode; ótimo para usuários do Vim, totalmente dispensável para iniciantes.


07 Prática: Executando Todo o Fluxo de Controle

A teoria sem prática é facilmente esquecida. Abaixo preparamos um exercício de 5 minutos, que não exige projetos complexos, para você testar os principais comandos de controle em sequência, observando o comportamento esperado.

Abra uma pasta vazia qualquer, inicie o claude e siga os passos:

Passo 1: Alternar modos com Shift+Tab observando a barra de status

Após iniciar, pressione Shift+Tab algumas vezes, com os olhos atentos à barra de status na parte inferior.

Resultado esperado: A barra de status muda indicando a rotação entre os três modos — exibindo ⏵⏵ accept edits on ao selecionar acceptEdits, exibindo as indicações do modo de plano ao selecionar plan, e voltando ao estado normal ao retornar para o modo default. Certifique-se de que consegue identificar o modo atual pela barra de status.

Passo 2: Entrar no Plan Mode e pedir uma proposta (sem aplicar alterações)

Use Shift+Tab para mudar para o modo plan e envie um pedido que normalmente alteraria arquivos:

text
crie um arquivo hello.txt neste diretório contendo a linha "hi from claude"

Resultado esperado: O Claude não criará o arquivo de fato. Em vez disso, ele apresentará uma explicação de "como planeja fazer isso" e pausará perguntando como prosseguir (aprovar e aceitar edições / revisão manual / continuar planejando...). Verifique a pasta e confirme que o arquivo hello.txt não existe — demonstrando a natureza do Plan Mode de planejar sem alterar.

Passo 3: Aprovar o plano e observar a transição de modo

Dentre as opções exibidas, selecione "Aprovar e aceitar edições" (ou revisão manual).

Resultado esperado: Ele sairá do Plan Mode, a barra de status atualizará para o modo escolhido (como accept edits on) e ele criará o arquivo hello.txt. Confirme que o arquivo agora existe na pasta e que a sessão saiu do modo plan para o modo que você selecionou ao aprovar — comprovando que "aprovar o plano define o modo de permissão seguinte".

Passo 4: Treinar a interrupção com Esc

Dê a ele uma tarefa um pouco mais longa (por exemplo, "leia todos os arquivos deste diretório um por um e gere um resumo de cada"), e assim que ele iniciar a execução, pressione Esc.

Resultado esperado: Ele parará imediatamente, devolverá o controle a você e o cursor voltará para a caixa de entrada. O progresso já feito (como leituras concluídas) será mantido. Você poderá enviar uma nova instrução de redirecionamento em seguida. Confirme que o Esc apenas pausa e devolve o controle, sem causar falhas ou erros.

Passo 5 (Opcional): Testar o interruptor do modo rápido

Digite /fast e pressione Tab para verificar o comportamento.

Resultado esperado: Se sua conta tiver suporte e créditos, você verá a mensagem Fast mode ON e o ícone ao lado da caixa de entrada; digite /fast novamente para desligar. Se sua conta ou plano não suportar ou não possuir créditos extras de uso, ele exibirá uma mensagem informando que o fast mode está indisponível — este passo serve apenas para conhecimento, não se preocupe caso não consiga ativá-lo.

Após concluir esses cinco passos, você terá experimentado na prática todos os principais recursos de controle apresentados. Para iniciantes, realizar os passos 2 e 3 é fundamental — sentir na prática que no Plan Mode nada é alterado e as alterações só acontecem após a aprovação (que já define o próximo modo) vale muito mais do que apenas ler a explicação.

💡 Resumo em uma frase: Siga estes cinco passos em sequência para testar o Shift+Tab, a criação e aprovação de planos no Plan Mode, a interrupção com Esc e o modo rápido /fast, validando com os resultados esperados; foque nos passos 2 e 3 para fixar a mecânica do modo de planejamento.


08 Resumo

Neste capítulo, exploramos detalhadamente o painel de controle que fica em suas mãos assim que uma sessão é iniciada. O Capítulo 20 apresentou as rédeas das permissões, e este entregou todas as alavancas de controle operacional.

Revisando as principais ações e ferramentas:

O que você quer fazerFerramenta / AtalhoPonto chave
Ajustar a quantidade de perguntas antes de agirShift+Tab para alternar modosTrês modos padrão; auto/bypass exigem condições e o auto fica por último no ciclo
Parar e redirecionar quando ele desviar do rumoEscPausa a execução mantendo o trabalho já concluído
Voltar a conversa a um ponto anteriorEsc Esc (entrada vazia)Abre o menu de rollback; detalhes no Capítulo 37
Interromper / Limpar / SairCtrl+C / Ctrl+DSegundo clique com entrada vazia no Ctrl+C encerra a sessão; use com cautela
Enviar comandos longos para segundo planoCtrl+BPressione duas vezes se estiver utilizando o tmux
Ver a proposta de alteração antes de agirPlan Mode (/plan)Planeja sem alterar arquivos; a aprovação define o próximo modo de trabalho
Pagar para acelerar o Opus/fastMesma qualidade, processamento acelerado, maior custo; ative no início da sessão
Utilizar gestos do Vim na entrada/config → Editor modeExcelente para quem já conhece o Vim, opcional para iniciantes

Agora você é capaz de: gerenciar ativamente as ações do Claude durante uma sessão ativa — alternando para o modo de autonomia correto com Shift+Tab, trazendo-o de volta aos trilhos com o Esc ao menor desvio, usando o Plan Mode para estruturar alterações antes de aplicá-las em códigos desconhecidos, ativando a velocidade extra com o /fast quando necessário, e editando comandos com gestos do Vim caso prefira. Em resumo, você deixou de ser um usuário passivo que apenas envia prompts e aguarda, tornando-se um controlador ativo do fluxo de trabalho.

Com a conclusão deste capítulo sobre controle e modos, cobrimos toda a base do quinto grupo sobre "Configuração e Otimização do Sistema" (configurações, estilos de saída, hooks, flags da CLI e modos de controle).


O próximo capítulo, 36 "Comandos de Barra (Slash Commands)", trará o foco para aquele pequeno caractere presente no início de vários comandos que já usamos, como /plan, /fast e /config: a barra (/). Quantos comandos de barra existem no total e como você pode criar um comando personalizado? Imagine poder encapsular processos repetitivos que você digita manualmente em um comando de barra único — veremos todos os detalhes no próximo capítulo.


Leituras Recomendadas