A renderização em tela cheia é uma visualização de pesquisa opcional e requer Claude Code v2.1.88 ou posterior. Ative-a com CLAUDE_CODE_NO_FLICKER=1. O comportamento pode mudar com base no feedback. vim ou htop, e renderiza apenas as mensagens que estão visíveis no momento. Isso reduz a quantidade de dados enviados para seu terminal em cada atualização.
A diferença é mais notável em emuladores de terminal onde a taxa de transferência de renderização é o gargalo, como o terminal integrado do VS Code, tmux e iTerm2. Se a posição de rolagem do seu terminal pular para o topo enquanto Claude está trabalhando, ou a tela piscar conforme a saída da ferramenta é transmitida, este modo resolve esses problemas.
O termo tela cheia descreve como Claude Code assume a superfície de desenho do terminal, da mesma forma que vim faz. Não tem nada a ver com maximizar a janela do seu terminal e funciona em qualquer tamanho de janela.
Ativar renderização em tela cheia
Defina a variável de ambiente CLAUDE_CODE_NO_FLICKER ao iniciar Claude Code:
CLAUDE_CODE_NO_FLICKER=1 claude
~/.zshrc ou ~/.bashrc:
export CLAUDE_CODE_NO_FLICKER=1
O que muda
A renderização em tela cheia altera como o CLI desenha no seu terminal. A caixa de entrada permanece fixa na parte inferior da tela em vez de se mover conforme a saída é transmitida. Se a entrada permanecer no lugar enquanto Claude está trabalhando, a renderização em tela cheia está ativa. Apenas as mensagens visíveis são mantidas na árvore de renderização, portanto a memória permanece constante independentemente do comprimento da conversa.
Como a conversa vive no buffer de tela alternativa em vez do scrollback do seu terminal, algumas coisas funcionam de forma diferente:
| Antes | Agora | Detalhes |
|---|
Cmd+f ou busca tmux para encontrar texto | Ctrl+o depois / para buscar, ou Ctrl+o depois [ para escrever a conversa no scrollback nativo para que Cmd+f funcione novamente | Buscar e revisar a conversa |
| Clique e arraste nativo do terminal para selecionar e copiar | Seleção no aplicativo, copia automaticamente ao soltar o mouse | Usar o mouse |
Cmd-clique para abrir uma URL | Clique na URL | Usar o mouse |
Usar o mouse
A renderização em tela cheia captura eventos de mouse e os manipula dentro do Claude Code:
- Clique na entrada do prompt para posicionar seu cursor em qualquer lugar no texto que você está digitando.
- Clique em um resultado de ferramenta recolhido para expandi-lo e ver a saída completa. Clique novamente para recolher. A chamada de ferramenta e seu resultado se expandem juntos. Apenas mensagens que têm mais a mostrar são clicáveis.
- Clique em uma URL ou caminho de arquivo para abri-lo. Caminhos de arquivo na saída da ferramenta, como os impressos após um Edit ou Write, abrem no seu aplicativo padrão. URLs simples
http:// e https:// abrem no seu navegador. Na maioria dos terminais, isso substitui o Cmd-clique ou Ctrl-clique nativo, que a captura de mouse intercepta. No terminal integrado do VS Code e terminais semelhantes baseados em xterm.js, continue usando Cmd-clique. Claude Code defere para o próprio manipulador de links do terminal para evitar abrir links duas vezes.
- Clique e arraste para selecionar texto em qualquer lugar da conversa. Clique duplo seleciona uma palavra, correspondendo aos limites de palavra do iTerm2 para que um caminho de arquivo seja selecionado como uma unidade. Clique triplo seleciona a linha.
- Role com a roda do mouse para se mover pela conversa.
O texto selecionado é copiado para sua área de transferência automaticamente ao soltar o mouse. Para desativar isso, alterne Copiar ao selecionar em /config. Com isso desativado, pressione Ctrl+Shift+c para copiar manualmente. Em terminais que suportam o protocolo de teclado kitty, como kitty, WezTerm, Ghostty e iTerm2, Cmd+c também funciona. Se você tiver uma seleção ativa, Ctrl+c copia em vez de cancelar.
Rolar a conversa
A renderização em tela cheia manipula a rolagem dentro do aplicativo. Use estes atalhos para navegar:
| Atalho | Ação |
|---|
PgUp / PgDn | Role para cima ou para baixo por meia tela |
Ctrl+Home | Pule para o início da conversa |
Ctrl+End | Pule para a mensagem mais recente e reative o auto-follow |
| Roda do mouse | Role algumas linhas por vez |
PgUp, PgDn, Home ou End, como teclados MacBook, mantenha Fn pressionado com as teclas de seta: Fn+↑ envia PgUp, Fn+↓ envia PgDn, Fn+← envia Home e Fn+→ envia End. Isso torna Ctrl+Fn+→ o atalho de pulo para o final. Se isso parecer desconfortável, role para o final com a roda do mouse para retomar o seguimento, ou rebinde scroll:bottom para algo acessível.
Rolar para cima pausa o auto-follow para que a nova saída não o puxe de volta para o final. Pressione Ctrl+End ou role para o final para retomar o seguimento.
Essas ações são rebindáveis. Veja Atalhos de teclado para personalizá-las. Os nomes das ações são scroll:pageUp, scroll:pageDown, scroll:top e scroll:bottom. Ações adicionais sem vinculação padrão incluem scroll:lineUp, scroll:lineDown, scroll:halfPageUp, scroll:halfPageDown, scroll:fullPageUp e scroll:fullPageDown.
Ajustar a velocidade de rolagem da roda
Se a rolagem da roda do mouse parecer lenta, seu terminal pode estar enviando um evento de rolagem por entalhe físico sem multiplicador. Alguns terminais, como Ghostty e iTerm2 com rolagem mais rápida ativada, já amplificam eventos de roda. Outros, incluindo o terminal integrado do VS Code, enviam exatamente um evento por entalhe. Claude Code não consegue detectar qual.
Defina CLAUDE_CODE_SCROLL_SPEED para multiplicar a distância de rolagem base:
export CLAUDE_CODE_SCROLL_SPEED=3
3 corresponde ao padrão em vim e aplicativos semelhantes. A configuração aceita valores de 1 a 20.
Buscar e revisar a conversa
Pressione Ctrl+o para entrar no modo de transcrição. Com a renderização em tela cheia ativa, o modo de transcrição ganha navegação e busca no estilo less:
| Tecla | Ação |
|---|
/ | Abrir busca. Digite para encontrar correspondências, Enter para aceitar, Esc para cancelar e restaurar sua posição de rolagem |
n / N | Pule para a próxima ou anterior correspondência. Funciona depois que você fechou a barra de busca |
j / k ou ↑ / ↓ | Role uma linha |
g / G ou Home / End | Pule para o topo ou final |
Ctrl+u / Ctrl+d | Role meia página |
Ctrl+b / Ctrl+f ou Space / b | Role uma página completa |
Esc, q ou Ctrl+o | Sair do modo de transcrição |
Cmd+f do seu terminal e a busca tmux não veem a conversa porque ela vive no buffer de tela alternativa, não no scrollback nativo. Para devolver o conteúdo ao seu terminal, pressione Ctrl+o para entrar no modo de transcrição primeiro, depois:
[: escreve a conversa completa no buffer de scrollback nativo do seu terminal, com toda a saída da ferramenta expandida. A conversa agora é texto comum no seu terminal, portanto Cmd+f, modo de cópia tmux e qualquer outra ferramenta nativa pode buscá-la ou selecioná-la. Sessões longas podem pausar por um momento enquanto isso acontece. Isso dura até você sair do modo de transcrição com Esc ou q, que o retorna à renderização em tela cheia. O próximo Ctrl+o começa do zero.v: escreve a conversa em um arquivo temporário e a abre em $VISUAL ou $EDITOR.
Pressione Esc, q ou Ctrl+o para retornar ao prompt.
A renderização em tela cheia funciona dentro do tmux, com duas ressalvas.
A rolagem da roda do mouse requer o modo de mouse do tmux. Se seu ~/.tmux.conf ainda não o ativa, adicione esta linha e recarregue sua configuração:
Sem o modo de mouse, os eventos de roda vão para tmux em vez de Claude Code. A rolagem do teclado com PgUp e PgDn funciona de qualquer forma. Claude Code imprime uma dica única na inicialização se detectar tmux com o modo de mouse desativado.
A renderização em tela cheia é incompatível com o modo de integração tmux do iTerm2, que é o modo que você entra com tmux -CC. No modo de integração, o iTerm2 renderiza cada painel tmux como uma divisão nativa em vez de deixar o tmux desenhar no terminal. O buffer de tela alternativa e o rastreamento de mouse não funcionam corretamente lá: a roda do mouse não faz nada e o clique duplo pode corromper o estado do terminal. Não ative a renderização em tela cheia em sessões tmux -CC. O tmux regular dentro do iTerm2, sem -CC, funciona bem.
Manter seleção de texto nativa
A captura de mouse é o ponto de atrito mais comum, especialmente sobre SSH ou dentro do tmux. Quando Claude Code captura eventos de mouse, a cópia nativa ao selecionar do seu terminal para de funcionar. A seleção que você faz com clique e arraste existe dentro do Claude Code, não no buffer de seleção do seu terminal, portanto o modo de cópia tmux, dicas do Kitty e ferramentas semelhantes não a veem.
Claude Code tenta escrever a seleção na sua área de transferência, mas o caminho que usa depende da sua configuração. Dentro do tmux, escreve no buffer de colagem do tmux. Sobre SSH, volta para sequências de escape OSC 52, que alguns terminais bloqueiam por padrão. Claude Code imprime um toast após cada cópia informando qual caminho foi usado.
Se você depender da seleção nativa do seu terminal, defina CLAUDE_CODE_DISABLE_MOUSE=1 para optar por não participar da captura de mouse mantendo a renderização sem cintilação e memória plana:
CLAUDE_CODE_NO_FLICKER=1 CLAUDE_CODE_DISABLE_MOUSE=1 claude
PgUp, PgDn, Ctrl+Home e Ctrl+End ainda funciona, e seu terminal manipula a seleção nativamente. Você perde clique para posicionar cursor, clique para expandir saída de ferramenta, clique em URL e rolagem de roda dentro do Claude Code.
Visualização de pesquisa
A renderização em tela cheia é um recurso de visualização de pesquisa. Ela foi testada em emuladores de terminal comuns, mas você pode encontrar problemas de renderização em terminais menos comuns ou configurações incomuns.
Se encontrar um problema, execute /feedback dentro do Claude Code para relatá-lo, ou abra uma issue no repositório GitHub claude-code. Inclua o nome e a versão do seu emulador de terminal.
Para desativar a renderização em tela cheia, desdefina a variável de ambiente ou defina CLAUDE_CODE_NO_FLICKER=0.
