Claude Code 세션 자동 삭제 주의사항 및 설정 변경 방법

실용적 조언

Claude Code 설정에서 cleanupPeriodDays 값을 현재 작업 주기보다 훨씬 긴 값으로 변경하세요.
중요한 작업 세션은 30일 이내에 한 번씩 재개하거나 별도의 메모로 맥락을 백업해 두는 것이 안전합니다.

섹션별 상세

Claude Code의 세션 보관 기본값이 30일로 설정되어 있어 장기 프로젝트 중단 시 데이터 손실 위험이 있다. 작성자는 6주 전 중단했던 작업을 재개하기 위해 'claude -r' 명령어를 실행했으나 세션이 이미 삭제된 상태였다. 이는 도구 내부의 자동 정리 로직에 의해 발생하며, 사용자가 인지하지 못한 상태에서 작업 맥락이 사라지는 문제를 야기한다.

bash

claude -r

이전 세션을 재개하기 위해 사용하는 Claude Code 실행 명령어

세션 삭제 문제를 해결하기 위해 'cleanupPeriodDays' 설정 항목을 수정하는 방법이 제시됐다. 해당 설정값의 숫자를 충분히 크게 변경함으로써 시스템이 자동으로 세션을 삭제하는 주기를 연장하거나 사실상 무력화할 수 있다. 작성자는 이 값을 1,000,000일로 설정하여 향후 발생할 수 있는 의도치 않은 데이터 유실을 방지했다.

용어 해설

세션 유지(Session Persistence): — 사용자가 도구를 사용하는 동안 생성된 데이터나 상태가 특정 기간 동안 보존되는 속성이다. Claude Code와 같은 CLI 도구에서 이전 작업 맥락을 유지하여 연속적인 개발을 가능하게 하는 핵심적인 메커니즘이다.
CLI 설정(CLI Configuration): — 명령줄 인터페이스 도구의 동작 방식을 정의하는 설정 파일이나 옵션이다. 사용자는 이를 통해 도구의 기본 동작, 데이터 보관 주기, 네트워크 설정 등을 자신의 작업 환경에 맞게 최적화할 수 있다.

언급된 도구

Claude Code중립

Anthropic에서 제공하는 CLI 기반 AI 코딩 에이전트