컨텍스트 윈도우 살펴보기
Claude Code의 컨텍스트 윈도우는 Claude가 세션에 대해 알고 있는 모든 것을 담습니다. 사용자의 지침, Claude가 읽은 파일, Claude 자신의 응답, 터미널에 전혀 나타나지 않는 콘텐츠까지 포함됩니다.
입력하기 전
CLAUDE.md, 자동 메모리, MCP 도구 이름, 스킬 설명이 모두 컨텍스트에 로드됩니다. 사용자의 설정에 따라 출력 스타일이나 --append-system-prompt의 텍스트처럼 시스템 프롬프트에 같은 방식으로 들어가는 항목이 더 추가될 수 있습니다.
Claude가 작업하는 동안
파일을 읽을 때마다 컨텍스트가 늘어나고, 경로 범위 규칙이 일치하는 파일과 함께 자동으로 로드되며, 각 편집 후 PostToolUse 훅이 실행됩니다.
후속 프롬프트
subagent가 자체 별도 컨텍스트 윈도우에서 조사를 처리하므로 큰 파일 읽기는 사용자의 컨텍스트에 들어오지 않습니다. 요약과 작은 메타데이터 꼬리표만 돌아옵니다.
압축
/compact가 대화를 구조화된 요약으로 대체합니다. 대부분의 시작 콘텐츠는 자동으로 다시 로드됩니다. 아래 표는 각 메커니즘에 어떤 일이 일어나는지 보여줍니다.
압축 후에도 남는 것
긴 세션이 압축되면 Claude Code는 컨텍스트 윈도우에 맞도록 대화 기록을 요약합니다. 지침에 어떤 일이 일어나는지는 지침이 어떻게 로드되었는지에 따라 달라집니다:
| 메커니즘 | 압축 후 |
|---|---|
| 시스템 프롬프트 및 출력 스타일 | 변경 없음. 메시지 기록의 일부가 아님 |
| 프로젝트 루트 CLAUDE.md 및 범위 없는 규칙 | 디스크에서 다시 주입됨 |
| 자동 메모리 | 디스크에서 다시 주입됨 |
paths: frontmatter가 있는 규칙 | 일치하는 파일을 다시 읽을 때까지 사라짐 |
| 하위 디렉토리의 중첩 CLAUDE.md | 해당 하위 디렉토리의 파일을 다시 읽을 때까지 사라짐 |
| 호출된 스킬 본문 | 다시 주입됨. 스킬당 5,000토큰, 전체 25,000토큰으로 제한되며 가장 오래된 것부터 제외됨 |
| 훅 | 해당 없음. 훅은 컨텍스트가 아니라 코드로 실행됨 |
경로 범위 규칙과 중첩된 CLAUDE.md 파일은 트리거 파일을 읽을 때 메시지 기록에 로드되므로, 압축 시 다른 항목과 함께 요약되어 사라집니다. Claude가 다음에 일치하는 파일을 읽으면 다시 로드됩니다. 규칙이 압축 후에도 반드시 유지되어야 한다면 paths: frontmatter를 제거하거나 프로젝트 루트 CLAUDE.md로 옮기세요.
스킬 본문은 압축 후 다시 주입되지만, 큰 스킬은 스킬별 한도에 맞도록 잘리고 전체 예산을 초과하면 가장 오래전에 호출된 스킬부터 제외됩니다. 잘림은 파일의 시작 부분을 보존하므로 가장 중요한 지침은 SKILL.md의 위쪽에 두세요.
자신의 세션 확인하기
어느 시점에서든 실제 컨텍스트 사용량을 보려면 /context를 실행해 카테고리별 실시간 분석과 최적화 제안을 확인하세요. 시작 시 어떤 CLAUDE.md와 자동 메모리 파일이 로드되었는지 확인하려면 /memory를 실행하세요.