Aula 07Gerenciamento de contexto

🖥️ Versão Desktop. Nesta aula, tudo acontece na aba Code do app Claude Desktop: na caixa de mensagem, no anel de uso e na barra lateral. Dois comandos, o /compact e o /btw, você digita na própria caixa de mensagem, e a aula mostra exatamente o que digitar. No fim do Na prática, quando você pede para guardar uma versão, os comandos do Git aparecem para você aprovar, como na Aula 06.

Objetivos

Ao final desta aula você vai saber:

• O que ocupa espaço na janela de contexto, a memória de trabalho do Claude
• O que acontece quando ela enche (a compactação)
• Quando usar o /compact, abrir uma sessão nova, olhar o anel de uso e abrir um chat lateral
• Três hábitos para economizar contexto
• Escolher quanto detalhe aparece na conversa e guardar as decisões num arquivo antes de começar uma sessão nova

O contexto é a memória de trabalho do Claude. Todo arquivo que ele lê, todo comando que ele roda, toda mensagem que você manda: tudo ocupa espaço nessa memória, que se chama janela de contexto.

Na Aula 06, para fazer o cardápio com filtro, o Claude leu a página, escreveu um plano e mudou os arquivos. Tudo isso ficou na memória de trabalho dele, e é por isso que, no meio da tarefa, ele lembrava do que vocês tinham combinado. Nesta aula, você aprende a cuidar dessa memória.

O que é a janela de contexto?

Pense na janela de contexto como o espaço que o Claude consegue manter na memória. Sempre que você envia um prompt, o Claude lê um arquivo, usa uma ferramenta ou recebe o resultado dela, isso entra na janela. Como o espaço é finito, vale a pena cuidar de como você o usa.

E não é só uma questão de espaço: quanto mais cheia a janela, pior o desempenho. Com o contexto lotado, o Claude começa a "esquecer" instruções do começo da conversa e a errar mais. Por isso, o contexto é o recurso mais importante para você cuidar.

Janela de contexto
[■■■■■■□□□□□□□□□□□□□□□□□□□□□□□□]
 ↑ prompts, arquivos lidos, saídas de comandos, resultados de ferramentas

No app, você acompanha isso pelo anel de uso, ao lado do seletor de modelo, na linha embaixo da caixa de mensagem. Clique nele para ver quanto da janela de contexto a sessão já ocupou. Cada sessão tem o seu próprio contexto.

O que acontece quando o contexto enche

Quando você se aproxima do limite, a janela é compactada automaticamente. A compactação resume os detalhes importantes e tira os resultados de ferramentas que não são mais necessários, para liberar espaço. Depois, o Claude continua trabalhando.

⚠️ Esse processo pode perder detalhes. Por isso, é melhor você mesmo decidir quando e como liberar espaço.

Os comandos e os botões

Quando terminar, feche o chat lateral e continue a sessão de onde parou. O app não guarda os chats laterais: depois de fechar o app, você não volta mais a eles.

🔧 Para ir além (para quem já programa; pode pular): além das sessões Local, o chat lateral funciona nas sessões SSH, que rodam em outro computador, e WSL, que rodam no Linux dentro do Windows.

Regra prática

• Use /compact quando estiver no meio de uma tarefa, como o filtro do cardápio, encostando no limite, mas precisar continuar. O que importa é manter na memória o que serve para a tarefa atual.
• Abra uma sessão nova (+ New) quando for começar algo que não tem nada a ver com a tarefa anterior. Por exemplo: você terminou o cardápio e agora quer mudar o texto do horário. A conversa antiga não ajuda e ainda pode puxar o Claude de volta para o assunto velho.
• Abra uma sessão nova também quando já corrigiu o Claude mais de duas vezes no mesmo problema. O contexto fica cheio de tentativas que não deram certo. Uma sessão limpa, com um pedido melhor que inclua o que você aprendeu, quase sempre resolve mais rápido.

E o que você quer que o Claude lembre entre uma sessão e outra? Hoje, você vê o arquivo de decisões, mais abaixo. Na Aula 11, vem o CLAUDE.md, um arquivo de anotações que o Claude lê no começo de toda conversa, como as regras da casa. Ele continua valendo na sessão nova e depois da compactação, então o Claude não precisa redescobrir tudo do zero.

💡 Dica: o /compact aceita instruções. Ao digitar /, o app mostra um menu com os comandos: escolha o /compact e escreva a instrução depois dele, na mesma mensagem. Por exemplo: /compact mantenha as decisões sobre as cores e os textos da página e descarte o resto. Para valer em toda compactação, inclusive na automática, a instrução vai no CLAUDE.md (Aula 11): "Ao compactar, preserve sempre a lista de arquivos que você mudou e as cores e os textos combinados."

Duas ajudas para conversas longas

