긴 문서를 읽는 서브에이전트만 일찍 압축하는 법

정의 파일 한 줄로 일찍 압축한다

자동 압축은 대화가 길어지면 앞부분을 요약으로 바꿔 자리를 비우는 일입니다. 서브에이전트 정의 파일에 autoCompactWindow를 적으면 그 서브에이전트만 압축 기준이 바뀝니다. 정의 파일 맨 위 --- 사이(frontmatter)에 토큰 수로 적습니다. 메인 세션의 압축 기준은 그대로입니다.

1---
2name: doc-reader
3description: 긴 문서를 처음부터 끝까지 읽고 답한다
4tools: Read
5model: haiku
6autoCompactWindow: 100000
7---
8맡은 파일을 청크마다 빠짐없이 읽은 뒤에 답한다.

압축은 창이 다 차기 전에 걸려서, 100000으로 두면 대화가 6만~7만 토큰대에 이를 때마다 압축합니다. 아래 비용에는 압축 요약을 만드는 호출도 들어 있습니다.

압축은 앞에서 읽은 내용을 요약으로 바꿉니다. 처음 읽은 부분의 원문 문장이 끝까지 필요한 일이라면 창을 낮추기보다 파일이나 폴더를 나눠 서브에이전트 여럿에 맡깁니다.

1[WARN] Agent file <프로젝트>/.claude/agents/doc-reader.md has invalid autoCompactWindow '50000'. Must be an integer from 100000 to 1000000.

1{
2  "doc-reader": {
3    "description": "긴 문서를 처음부터 끝까지 읽고 답한다",
4    "prompt": "맡은 파일을 청크마다 빠짐없이 읽은 뒤에 답한다.",
5    "tools": ["Read"],
6    "model": "haiku",
7    "autoCompactWindow": 100000
8  }
9}

1f=$(ls -t ~/.claude/projects/*/*/subagents/agent-*.jsonl | head -1)
2jq -s -c '{compactions: map(select(.subtype=="compact_boundary")) | length,
3  max_prompt: [.[].message.usage? // empty | .input_tokens
4    + .cache_read_input_tokens + .cache_creation_input_tokens] | max}' "$f"

서브에이전트는 압축 기준을 물려받는다

Claude Code는 요청마다 그때까지의 대화를 통째로 다시 보내므로, 서브에이전트가 읽은 만큼 프롬프트가 자랍니다. 서브에이전트도 제 대화를 따로 압축하지만, 압축이 걸리는 크기는 메인 세션 것을 물려받습니다. 이 크기가 자동 압축 창입니다.

Haiku처럼 1M 창을 쓰는 모델은 대화가 약 967K에 이르러서야 압축합니다. 그런데 프롬프트가 100K를 넘는 요청에는 다섯 배 단가가 붙습니다. 캐시로 싸게 읽은 앞부분도 예외가 아닙니다. 압축이 걸리기 한참 전에 비싼 요청이 시작됩니다.