Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
A renderização em tela cheia é uma visualização de pesquisa opcional e requer Claude Code v2.1.89 ou posterior. Execute
/tui fullscreen para alternar em sua conversa atual, ou defina CLAUDE_CODE_NO_FLICKER=1 em versões anteriores a v2.1.110. 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
Execute/tui fullscreen dentro de qualquer conversa do Claude Code. O CLI salva a configuração tui e reinicia em tela cheia com sua conversa intacta, para que você possa alternar no meio da sessão sem perder contexto. Execute /tui sem argumentos para imprimir qual renderizador está ativo.
Você também pode definir a variável de ambiente CLAUDE_CODE_NO_FLICKER antes de iniciar Claude Code:
tui e a variável de ambiente são equivalentes. O comando /tui limpa CLAUDE_CODE_NO_FLICKER do processo reiniciado para que a configuração que ele escreve tenha efeito.
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 para modo de transcrição, depois / para buscar ou [ para escrever no scrollback | 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://ehttps://abrem no seu navegador. Na maioria dos terminais, isso substitui oCmd-clique ouCtrl-clique nativo, que a captura de mouse intercepta. No terminal integrado do VS Code e terminais semelhantes baseados em xterm.js, continue usandoCmd-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.
/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.
Com uma seleção ativa, mantenha Shift pressionado e pressione as teclas de seta para estendê-la a partir do teclado. Shift+↑ e Shift+↓ rolam a janela de visualização quando a seleção atinge a borda superior ou inferior. Shift+Home e Shift+End estendem para o início ou fim da linha atual.
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.
Essas ações são rebindáveis. Veja Ações de rolagem para a lista completa de nomes de ações, incluindo variantes de meia página e página completa que não têm vinculação padrão.
Auto-follow
Rolar para cima pausa o auto-follow para que a nova saída não o puxe de volta para o final. PressioneCtrl+End ou role para o final para retomar o seguimento.
Para desativar o auto-follow completamente para que a visualização permaneça onde você a deixar, abra /config e defina Auto-scroll como desativado. Com auto-scroll desativado, a visualização nunca pula para o final por conta própria. Prompts de permissão e outros diálogos que precisam de uma resposta ainda rolam para a visualização independentemente dessa configuração.
Rolagem da roda do mouse
A rolagem da roda do mouse requer que seu terminal encaminhe eventos de mouse para Claude Code. A maioria dos terminais faz isso sempre que um aplicativo solicita. O iTerm2 torna isso uma configuração por perfil: se a roda não fizer nada, masPgUp e PgDn funcionarem, abra Configurações → Perfis → Terminal e ative Ativar relatório de mouse. A mesma configuração também é necessária para clique para expandir e seleção de texto funcionarem.
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:
3 corresponde ao padrão em vim e aplicativos semelhantes. A configuração aceita valores de 1 a 20.
Para ajustar a velocidade de rolagem interativamente, execute /scroll-speed. O diálogo mostra uma régua que você pode rolar enquanto está aberto para que você possa sentir a mudança imediatamente. Pressione ← e → para ajustar, r para redefinir para o padrão detectado automaticamente e Enter para salvar. O comando escreve o mesmo valor que a variável de ambiente CLAUDE_CODE_SCROLL_SPEED define, persistido em ~/.claude/settings.json. O comando não está disponível no terminal do IDE JetBrains.
Rolagem no terminal do IDE JetBrains
No terminal do IDE JetBrains, Claude Code aplica sua própria manipulação de rolagem e ignoraCLAUDE_CODE_SCROLL_SPEED. O terminal envia eventos de rolagem em uma taxa muito mais alta do que outros emuladores, portanto um multiplicador ajustado em outro lugar ultrapassa aqui.
Em 2025.2, o terminal também tem bugs de rolagem de roda que produzem teclas de seta espúrias e eventos de direção incorreta. Claude Code detecta esses em tempo de execução e os mitiga automaticamente, portanto a rolagem do trackpad e da roda do mouse funcionam sem configuração. Para a melhor experiência de rolagem, atualize para 2025.3 ou posterior. Claude Code mostra uma dica na primeira vez que você rola se detectar o bug.
Buscar e revisar a conversa
Ctrl+o alterna entre o prompt normal e o modo de transcrição. Para uma visualização mais silenciosa que mostra apenas seu último prompt, um resumo de uma linha de chamadas de ferramenta com estatísticas de diff de edição e a resposta final, execute /focus. A configuração persiste entre sessões. Execute /focus novamente para desativá-la.
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 |
Ctrl+o, Esc, ou q | Sair do modo de transcrição e retornar ao prompt |
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, portantoCmd+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 comEscouq, que o retorna à renderização em tela cheia. O próximoCtrl+ocomeça do zero.v: escreve a conversa em um arquivo temporário e a abre em$VISUALou$EDITOR.
Esc ou q para retornar ao prompt.
Limpar a conversa
PressioneCtrl+L duas vezes em dois segundos para executar /clear e iniciar uma nova conversa. O primeiro pressionamento redesenha a tela e mostra uma dica; o segundo pressionamento limpa a conversa. No macOS, pressionar duas vezes Cmd+K também executa /clear.
Usar com tmux
A renderização em tela cheia funciona dentro do tmux, com três 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:
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.
O tmux não suporta saída sincronizada, portanto você pode ver mais cintilação durante redesenhos do que ao executar Claude Code diretamente em seu terminal. Se a cintilação for perceptível, especialmente via SSH, execute Claude Code em sua própria aba de terminal fora do tmux.
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. O iTerm2 bloqueia até que você ative Configurações → Geral → Seleção → Aplicativos no terminal podem acessar a área de transferência. Executar/terminal-setup no iTerm2 ativa isso para você. Claude Code imprime um toast após cada cópia informando qual caminho foi usado.
Para uma seleção nativa única, mantenha pressionada a tecla modificadora de bypass do seu terminal enquanto clica e arrasta: Option no iTerm2, ou Shift na maioria dos terminais Linux e Windows. O modificador diz ao seu terminal para manipular a seleção em si em vez de encaminhar eventos de mouse para Claude Code, portanto Cmd+C e outros atalhos de cópia do seu terminal funcionam nela.
Se você depender da seleção nativa o tempo todo, 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:
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, execute /tui default, ou desdefina CLAUDE_CODE_NO_FLICKER se você a ativou dessa forma. Para forçar o renderizador clássico independentemente da configuração tui salva, defina CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1. O renderizador clássico mantém a conversa no scrollback nativo do seu terminal, portanto Cmd+f e o modo de cópia do tmux funcionam como de costume.