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

Cloken: Uma Extensão do Chrome que Mostra o Uso de Contexto em Tempo Real do Claude como Porcentagem
Cloken é uma extensão gratuita do Chrome que exibe o uso do contexto do seu chat atual no Claude.ai como uma porcentagem — incluindo mensagens, arquivos, imagens e o prompt do sistema.

InsForge: Uma Camada Semântica de Backend para Agentes de Código Claude
O InsForge expõe seis primitivas de backend—autenticação, banco de dados Postgres, armazenamento compatível com S3, funções edge/serverless, gateway de modelos e implantação de sites—como componentes estruturados que os agentes Claude Code podem inspecionar e configurar via MCP, em vez de adivinhar integrações de API.

Claude Code como Compilador: Uma Reestruturação Prática para o Desenvolvimento de IA
Uma postagem no Reddit argumenta que o Claude Code funciona como um compilador que traduz inglês para software funcional, traçando paralelos com avanços históricos da computação como o A-0 de Grace Hopper e o FORTRAN. O autor descreve a geração de 400 linhas em 6 arquivos a partir de uma descrição em inglês de 3 parágrafos, identificando dois problemas em 25 minutos.

Clooks: Um Ambiente de Execução Persistente de Hooks para Claude Code
Clooks é um daemon HTTP persistente que gerencia o despacho de hooks do Claude Code sem gerar novos processos, reduzindo a latência de ~34,6ms para ~0,31ms por invocação. Inclui migração automática, manipuladores LLM com modelos de prompt, resolução de dependências e empacotamento de plugins.