Claude Code CLI의 11GB 메모리 점유 문제 해결을 위한 'memory-sentry' 스킬 공유

실용적 조언

Claude Code CLI에서 11.3GB에 달하는 고부하 메모리 사용 경고가 발생하며 시스템 전체 성능이 저하되는 현상이 보고됐다.

분석 결과 종료되지 않은 '유령(orphan)' VS Code Helper 프로세스들이 백그라운드에서 Node/Bun 힙 메모리를 지속적으로 점유하는 것이 원인으로 파악됐다.

sysctl 명령어로 macOS 메모리 압력을 감시하고 8시간 이상 활성화된 유령 프로세스를 찾아 강제 종료하는 'memory-sentry' 스킬이 해결책으로 제시됐다.

bash

npx skills add Mohammed21Sharraf/memory-sentry

memory-sentry 스킬을 Claude Code CLI에 추가하는 명령어

이 도구는 CLI가 충돌하기 전에 사용자에게 /compact 명령 실행을 권고하여 작업 흐름이 끊기지 않도록 돕는 기능을 포함한다.

힙 덤프(Heap Dump): — 프로그램이 특정 시점에 사용 중인 메모리(힙)의 전체 내용을 기록한 파일이다. 메모리 누수나 과도한 자원 점유의 원인을 분석하기 위해 객체 할당 상태를 확인하는 용도로 사용되며, 디버깅 시 핵심적인 근거가 된다.
고아 프로세스(Orphan Process): — 부모 프로세스가 먼저 종료되었음에도 불구하고 시스템에 남아 계속 실행 중인 프로세스이다. Claude Code CLI 환경에서는 VS Code Helper 프로세스가 이 상태로 남아 메모리를 지속적으로 낭비하는 원인이 된다.
메모리 압력(Memory Pressure): — 운영체제가 현재 가용 메모리 상태를 기반으로 판단하는 시스템의 메모리 부족 긴박도이다. 단순히 사용량 수치뿐만 아니라 스왑 발생 빈도 등을 종합하여 시스템 성능 저하 가능성을 나타내는 지표로 활용된다.

Claude Code CLI중립

AI 기반 코딩 에이전트 인터페이스

memory-sentry추천링크

유령 프로세스 정리 및 메모리 모니터링 스킬