Claude Code v2.1.299 — 방치된 200K 대화를 자동 요약하는 'idle compaction'이 왔습니다
AI

Claude Code v2.1.299 — 방치된 200K 대화를 자동 요약하는 'idle compaction'이 왔습니다

zaq · · 4 min read

1M 컨텍스트 시대의 비용 함정 — 방치된 대형 세션 — 이 드디어 해결됐습니다. v2.1.299의 idle compaction은 200K 토큰을 넘긴 대화가 약 54분간 방치되면, 1시간 프롬프트 캐시가 만료되기 전에 자동으로 요약해 다음 메시지가 전체를 다시 처리하지 않게 합니다.

한마디로 말하면, "캐시 만료 직전에 컴팩션"이라는 비용 절감 기능이 핵심이고, Mods 관리형 기능과 러너 종료 드레인이 함께 들어온 릴리스입니다.

idle compaction — 비용 관점의 타이밍 설계

동작은 정밀합니다. 200K+ 토큰 대화가 약 54분 방치되면 compaction이 실행되고, 이는 1시간 프롬프트 캐시 만료 직전이라 요약 자체가 캐시 요금을 치솟지 않게 됩니다. 다음 메시지는 compaction된 요약만 처리하면 되죠. 조정도 유연합니다 — CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS로 200K 최소치를 바꿀 수 있고, settings.json에서 "idleCompaction": false로 끌 수도 있습니다(290 이후 버전 필요). Opus 5.5·Sonnet 5.5·Haiku 5.5의 1M 컨텍스트 세대에서 이 기능은 "컨텍스트를 크게 쓰되 비용은 통제"하는 마지막 퍼즐입니다.

관리형 Mods 기능 강화 — 첨부 바이트와 세션 신원

관리 설정으로 설치된 mod의 기능이 확대됐습니다. **$.prompt.media**는 프롬프트에 첨부된 이미지·문서의 바이트를 prompt.submit 훅이 읽을 수 있게 하고, **$.session.identity()**는 세션이 어떻게 로그인됐는지, 관리 forceLoginOrgUUID가 지정한 조직 소속일 때 조직과 이메일을 반환합니다. 컴플라이언스 관점에서 "이 세션이 누구의 것인가"를 mod 차원에서 검증할 수 있게 된 것입니다. Text·Box 스타일링도 size, weight, mono, tabular와 xs~xl 간격 단계를 얻고 bold는 weight로 대체됩니다.

운영자 기능 — 러너 드레인과 에이전트 뷰

claude self-hosted-runner orchestrator에 **--shutdown-drain-sec**가 추가돼 SIGTERM 시 폴링을 멈추고 진행 중인 폴링과 spawn 훅에 지정한 초만큼 마무리 시간을 줍니다. 에이전트 뷰에서는 /effort와 /fast로 새 세션의 시작값을 정하고, 맨 커맨드는 피커를 열며, --safe-mode 백그라운드 세션은 peek 패널에 safe mode 표시가 붙습니다. claude plugin eval에는 --disallow-tools와 disallowed_tools 케이스 필드가 생겨 평가 실행에서 특정 내장 tool(예: Agent)을 뺄 수 있습니다.

실전에서 어떻게 쓸까?

1M 컨텍스트 모델로 장시간 대화를 돌리는 팀의 비용 최적화 체크리스트는: ① idle compaction 기본 활성화 상태 확인(290+ 필요), ② 대형 서브에이전트가 있다면 autoCompactWindow(296)와 함께 튜닝, ③ CLAUDE_CODE_OVERLOADED_RETRY_BASE/MAX_DELAY_MS(295·296)로 과부하 백오프 조절. 참고로 CLAUDE_CODE_DISABLE_FILE_MENTIONS로 @ 파일 언급 시 경로만 전달하고 내용은 file tools로 읽게 하는 옵션도 생겨, 프라이버시 민감 환경의 컨텍스트 통제가 늘었습니다. CLAUDE_CODE_ATTRIBUTION 스위치로 Desktop Code 탭의 어트리뷰션 블록도 끌 수 있습니다.

마무리로 — idle compaction은 화려하지 않지만 1M 컨텍스트 세대의 경제성을 실사용 가능하게 만든 조용한 필수 기능입니다. 컨텍스트를 크게 쓸수록 이 릴리스의 가치가 커집니다.

출처: https://github.com/anthropics/claude-code/releases/tag/v2.1.299

태그: AI Claude Claude Code 개발도구