Otimizando CLAUDE.md para Reduzir a Ansiedade de Contexto no Claude AI

Estratégias Principais de Otimização do CLAUDE.md

Com base em uma discussão no Reddit que analisa a documentação da Anthropic, várias melhorias concretas podem aumentar significativamente a eficácia do CLAUDE.md e reduzir a ansiedade de contexto.

Estrutura e Tamanho do Arquivo

• Mantenha o CLAUDE.md com menos de 200 linhas. A orientação da Anthropic indica que arquivos mais longos reduzem a adesão, fazendo com que o Claude ignore regras quando há muitas.
• Use o diretório .claude/rules/ para dividir as regras em arquivos separados, escopados para caminhos de arquivo específicos. Essas regras só são carregadas quando o Claude toca em arquivos correspondentes, reduzindo o ruído de contexto.
• Separe regras comportamentais da estrutura do projeto. O CLAUDE.md deve lidar com regras comportamentais, enquanto os detalhes de arquitetura devem referenciar documentos externos usando o formato @/path/to/architecture.md, que o Claude carrega na inicialização sem inflar o arquivo principal.
• Use comentários HTML como <!-- nota do mantenedor --> para notas humanas, que são removidas antes de entrar no contexto, fornecendo espaço livre para comunicação da equipe sem custar tokens.

Especificidade das Instruções

• Torne as instruções específicas o suficiente para verificar. "Use indentação de 2 espaços" funciona efetivamente, enquanto instruções vagas como "Escreva código limpo" são ignoradas, levando a loops de correção que desperdiçam tokens.
• Um único loop de correção pode facilmente consumir 10 a 50 vezes mais tokens do que a linha que o teria prevenido.

Aproveitando a Memória Automática

• Desde a versão 2.1.59, o Claude salva suas próprias notas sobre comandos de construção, padrões de depuração e preferências do usuário.
• Verifique o que o Claude já aprendeu com /memory antes de adicionar informações redundantes ao CLAUDE.md.
• Pare de duplicar o que a memória automática já lida para evitar inchaço desnecessário de contexto.

Implementação

Para equipes sem um arquivo CLAUDE.md, /init gera um ponto de partida decente que pode ser refinado a partir daí. Como o CLAUDE.md é carregado em todas as sessões de qualquer maneira, não custa nada extra, enquanto instruções claras desde o início previnem correções de ida e volta que consomem tokens significativos.