O que é o CLAUDE.md e para que serve?

O CLAUDE.md é um ficheiro de texto que Claude lê automaticamente no início de cada sessão. Contém instruções persistentes: o teu stack tecnológico, convenções de código, preferências de estilo, regras do projeto. É a forma de não ter de repetir o mesmo contexto em cada sessão.

Quando devo usar /clear vs /compact?

/clear reinicia completamente o contexto — como abrir uma nova sessão. /compact tenta resumir o historial para libertar tokens sem perder o fio. A recomendação do Nível 3 é preferir /clear: um contexto limpo e deliberado produz melhores resultados do que um resumo degradado de uma conversa longa.

Porque é que o desempenho cai após ~100K tokens?

Os modelos de linguagem têm dificuldade em manter atenção uniforme ao longo de contextos muito longos — especialmente para a informação no «meio» da janela. A partir de certo ponto, adicionar mais texto não acrescenta mais compreensão: acrescenta ruído. Esta degradação é a razão pela qual reiniciar estrategicamente o contexto melhora a qualidade.

Como sei o que incluir no CLAUDE.md e o que deixar de fora?

Inclui apenas o que Claude precisa de saber em TODOS os prompts desse projeto — não o que precisa para uma tarefa específica. O critério é: o output mudaria se Claude não soubesse isto? Se a resposta for sim para a maioria das tarefas, entra. Se for apenas relevante para casos extremos, não entra.

Nível 3 — O Engenheiro de Contexto

13 de março de 2026

Mentalidade: «Não és um programador — és um curador»

O Nível 3 é onde a maioria dos praticantes de Claude Code se separa dos restantes 50%. O insight central é este: a qualidade do output não depende do que pedes — depende de que informação Claude tem quando o pedes.

O teu trabalho já não é apenas escrever prompts. É decidir o que entra no contexto, o que sai, e quando reiniciar. És um curador de informação, não um escritor de comandos.

Estás aqui quando...

Escreves e manténs ficheiros CLAUDE.md lean — não inchados
Pensas deliberadamente sobre o que Claude vê vs. o que não vê
Usas /clear entre tarefas para reiniciar a janela de contexto
Monitorizas o uso de tokens ativamente
Sabes quando menos informação produz melhores resultados

Competências a dominar

Gestão da janela de contexto — a competência #1 neste nível
Claude tem um orçamento de 200K tokens
O desempenho degrada significativamente após ~100K tokens (50–60%) — a «zona morta»
Usa /context para ver o uso em qualquer momento
Usa /clear para reiniciar (preferível a /compact)
CLAUDE.md lean — não inchado. Menos é mais
Exemplos few-shot em vez de instruções longas
Contexto certo no momento certo — cirúrgico, não exaustivo

A armadilha: O CLAUDE.md inchado

Um estudo da ETH Zurich descobriu que os ficheiros de contexto gerados por LLMs tornavam os agentes PIORES em 5 de 8 configurações e aumentavam o custo de inferência em mais de 20%. Mais contexto não equivale a melhor output.

Claude precisa de algum contexto, não de todo o contexto. A diferença entre «suficiente» e «demasiado» é onde se ganha ou perde qualidade. Um CLAUDE.md de 50 linhas bem escolhidas supera um de 500 linhas acumuladas sem critério. Dominar esta distinção coloca-te no top 50% de praticantes de Claude Code a nível global.

Como desbloquear o Nível 4

O desbloqueio chega quando percebes que precisas de capacidades que Claude não tem de forma nativa. Para ligar Claude à tua base de dados, testar a tua UI ou fazer push para o GitHub, precisas de ferramentas externas. Isso é o Nível 4.

Próximos passos

A engenharia de contexto é a competência menos ensinada e mais impactante do ecossistema de IA. Se quiseres que a tua equipa a desenvolva, podemos trabalhá-la com projetos reais.

Perguntas frequentes

O que é o CLAUDE.md e para que serve?: O CLAUDE.md é um ficheiro de texto que Claude lê automaticamente no início de cada sessão. Contém instruções persistentes: o teu stack tecnológico, convenções de código, preferências de estilo, regras do projeto. É a forma de não ter de repetir o mesmo contexto em cada sessão.
Quando devo usar /clear vs /compact?: /clear reinicia completamente o contexto — como abrir uma nova sessão. /compact tenta resumir o historial para libertar tokens sem perder o fio. A recomendação do Nível 3 é preferir /clear: um contexto limpo e deliberado produz melhores resultados do que um resumo degradado de uma conversa longa.
Porque é que o desempenho cai após ~100K tokens?: Os modelos de linguagem têm dificuldade em manter atenção uniforme ao longo de contextos muito longos — especialmente para a informação no «meio» da janela. A partir de certo ponto, adicionar mais texto não acrescenta mais compreensão: acrescenta ruído. Esta degradação é a razão pela qual reiniciar estrategicamente o contexto melhora a qualidade.
Como sei o que incluir no CLAUDE.md e o que deixar de fora?: Inclui apenas o que Claude precisa de saber em TODOS os prompts desse projeto — não o que precisa para uma tarefa específica. O critério é: o output mudaria se Claude não soubesse isto? Se a resposta for sim para a maioria das tarefas, entra. Se for apenas relevante para casos extremos, não entra.