Claude Code 유휴 압축은 캐시를 보존하지만 요약에서 다시 시작됩니다

Claude Code 유휴 압축은 이제 컨텍스트 창이 가득 차지 않았더라도 프롬프트 캐시가 만료되기 전에 대규모 세션을 요약할 수 있습니다. 이 기능은 기본적으로 최소 200,000개의 토큰을 포함한 세션을 대상으로 합니다. 핵심적인 상충 관계는 분명합니다. Claude는 더 저렴하고 짧은 컨텍스트로 돌아가지만, 모든 원래 대화 턴이 아닌 생성된 요약을 바탕으로 작업을 이어갑니다.

Anthropic 엔지니어 Lydia Hallie는 2026년 10월 유휴 압축 게시물에서 이 동작을 설명했습니다. 사용자는 Claude Code 설정 파일에 "idleCompaction": false를 추가해 기능을 비활성화할 수 있습니다. 또한 CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS를 사용해 최소 컨텍스트 임계값을 변경할 수 있습니다.

이 제어 기능은 개발자들이 장기 실행 세션에서 예상치 못한 압축을 보고한 뒤 도입됐습니다. 이들의 우려는 압축 기능 자체가 존재한다는 점이 아니었습니다. Claude Code는 이미 컨텍스트 한계에 가까워지면 대화를 요약했습니다. 쟁점은 유휴 타이머가 캐시 만료 후 재개 비용을 줄이기 위해 아직 사용할 수 있는 대화 기록을 대체해야 하는지였습니다.

Claude Code 유휴 압축이 세션 재개의 의미를 바꿉니다

재개된 세션은 정체성을 유지할 수 있지만, 그 정체성을 처음 형성한 원문 기록은 잃을 수 있습니다.

Claude Code는 세션 메시지를 로컬에 저장하며 --continue 또는 --resume으로 다시 열 수 있도록 지원합니다. 이러한 지속성은 세션을 영속적인 작업 공간처럼 느끼게 할 수 있습니다. 하지만 모델은 디스크에 저장된 모든 산출물이 아니라 현재 요청에 포함된 컨텍스트만을 바탕으로 추론합니다.

Anthropic의 컨텍스트 창 가이드는 활성 컨텍스트에 대화 기록, 파일 내용, 명령 출력, 프로젝트 지침, 메모리, 스킬, 시스템 지침이 포함된다고 설명합니다. 이러한 자료가 누적되면 Claude Code는 오래된 도구 출력을 지우고, 결국 대화를 요약합니다.

압축은 이전 대화 자료를 더 짧은 요약으로 대체하는 행위입니다. 세션은 계속 사용할 수 있고 Claude도 작업을 이어갈 수 있습니다. 그러나 모델은 대체된 각 대화 턴을 더 이상 원문 그대로 받지 못합니다.

새로운 유휴 경로는 이 대체가 일어날 수 있는 시점을 바꿉니다. 기존 자동 압축은 줄어드는 컨텍스트 예산에 반응합니다. 반면 유휴 압축은 세션이 충분히 큰 경우 비활성 상태와 프롬프트 캐시 타이밍에 반응합니다.

사용자들은 세션을 방치한 뒤 “Compacted while idle, before the prompt cache expired,”라는 메시지를 보고하기 시작했습니다. 보고에 따르면 이 배포는 Claude Code 2.1.286과 연관됐지만, 동작은 부분적으로 서버 측 게이트를 통해 제어됐습니다. 즉 특정 클라이언트 버전만 설치했다고 해서 전체 배포 상태가 반드시 드러나는 것은 아니었습니다.

Hallie가 언급했고 Anthropic의 공개 저장소에서 논의된 기본 최소값은 200,000토큰입니다. 이 수치는 자격 요건 임계값일 뿐, 대화가 정확히 200,000토큰에 도달하는 순간 압축이 일어난다는 보장은 아닙니다.