• Os modos de visualização mudam quanto detalhe aparece na conversa. No Normal, o que o Claude fez (ler um arquivo, rodar um comando) aparece resumido, e as respostas, completas. O Thinking (raciocínio) mostra também o que o Claude pensou; ele só aparece no menu depois que o Claude pensou alguma coisa na sessão. O Verbose (detalhado) mostra cada ferramenta que o Claude usou, cada arquivo lido e cada passo intermediário. Aperte Ctrl + O (no Mac e no Windows) para passar de um modo para o outro, ou abra o menu da sessão, na setinha ao lado do título, e escolha Transcript view (o modo de ver a conversa). Eles mudam o que você vê, não o contexto do Claude.
• Um arquivo de decisões guarda o que importa antes de você começar uma sessão nova. Peça ao Claude: "Salve num arquivo decisoes.md as decisões que tomamos nesta sessão." Na sessão nova, comece pedindo "leia o decisoes.md", e ele volta a saber o que foi combinado. A sessão antiga continua na barra lateral, mas um arquivo curto é mais fácil de consultar do que a conversa inteira.

Dicas para economizar contexto

1. Seja específico. Um pedido vago parece menor, mas no fim custa mais contexto. Sem instruções claras, o Claude precisa ler mais arquivos e raciocinar por conta própria para descobrir o que você quer, e isso ocupa muito mais espaço do que um pedido detalhado. É o mesmo pedido de cinco partes da Aula 04.

2. Desligue os conectores que você não usa. Os conectores, também chamados de servidores MCP, ligam o Claude a outros apps, como a sua agenda ou o Google Drive (Aula 14). Por padrão, o Claude Code carrega só os nomes das ferramentas de cada um e as instruções deles. O resto só entra no contexto quando o Claude procura uma ferramenta específica (é a busca de ferramentas, ou tool search). Mesmo assim, cada conector ligado ocupa um pouco de espaço. Se você tem conectores que não têm nada a ver com o projeto atual, desconecte-os em Settings → Connectors (Configurações → Conectores). Se você ainda não ligou nenhum, guarde a dica para a Aula 14.

As skills, receitas salvas para o Claude fazer uma tarefa do seu jeito (Aula 13), seguem a mesma ideia: só a descrição de cada uma fica no contexto, e o resto carrega quando ela é usada.

3. Use subagentes. Um subagente é um ajudante que o Claude chama para uma parte da tarefa (Aula 12). Ele trabalha com uma janela de contexto própria e volta só com o resumo. Use quando a tarefa encheria a sua conversa de coisas que você não vai olhar de novo, como uma pesquisa na internet. Por exemplo: "use um subagente para pesquisar cinco doces típicos de festa junina e me traga só a lista". As páginas que ele lê ficam na memória dele, e a sua conversa recebe só a lista.

Na prática

Use a pasta da sua página (a confeitaria, ou a da sua ideia), com o cardápio da Aula 06.

1. Na aba Code, na linha abaixo da caixa de mensagem, escolha Local e a pasta da sua página. Antes da primeira mensagem, escolha Manual no seletor de modo, na mesma linha.
2. Peça: "leia os arquivos da página, menos o .env, e resuma cada um em uma frase". Acompanhe o que ele lê.
3. Aperte Ctrl + O algumas vezes e compare os modos Normal e Verbose (e o Thinking, se ele aparecer): no Verbose, aparece cada arquivo que o Claude leu. Termine no Normal.
4. Clique no anel de uso, ao lado do seletor de modelo, e veja quanto da janela de contexto a sessão já ocupou.
5. Abra um chat lateral (Cmd + ; no Mac, Ctrl + ; no Windows, ou digite /btw na caixa de mensagem) e pergunte: "qual é mesmo o tom de rosa da página?". Feche o chat lateral e confira na conversa principal: a pergunta e a resposta não entraram nela.
6. Na caixa de mensagem, digite /compact mantenha as cores e os textos da página e aperte Enter. Depois, clique no anel de novo e compare com o passo 4.
7. Peça: "salve num arquivo decisoes.md as cores, as fontes e os textos que a página usa hoje" e aceite a mudança. Depois, peça: "guarde uma versão com o decisoes.md" e aprove os comandos do Git, como na Aula 06.
8. Clique em + New, na barra lateral, e abra a sessão nova na mesma pasta, no Manual, como no passo 1. Peça: "leia o decisoes.md e me diga qual é o tom de rosa da página". A sessão começou vazia, mas o arquivo trouxe o que importa, e a sessão anterior continua na barra lateral.

Resumo

• Tudo ocupa contexto: os seus pedidos, os arquivos que o Claude lê, os comandos e os resultados das ferramentas.
• Quanto mais cheio o contexto, pior o desempenho. Perto do limite, o Claude compacta sozinho, e isso pode perder detalhes.
• /compact resume e continua; + New começa uma sessão nova (a antiga fica na barra lateral); o anel de uso mostra o consumo; o chat lateral (/btw) tira uma dúvida sem desviar a sessão.
• Corrigiu o Claude mais de duas vezes no mesmo ponto? Sessão nova e um pedido melhor.
• Ctrl + O troca o modo de visualização (muda só o que você vê), e um arquivo de decisões guarda o que importa antes de você começar uma sessão nova.
• Economize contexto: seja específico, desconecte os conectores que não usa e passe as pesquisas para subagentes.
• O que deve valer em toda sessão vai para o CLAUDE.md, que a Aula 11 apresenta.

Na próxima aula: quanto custa usar o Claude Code, os limites do seu plano e como escolher o modelo.