자리를 비운 사이 긴 세션을 압축하는 Claude Code — 전체 컨텍스트가 아닌 요약본으로 돌아옵니다 (2026)

Claude Code는 이미 컨텍스트 한계에 도달할 때 대화를 압축하여 작업을 계속할 수 있도록 이력을 요약하고 있었습니다. 이 작업은 사용자가 작업하는 동안 실행됩니다.

유휴 압축(Idle compaction)은 두 번째 트리거를 추가합니다. Anthropic의 설정 레퍼런스에서는 이를 다음과 같이 설명합니다: "유휴 압축은 사용자가 자리를 비운 긴 대화를 프롬프트 캐시가 만료되기 직전에 압축합니다." 이어서 다음과 같이 덧붙입니다: "그러면 다음 메시지는 전체 대화 대신 요약본을 전송합니다."

다시 돌아오면 대화창에 Compacted while idle, before the prompt cache expired라는 메시지가 표시됩니다.

Lydia Hallie의 발표에서 그 이유를 찾을 수 있습니다: "이제 프롬프트 캐시가 만료되기 직전(~1시간)에 긴 유휴 세션을 압축합니다." 나중에 돌아왔을 때 Claude는 전체 대화 대신 요약본만 다시 프로세싱하면 되므로 "사용량을 절약할 수 있다"고 설명합니다. 그녀는 같은 스레드에서 두 가지 제어 방법을 제시했습니다: settings.json에서 "idleCompaction": false로 설정하면 이 기능을 끌 수 있으며, CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS 환경 변수를 통해 사용자 정의 임계값을 설정할 수 있습니다.

공식 문서에는 다섯 가지 조건이 나열되어 있습니다. 이 조건이 모두 충족되어야 합니다.

• 세션(Session). 대화형 터미널 세션에 있어야 합니다.
• 프롬프트 캐시(Prompt cache). 대화가 1시간짜리 프롬프트 캐시 TTL을 사용 중이어야 합니다.
• 피처 플래그(Feature flags). Claude Code가 Anthropic으로부터 피처 플래그를 가져올 수 있어야 합니다.
• 크기(Size). 대화의 컨텍스트가 토큰 임계값(기본값 200,000)에 도달해야 합니다.
• 유휴 시간(Idle time). 마지막 요청 이후 약 54분이 경과해야 하며, 그 시점에 컴퓨터가 켜져 있는 상태(awake)여야 합니다.

이 중 두 가지 조건은 생각보다 대상 사용자의 범위를 좁힙니다.

1시간 캐시는 결제 방식에 따라 다릅니다. Anthropic의 프롬프트 캐싱 페이지에 따르면 "사용자가 직접 TTL을 선택하지 않는 한, Claude Code는 요금제에 포함된 사용량 범위 내의 Claude 구독에서만 1시간 TTL을 요청합니다." API 키나 클라우드 제공업체를 사용하는 경우, 메인 대화는 기본적으로 5분 캐시로 설정됩니다. 구독자가 요금제 사용량 제한을 초과하여 사용 크레딧을 쓰기 시작하면, Claude Code는 메인 대화의 TTL을 5분으로 낮춥니다. 따라서 기본적으로 유휴 압축은 주로 요금제 범위 내에서 작업하는 구독자에게 영향을 미칩니다.

기본 임계값은 주로 1M 토큰 세션에 해당합니다. 설정 레퍼런스에서는 "기본적으로 200K 컨텍스트 창에서의 대화는 200,000 토큰에 도달하기 전에 자동으로 압축됩니다"라고 명시하고 있습니다. 즉, 200K 창의 세션은 대개 유휴 압축이 적용되기 전에 일반적인 방식으로 자동 압축됩니다. 따라서 기본 설정에서 이 조건에 부합하는 세션은 대부분 100만(1M) 토큰 창으로 실행되는 세션입니다.

더 작은 세션에서 유휴 압축을 적용하려면 임계값을 낮출 수 있습니다. 문서에 따르면 "100000 미만의 값은 가장 낮은 임계값인 100000으로 상향 조정됩니다."