조건을 충족하는 세션에는 관련 캐시 조건과 충분한 유휴 시간도 필요합니다. 유휴 압축 이슈에서의 커뮤니티 조사에 따르면 타이머는 1시간 프롬프트 캐시 기간의 끝에 가까워졌습니다. 사용자들은 마지막 활동 후 약 54~56분 사이에 눈에 보이는 이벤트가 발생했다고 관찰했습니다.

이 타이밍 세부 사항은 이슈 참여자들이 클라이언트 동작을 살피고 로컬 테스트를 실행해 얻은 것입니다. Anthropic의 공개 Claude Code 문서는 처음에는 완전한 유휴 압축 사양을 제공하지 않았습니다. 따라서 독자는 세 가지 증거 수준을 구분해야 합니다. Anthropic의 압축 설명, 엔지니어의 발표, 그리고 구현 세부 사항에 관한 커뮤니티 분석입니다.

검증된 제품상 결과는 이 출처들 전반에서 분명합니다. 유휴 압축 후 Claude는 압축된 대화 상태에서 재개됩니다. 원본 기록은 여전히 로컬에 존재할 수 있지만, 그 전체 내용이 모델의 작업 컨텍스트에 자동으로 포함되지는 않습니다.

이 차이는 로컬 지속성과 모델의 주의가 서로 다른 문제를 해결하기 때문에 중요합니다. 저장된 기록은 감사와 복구를 지원합니다. 활성 컨텍스트는 Claude가 다음 응답에서 무엇을 고려할 수 있는지를 결정합니다.

이 기능은 캐시 효율성을 위해 컨텍스트 충실도를 희생합니다

유휴 압축은 반복적인 컨텍스트 처리 비용을 줄이기 위해 요약 손실을 감수하면서, 잠재적으로 콜드 상태가 될 재개 작업을 마지막 웜 캐시 구간으로 옮깁니다.

프롬프트 캐싱은 반복 요청이 일치하는 입력 접두사를 재사용할 수 있게 합니다. 캐시 적중은 일반적으로 캐시 항목 만료 후 동일한 대규모 접두사를 다시 구성하는 것보다 입력 처리량이 적습니다. 모든 턴에 이전 메시지, 도구 활동, 프로젝트 자료가 포함될 수 있으므로 장기 Claude Code 세션은 특히 큰 재사용 가능 접두사를 만듭니다.

Anthropic의 프롬프트 캐싱 문서는 캐시 수명과 캐시 쓰기 및 읽기의 서로 다른 처리 방식을 설명합니다. 콜드 상태가 된 긴 세션에서는 사용자가 돌아올 때 Claude Code가 상당한 접두사를 다시 처리해야 할 수 있습니다.

유휴 압축은 그 전에 개입하려 합니다. 큰 접두사가 캐시된 상태에서 Claude Code는 모델에 이를 요약하도록 요청할 수 있습니다. 이후 요청은 짧은 요약과 Claude Code가 복원하는 지침 또는 프로젝트 자료로 시작합니다.

이 메커니즘은 사용자가 휴식 후 대규모 세션을 재개하려 할 때 효율성을 높입니다. 사용자는 이전의 전체 컨텍스트가 아니라 처리에 필요한 토큰이 더 적은 압축된 표현으로 돌아오게 됩니다.

그 대가는 정보 충실도입니다. 요약은 선택된 사실과 결정을 보존하지만, 모든 제약 조건, 폐기된 선택지, 테스트 관찰, 대화 중 수정 사항을 정확하게 유지한다고 보장하지는 않습니다.

Anthropic은 컨텍스트 문서에서 이러한 일반적 한계를 인정합니다. 압축 중에는 요청과 핵심 코드 스니펫이 보존되지만, 이전 대화의 상세 지침은 손실될 수 있다고 설명합니다.

이 경고는 에이전트형 코딩 세션에서 더 중대한 의미를 갖습니다. 미묘한 지침 하나가 허용되는 마이그레이션 경로를 결정할 수 있습니다. 기각된 가설은 Claude가 비용이 큰 조사를 반복하지 않도록 막을 수 있습니다. 작은 테스트 이상 현상은 겉보기에 명백한 수정이 왜 안전하지 않은지 설명할 수 있습니다.

