Correction de la fuite mémoire de Claude Code pour les homelabs Linux

Détails de la fuite de mémoire

Un développeur utilisant un homelab Proxmox avec 64 cœurs et 503 Go de RAM a subi des plantages répétés en utilisant Claude Code pour gérer des machines virtuelles, GitLab, DNS et d'autres services. Malgré une mise à niveau à 500 Go de RAM, Claude Code a consommé 400 Go et fait planter tout le système.

L'analyse du dump mémoire a révélé :

• 1,15 milliard d'objets identiques de 160 octets dans le tas
• Les objets ne sont jamais libérés (free=0)
• Taux de croissance d'environ 32 000 objets par seconde pendant une utilisation active
• L'utilisation au repos est normale

Découvertes techniques

L'enquête a mis en lumière :

• Claude Code est construit sur le runtime Bun
• Utilise deux allocateurs : mimalloc + glibc malloc
• La fuite se situe du côté de glibc malloc
• Les correctifs au niveau JavaScript ne fonctionnent pas à cause de la couche d'allocateur
• Ce problème est ouvert depuis des mois avec des dizaines de rapports sur GitHub

Solution de correctif à deux niveaux

Le développeur a créé une solution uniquement pour Linux :

Niveau 1 (seuil de 10 Go) : Shim LD_PRELOAD qui intercepte les appels malloc(160) et limite la croissance. Aucune surcharge jusqu'à ce que le seuil soit atteint.

Niveau 2 (seuil de 20 Go) : Watchdog qui redémarre la session si le Niveau 1 n'est pas suffisant, agissant comme un filet de sécurité.

Le correctif est disponible sur github.com/dalsoop/claude-code-memory-leak-fix.