CLAUDE.md: Arquivo de substituição reduz tokens de saída do Claude em 63%

O que o CLAUDE.md faz
CLAUDE.md é um único arquivo que você coloca na raiz do seu projeto. Quando o Claude Code o lê, o comportamento muda imediatamente sem modificações no código. Ele visa especificamente o comportamento de saída: bajulação, verbosidade e ruído de formatação.
O problema que ele aborda
Por padrão, o Claude desperdiça tokens em comportamentos que não agregam valor:
- Abre respostas com "Claro!", "Ótima pergunta!", "Absolutamente!"
- Termina com "Espero que isso ajude! Avise se precisar de algo!"
- Usa travessões (--), aspas inteligentes, caracteres Unicode que quebram analisadores
- Repete sua pergunta antes de responder
- Adiciona sugestões não solicitadas além do que você pediu
- Sobreprojeta código com abstrações desnecessárias
- Concorda com declarações incorretas ("Você está absolutamente certo!")
Resultados de benchmark
Os mesmos 5 prompts testados sem CLAUDE.md (linha de base) e com CLAUDE.md (otimizado):
- Explicar async/await: 180 palavras → 65 palavras (redução de 64%)
- Revisão de código: 120 palavras → 30 palavras (redução de 75%)
- O que é uma API REST: 110 palavras → 55 palavras (redução de 50%)
- Correção de alucinação: 55 palavras → 20 palavras (redução de 64%)
- Total: 465 palavras → 170 palavras (redução de 63%)
Aproximadamente 384 tokens de saída salvos por 4 prompts. Nota: Este é um indicador direcional de 5 prompts, não um estudo estatisticamente controlado.
Quando ajuda vs. quando não ajuda
Funciona melhor para:
- Pipelines de automação com alto volume de saída (bots de currículo, loops de agentes, geração de código)
- Tarefas estruturadas repetidas onde a verbosidade padrão do Claude se acumula em centenas de chamadas
- Equipes que precisam de um formato de saída consistente e analisável entre sessões
Não vale a pena para:
- Consultas únicas curtas (o arquivo carrega no contexto em cada mensagem, causando aumento líquido de tokens em trocas de baixa saída)
- Uso casual pontual (a sobrecarga não compensa em baixo volume)
- Corrigir modos de falha profundos como implementações alucinadas ou deriva arquitetural
- Pipelines usando múltiplas sessões novas por tarefa
- Confiabilidade do analisador em escala (use saídas estruturadas como modo JSON em vez disso)
- Trabalho exploratório ou arquitetural onde debate e alternativas são o objetivo
Considerações de custo
O próprio arquivo CLAUDE.md consome tokens de entrada em cada mensagem. A economia vem da redução dos tokens de saída. O benefício líquido é positivo apenas quando o volume de saída é alto o suficiente para compensar o custo persistente de entrada. Em baixo uso, custa mais do que economiza.
Suporte a modelos
Os benchmarks foram executados apenas no Claude. As regras são independentes do modelo e devem funcionar em qualquer modelo que leia contexto, mas os resultados em modelos locais como llama.cpp, Mistral ou outros não foram testados.
📖 Read the full source: HN AI Agents
👀 See Also

Ferramenta Monitor do Claude Code canaliza logs do servidor de desenvolvimento para correções automáticas orientadas por IA
A ferramenta Monitor do Claude Code permite executar um servidor de desenvolvimento em segundo plano, monitorar logs com filtros grep inteligentes e fazer com que o Claude detecte automaticamente erros, escreva correções e as envie — tudo enquanto você testa a interface.

Cérebro Aberto: servidor MCP de código aberto adiciona memória persistente com auto-grafo e busca semântica ao Claude
Open Brain é um servidor MCP de código aberto que dá ao Claude memória persistente entre sessões com extração automática de entidades, deduplicação semântica e criação automática de grafos de conexões entre pensamentos. Ele usa Supabase com pgvector e Deno Edge Functions, é auto-hospedável e inclui 16 ferramentas MCP para navegação em grafos, navegação de entidades e síntese de revisão semanal.

CC-Wiki: Transforme Sessões do Claude Code em uma Base de Conhecimento Quartz Compartilhável
O CC-Wiki converte seu histórico de sessões ~/.claude em uma base de conhecimento baseada em Quartz. Um comando instala; executar /cc-wiki dentro de uma sessão do Claude Code empacota a conversa.

Plugin de Excelência Criativa para Claude Code Melhora a Qualidade da Animação com Tese de Interação
Um novo plugin de código aberto para Claude Code aborda a geração de animações genéricas implementando uma abordagem de 'tese de interação' onde o Claude deve descrever conceitos de movimento antes de codificar. O plugin inclui 8 sub-habilidades que abrangem GSAP, Framer Motion, animações CSS e princípios de design de repositórios estudados.