이런 세부 사항은 요약기에는 부차적으로 보일 수 있지만, 다음 코딩 단계에는 결정적일 수 있습니다. 요약은 프로젝트의 광범위한 목표를 정확히 설명하면서도 구현을 제한했던 근거는 누락할 수 있습니다.

위험은 길고 탐색적인 세션에서 커집니다. 개발자는 Claude에게 여러 모듈을 조사하고, 경쟁 설계를 비교하고, 테스트를 실행하고, 두 가지 접근법을 포기하도록 요청할 수 있습니다. 최종 방향은 명령 출력과 짧은 수정 사항 곳곳에 흩어진 부정적 결과에 의존할 수 있습니다.

압축 후 Claude는 하나의 접근법이 선택됐다는 점은 기억하더라도, 대안들이 실패한 모든 이유를 유지하지 못할 수 있습니다. 그러면 실제 조사와 다른 그럴듯한 설명을 재구성할 수 있습니다.

그렇다고 압축이 본질적으로 결함 있는 기능이라는 뜻은 아닙니다. 어떤 유한한 컨텍스트 관리 시스템도 무제한의 기록을 원문 그대로 보존할 수는 없습니다. 논쟁은 타이밍과 사용자 의도에 관한 것입니다.

하드 컨텍스트 한계에 가까워지면 요약은 세션이 멈추는 것을 방지합니다. 캐시 만료 전에는 세션에 여전히 상당한 컨텍스트 용량이 남아 있을 수 있는데도 제품이 효율성을 선택하는 것입니다.

이 이야기의 주된 대립축은 캐시 효율성과 컨텍스트 충실도입니다. Claude Code와 다른 코딩 도우미의 대결이 아닙니다. 모든 장기 실행 에이전트는 결국 유한한 컨텍스트를 관리해야 하지만, 유휴 트리거는 Anthropic이 선택한 균형을 유난히 뚜렷하게 드러냅니다.

개발자들이 자동 요약에 반대한 이유

반발의 핵심은 컨텍스트 압축 자체가 아니라, 사전 공지 없는 상태 변화였습니다.

개발자가 수동으로 /compact를 입력하면 Claude가 이전 대화를 요약한다는 점을 알고 있습니다. 이 명령에는 API 결정이나 해결되지 않은 테스트 실패를 보존하는 것과 같은 초점을 포함할 수 있습니다. 이 시점은 자연스러운 검토 경계를 만듭니다.

유휴 압축은 이러한 즉각적인 선택을 제거합니다. 사용자는 점심을 먹거나, 회의에 참석하거나, 외부 피드백을 기다린 뒤 활성 기록이 바뀐 세션으로 돌아올 수 있습니다.

원래 GitHub 보고서는 여러 작업 세션이 유휴 상태에서 압축됐다고 설명했습니다. 보고자는 요약에서 정확한 지침, 의사결정 근거, 이전에 합의된 방법이 누락됐다고 말했습니다. 다른 사용자들은 구성한 컨텍스트 임계값에 근접하지 않았는데도 동일한 알림을 봤다고 보고했습니다.

이는 요약 정확도에 대한 통제된 측정이 아닌 사용자 보고입니다. 그럼에도 Anthropic의 문서가 이미 압축 과정에서 초기 세부 사항이 손실될 수 있다고 밝히고 있으므로, 신뢰할 만한 제품 위험을 보여 줍니다.

초기 구현은 모니터링도 복잡하게 만들었습니다. 이슈에 기록된 테스트에 따르면, 초기 유휴 압축은 사용자가 /compact를 입력하지 않았음에도 훅 메타데이터에서 manual로 나타난 것으로 보입니다.

Claude Code 훅을 사용하면 팀은 정의된 이벤트 전후에 자동화를 실행할 수 있습니다. 오해를 부르는 트리거 라벨은 의도적인 사용자 작업과 타이머 기반 전환을 구분하기 어렵게 만듭니다.

