Pular para o conteúdo principal
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 uma sessão completa do início até a compactação: o que é carregado antes de você digitar, o que cada leitura de arquivo, regra e hook adiciona conforme Claude trabalha, e como um subagent mantém leituras grandes fora de seu contexto. 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: /compact substitui 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:
MecanismoApós compactação
Prompt do sistema e estilo de saídaInalterado; não faz parte do histórico de mensagens
CLAUDE.md na raiz do projeto e regras sem escopoRe-injetado do disco
Memória automáticaRe-injetado do disco
Regras com frontmatter paths:Perdidas até que um arquivo correspondente seja lido novamente
CLAUDE.md aninhado em subdiretóriosPerdido até que um arquivo nesse subdiretório seja lido novamente
Corpos de skills invocadosRe-injetado, limitado a 5.000 tokens por skill e 25.000 tokens no total; os mais antigos são descartados primeiro
HooksNã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.

Quando sua janela de contexto se preenche

Claude Code faz compactação automática conforme você se aproxima do limite, então uma janela de contexto cheia não encerra sua sessão. A passagem automática funciona da mesma forma que a etapa /compact na linha do tempo. Veja Quando o contexto se preenche para o que ela preserva. Você também pode agir antes da passagem automática ser executada:
  • Compacte com um foco: execute /compact com instruções, como /compact focus on the auth bug fix, antes de iniciar uma tarefa longa nova. O resumo mantém o que você escolhe em vez do que a passagem automática acha que é importante.
  • Limpe entre tarefas: execute /clear ao mudar para trabalho não relacionado. Conversa antiga ocupa espaço dos arquivos que você precisa em seguida e custa tokens em cada mensagem.
  • Delegue leituras grandes: envie pesquisa para um subagent para que o conteúdo do arquivo fique em sua janela de contexto, não na sua.
Se você precisar de uma janela maior em vez de uma conversa menor, Fable 5, Sonnet 5, Opus 4.6 e posteriores, e Sonnet 4.6 suportam uma janela de contexto de 1 milhão de tokens. Veja Extended context para disponibilidade por plano e como selecionar uma variante de modelo [1m]. Sonnet 5 é executado em 1M sem variante [1m] para selecionar; veja Sonnet 5 context window para seus limites de auto-compactação e a exceção do gateway LLM. A compactação funciona da mesma forma no limite maior.

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. Para cobertura mais profunda dos recursos mostrados na linha do tempo, veja estas páginas: