SpyBara
Go Premium

context-window.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 23 additions and 23 deletions.

2026
Thu 1 23:59 Tue 6 23:59 Wed 7 23:59 Thu 8 22:58 Wed 14 22:58 Tue 20 23:00 Thu 22 22:58 Fri 23 22:59 Tue 27 22:59

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 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. Arquivos AGENTS.md podem ser carregados no lugar de CLAUDE.md. Sua própria configuração pode adicionar mais aqui, como um estilo de saída ou texto de --append-system-prompt.
  • 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 da apresentação: você executa /compact, que 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. A partir da v2.1.198, a requisição de resumo herda a configuração de pensamento estendido da sua sessão, portanto ela raciocina com o pensamento habilitado quando sua sessão o tem habilitado e permanece desativado caso contrário. O pensamento afeta apenas como o resumo é produzido; suas configurações de sessão permanecem inalteradas depois. O que acontece com cada tipo de conteúdo depende de como foi carregado:

Mecanismo Após compactação
System prompt e estilo de saída Ambos ainda se aplicam
CLAUDE.md na raiz do projeto e regras sem escopo Re-injetado do disco
Memória automática Re-injetado do disco
Descrições de skills Reconstruídas a partir das suas skills atuais e re-injetadas. Requer Claude Code v2.1.304 ou posterior
Snapshot de status do Git Se a sessão começou com um, Claude Code lê um novo do seu repositório
O plano que Claude escreveu em modo de planejamento Re-injetado do disco
Regras com frontmatter paths: Claude Code as recarrega sob demanda
CLAUDE.md aninhado em subdiretórios Claude Code os recarrega sob demanda
Arquivos que Claude leu ou editou Claude Code relê até cinco, os mais recentemente modificados primeiro
Corpos de skills invocadas Re-injetado, limitado a 5.000 tokens por skill e 25.000 tokens no total; os mais antigos são descartados primeiro
Comandos em segundo plano e subagentes em segundo plano Continuam em execução. Claude Code lembra Claude quais ainda estão em execução para que ele não inicie uma duplicata
Contexto que hooks adicionaram anteriormente Resumido junto com o resto da conversa
SessionStart hooks que correspondem à fonte compact Claude Code os executa e adiciona sua saída ao contexto compactado

Logo após a compactação, Claude Code relê até cinco dos arquivos que Claude leu ou editou na sessão, escolhendo os modificados mais recentemente. Um arquivo com mais de 5.000 tokens volta como uma referência de caminho sem seu conteúdo, mostrado como Referenced file em vez de Read.

Regras com escopo de caminho e arquivos CLAUDE.md aninhados são carregados no histórico de mensagens quando Claude lê, escreve ou edita seu arquivo de gatilho, portanto a compactação os resume junto com tudo mais. Se uma regra deve persistir através da compactação, remova o frontmatter paths: ou mova-a para o CLAUDE.md na raiz do projeto.

Corpos de skills são re-injetados após compactação, mas skills grandes são truncadas para caber no limite por skill, e as skills invocadas mais antigas são descartadas 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. Para saber quando Claude Code também compacta uma conversa que você deixa ociosa, veja compactação por inatividade.

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.
  • Compacte parte da conversa: execute /rewind, selecione uma mensagem e escolha Summarize from here ou Summarize up to here. Veja Rewind and summarize para o que cada opção mantém e como orientar o resumo.
  • Compacte mais cedo: execute /autocompact com uma contagem de tokens, como /autocompact 500k, para definir o quão cheio a janela de contexto fica antes da passagem automática ser executada. Veja Set the auto-compact window para valores aceitos e substituições.
  • 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, modelos Fable, Sonnet 5 e posteriores, Haiku 5.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]. A compactação funciona da mesma forma no limite maior.

O ponto em que a compactação automática é executada depende do seu modelo e configuração. Veja Default auto-compact thresholds para os limites por modelo, e Correct the window for a gateway or custom model ID se Claude Code assumir a janela errada para seu ID de modelo, como um alias de LLM gateway.

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, incluindo quais arquivos CLAUDE.md e memória automática foram carregados. Execute /memory para abrir e editar esses arquivos.

Recursos relacionados

Para cobertura mais profunda dos recursos mostrados na linha do tempo, veja estas páginas: