효과적인 컨텍스트 관리 전략

컨텍스트 관리 — 긴 작업에서 집중력을 잃지 않기

Claude Code의 가장 큰 제약은 컨텍스트 윈도우입니다. 대화가 길어질수록 초기 정보가 밀려나고, 일관성이 떨어지기 시작합니다. 전문 사용자와 초보자의 가장 큰 차이가 바로 이 컨텍스트 관리 능력입니다. 긴 작업을 어떻게 설계하느냐에 따라 결과의 품질이 결정됩니다.

컨텍스트 윈도우란

Claude는 한 세션에서 처리할 수 있는 텍스트의 양(토큰)이 제한되어 있습니다. Claude Opus 4 기준 200K 토큰 — 영문 기준 약 15만 단어입니다. 충분히 커 보이지만, 코드베이스 파일들을 읽기 시작하면 빠르게 소모됩니다.

# 토큰 소모 예시
- 파일 하나 읽기 (500줄):      ~3,000 토큰
- npm run build 출력:           ~1,000 토큰
- 대화 메시지 20개:             ~5,000 토큰
- 10개 파일 분석:               ~30,000 토큰

# 200K 중 절반이 소모되면 → 응답 품질 저하 시작

/clear 명령어 — 언제 써야 하는가

/clear는 현재 대화를 초기화하고 새 세션을 시작합니다. CLAUDE.md는 유지됩니다.

# /clear를 써야 하는 시점
✅ 작업 하나가 완전히 완료됐을 때 (버그 수정 완료, 기능 구현 완료)
✅ 다른 영역으로 작업 전환할 때 (결제 모듈 → 알림 시스템)
✅ Claude 응답이 이전보다 부정확해졌을 때
✅ 에러가 반복 발생하고 이상한 방향으로 수정할 때

# /clear를 쓰면 안 되는 시점
❌ 작업 중간에 (미완성 상태에서 맥락을 잃음)
❌ 중요한 결정 사항 공유 전에 (재설명 필요)

세션 설계 — 작업을 어떻게 나눌까

하나의 긴 세션 대신 목적이 명확한 짧은 세션들로 나누는 것이 효율적입니다.

# 나쁜 패턴: 하나의 거대한 세션
세션 1 (4시간):
  - 버그 수정 → 새 기능 → 리팩터링 → DB 마이그레이션
  → 컨텍스트 오염, 마지막에 초기 규칙 망각

# 좋은 패턴: 목적별 세션 분리
세션 1 (30분): "로그인 오류 수정" → /clear
세션 2 (45분): "알림 컴포넌트 구현" → /clear
세션 3 (20분): "DB 마이그레이션 생성" → /clear

세션 간 컨텍스트 전달

세션을 나누면 이전 세션의 결정 사항을 다음 세션에 전달해야 합니다. 가장 효과적인 방법은 간단한 handoff 메모입니다.

# 세션 종료 전 Claude에게 요청
"이 세션에서 결정한 중요 사항을 다음 세션에 전달할 handoff 메모로 3~5줄로 요약해줘"

# Claude가 생성하는 예시 handoff 메모
다음 세션 시작 시 전달:
- users 테이블에 notification_preference 컬럼 추가 완료 (nullable, jsonb)
- UserNotificationSettings 컴포넌트는 app/components/settings/ 아래 생성
- Supabase Realtime 구독은 useEffect cleanup에서 반드시 unsubscribe 필요
- 미완료: 알림 이메일 발송 로직 (resend 라이브러리 사용 예정)

서브에이전트로 컨텍스트 보호

큰 코드베이스를 분석할 때 메인 세션의 컨텍스트를 소모하지 않고 서브에이전트에게 위임합니다.

# 메인 세션 컨텍스트 보호 패턴
"app/actions/ 디렉토리의 타입 오류를 모두 수정해줘.
 서브에이전트를 사용해서 메인 세션 컨텍스트를 아끼면서 처리해줘."

# Claude가 서브에이전트를 생성해 별도 컨텍스트에서 처리
# 메인 세션에는 결과 요약만 전달됨

컨텍스트 오염 신호 감지

# 컨텍스트가 오염됐다는 신호들
- 이전에 정한 규칙을 반복 위반
- 같은 파일을 다시 찾아달라고 요청
- 프레임워크를 잘못 인식 (Next.js인데 Express로 착각)
- 이전 대화 내용을 다시 물어봄
- 제거한 코드가 다시 나타남

# 대응: /clear 후 핵심 컨텍스트 재주입
/clear
"방금 전 세션에서 [결정 사항 3줄 요약]. 이 상태에서 계속해줘."

컨텍스트 관리는 Claude Code 사용에서 가장 과소평가되는 스킬입니다. 많은 사람이 Claude가 실수한다고 느낄 때 실제 원인은 컨텍스트 오염입니다. /clear가 두렵다면 작업 완료 기준을 명확히 정하고, 완료할 때마다 handoff 메모를 작성하는 습관을 들이세요.

핵심 정리

• 컨텍스트 절반 소모 시점부터 응답 품질 저하 — 작업 완료 후 /clear로 초기화, CLAUDE.md는 유지됨
• 세션은 목적별로 분리(30~60분) — 긴 단일 세션보다 짧은 집중 세션들이 품질·비용 모두 유리
• 세션 종료 전 handoff 메모 요청 — 다음 세션에 3~5줄 요약 전달로 맥락 복원 비용 최소화

관련 검색어  ·  클로드 코드 컨텍스트  ·  Claude Code /clear  ·  AI 세션 관리  ·  컨텍스트 윈도우  ·  클로드 코드 완벽 마스터  ·  AI 개발 워크플로우