저장소의 Anthropic 협력자에 따르면 Claude Code 2.1.290은 이 트리거를 auto로 변경했습니다. 이는 유휴 압축을 명시적으로 호출된 /compact와 구분하지만, 유휴 압축과 일반적인 임계값 기반 자동 압축을 완전히 구분하지는 못합니다.

이 모호성은 작업 상태를 보존하기 위해 훅을 사용하는 팀에 중요합니다. 훅은 긴급한 컨텍스트 한계 압축 전에는 한 정책을, 캐시 기반 유휴 압축 전에는 다른 정책을 원할 수 있습니다.

이슈 토론에서는 별도의 idle 트리거를 요청했습니다. 보고된 2.1.290 동작 기준으로 유휴 이벤트와 컨텍스트 임계값 이벤트는 모두 auto로 표시될 수 있었습니다. 터미널 알림은 사람에게 유휴 이벤트를 식별해 주었지만, 그 알림이 반드시 훅 입력에 포함되는 것은 아니었습니다.

더 넓은 제품 교훈은 보이지 않는 최적화에 관한 것입니다. 개발자들은 대개 의미를 바꾸지 않고 지연 시간이나 리소스 사용량만 바꾸는 최적화는 수용합니다. 요약은 다음 모델 요청이 다른 근거를 받게 하므로 의미를 바꿀 수 있습니다.

따라서 유휴 압축은 백그라운드 정리 작업보다는 자동 상태 마이그레이션에 더 가깝습니다. 세션 식별자는 안정적으로 유지되지만, 추론의 기반은 바뀝니다.

고위험 마이그레이션, 인시던트 대응 또는 장기간 코드 리뷰를 수행하는 팀은 이 전환을 신중하게 다룰 이유가 있습니다. 이들의 세션에는 각각은 작지만 전체적으로 중요한 제약 조건이 쌓이는 경우가 많습니다.

짧은 세션은 최소 임계값 아래에 머무르므로 노출이 적습니다. 이미 명시적인 인수인계를 중심으로 구축된 워크플로도 중요한 상태가 채팅 기록 외부에 존재하므로 비용을 줄입니다.

따라서 가장 큰 부담은 하나의 긴 Claude Code 세션을 영속적인 프로젝트 파트너로 여기는 개발자들에게 돌아갑니다. 이들은 연속성에서 가장 큰 이점을 얻지만, 의도적인 경계 없이 연속성이 요약 의존적으로 바뀔 때도 가장 큰 손실을 봅니다.

idleCompaction 설정은 서로 다른 두 가지 보호 장치를 분리합니다

사용자는 컨텍스트 한계에 가까운 세션을 보호하는 자동 압축을 비활성화하지 않고도 유휴 압축만 비활성화할 수 있습니다.

공개 이슈에서 답변한 Anthropic 협력자에 따르면 Claude Code 2.1.290은 전용 설정을 도입했습니다. 이후 한 사용자는 이 옵션이 버전 2.1.291에서 작동한다고 확인했습니다.

기본 구성은 다음과 같습니다:

Claude Code는 사용자, 프로젝트, 로컬 프로젝트, 관리형 정책 수준을 비롯한 여러 범위의 설정을 지원합니다. Anthropic의 settings reference에서는 설정 위치와 우선순위를 설명합니다.

사용자 전체에 적용되는 기본 설정은 개인 설정 파일에 둘 수 있습니다. 모든 구성원이 동일한 동작을 공유해야 하는 경우 리포지토리 팀은 프로젝트 설정을 버전 관리에 포함할 수 있습니다. 로컬 프로젝트 설정은 리포지토리의 공유 구성을 변경하지 않고도 동작을 재정의할 수 있습니다.

중요한 구분은 idleCompaction과 autoCompactEnabled 사이에 있습니다. 전자는 새로운 타이머 기반 경로를 대상으로 합니다. 후자는 더 광범위한 자동 압축 동작을 제어합니다.

