클로드 코드 서브에이전트가 더 일찍 압축하게 하는 autoCompactWindow 설정법

클로드 코드 v2.1.296부터 서브에이전트 정의에 autoCompactWindow를 넣을 수 있다. 서브에이전트가 메인 대화보다 작은 창에서 먼저 자동 압축(auto-compact)하게 된다.

.claude/agents/ 아래 서브에이전트 파일의 프런트매터에 적는다.

---
name: explorer
description: 코드베이스를 훑어 관련 파일을 찾는다
autoCompactWindow: 200000
---

--agents로 넘기는 정의에도 같은 키를 쓴다.

메인 대화용 autoCompactWindow 설정과 CLAUDE_CODE_AUTO_COMPACT_WINDOW 환경변수는 토큰 수를 정수로 받고, 범위는 100000~1000000이다. 500k처럼 쓰면 500으로 읽혀 최솟값으로 잘린다. 서브에이전트 쪽 범위는 체인지로그에 따로 적혀 있지 않다.