프롬프트 캐시는 매 요청마다 Claude Code가 대화의 변경되지 않은 접두사(prefix)를 다시 프로세싱하지 않도록 방지해주지만, 그 유지 시간은 제한적입니다. Anthropic 문서에서는 캐시가 만료되었을 때 어떤 일이 일어나는지 다음과 같이 설명합니다: "충분히 긴 공백이 생긴 후 다음 요청이 들어오면 전체 입력을 다시 계산하고 캐시를 재설정하므로, 자리를 비운 후 돌아와서 보내는 첫 번째 턴은 눈에 띄게 느려질 수 있습니다."

수십만 토큰 길이의 세션에서 돌아온 후의 첫 번째 요청은 비용이 많이 듭니다. 유휴 압축은 캐시가 아직 유효한(warm) 동안 대화 이력을 요약하므로, 다음 메시지는 전체 대신 요약본을 전달하게 됩니다.

Claude Code는 이미 재개된 세션에 대해 이와 유사한 선택지를 제공하고 있었습니다. Pro 또는 Max 요금제에서 약 1시간 이상 비활성 상태였고 100,000 토큰이 넘는 세션을 재개할 때, Claude Code는 요약본에서 재개할지 아니면 이전의 전체 세션 그대로 재개할지 묻는 대화 상자를 띄웁니다. 문서는 이 트레이드오프를 명확히 설명합니다: "있는 그대로 재개하면 대화의 모든 세부 정보를 유지할 수 있지만, 요청당 비용이 대화 크기에 비례하여 증가합니다." 요약본에서 재개하면 이후 요청 비용은 줄어들지만, "요약에서 누락된 내용은 더 이상 Claude의 컨텍스트에 존재하지 않게 됩니다."

유휴 압축은 열어둔 터미널 세션에 대해 이 저렴한 선택을 미리 내려놓는 것입니다. 문서는 사용자가 돌아왔을 때 보게 되는 알림과 동작을 변경하는 설정에 대해 설명하지만, 압축이 실행되기 전에 사용자에게 묻는 프롬프트에 대해서는 언급하지 않습니다. 다른 선택을 원한다면 미리 설정을 해두어야 합니다.

압축된 세션이 완전히 비어 있는 것은 아닙니다. Claude Code는 디스크에서 컨텍스트의 일부를 다시 빌드하며, Anthropic의 컨텍스트 창 문서에는 각 콘텐츠 유형별로 어떤 처리가 일어나는지 나열되어 있습니다.

디스크에서 재주입(Re-injected): 프로젝트 루트의 CLAUDE.md 및 범위가 지정되지 않은 규칙(unscoped rules), 자동 메모리(auto memory), 그리고 Claude가 계획 모드(plan mode)에서 작성한 계획.

필요 시 재로드(Reloaded on demand): paths: 프런트매터가 있는 규칙 및 하위 디렉터리의 중첩된 CLAUDE.md 파일. 이들은 즉시 복구되지 않고, Claude가 일치하는 파일을 터치할 때 다시 로드됩니다.

다시 읽기(Re-read): Claude가 읽거나 편집한 파일 중 가장 최근에 수정된 순서대로 최대 5개. "5,000 토큰이 넘는 파일은 내용 없이 경로 참조로만 복구되므로", 대용량 파일은 Claude가 내용을 사용하기 전에 다시 읽어야 합니다.

제한적으로 재주입(Re-injected with caps): 호출된 스킬 바디(skill bodies), 스킬당 최대 5,000 토큰 및 총 25,000 토큰 한도 내에서 가장 오래된 것부터 삭제됨.

요약됨(Summarized): 이전에 훅(hooks)이 추가한 컨텍스트를 포함하여 대화의 나머지 모든 내용.

마지막 카테고리에 리스크가 존재합니다. 채팅에서 언급한 제약 조건, 특정 접근 방식을 거부한 이유, 해결 중이던 정확한 에러 출력, 40분 전에 내린 결정 등은 모두 대화 속에만 존재합니다. 압축이 진행되면 이 정보들은 요약본에 캡처된 수준으로만 남게 됩니다. Claude Code 작동 방식에 대한 Anthropic의 개요에서도 일반적인 압축에 대해 동일하게 언급하고 있습니다: 사용자의 요청과 핵심 코드 스니펫은 보존되지만, "대화 초반의 상세한 지침은 유실될 수 있습니다."

