O Vazamento do Código Claude Revelou o Que Eu Estava Configurando Errado

Lucas Moraes (CEO Toolzz AI)
6 de abril de 2026

Recentemente, o código-fonte completo do Claude foi vazado, incluindo o módulo Coordinator, o sistema de memória, o carregador de habilidades e o motor de hooks. Após analisar o código, ficou claro que muitas das abordagens comuns para configurar e utilizar o Claude estão subótimas, deixando grande parte do seu potencial inexplorado.

A Falha na Configuração Comum

Grande parte dos usuários do Claude, incluindo eu, estávamos configurando o sistema de forma inadequada. Não se tratava de um erro grave, mas sim de uma subutilização das capacidades da ferramenta. O código revelou um sistema de compactação multiestágios que a maioria dos usuários nunca ativa, um ranqueador de memória semântica que consulta o Sonnet para selecionar as memórias relevantes e um motor de hooks que funciona mesmo no modo YOLO. Além disso, o sistema de descoberta de habilidades raramente é ativado devido à falta de metadados adequados.

Quer otimizar a performance do seu Claude? Conheça a Toolzz AI e descubra como implementar as melhores práticas de configuração.

1. Pare de Colocar Regras no CLAUDE.md. Use Hooks.

Uma das descobertas mais impactantes foi a compreensão de como o CLAUDE.md realmente funciona. Ao contrário do que muitos pensam, o CLAUDE.md é probabilístico. As instruções inseridas no arquivo competem por espaço na janela de atenção com as instruções do sistema, que já incluem diversas regras de segurança, formatação e protocolos. Quanto mais instruções você adiciona, menor a probabilidade de cada regra individual ser seguida consistentemente.

Os hooks, por outro lado, são determinísticos. Um hook PreToolUse que bloqueia o comando rm -rf sempre o bloqueará, independentemente do modo de execução ou se o modelo “esqueceu” a regra. A distinção é intencional, com o sistema de hooks interno possuindo um registro assíncrono completo, proteção contra timeout e execução ordenada. Não é um recurso secundário, mas sim a camada primária de aplicação para qualquer coisa que precise sempre acontecer.

A regra: Se algo deve sempre acontecer, implemente como um hook. Se algo deve geralmente acontecer, coloque no CLAUDE.md.

Exemplos de regras que devem ser movidas para hooks:

• Formatação de código: Um hook PostToolUse que executa o Prettier ou Black após cada edição garante a formatação consistente do código.

  { "hooks": { "PostToolUse": [ { "matcher": "Edit|Write", "hooks": [{ "type": "command", "command": "npx prettier --write "$FILE_PATH"" }] } ] } }

• Bloqueio de comandos perigosos: Um hook PreToolUse com código de saída 2 bloqueia a execução antes que ela comece.

• Execução de testes: Um hook PostToolUse que executa os testes relevantes após mudanças em arquivos.

• Verificações de qualidade: Integrei um script de detecção de IA para marcar frases e trechos gerados por IA em cada escrita. A detecção é feita com mais de 70 frases e a flag é disparada se alguma for encontrada. Esta verificação nunca funcionaria no CLAUDE.md.

Ao mover essas regras para hooks, reduzi meu arquivo de instruções de mais de 200 linhas para menos de 80, garantindo que as regras transferidas fossem sempre seguidas.

2. A Taxonomia da Memória

O código-fonte do Claude revela uma estrutura rígida para a categorização da memória em quatro tipos: usuário, feedback, projeto e referência. Qualquer informação que possa ser derivada do código é explicitamente excluída, pois é considerada descartável e obsoleta em poucos dias. Salvar anotações da arquitetura ou caminhos de arquivos é um desperdício de tokens. A organização adequada da memória, seguindo essa taxonomia, otimiza o desempenho e a relevância das informações recuperadas.

3. CLAUDE.md como um Orçamento

É crucial mudar a forma como vemos o CLAUDE.md. Ele não é um documento ou um README, mas sim um orçamento limitado de cerca de 100 restrições prescritivas. Auditoriei cada linha do meu CLAUDE.md e cortei 60% do conteúdo desnecessário, otimizando o uso do espaço disponível.

4. Metadados de Habilidade

Apenas os campos de metadados são expostos ao modelo para descoberta de habilidades. O conteúdo do corpo só entra em contexto quando a habilidade é invocada. Minhas habilidades tinham nomes vagos e faltava o campo when_to_use, o que impedia a invocação automática. Essas habilidades estavam adormecidas, ocupando espaço sem serem utilizadas.

5. Economia de Contexto

Cada servidor MCP injeta definições de ferramentas no seu contexto, consumindo tokens valiosos. Algumas dessas definições podem custar mais de 15.000 tokens cada. Conectar cinco servidores pode esgotar 60.000 tokens antes mesmo de você digitar sua primeira mensagem. O código vazado inclui um sistema de compactação multiestágios para gerenciar esse consumo, mas a maioria dos usuários nunca o ativa deliberadamente.

O Poder da Toolzz AI

Implementar essas mudanças pode parecer complexo, mas ferramentas como a Toolzz AI simplificam o processo. Com a Toolzz AI, você pode criar agentes personalizados com hooks e metadados otimizados, aproveitando ao máximo o poder do Claude e de outros modelos de linguagem. A plataforma da Toolzz oferece uma interface intuitiva para gerenciar a memória, definir habilidades e monitorar o uso de contexto, garantindo que seus agentes de IA sejam eficientes e eficazes. Além disso, a Toolzz AI oferece integração com diversas ferramentas e APIs, permitindo que você crie fluxos de trabalho automatizados e personalizados.

Ao adotar uma abordagem mais estratégica para a configuração do Claude, você pode desbloquear todo o seu potencial e obter resultados significativamente melhores. A Toolzz AI é sua aliada nessa jornada, oferecendo as ferramentas e o suporte necessários para criar agentes de IA de alto desempenho. Se você busca uma solução completa para gerenciar seus agentes de IA, verifique os planos da Toolzz AI e encontre o plano ideal para sua empresa.