Claude Code 세션 기록(~/.claude/projects) 지워도 될까?

무엇인가요

Claude Code가 프로젝트별로 저장하는 대화 기록(JSONL)과 파일 변경 체크포인트(file-history), 할 일 목록, 세션 환경 정보입니다. 지난 대화를 이어서 하거나 변경 사항을 되돌릴 때 이 데이터를 씁니다.

왜 이렇게 커지나요

세션마다 주고받은 메시지와 도구 실행 결과가 모두 기록되고, 파일을 수정할 때마다 되돌리기용 사본이 남습니다. 큰 파일을 읽거나 긴 작업을 자주 하면 프로젝트 하나에서도 기록이 빠르게 커집니다.

삭제해도 되나요?

캐시가 아니라 사용자 데이터라서 지우면 되돌릴 수 없습니다. 지운 세션은 더 이상 이어서 진행할 수 없고, 그 세션의 체크포인트로 되돌리는 것도 불가능해집니다. 한동안 열지 않은 오래된 세션만 정리하고, 진행 중인 세션은 건드리지 마세요. 정리 전에 claude 프로세스를 종료해 두는 것이 안전합니다.

팁

Claude Code는 settings.json의 cleanupPeriodDays 설정(기본 30일)에 따라 오래된 대화 기록을 스스로 정리합니다. 더 짧게, 또는 더 길게 보관하고 싶다면 이 값을 조정하세요.