경로 범위 규칙(Path-scoped rules)은 별도로 주의해야 합니다. 문서에 따르면 "경로 범위 규칙과 중첩된 CLAUDE.md 파일은 Claude가 트리거 파일을 읽고 쓰거나 편집할 때 메시지 이력에 로드되므로, 압축 시 다른 모든 내용과 함께 요약되어 사라집니다." 이 규칙들은 Claude가 다음에 일치하는 파일을 터치할 때 다시 돌아오지만, 그 전까지는 규칙이 아닌 요약본의 일부로 취급됩니다.

유휴 압축을 버그라고 생각하는 것. 이는 문서화된 기본 동작입니다. 설정 레퍼런스에 명시되어 있고, 릴리스 노트에서 발표되었으며, 훅 문서의 PreCompact 및 PostCompact 훅에 대한 auto 트리거에도 포함되어 있습니다.

요약본이 한 시간 전에 말한 내용을 그대로 유지할 것이라 믿는 것. 요약본은 요약 프로세스가 중요하다고 판단한 내용만 유지합니다. 프로젝트 루트의 CLAUDE.md, 범위가 지정되지 않은 규칙, 자동 메모리는 디스크에서 다시 가져오지만, 채팅에서만 언급된 내용은 유지되지 않을 수 있습니다.

자동 압축을 꺼도 유휴 압축은 켜져 있을 것이라 생각하는 것. DISABLE_AUTO_COMPACT 환경 변수는 두 기능 모두를 끄며, 문서에서는 "수동 /compact 명령은 여전히 사용할 수 있습니다"라고 덧붙이고 있습니다.

1단계: 이 작업에 유휴 압축을 실행할지 결정하기

유휴 압축은 대화의 정확한 어휘보다 긴 세션의 비용이 더 중요한 탐색적 작업에 적합한 기본 설정입니다. 반면, 세부 사항이 핵심인 디버깅 세션에는 적합하지 않습니다.

이 기능을 끄려면 설정 파일에서 "idleCompaction": false로 설정하세요. 이 키는 모든 설정 파일에 들어갈 수 있으므로, 특정 프로젝트의 설정에서만 끄고 다른 곳에서는 켜둘 수 있습니다. 이 키를 사용하려면 Claude Code v2.1.290 이상 버전이 필요합니다. "이 키를 무시하는 이전 버전에서는 autoCompactEnabled를 꺼서 유휴 압축을 중지하세요."

기능은 유지하되 적용 시점을 변경하려면 설정의 env 블록에 CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS를 설정하세요. 값을 높게 설정하면 가장 큰 세션에만 적용되도록 제한할 수 있습니다. 값을 100,000까지 낮추면 200K 창의 세션까지 적용 범위를 넓힐 수 있습니다.

단일 세션의 경우, DISABLE_AUTO_COMPACT를 사용하면 자동 압축과 함께 유휴 압축도 꺼집니다.

훅(hooks)을 사용하는 경우, auto 매처가 있는 PreCompact 훅은 유휴 압축 시에도 실행되며, 컨텍스트 한계 전에 트리거되는 압축에 대해서도 실행됩니다. 이를 차단하면 "Claude Code가 압축을 건너뛰고 대화가 압축되지 않은 상태로 계속됩니다." 동일한 매처가 일반 자동 압축도 처리하므로, 의존하기 전에 먼저 테스트해 보세요.

2단계: 자리를 비우기 전에 보존해야 할 내용을 압축 시 다시 읽는 위치에 두기

압축 과정에서 정보를 확실히 보존하는 가장 좋은 방법은 정보를 대화 외부로 빼두는 것입니다. Anthropic의 조언은 명확합니다: "대화 이력에 의존하기보다 영구적인 규칙은 CLAUDE.md에 작성하세요."

긴 세션 중에 휴식을 취하기 전에 2분만 투자하여 다음을 수행하세요:

