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.
Conteúdo Premium
Desbloqueie todas as 19 seções do Claude Code Guide com acesso vitalício.
Incluído no Guide:
- 19 seções detalhadas, do setup ao workflow
- Acesso vitalício com atualizações
- Exemplos práticos e configurações prontas
- Suporte bilíngue (PT-BR e EN)