Correção de Vazamento de Memória do Claude Code para Homelabs Linux

Detalhes do Vazamento de Memória

Um desenvolvedor executando um homelab Proxmox com 64 núcleos e 503GB de RAM experimentou quedas repetidas ao usar o Claude Code para gerenciar VMs, GitLab, DNS e outros serviços. Apesar de atualizar para 500GB de RAM, o Claude Code consumiu 400GB e derrubou todo o sistema.

A análise do despejo de memória revelou:

• 1,15 bilhão de objetos idênticos de 160 bytes no heap
• Objetos nunca liberados (free=0)
• Taxa de crescimento de ~32.000 objetos por segundo durante uso ativo
• Uso em modo ocioso é normal

Descobertas Técnicas

A investigação descobriu:

• Claude Code é construído sobre o runtime Bun
• Usa dois alocadores: mimalloc + glibc malloc
• O vazamento está no lado do glibc malloc
• Correções no nível JavaScript não funcionam devido à camada do alocador
• Este tem sido um problema em aberto por meses com dezenas de relatórios no GitHub

Solução de Correção de Dois Níveis

O desenvolvedor criou uma solução apenas para Linux:

Nível 1 (limite de 10GB): Shim LD_PRELOAD que intercepta chamadas malloc(160) e limita o crescimento. Zero sobrecarga até que o limite seja atingido.

Nível 2 (limite de 20GB): Watchdog que reinicia a sessão se o Nível 1 não for suficiente, atuando como rede de segurança.

A correção está disponível em github.com/dalsoop/claude-code-memory-leak-fix.