Claude Code v2.1.299: 쉬고 있는 긴 대화를 캐시 만료 전에 미리 압축
무엇인가요
터미널에서 20만 토큰이 넘는 대화를 약 54분 동안 내버려 두면, 1시간짜리 프롬프트 캐시(같은 앞부분을 다시 계산하지 않게 저장해 두는 것)가 만료되기 전에 대화를 미리 압축해요. 기준 토큰 수는 CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS로 바꾸고 settings.json의 "idleCompaction": false로 끌 수 있어요. 새 환경 변수 CLAUDE_CODE_DISABLE_FILE_MENTIONS를 켜면 @로 언급한 파일은 내용 대신 경로만 넘어가요.
npm install -g @anthropic-ai/claude-code@2.1.299왜 중요한가요
점심 먹고 돌아와 긴 세션을 이어 갈 때 대화 전체를 다시 처리하는 비용이 크게 줄어요. 보안 쪽 수정도 함께 들어갔어요. mcp__a 허용 규칙이 이름이 비슷한 a__b 서버까지 허용하던 문제, macOS 샌드박스 거부 규칙이 심볼릭 링크로 우회되던 문제, 플랜 모드에서 PreToolUse 훅이 허용한 쓰기가 실행되던 문제가 고쳐졌어요.
완성도
GA 정식정식 릴리스예요. 유휴 압축은 터미널에서만 동작하고 관련 설정은 v2.1.290 이상에서 읽혀요.
앞으로 이렇게 지켜보세요
- 기본값 변화: 다음 릴리스 노트에서 유휴 압축 기준(20만 토큰·54분)이 바뀌는지 GitHub Releases를 구독해 봐요.
- 적용 범위: 데스크톱 앱·IDE 확장에도 유휴 압축이 들어오는지 Claude Code 문서 변경 내역에서 확인해요.
- 보안 수정: MCP 허용 규칙을 접두사로 넓게 써 왔다면 지금 설정을 다시 점검해요.