클로드 코드 자동 압축 창을 200k·1M 단위로 지정하는 환경변수 설정법

클로드 코드(Claude Code)는 대화가 자동 압축 창(auto-compact window)만큼 차면 앞의 대화를 요약해 줄인다. 10월 19일 나온 2.1.304부터는 CLAUDE_CODE_AUTO_COMPACT_WINDOW 환경변수에도 k(천)와 M(백만) 단위를 쓸 수 있다. 이전 버전에서 200k라고 쓰면 경고 하나 없이 최솟값 100K 창으로 돌았다.

export CLAUDE_CODE_AUTO_COMPACT_WINDOW=200k

범위는 100000~1000000 토큰이다. 모델의 컨텍스트 창보다 크게 잡으면 컨텍스트 창 크기에서 멈추고, 범위를 벗어나거나 읽을 수 없는 값을 넣으면 이제 경고가 뜬다.

단위 없는 숫자는 토큰 수로 읽는다. /autocompact 200은 20만 토큰이고, CLAUDE_CODE_AUTO_COMPACT_WINDOW=200은 200토큰으로 읽혀 최솟값 100K로 잘린다.

환경변수는 /autocompact 명령, --autocompact 플래그, 설정 파일의 autoCompactWindow보다 먼저 적용된다. 이 변수를 쓰는 동안 상태 줄의 used_percentage는 모델 전체 창을 기준으로 재므로 압축 시점과 맞지 않는다. 스크립트나 클라우드 환경이 아니면 모델별로 저장되는 명령이 편하다.

/autocompact 500k