---
published: true
id: compaction
title: Compactação
description: Knowledge captured in João Lopes' learning graph.
tags:
- ai-engineering
- context-window
- agent-design
locale: pt-br
resource: https://joaolopes.dev.br/knowledge/concepts/pt-br/compaction/
created: '2026-04-06'
---

# Compactação
O processo de resumir contexto mais antigo para liberar tokens quando a janela de contexto enche.

## Definição
Conforme uma sessão progride, a janela de contexto acumula tokens do histórico da conversa, resultados de tools e conteúdo de arquivos. Quando a janela se aproxima do seu limite, o harness compacta: limpa outputs de tools mais antigos primeiro, depois resume a conversa se necessário. Instructions e trechos-chave de código sobrevivem à compactação. Detalhes da conversa de mais cedo na sessão talvez não. É por isso que instruções persistentes pertencem ao CLAUDE.md ou AGENTS.md em vez de mensagens na conversa.

## Fonte
- [How Claude Code works](https://code.claude.com/docs/en/how-claude-code-works) — "It clears older tool outputs first, then summarizes the conversation if needed."
- [The Anatomy of an Agent Harness](https://blog.langchain.com/the-anatomy-of-an-agent-harness/) — describes context as a "precious and scarce resource" and compaction as active management against "context rot."

## Relacionados
- [Context Window](/concepts/pt-br/context-window.md)
- [Tokens](/concepts/pt-br/tokens.md)
- [Instructions](/concepts/pt-br/instructions.md)