AI 요약
Claude Code 사용 중 과거 작업 세션이 사라지는 현상은 기본적으로 설정된 30일의 로컬 데이터 보존 기간 때문입니다. 2026년 1월 21일에 공개된 분석에 따르면, Claude Code의 데이터 보관은 Anthropic 서버 측과 사용자 로컬 기기 측으로 이원화되어 관리됩니다. 서버 측 데이터는 요금제와 모델 개선 동의 여부에 따라 최소 30일에서 최대 5년까지 보관되지만, 로컬 세션은 사용자가 직접 설정값을 변경하여 보관 기간을 제어할 수 있습니다. 사용자는 로컬 설정 파일인 settings.json을 수정함으로써 세션 삭제 주기를 9999일로 늘려 사실상 반영구적인 지식 축적과 프로젝트 복기 기능을 활용할 수 있게 됩니다. 이는 작업 흐름의 단절을 막고 과거의 조사 기록을 자산화하려는 개발자들에게 유용한 기술적 조치입니다.
핵심 인사이트
- 기본 보존 기간: Claude Code의 로컬 세션은 기본적으로 30일간 비활동 상태일 경우 실행 시 자동으로 삭제됨.
- 설정값 변경:
cleanupPeriodDays값을9999로 설정하면 약 27년 동안 세션 데이터를 유지할 수 있음. - 날짜 정보: 해당 가이드는 2026년 1월 21일 기준으로 작성되었으며, 최신 버전의 Claude Code 작동 방식을 반영함.
- 서버 측 정책: Anthropic 서버의 보관 기간은 Free/Pro 플랜의 경우 모델 개선 동의 시 5년, 미동의 시 및 Team/Enterprise 플랜은 30일로 규정됨.
주요 디테일
- 설정 파일 경로: 사용자 홈 디렉터리의
~/.claude/settings.json또는 프로젝트별.claude/settings.json에서 설정 가능. - JSON 설정 코드:
{ "cleanupPeriodDays": 9999 }형식을 통해 간단히 적용 가능함. - 값의 의미:
30은 기본값,9999는 실질적 무기한 보존,0은 실행 시마다 모든 세션을 삭제하는 초기화 모드를 의미함. - 데이터 관리 주의점: 세션 장기 보존 시 로컬 디스크 용량을 점유하게 되며, 세션 목록(List)이 지나치게 길어질 수 있는 부작용이 있음.
- ZDR 정책: API 사용 시 Zero Data Retention(ZDR)을 설정하면 서버 측에는 데이터가 전혀 저장되지 않음.
향후 전망
- AI 코딩 어시스턴트가 단순 도구를 넘어 개인화된 지식 베이스(Knowledge Base) 역할을 수행함에 따라 세션 관리의 중요성이 더욱 커질 것으로 보임.
- 향후 Anthropic이 로컬 설정 변경 없이도 CLI나 GUI 상에서 직관적으로 보존 기간을 관리할 수 있는 옵션을 추가할 가능성이 높음.
출처:note.com