Explore a janela de contexto
Uma simulação interativa de como a janela de contexto do Claude Code se preenche durante uma sessão. Veja o que é carregado automaticamente, quanto cada leitura de arquivo custa e quando regras e hooks são acionados.
A janela de contexto do Claude Code contém tudo o que Claude sabe sobre sua sessão: suas instruções, os arquivos que lê, suas próprias respostas e conteúdo que nunca aparece em seu terminal. A linha do tempo abaixo mostra o que é carregado e quando. Veja o detalhamento escrito para o mesmo conteúdo como uma lista.
O que a linha do tempo mostra
A sessão percorre um fluxo realista com contagens de tokens representativas:
- Antes de você digitar qualquer coisa: CLAUDE.md, memória automática, nomes de ferramentas MCP e descrições de skills são todos carregados no contexto. Sua própria configuração pode adicionar mais aqui, como um estilo de saída ou texto de
--append-system-prompt, que ambos vão para o prompt do sistema da mesma forma. - Conforme Claude trabalha: cada leitura de arquivo adiciona ao contexto, regras com escopo de caminho são carregadas automaticamente junto com arquivos correspondentes, e um hook PostToolUse é acionado após cada edição.
- O prompt de acompanhamento: um subagent lida com a pesquisa em sua própria janela de contexto separada, então as leituras de arquivo grandes ficam fora da sua. Apenas o resumo e um pequeno trailer de metadados voltam.
- No final:
/compactsubstitui a conversa por um resumo estruturado. A maioria do conteúdo de inicialização é recarregada automaticamente; a tabela abaixo mostra o que acontece com cada mecanismo.
O que sobrevive à compactação
Quando uma sessão longa é compactada, Claude Code resume o histórico de conversa para caber na janela de contexto. O que acontece com suas instruções depende de como foram carregadas:
| Mecanismo | Após compactação |
|---|---|
| Prompt do sistema e estilo de saída | Inalterado; não faz parte do histórico de mensagens |
| CLAUDE.md na raiz do projeto e regras sem escopo | Re-injetado do disco |
| Memória automática | Re-injetado do disco |
Regras com frontmatter paths: |
Perdidas até que um arquivo correspondente seja lido novamente |
| CLAUDE.md aninhado em subdiretórios | Perdido até que um arquivo nesse subdiretório seja lido novamente |
| Corpos de skills invocados | Re-injetado, limitado a 5.000 tokens por skill e 25.000 tokens no total; os mais antigos são descartados primeiro |
| Hooks | Não aplicável; hooks são executados como código, não contexto |
Regras com escopo de caminho e arquivos CLAUDE.md aninhados são carregados no histórico de mensagens quando seu arquivo de gatilho é lido, então a compactação os resume junto com tudo mais. Eles são recarregados na próxima vez que Claude lê um arquivo correspondente. Se uma regra deve persistir através da compactação, remova o frontmatter paths: ou mova-o para o CLAUDE.md na raiz do projeto.
Corpos de skills são re-injetados após compactação, mas skills grandes são truncados para caber no limite por skill, e os skills invocados mais antigos são descartados uma vez que o orçamento total é excedido. O truncamento mantém o início do arquivo, então coloque as instruções mais importantes perto do topo de SKILL.md.
Verifique sua própria sessão
A visualização usa números representativos. Para ver seu uso real de contexto em qualquer ponto, execute /context para um detalhamento ao vivo por categoria com sugestões de otimização. Execute /memory para verificar quais arquivos CLAUDE.md e memória automática foram carregados na inicialização.
Recursos relacionados
Para cobertura mais profunda dos recursos mostrados na linha do tempo, veja estas páginas:
- Estenda Claude Code: quando usar CLAUDE.md vs skills vs regras vs hooks vs MCP
- Armazene instruções e memórias: hierarquia CLAUDE.md e memória automática
- Subagents: delegue pesquisa a uma janela de contexto separada
- Melhores práticas: gerenciando contexto como sua restrição principal
- Prompt caching: quais ações invalidam o prefixo em cache
- Reduza o uso de tokens: estratégias para manter o uso de contexto baixo