• 상시 규칙을 프로젝트 루트의 CLAUDE.md로 이동합니다. 전체 작업에 적용되는 제약 조건은 여기에 두어야 합니다. 파일은 짧게 유지하세요. Anthropic의 메모리 가이드라인은 파일당 200행 미만을 목표로 할 것을 권장합니다.
• 세션의 결정 사항을 노트 파일에 기록합니다. 결정 사항당 한 줄씩 이유와 함께 기록하세요. Claude가 인지할 수 있도록 CLAUDE.md에서 해당 파일을 가리키도록 하세요.
• 원하는 방식으로 직접 압축합니다. 요약본을 직접 제어하고 싶다면 자리를 비우기 전에 /compact focus on the auth bug fix와 같이 초점을 지정하여 /compact를 실행하세요. 이 옵션에 대한 문서의 설명이 핵심을 짚고 있습니다: "자동 프로세스가 중요하다고 추측하는 대신 사용자가 선택한 내용이 요약본에 유지됩니다."

또한 Anthropic은 압축 시 보존할 내용을 제어하기 위해 CLAUDE.md에 'Compact Instructions' 섹션을 작성하는 방법을 문서로 제공하고 있으며, 이 글 상단에 링크된 자동 압축 가이드에서 작성 방법을 다루고 있습니다.

3단계: 유휴 알림이 표시되면 계속하기 전에 요약본 확인하기

Compacted while idle, before the prompt cache expired 메시지를 보고 복귀했을 때, 생각하던 흐름대로 바로 이어가지 마세요. 먼저 확인부터 해야 합니다.

• Claude에게 노트 파일을 다시 읽고 작업 상태를 재진술하도록 요청하세요. 목표가 무엇인지, 무엇이 결정되었고 배제되었는지, 다음 단계는 무엇인지 확인하고 2단계에서 작성한 노트와 비교해 보세요.
• 대화뿐만 아니라 파일에서도 누락된 내용을 복구하세요. 제약 조건이 보존되지 않았다면, 단순히 말로 다시 설명하는 데 그치지 않고 CLAUDE.md나 노트 파일에 추가하여 다음 압축 때 다시 누락되지 않도록 하세요. Claude Code가 수정한 내용을 잊어버리는 현상에 대한 가이드에서 이 패턴을 더 자세히 다룹니다.
• Claude가 대용량 파일을 다시 읽도록 하세요. 5,000 토큰이 넘는 파일은 내용이 아닌 참조로만 복구됩니다.
• 요약본의 사본을 보관하세요. PostCompact 훅은 생성된 요약본을 compact_summary 필드로 수신합니다. 이를 파일에 기록하면 Claude가 어떤 내용을 바탕으로 작업하고 있는지 정확히 확인할 수 있습니다.

캐시에 어떤 일이 일어났는지 확인하려면, 최근 버전의 /usage에 있는 Session 블록에 Prompt cache (main) 행이 포함되어 있습니다. 캐시가 유효한지(warm) 여부를 보고하고 압축을 예상된 재빌드로 카운트합니다.

2단계의 노트는 단일 압축이나 단일 세션을 넘어 보존할 가치가 있는 긴 세션의 결과물입니다. MemoryLake는 이러한 기록을 사용자가 관리하는 하나의 리스트로 유지하여 Claude Code 및 다른 어시스턴트에서 사용할 수 있도록 지원하는 메모리 레이어입니다.

기록은 사용자가 직접 자신의 언어로 작성합니다. Claude Code 세션, 트랜스크립트, 요약본, 자동 메모리 또는 기타 벤더의 저장소에서 데이터를 읽거나 쓰거나 삭제하지 않습니다. 리포지토리 외부에 프로젝트 세부 정보를 저장하기 전에 조직의 보안 정책을 확인하세요.

1단계: API 키 생성하기

로그인 후 대시보드에서 키를 생성합니다. 이 키는 MemoryLake 워크스페이스에 속하며 Anthropic 계정과는 별개입니다.

2단계: 첫 번째 메모리 업로드하기

두 번 설명하고 싶지 않은 결정 사항부터 시작해 보세요: 계속 누락되는 제약 조건, 배제한 접근 방식과 그 이유, 프로젝트가 의존하는 컨벤션 등입니다. 항목당 하나의 결정을 날짜와 함께 기록합니다.

3단계: AI 및 에이전트 연결하기

Claude Code 및 사용하는 다른 어시스턴트를 연결합니다. 그러면 이전 세션이 정상적으로 종료되었든, 자리를 비운 사이 압축되었든, 혹은 다른 도구에서 실행되었든 관계없이 동일한 결정 사항을 새 세션에서 바로 사용할 수 있습니다.