"idleCompaction": false로 설정하면 2.1.290 버전에 설명된 동작을 기준으로 하는 일반적인 임계값 압축은 유지됩니다. 이는 컨텍스트 창이 거의 가득 찼을 때의 보호 기능은 원하지만, 휴식 시간 동안 캐시 기반 요약이 이루어지는 것은 원치 않는 개발자에게 유용합니다.

이러한 분리는 가장 강력한 사용자 요구에 직접적으로 답했습니다. 전용 스위치가 등장하기 전에는 자동 압축을 더 폭넓게 비활성화할 경우 세션이 컨텍스트 한계에 도달하지 않도록 방지하는 보호 장치까지 함께 제거될 수 있었습니다.

사용자는 이 키가 작동한다고 가정하기 전에 설치된 버전을 확인해야 합니다. 실행:

공개 이슈에서는 이 설정이 2.1.290에 포함되었다고 언급하며, 한 사용자는 2.1.291에서 이를 명시적으로 확인했습니다. 관리형 설치 환경을 사용하는 조직은 통제된 일정에 따라 업데이트를 받을 수도 있습니다.

기능의 서버 측 게이트는 주의가 필요한 또 다른 이유입니다. idleCompaction을 true로 설정한다고 해서 Anthropic이 모든 계정이나 환경에서 반드시 이 기능을 활성화하는 것은 아닙니다. 다른 자격 조건이 충족될 때 클라이언트 동작을 허용하는 설정입니다.

옵트아웃이 필요한 사용자에게는 이를 false로 설정하는 것이 관련 제어 수단입니다. 팀은 자체 설치 환경, 계정 유형 및 정책 계층에서 동작을 계속 테스트해야 합니다.

관리형 설정은 사용자 선택보다 우선할 수 있습니다. 이는 중앙 구성을 사용하는 조직에는 적절하지만, 로컬 파일 하나를 수정한다고 해서 기대한 결과가 나오지는 않을 수 있음을 뜻합니다.

가장 안전한 검증 방법은 실제 동작을 확인하는 것입니다. 클라이언트 버전을 확인하고, 유효 설정을 점검한 뒤, 중요한 작업 중 이 옵션에 의존하기 전에 중요하지 않은 세션에서 테스트하세요.

사용자는 대화 기록 외부에도 지속적인 지침을 보존해야 합니다. Anthropic은 Claude Code가 프로젝트 컨텍스트로 불러오는 CLAUDE.md에 영구 규칙을 배치할 것을 권장합니다. 일반적인 한계 근접 압축은 여전히 발생할 수 있으므로, 이 조언은 유휴 압축의 활성화 여부와 관계없이 적용됩니다.

검색 가능한 engineering knowledge base는 사람으로 구성된 팀에도 유사한 역할을 할 수 있습니다. 의사결정, 제약 조건, 조사 결과를 하나의 에이전트 세션에 전적으로 의존하는 대신 복구 가능한 산출물로 만들 수 있습니다.

200K 임계값은 조정할 수 있지만 컨텍스트 한계는 아닙니다

`CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS`는 세션이 유휴 압축 대상이 되는 시점을 변경할 뿐, 모델의 컨텍스트 창 크기를 변경하지는 않습니다.

Hallie에 따르면 최소값의 기본값은 200,000토큰입니다. 사용자는 Claude Code 설정의 환경 구성에서 다른 정수 값을 지정할 수 있습니다.

예를 들면:

이 예시는 대상 자격 임계값을 400,000토큰으로 올립니다. 더 큰 컨텍스트 창을 제공하거나, 대화 기록을 위해 400,000토큰을 예약하거나, 해당 시점에 즉시 압축이 실행되도록 보장하지는 않습니다.

공개 이슈 분석에서는 하한값이 100,000토큰이라고 보고했습니다. 이 하한보다 낮은 값은 100,000으로 상향 조정된다고 설명되었습니다. 논의가 진행될 당시 Anthropic은 공개 설정 참조 문서에서 이 환경 변수를 완전히 문서화하지 않았으므로, 사용자는 구현 세부 사항이 버전에 민감하다고 봐야 합니다.

