Claude Code 완전 가이드 · 3 min read
컨텍스트 관리
"컨텍스트는 관리해야 할 가장 중요한 리소스입니다." — Anthropic 공식 문서
핵심 원칙
- 관련 없는 작업 사이에
/clear— 이전 컨텍스트가 새 작업을 오염시킴 - 2번 교정 실패 시
/clear— 더 나은 초기 프롬프트를 작성하는 것이 효율적 - 자동 압축은 ~95%에서 발동 — 수동 압축을 70-80%에서 하면 결과가 더 좋음
- CLAUDE.md는 압축 후 생존 — 디스크에서 다시 읽어옴
Compaction 전략
# 기본 압축
/compact
# 포커스 지정 압축 (훨씬 효과적)
/compact Focus on the API changes we discussed
/compact Preserve the list of all modified files
# CLAUDE.md에 압축 가이드 추가
# "When compacting, always preserve the full list of modified files"/btw — 사이드 체인 질문
/btw는 대화 히스토리에 추가되지 않는 사이드 질문입니다. 컨텍스트를 소비하지 않으면서 빠른 질문을 할 수 있습니다.
서브에이전트를 활용한 컨텍스트 보호
서브에이전트는 별도 컨텍스트 윈도우에서 작동하고 요약만 반환합니다. 이것이 컨텍스트를 보호하는 가장 강력한 방법입니다.
메인 컨텍스트 (1M 토큰)
|
+-- 서브에이전트 A: "테스트 실행" --> "3개 실패" (요약만 반환)
|
+-- 서브에이전트 B: "코드 탐색" --> "auth.ts:42에 버그" (요약만 반환)
|
= 메인 컨텍스트는 깨끗하게 유지됨
Document & Clear 메서드 (Shrivu Shankar)
자동 압축을 신뢰하지 말고, 명시적으로 상태를 저장하세요:
- Claude에게 현재 진행 상황을 마크다운 파일로 덤프시킴
/clear로 완전히 초기화- 새 세션에서 그 파일을 컨텍스트로 시작
TIP: 작업을 30분 스프린트로 나누고, 스프린트 사이에
/compact를 명시적 요약과 함께 실행하세요./context로 중간중간 사용량을 확인하세요. 신규 모노레포 세션은 기본 ~20K 토큰부터 시작합니다. — Shrivu Shankar