Context window
Entenda o limite mais importante do Claude — e como gerenciá-lo
⏱ Estim. ~5 min
01 · Ler
O context window do Claude é como uma mesa. Tudo em que o Claude está pensando precisa caber nessa mesa — sua conversa, o conteúdo dos arquivos que ele lê, o output dos comandos, o CLAUDE.md, as skills carregadas, as descrições das ferramentas MCP, as instruções do sistema.
Quando a mesa enche, o Claude precisa empurrar coisas antigas para fora para abrir espaço para as novas. Quando isso acontece, ele pode esquecer instruções que você deu antes, ou perder de vista quais arquivos já leu.
Esse é o conceito mais importante para usar o Claude Code com eficácia.
💡 Imagine assimImagine trabalhar com um colega supercompetente cuja mesa só comporta 50 páginas. Cada vez que você entrega um documento novo, um antigo cai. Você vai entregando arquivos sem parar e, no fim, suas instruções originais escorregam para fora da mesa. Entender esse limite é a chave para sessões produtivas.
Pontos-chave
- O context window guarda tudo em que o Claude está "pensando"
- Inclui conversa, arquivos, output de comandos, CLAUDE.md, skills, ferramentas MCP
- Quando enche, o conteúdo antigo é removido automaticamente
- É por isso que o CLAUDE.md importa — ele é sempre recarregado, até depois da compactação
02 · Ler
Nem tudo consome a mesma quantidade de contexto. Ler um arquivo grande despeja todo o conteúdo na janela. Outputs longos de comandos consomem tokens. Cada descrição de ferramenta MCP ocupa espaço (é por isso que existe o Tool Search).
Guia aproximado — CLAUDE.md usa de 2 a 5 mil tokens dependendo do tamanho. Cada leitura de arquivo usa tokens proporcionais ao tamanho. Outputs de comandos (como resultados de testes ou erros de build) podem ser surpreendentemente grandes. Skills carregam sob demanda e só consomem tokens quando ativadas. Ferramentas MCP consomem tokens com suas descrições.
Insight chave — mantenha o contexto inicial enxuto e deixe o Claude carregar o que ele precisar.
Pontos-chave
- CLAUDE.md: 2 a 5 mil tokens (mantenha em menos de 200 linhas)
- Leitura de arquivos: proporcional ao tamanho do arquivo
- Output de comandos: pode ser grande (suítes de teste, logs de build)
- Skills: sob demanda — custo zero ao iniciar
- Ferramentas MCP: as descrições consomem tokens (o Tool Search ajuda)
03 · Exemplo de código
O Claude Code te dá ferramentas para monitorar o uso de contexto e liberar espaço quando precisar.
Ver o uso de contexto
/context
Compactar com instrução de foco
/compact Focus on the API changes and test failures
Limpar entre tarefas não relacionadas
/clear
Use /context para ver o quanto a janela está cheia. Quando estiver apertado, /compact resume a conversa preservando o que importa — adicione uma instrução de foco para dizer ao Claude o que manter. Entre tarefas totalmente não relacionadas, use /clear para resetar tudo (mas o CLAUDE.md é recarregado automaticamente).
04 · Ler
Quando o contexto fica cheio demais, o Claude Code compacta automaticamente. Ele resume a conversa, preservando o trabalho recente e as decisões chave, e condensa as trocas mais antigas.
Depois da compactação — automática ou manual — o Claude relê o CLAUDE.md do disco. Isso significa que o que está no CLAUDE.md sobrevive à compactação. O que está só no histórico da conversa pode não sobreviver.
Essa é a razão fundamental para colocar regras importantes no CLAUDE.md em vez de só dizer na conversa.
Pontos-chave
- O Claude compacta automaticamente quando se aproxima do limite
- A compactação resume conversas antigas e preserva o trabalho recente
- O CLAUDE.md é sempre relido após a compactação
- Regras no CLAUDE.md sobrevivem; instruções faladas podem não sobreviver
- Use /compact proativamente antes que a compactação automática dispare
05 · Quiz
Você disse ao Claude no começo de uma sessão longa: "sempre use Bun, nunca npm". Depois da compactação automática, o Claude começa a usar npm. Por quê?
- O Claude está ignorando suas instruções de propósito
- Bun é incompatível com o Claude Code
- Você precisa reiniciar o Claude Code para o comando ter efeito
- Instruções faladas se perdem na compactação — coloque no CLAUDE.md
06 · Classificar arrastando
Pense em como cada tipo de conteúdo afeta o context window. Ordene do mais eficiente em contexto ao menos eficiente.
(Esta seção é interativa — ative o JavaScript para usar.)
Outras lições deste capítulo
⚠ A experiência interativa completa precisa de JavaScript. Ative-o e recarregue a página.
※ Este é um projeto educacional independente — não é um produto oficial da Anthropic. Claude™ é uma marca registrada da Anthropic, PBC.