임계값을 올리면 충실도를 우선하게 됩니다. 더 많은 대규모 세션이 요약되지 않은 채 유휴 상태로 유지될 수 있지만, 캐시가 만료된 후 돌아오면 더 많은 입력 처리가 필요할 수 있습니다.

임계값을 낮추면 캐시 효율성을 우선하게 됩니다. 더 많은 세션이 만료 전 압축 대상이 되므로, 사용자가 전체 대화 기록 대신 요약본으로 돌아올 가능성이 커집니다.

적절한 값은 단순히 모델 용량이 아니라 워크플로의 형태에 따라 달라집니다. 반복적인 도구 출력이 많은 긴 세션은 깔끔하게 요약될 수 있습니다. 반면 더 짧은 아키텍처 논의에는 압축하기 어려운 밀도 높고 상호 의존적인 결정이 담겨 있을 수 있습니다.

토큰 수는 크기를 측정할 뿐, 의미상의 중요도를 측정하지는 않습니다. 300,000토큰 규모의 디버깅 세션에는 폐기해도 되는 로그 줄 수천 개가 포함될 수 있습니다. 120,000토큰 규모의 보안 검토에는 원문 그대로 유지해야 하는 수많은 정확한 위협 가정이 포함될 수 있습니다.

이것이 구성 가능한 최소값이 핵심 긴장을 해결하지는 못하면서도 도움이 되는 이유입니다. 팀이 트레이드오프가 시작되는 지점을 선택할 수 있게 해주지만, 숫자 임계값만으로는 현재 대화를 안전하게 요약할 수 있는지 판단할 수 없습니다.

개발자는 세션을 떠나기 전에 명시적인 체크포인트를 만들어 위험을 줄일 수 있습니다. Claude에게 리포지토리 메모에 현재 목표, 확인된 발견 사항, 배제한 접근 방식, 변경된 파일, 테스트 상태 및 다음 명령을 기록하도록 요청하세요.

그 메모는 단순히 작업을 다시 서술해서는 안 됩니다. 전체 대화를 재구성하지 않고도 작업을 재개하는 데 필요한 근거를 담아야 합니다.

지속적인 제약 조건은 CLAUDE.md 또는 다른 권위 있는 프로젝트 파일에 두어야 합니다. 일시적인 발견 사항은 이슈, 작업 로그 또는 인수인계 문서에 두어야 합니다. 그러면 생성된 요약은 유일한 기록이 되지 않으면서 연속성을 뒷받침할 수 있습니다.

팀은 /context를 사용해 활성 창에서 무엇이 공간을 차지하는지도 살펴볼 수 있습니다. 방대한 명령 출력이 대부분을 차지한다면, 일반적인 요약이 중요 요소를 판단하도록 두는 것보다 해당 자료를 지우거나 재구성하는 편이 더 안전할 수 있습니다.

수동 /compact는 자연스러운 경계 지점에서 여전히 유용합니다. Anthropic은 사용자가 초점 지침을 추가할 수 있다고 설명하며, 이는 요약기에 방치된 유휴 이벤트보다 더 나은 보존 목표를 제공합니다.

더 큰 원칙은 간단합니다. 가능하면 작업 경계를 기준으로 압축을 선택하세요. 토큰 임계값은 실패를 막지만, 사람이 정의한 경계는 엔지니어링 작업의 구조를 더 잘 반영합니다.

Claude Code 압축이 보존하는 것과 보장할 수 없는 것

압축은 세션의 작업용 표현을 보존할 뿐, 추론 기록의 무손실 사본을 보존하지는 않습니다.

Anthropic의 Claude Platform 문서는 압축을 오래된 대화 턴을 모델이 작성한 요약으로 대체하는 것으로 정의합니다. compaction overview에서는 애플리케이션이 요약된 메시지가 있던 위치에 반환된 압축 블록을 배치하여 계속 진행한다고 설명합니다.

