클로드 코드 자리 비운 사이 자동 압축을 끄거나 기준을 바꾸는 설정법

클로드 코드(Claude Code) 2.1.299 체인지로그에 실린 기능이다. 터미널에서 긴 대화를 열어 둔 채 자리를 비우면, 1시간짜리 프롬프트 캐시가 만료되기 직전에 클로드 코드가 대화를 미리 압축한다. 돌아와서 보내는 다음 메시지에는 대화 전체 대신 요약이 실려서, 캐시가 끝난 대화를 처음부터 다시 처리하는 비용이 들지 않는다. 압축된 대화에는 Compacted while idle, before the prompt cache expired가 뜬다.

아래 조건을 모두 채우면 기본으로 켜진다.

• 터미널 대화형 세션
• 1시간 프롬프트 캐시를 쓰는 대화
• 앤트로픽에서 기능 플래그를 받아 올 수 있는 환경
• 컨텍스트 20만 토큰 이상
• 마지막 요청 뒤 약 54분이 지났고, 그 시점에 컴퓨터가 깨어 있음

기준 토큰 수는 환경변수로 바꾼다. 10만보다 작게 넣으면 10만으로 올라간다.

export CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS=150000

요약 말고 대화 원문을 그대로 이어 가려면 settings.json에서 끈다.

{
  "idleCompaction": false
}

설정 키와 환경변수는 v2.1.290 이상에서 먹는다. DISABLE_AUTO_COMPACT를 켜 두면 자동 압축과 함께 이 기능도 꺼진다. 압축한 뒤에는 앞선 대화의 세부 내용이 요약으로만 남는다.