공지: Claude Code는 기본적으로 30일 후 로컬 세션 기록을 삭제합니다
PSA: Claude Code deletes your local session history after 30 days by default
핵심 요약
Claude Code의 30일 자동 기록 삭제 설정을 우회하여 데이터를 영구 보존하는 방법을 공유합니다.
- 기록 삭제 설정 — 설정 파일에서 cleanupPeriodDays 값을 크게 수정하여 데이터 보존 가능함
- 데이터 백업 — 로컬 기록 삭제를 방지하기 위해 별도의 백업 프로세스나 문서화 작업이 권장됨
- 설정 주의사항 — 0으로 설정 시 유효성 검사 오류가 발생하므로 큰 숫자를 입력해야 함
- 삭제 범위 — 세션 기록뿐만 아니라 파일 히스토리와 서브 에이전트 기록까지 함께 삭제됨
공지: Claude Code가 30일 지나면 채팅 기록 다 날려버림
다들 주목해라. Claude Code는 기본 설정이 로컬 세션을 딱 30일까지만 보관하게 돼 있다. 나도 올해 초에 했던 작업 좀 보려고 들어갔더니 8월 이전 기록은 싹 다 증발했더라.
기록 보존하고 싶으면 ~/.claude/settings.json에 아래 내용 추가해라.
"cleanupPeriodDays": 36500
이게 100년 치니까 사실상 영구 보존이나 다름없다. 0으로 설정하는 건 비추한다. 이게 생각하는 대로 작동할지 확신이 안 서거든.
이미 기록 날아갔으면 다음 두 군데 확인해 봐라.
- ~/.claude/history.jsonl 여기엔 1월부터 내가 입력한 프롬프트는 다 남아있더라. Claude가 답변한 내용만 없을 뿐임.
- 타임머신(Time Machine) 백업. 물론 제대로 돌아가고 있었을 때 얘기지(난 안 돌아가고 있었음, 하하).