Claude Code는 제품 내부에서 이 워크플로를 처리합니다. 정확한 구현 방식은 Claude API를 직접 사용하는 애플리케이션과 다르지만, 개념적인 결과는 비슷합니다. 이전 입력은 생성된 텍스트로 표현됩니다.

좋은 요약은 사용자의 요청, 현재 구현 상태, 중요한 파일 경로, 테스트 결과 및 남은 작업을 유지할 수 있습니다. 이후 턴에 전송되는 이전 자료의 양을 크게 줄일 수도 있습니다.

그러나 모든 대화를 원문 그대로 보존한다고 보장할 수는 없습니다. 요약기는 정보를 선택하고, 구성하며, 더 작은 토큰 예산 안에서 표현해야 합니다.

추론 기록은 특히 어려운 과제를 제기합니다. 코딩 세션에는 흔히 배제의 연쇄가 포함됩니다. Claude는 한 파일을 검토하고, 가설을 세우고, 상충하는 출력을 확인한 뒤 방향을 바꿉니다.

최종 요약은 검증 과정을 압축하면서 수용된 설명만 기록할 수 있습니다. 이는 대체로 충분하지만, 다음 모델이 결론을 감사할 수 있는 능력은 약화됩니다.

도구 출력도 또 다른 문제를 만듭니다. 로그, 컴파일러 오류, 데이터베이스 계획, 테스트 추적에는 나중에야 중요성이 드러나는 작은 세부 정보가 포함될 수 있습니다. 그 후속 발견 이전에 생성된 요약은 어떤 줄이 중요해질지 알 수 없습니다.

사용자 수정 사항도 영향력이 약해질 수 있습니다. “스키마를 변경하지 마세요”라는 지침이 한 번만 등장하고 그 뒤로 수백 턴이 이어질 수 있습니다. 이것이 지속적인 지침으로 승격되지 않으면, 압축 과정에서 중요성이 낮아지거나 생략될 수 있습니다.

Claude Code 문서는 명시적으로 유지되어야 하는 규칙을 위해 CLAUDE.md를 권장합니다. 또한 압축 중 요약기에 무엇을 보존할지 알려주는 “Compact Instructions” 섹션도 지원합니다.

이러한 메커니즘은 위험을 줄이지만 요약을 무손실로 만들지는 않습니다. 압축 지침은 여전히 선택 작업을 수행하는 모델에 대한 안내입니다. 프로젝트 지침 파일은 Claude Code가 권위 있는 컨텍스트로 다시 불러올 수 있으므로 더 강력합니다.

따라서 개발자는 세션 지식을 세 가지 범주로 나누어야 합니다. 영구적인 운영 규칙은 프로젝트 지침에 속합니다. 검증된 엔지니어링 상태는 파일이나 추적되는 작업 기록에 속합니다. 대화형 탐색은 트랜스크립트에 남겨 두고 궁극적인 압축을 받아들일 수 있습니다.

이 접근 방식은 협업도 개선합니다. 다른 엔지니어는 개인 에이전트 대화에만 존재하는 문서화되지 않은 뉘앙스를 신뢰성 있게 이어받을 수 없습니다. 간결한 인수인계 파일은 사람과 에이전트 모두에게 공동의 복구 지점을 제공합니다.

실질적인 질문은 요약이 좋은지 나쁜지가 아닙니다. 특정 사실이 요약 안에만 존재해도 안전한지 여부입니다.

세부 정보를 잃으면 안전하지 않은 마이그레이션, 반복되는 사고 또는 잘못된 결과가 발생할 수 있다면, 세션을 떠나기 전에 대화 밖에 기록하세요.

유휴 압축이 신뢰를 얻는지 보여줄 세 가지 신호

다음 검증 과제는 Anthropic이 세션 연속성을 예측 불가능하게 만들지 않으면서 효율성 이점을 관찰 가능하게 만들 수 있는지입니다.

첫 번째 신호는 공식 문서입니다. 사용자는 자격 조건, 시점, 지원 버전, 임계값 제한, 설정 우선순위 및 프롬프트 캐시 정책과의 상호작용에 관한 안정적인 설명을 필요로 합니다.