첫 번째 차이점은 비용입니다. 점심 식사 후 돌아온 긴 세션에서 첫 메시지를 보낼 때 전체를 다시 프로세싱할 필요가 없어집니다. 이것이 Anthropic이 이 기능을 만든 이유입니다.

두 번째는 대용량 세션을 열어두는 것이 더 이상 무해하지 않다는 점입니다. 조건이 충족되면 돌아왔을 때 요약본을 마주하게 됩니다. 많은 작업에서는 괜찮을 수 있지만, 어떤 작업에서는 Claude가 특정 수정안이 거부된 이유를 기억하느냐, 아니면 이를 다시 제안하느냐의 차이를 만들 수 있습니다.

세 번째는 파일의 중요성이 커진다는 점입니다. 압축 과정에서 디스크로부터 다시 읽어오는 내용은 온전히 복구되며, 노트 파일은 요청 한 번으로 불러올 수 있습니다. 반면 채팅에만 존재하던 내용은 요약본에 캡처된 수준으로만 복구됩니다. 이 규칙은 Claude Code가 프로젝트 컨텍스트를 잊어버리는 현상에 대한 가이드에서 다룬 것처럼 일반 압축 및 새 세션에도 이미 적용되던 사항입니다. 유휴 압축은 이를 휴식 시간에도 적용합니다.

네 번째는 습관의 변화입니다. 휴식 전에 결정 사항을 기록해 두는 습관은 유휴 압축, 일반 압축, 터미널 종료 모두로부터 정보를 보호해 줍니다. 이는 Claude Code 세션 간 컨텍스트 공유 가이드에서 다룬 개념과 일맥상통합니다.

1시간 캐시를 사용 중인지 확인하세요. API 키와 기본 설정을 사용하는 경우 메인 대화는 5분 캐시를 사용하므로 유휴 압축 조건이 충족되지 않습니다.

모든 곳이 아닌 프로젝트별로 기능을 끄세요. 디버깅이 많은 리포지토리에는 프로젝트 설정을 사용하고, 다른 곳은 기본값을 유지하세요.

휴식 전에 결정 사항을 기록하세요. 날짜가 적힌 노트 파일을 작성하는 데는 몇 분밖에 걸리지 않으며, 어떤 종류의 압축이 실행되더라도 디스크에 안전하게 유지됩니다.

유휴 알림이 뜨면 확인하세요. 작업을 계속하기 전에 작업 상태를 다시 진술하도록 요청하세요.

작업과 함께 노트 파일을 이동하세요. 다른 기기에서 작업을 이어가는 경우 파일도 함께 이동해야 합니다. 이에 대해서는 Claude Code 세션 내보내기 가이드에서 다루고 있습니다.

유휴 압축은 합리적인 트레이드오프이며, Anthropic은 이에 대해 투명하게 공개해 왔습니다. 1시간 캐시를 사용하는 세션이 약 54분 동안 유휴 상태로 방치되면 캐시가 만료되기 전에 요약되므로, 복귀 후 첫 메시지 비용이 저렴해집니다. 그 대가는 Claude가 전체 컨텍스트 대신 요약본을 바탕으로 대화를 이어간다는 점입니다.

이 기능을 끄거나, 임계값을 변경하거나, 그대로 유지할 수 있습니다. 기능을 유지하는 경우의 대처법은 이미 일반 압축에 적용되던 방식과 동일합니다: CLAUDE.md에 상시 규칙을 작성하고, 자리를 비우기 전에 파일에 결정 사항을 기록하며, 계속하기 전에 Claude가 무엇을 기억하고 있는지 확인하는 것입니다.

다른 도구들도 컨텍스트 제한과 관련하여 유사한 행보를 보이고 있습니다. 예를 들어 GPT-6.1 Sol을 위한 Codex의 더 큰 기본 창 등이 있습니다. 더 넓은 컨텍스트 창과 더 스마트한 압축 기술은 문제 발생 빈도를 줄여주지만, 영구적인 컨텍스트가 보존되어야 할 위치 자체를 바꾸지는 못합니다.