example-01-compact-사용

예시 01 · /compact로 컨텍스트 다이어트

Claude Code에서 한 세션이 길어졌을 때, 가장 먼저 시도하는 명령은 /compact다.

> /compact
[과거 30개 메시지를 요약합니다 ...]
[현재 컨텍스트: 약 14,500 토큰 → 4,200 토큰]

언제 쓰는가

• 같은 세션에서 한 가지 굵직한 작업이 끝나고, 다음 작업으로 주제는 이어지지만 과거 디테일은 더 이상 필요 없을 때.
• 응답이 점점 엉뚱해지기 시작할 때(context rot 신호).
• 토큰 사용량 경고가 뜰 때.

언제 쓰지 말아야 하는가

• 진행 중인 작업의 핵심 결정이 과거 턴에만 남아 있을 때 — 요약 손실 위험이 크다.
• 새 작업을 시작할 때 — 새 세션을 여는 것이 더 깨끗하다.

더 나은 패턴

• 결정 은 CLAUDE.md 또는 .omc/notepad.md에 글자로 박아 둔다.
• 탐색 은 서브에이전트에서 수행한다.
• 검색 가능한 사실 은 외부 인덱스에 두고 필요할 때만 로드한다.

출처

• sources/14-research-notes/2026-04-07-anthropic-claude-code-best-practices.md
• sources/14-research-notes/2026-04-07-anthropic-projects-and-context-engineering.md