문서는 200,000토큰 기본값이 모델과 계정 전반에 걸쳐 일관되게 적용되는지도 명확히 할 것입니다. Anthropic이 환경 변수와 하한값을 문서화한다면, 팀은 이슈 추적에 의존하지 않고 이를 구성할 수 있습니다.

그러한 결과는 기능에 대한 신뢰를 높일 것입니다. 문서화되지 않은 제어 항목은 명확한 마이그레이션 경로 없이 바뀔 수 있으므로, 소셜 게시물과 바이너리 분석에 계속 의존하게 된다면 신뢰는 약화될 것입니다.

두 번째 신호는 구별되는 훅 메타데이터입니다. 전용 idle 트리거를 사용하면 팀은 타이머 기반 압축을 수동 /compact 명령 및 한계 근접 자동 압축과 다르게 처리할 수 있습니다.

조직은 유휴 이벤트 전에 상태를 스냅샷으로 저장하고, 맞춤형 압축 지침을 첨부하거나, 기능이 활성화되는 빈도에 관한 텔레메트리를 기록할 수 있습니다. 명확한 이벤트 식별 정보는 사고 조사도 더 쉽게 만듭니다.

Anthropic이 두 자동 경로를 같은 auto 라벨 아래에 유지한다면, 관리자는 세션이 변경된 이유를 파악할 수 있는 가시성이 제한될 것입니다. 이는 터미널 경험과 자동화 인터페이스 사이의 간극을 유지하게 됩니다.

세 번째 신호는 긴 코딩 세션에서 요약 품질에 관한 증거입니다. 사용자 보고서는 누락된 뉘앙스를 지적하지만, 공개 논의는 일반적인 실패율을 확립하지 못합니다.

유용한 평가는 요약이 명시적 제약 조건, 배제된 가설, 보류 작업, 테스트 실패, 파일 참조 및 안전 규칙을 유지하는지 측정할 것입니다. 또한 하나의 압축된 상태가 다음 상태의 입력이 되면 오류가 누적될 수 있으므로 반복 압축도 테스트해야 합니다.

긍정적인 결과는 Anthropic의 효율성 주장을 뒷받침할 것입니다. 대부분의 적격 세션이 캐시 만료 전에 자동 압축을 정당화할 만큼 충분히 정확하게 재개된다는 점을 보여줄 것입니다.

부정적인 결과는 옵트인 동작이나 더 높은 기본 임계값의 필요성을 강화할 것입니다. 또한 Claude Code가 최근 턴은 원문 그대로 유지하면서 오래된 자료를 요약하는 부분 압축으로 나아가도록 만들 수 있습니다.

현재로서는 개발자에게 실용적인 선택지가 있습니다. 재개 오버헤드를 줄이는 일이 원문 그대로의 연속성보다 중요하다면 Claude Code 유휴 압축을 활성화한 상태로 유지하세요. 아주 큰 세션에서만 그 절충이 정당화된다면 토큰 임계값을 높이세요.

일시 중지된 세션이 기존의 활성 히스토리를 온전히 유지한 채 돌아와야 한다면 "idleCompaction": false로 비활성화하세요. 별도의 안전장치로 일반 컨텍스트 한도 압축은 계속 활성화해 둘 수 있습니다.

어떤 정책을 선택하든, 긴 대화 하나만을 핵심 엔지니어링 상태의 유일한 기록으로 삼지는 마세요. 지속되어야 할 제약 조건은 프로젝트 지침에 명시하고, 검증된 결과는 파일에 보존하며, 자리를 비우기 전에 인수인계 자료를 만드세요.

Claude Code 유휴 압축은 코딩 에이전트에 관한 한 가지 기본적인 사실을 드러냅니다. 세션 연속성은 완벽한 기억과 같지 않습니다. 다음에 긴 휴식을 취하기 전에, 워크플로에 실제로 필요한 것이 무엇인지 결정하세요.