테마
컨텍스트 관리 전략
컨텍스트란?
컨텍스트(Context)는 AI가 작업을 위해 참조하는 정보의 총량이다. Claude Code는 현재 약 200K 토큰의 컨텍스트 한도를 가지고 있다.
Auto Compact의 문제점
컨텍스트가 약 80% 차면 Auto Compact가 자동으로 발동한다. 기존 컨텍스트를 압축(요약)해서 다음 세션에서 맥락을 유지할 수 있게 하는 기능이다.
하지만 문제가 있다.
"저는 Auto Compact를 신뢰하지 않습니다. Clear 후 핸드오프 문서를 참고해 진행하는 걸 권장합니다."
Compact 연쇄 오염
권장 전략 1: Clear + 핸드오프 문서
가장 좋은 전략은 한두 번의 세션에서 작업을 끝내고 Clear하는 것이다. 다음 세션을 위해 핸드오프 문서를 작성해둔다.
핸드오프 문서란?
핸드오프 문서는 현재 세션에서 무엇을 했는지, 다음에 무엇을 해야 하는지를 정리한 문서다. AI가 다음 세션에서 이 문서를 읽고 맥락을 파악한다.
Auto Compact보다 정확하고 내가 원하는 정보만 다음 세션에 전달할 수 있다.
권장 전략 2: 서브 에이전트 활용
서브 에이전트는 별도의 컨텍스트를 사용한다. 메인 컨텍스트를 오염시키지 않으면서 대규모 작업을 수행할 수 있다.
실제 토큰 사용 예시 (To-Do 앱)
| 단계 | 서브 에이전트 사용 토큰 | 메인 컨텍스트 증가분 |
|---|---|---|
| Plan (PRD 작성) | 33K | ~4K |
| Design (Tech Spec 작성) | 49K | ~20K |
| Build (코드 구현) | 84K | ~20K |
| Review (검증) | 별도 | ~10K |
서브 에이전트가 33K~84K를 사용했지만, 메인 컨텍스트에는 결과 요약만 전달되므로 메인이 깨끗하게 유지된다.
컨텍스트 관리 체크리스트
정리
| 전략 | 방법 | 효과 |
|---|---|---|
| Clear + 핸드오프 | 작업 후 Clear, 핸드오프 문서 작성 | 깨끗한 컨텍스트로 다음 세션 시작 |
| 서브 에이전트 | 대규모 작업은 서브 에이전트에 위임 | 메인 컨텍스트 오염 방지 |
| 짧은 세션 | 1~2번 작업 후 Clear | Auto Compact 회피 |
| 토큰 모니터링 | 상태바에서 사용량 확인 | 80% 도달 전 Clear |