Equipando o Claude Code
10. Contexto
Entenda como o Claude Code gerencia contexto e janela de tokens. Técnicas para manter conversas produtivas e eficientes.
A janela de contexto (context window) é a "memória de trabalho" do Claude durante uma sessão — tudo que o modelo consegue "enxergar" ao gerar uma resposta. Nos modelos Claude atuais, ela é de 200.000 tokens (~500 páginas de texto). Porém, na prática, o espaço utilizável é consideravelmente menor.
Por que o limite real não é 200K?
Parte dos 200K tokens é consumida por elementos fixos que o Claude Code carrega automaticamente em toda interação:
| Componente | Consumo aprox. | O que é |
|---|---|---|
| Buffer do auto-compact | ~33K tokens (16,5%) | Reserva fixa para sumarização e geração de resposta |
| Ferramentas do sistema | ~17K tokens (8,4%) | Definições de ferramentas internas (Read, Edit, Bash, etc.) |
| Arquivos de memória | ~7K tokens (3,7%) | CLAUDE.md do projeto + global + auto-memory |
| System prompt | ~3K tokens (1,3%) | Instruções internas do Claude Code |
| Plugins, skills e agentes | ~2K+ tokens | Cada plugin/skill instalado adiciona overhead |
Somando tudo, ~60K tokens (~30%) são consumidos antes mesmo de você digitar o primeiro prompt. Por isso, o auto-compact dispara quando o uso atinge ~83% — não 100%. Na prática, o espaço real para sua conversa é de aproximadamente ~160-165K tokens.
O que é auto-compact? Quando o contexto se aproxima do limite, o Claude Code automaticamente sumariza a conversa anterior para liberar espaço. Isso permite continuar a sessão, mas detalhes antigos podem ser perdidos na compactação. O indicador Context left until auto-compact: X% na status line mostra quanto falta para isso acontecer.
Degradação de qualidade
Mesmo antes de atingir o limite, a qualidade das respostas do modelo começa a cair a partir de ~70% de uso da janela de contexto. Quanto mais longa a conversa, maior a chance do modelo "esquecer" detalhes do meio da sessão (fenômeno conhecido como "lost in the middle"). Por isso, considere:
- Limite prático seguro: ~160K tokens (não 200K)
- Faixa ideal de trabalho: tente concluir sessões complexas antes de atingir ~130-140K tokens (~65-70%)
- A partir de 70%, considere usar
/compactou iniciar uma nova sessão com/clear
Conteúdo Premium
Desbloqueie todas as 20 seções do Claude Code Guide com acesso vitalício.
Incluído no Guide:
- 20 seções detalhadas, do setup à automação
- Acesso vitalício com atualizações
- Exemplos práticos e configurações prontas
- Suporte bilíngue (PT-BR e EN)