클로드 코드는 자리를 비운 사이 큰 대화를 프롬프트 캐시가 만료되기 전에 스스로 압축하고 'Compacted while idle, before the prompt cache expired' 라는 안내를 남기는데, 이 동작은 릴리스 노트와 공식 문서에 없고 깃허브 이슈 제보자는 9월 30일 나온 v2.1.286 부터 겪었다고 적었어요. 저장소 관리자(앤트로픽 쪽 collaborator)는 같은 이슈에서 20만 토큰 이상 대화에만 적용된다고 답했고, 10월 5일 나온 v2.1.290 부터 settings.json 에 "idleCompaction": false 를 두면 끌 수 있으며 기록에 남는 압축 계기도 manual 에서 auto 로 고쳤다고 밝혔어요. 마지막 활동 뒤 약 54분에 1시간 캐시에서만 실행된다는 설명과 기준 토큰 수를 바꾸는 CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS 환경변수는 사용자가 실행 파일을 분석한 결과라 공식 확인은 아니고, 10월 10일 소개한 v2.1.296 의 autoCompactWindow 는 용량 기준 자동 압축이라 이 기능과는 다른 설정이에요.
- 프롬프트 캐시
- 같은 앞부분 입력을 저장해 두고 다시 보낼 때 싸고 빠르게 처리하는 기능
- 압축
- 긴 대화 기록을 요약으로 바꿔 문맥 크기를 줄이는 클로드 코드 동작
- PreCompact
- 압축 직전에 실행되는 클로드 코드 훅 이벤트
- CLAUDE.md
- 클로드 코드가 세션을 시작하거나 압축한 뒤 다시 읽는 프로젝트 지침 파일
여러 세션을 밤새 띄워 두고 이어 가는 방식이라면 v2.1.290 이상에서 "idleCompaction": false 를 넣어 쌓아 둔 지시와 결정이 요약으로 줄어드는 일을 막을 수 있어요. 비용을 아끼려고 켜 둔다면 압축 뒤에도 남아야 할 규칙은 대화가 아니라 CLAUDE.md 에 적어 두는 편이 안전하고, 이 압축이 PreCompact 훅을 부르는지는 문서에 없으니 훅에 기대고 있다면 직접 확인하세요.
- 기능 요청과 반대 의견 6월 7일 열린 '유휴 시간에 자동 압축' 기능 요청은 아직 열려 있고, 10월 10일에는 기본으로 켜 둔 탓에 중요한 작업 문맥이 지워진다며 선택해서 켜는 방식으로 바꿔 달라는 댓글이 달렸어요. GitHub (anthropics/claude-code)
- 캐시 수명 공식 문서 공식 문서는 구독 요금제의 기본 대화에 1시간 캐시를, 추가 사용량·API 키·클라우드 제공사에는 5분 캐시를 기본으로 쓴다고 적었어요. Claude Code Docs