Mac에서 Claude Code가 메모리나 CPU를 너무 많이 쓰나요? 찾아서 되찾는 방법

세션은 대화 전체, 읽은 모든 파일, 모든 명령의 출력을 계속 갖고 있습니다. 몇 시간이 지나면 이것이 쌓이며, Claude Code의 이슈 트래커에는 세션이 수 기가바이트에 이르렀거나 유휴 상태에서도 CPU 코어 하나를 계속 썼다는 보고가 있습니다. 보고들이 말하는 해결 방법은 같습니다. 세션을 종료하고 이어서 시작하는 것입니다. 대화는 진행하는 동안 저장되므로 claude --resume를 써도 잃는 것 없이 깨끗한 프로세스에서 시작합니다.

Claude Code는 다른 도구보다 최신 상태로 유지하는 것이 더 중요합니다. 새 버전이 자주 나오며, 메모리 문제도 버전 사이에 고쳐지는 것 중 하나입니다. claude update로 업데이트합니다.

세션이 끝나면 세션이 시작한 프로세스도 함께 끝나야 합니다. 하지만 항상 그렇지는 않습니다. MCP 서버, 하위 에이전트, 헤드리스 브라우저는 상위 프로세스를 잃고도 계속 실행되면서, 아무도 쓰지 않는 메모리를 붙잡고 있을 수 있습니다. 이에 대해 글을 쓴 한 개발자는 하루 작업 뒤 이런 프로세스 37개가 6GB 넘게 붙잡고 있는 것을 확인했습니다.

한번 살펴보면 쉽게 알아볼 수 있습니다. 터미널이 없고, 상위 프로세스가 1이며, 시작 시간이 몇 시간 전입니다. 종료해도 안전합니다. 엄밀히 말해 좀비 프로세스는 다른 것입니다. 이미 끝난 프로세스이며 메모리를 쓰지 않습니다. 여기서 사람들이 좀비라고 부르는 것은 살아서 메모리를 붙잡고 있는 고아 프로세스입니다.

Claude Code는 작업 결과를 확인하려고 개발 서버를 시작하거나, 테스트를 실행하거나, 프로젝트를 빌드합니다. 백그라운드에서 시작한 개발 서버는 작업이 끝난 뒤에도 계속 실행되고, 아무도 중단하지 않으면 세션을 닫은 뒤에도 실행됩니다. 프로젝트 두세 개에 각각 잊어버린 개발 서버가 있는 것은 메모리가 넉넉한 Mac에서 메모리가 부족해지는 흔한 이유입니다.

세션을 끝내기 전에 Claude Code에 시작한 것을 중단해 달라고 하거나, 어떤 포트가 수신 대기 중인지 확인하세요. 쓰지 않는 포트에 있는 서버는 아무도 쓰지 않는 서버입니다.

작업마다 또는 브랜치마다 하나씩 에이전트를 병렬로 실행하면 위의 모든 것이 그만큼 곱해집니다. 세션마다 자체 메모리, 모든 MCP 서버의 사본, 자체 개발 서버를 갖습니다. 16GB Mac에서는 이것이 여유 있는 상태와 메모리 압력이 노란색인 상태를 가릅니다. 끝난 세션은 닫고, 서버마다 다른 포트를 지정해 두 번째 서버가 조용히 실패하고 재시도하지 않게 하세요.