리눅스 홈랩을 위한 Claude 코드 메모리 누수 수정

메모리 누수 세부 정보

64코어와 503GB RAM을 갖춘 Proxmox 홈랩을 운영하는 개발자가 Claude Code로 VM, GitLab, DNS 및 기타 서비스를 관리할 때 반복적인 시스템 다운을 경험했습니다. 500GB RAM으로 업그레이드했음에도 Claude Code가 400GB를 소비하며 전체 시스템을 다운시켰습니다.

메모리 덤프 분석 결과:

• 힙에 11억 5천만 개의 동일한 160바이트 객체 존재
• 객체가 절대 해제되지 않음 (free=0)
• 활성 사용 시 초당 약 32,000개 객체 증가율
• 유휴 상태 사용량은 정상

기술적 발견

조사 결과 밝혀진 내용:

• Claude Code는 Bun 런타임 기반
• 두 개의 할당자 사용: mimalloc + glibc malloc
• 누수는 glibc malloc 측에서 발생
• 할당자 계층 때문에 JavaScript 수준 수정이 작동하지 않음
• 이 문제는 수개월 동안 수십 건의 GitHub 보고서와 함께 오픈 이슈 상태

이중 계층 수정 솔루션

개발자가 Linux 전용 솔루션을 제작:

계층 1 (10GB 임계값): malloc(160) 호출을 가로채고 증가를 제한하는 LD_PRELOAD 심. 임계값 도달 전까지 오버헤드 없음.

계층 2 (20GB 임계값): 계층 1이 충분하지 않을 경우 세션을 재시작하는 안전망 역할의 워치독.

수정 사항은 github.com/dalsoop/claude-code-memory-leak-fix에서 확인할 수 있습니다.