컨텍스트 창 살펴보기 (Explore the context window)

기준일: 2026-11-03
공식 기준: Explore the context window

개요

Claude Code의 컨텍스트 창에는 세션에 대해 Claude가 아는 모든 것이 들어 있습니다. 사용자의 지시, Claude가 읽은 파일, Claude 자신의 응답, 그리고 터미널에는 보이지 않는 내용까지 포함됩니다.

공식 페이지의 본체는 사이트에서만 동작하는 인터랙티브 시뮬레이션입니다. 시작부터 compaction까지 한 세션을 타임라인으로 재생하면서, 입력 전에 무엇이 로드되는지, 파일 읽기·규칙·hook이 작업 중에 무엇을 더하는지, subagent가 큰 파일 읽기를 어떻게 내 컨텍스트 밖에 두는지를 대표적인 토큰 수와 함께 보여 줍니다. 이 문서는 시뮬레이션을 직접 옮길 수 없으므로, 공식 페이지가 함께 제공하는 서술형 설명(타임라인이 보여 주는 것, compaction 뒤에 남는 것, 창이 찰 때의 대응)을 정리합니다. 애니메이션은 공식 페이지에서 확인하세요.

핵심 개념

단계	컨텍스트에 일어나는 일
입력 전	CLAUDE.md, auto memory, MCP tool 이름, skill 설명이 로드됨
작업 중	파일 읽기마다 누적, 경로 범위 규칙이 일치 파일과 함께 로드, 편집 뒤 PostToolUse hook 실행
후속 프롬프트	subagent가 별도 컨텍스트 창에서 조사하고 요약과 작은 메타데이터만 돌려줌
/compact	대화를 구조화된 요약으로 교체. 시작 시 내용 대부분은 자동 재로드

상세

타임라인이 보여 주는 것

시뮬레이션은 대표적인 토큰 수로 현실적인 흐름을 따라갑니다.

• 아무것도 입력하기 전: CLAUDE.md, auto memory, MCP tool 이름, skill 설명이 모두 컨텍스트에 로드됩니다. CLAUDE.md 대신 AGENTS.md 파일이 로드될 수도 있습니다. 설정에 따라 output style이나 --append-system-prompt 텍스트가 더해집니다.
• Claude가 작업하는 동안: 파일을 읽을 때마다 컨텍스트가 늘고, 경로 범위 규칙이 일치하는 파일과 함께 자동 로드되며, 편집마다 PostToolUse hook이 실행됩니다.
• 후속 프롬프트: subagent가 별도 컨텍스트 창에서 조사를 맡으므로 큰 파일 읽기가 내 컨텍스트에 들어오지 않습니다. 요약과 작은 메타데이터 trailer만 돌아옵니다.
• 마지막 단계: /compact를 실행하면 대화가 구조화된 요약으로 바뀝니다. 시작 시 로드된 내용 대부분은 자동으로 다시 로드되며, 메커니즘별 처리는 아래 표와 같습니다.

compaction 뒤에 남는 것

긴 세션이 compaction되면 Claude Code는 대화 기록을 컨텍스트 창에 맞게 요약합니다. v2.1.198부터 요약 요청은 세션의 extended thinking 설정을 이어받아, 세션에서 thinking이 켜져 있으면 thinking으로 추론하고 아니면 끈 채로 요약합니다. thinking은 요약을 만드는 방식에만 영향을 주고, 이후 세션 설정은 바뀌지 않습니다. 내용별 처리는 로드 방식에 따라 다릅니다.

메커니즘	compaction 후
시스템 프롬프트와 output style	둘 다 계속 적용
프로젝트 루트 CLAUDE.md와 범위 없는 규칙	디스크에서 다시 주입
Auto memory	디스크에서 다시 주입
Skill 설명	현재 skills에서 다시 만들어 주입. Claude Code v2.1.304 이상 필요
Git status 스냅샷	세션이 스냅샷으로 시작했다면 저장소에서 새로 읽음
plan mode에서 Claude가 쓴 계획	디스크에서 다시 주입
paths: frontmatter가 있는 규칙	필요할 때 다시 로드
하위 디렉터리의 중첩 CLAUDE.md	필요할 때 다시 로드
Claude가 읽거나 편집한 파일	최근 수정순으로 최대 5개까지 다시 읽음
호출된 skill 본문	다시 주입. skill당 5,000토큰, 합계 25,000토큰 상한. 초과 시 오래된 것부터 제외
백그라운드 명령과 백그라운드 subagent	계속 실행. 중복 실행을 막도록 아직 실행 중인 것을 Claude에게 알려 줌
앞서 hook이 추가한 컨텍스트	나머지 대화와 함께 요약됨
compact source와 일치하는 SessionStart hook	실행하고 출력을 compaction된 컨텍스트에 추가

세부 동작:

• compaction 직후 Claude Code는 세션에서 읽거나 편집한 파일 중 가장 최근에 수정된 최대 5개를 다시 읽습니다. 5,000토큰이 넘는 파일은 내용 없이 경로 참조로 돌아오며 Read 대신 Referenced file로 표시됩니다.
• 경로 범위 규칙과 중첩 CLAUDE.md는 Claude가 트리거 파일을 읽기·쓰기·편집할 때 메시지 기록에 로드되므로, compaction 때 다른 내용과 함께 요약되어 사라집니다. compaction을 넘어 유지해야 하는 규칙은 paths: frontmatter를 빼거나 프로젝트 루트 CLAUDE.md로 옮기세요.
• skill 본문은 다시 주입되지만, 큰 skill은 skill당 상한에 맞게 잘리고 합계 예산을 넘으면 가장 오래전에 호출된 skill부터 빠집니다. 잘라낼 때 파일 앞부분을 남기므로 가장 중요한 지시는 SKILL.md 위쪽에 두세요.

컨텍스트가 찰 때

Claude Code는 한도에 가까워지면 자동으로 compaction하므로 컨텍스트 창이 가득 차도 세션이 끝나지 않습니다. 자동 compaction은 타임라인의 /compact 단계와 같은 방식으로 동작합니다. 무엇을 보존하는지는 When context fills up을, 방치된 대화를 compaction하는 시점은 idle compaction을 보세요.

자동 compaction 전에 직접 대응할 수도 있습니다.

방법	사용법
초점을 정해 compaction	긴 새 작업 전에 /compact focus on the auth bug fix처럼 지시와 함께 실행. 자동 compaction이 추측하는 대신 내가 고른 내용을 요약에 남김
대화 일부만 compaction	/rewind에서 메시지를 고르고 Summarize from here 또는 Summarize up to here 선택. 각 옵션의 동작은 Rewind and summarize 참고
더 일찍 compaction	/autocompact에 토큰 수를 지정(예: /autocompact 500k)해 자동 compaction이 시작되는 지점을 설정. 허용 값과 override는 Set the auto-compact window 참고
작업 사이에 비우기	관련 없는 작업으로 넘어갈 때 /clear. 오래된 대화는 다음에 필요한 파일 자리를 차지하고 메시지마다 토큰 비용이 듦
큰 읽기 위임	조사를 subagent에 맡겨 파일 내용이 내 창이 아닌 subagent 창에 머물게 함

대화를 줄이기보다 더 큰 창이 필요하다면, Fable 모델, Sonnet 5 이후, Haiku 5.5, Opus 4.6 이후, Sonnet 4.6이 100만 토큰 컨텍스트 창을 지원합니다. 플랜별 제공 여부와 [1m] 모델 variant 선택 방법은 Extended context를 보세요. 큰 한도에서도 compaction은 같은 방식으로 동작합니다.

자동 compaction이 실행되는 지점은 모델과 설정에 따라 다릅니다. 모델별 경계는 Default auto-compact thresholds를, LLM gateway alias처럼 모델 ID에 대해 Claude Code가 창 크기를 잘못 가정한다면 Correct the window for a gateway or custom model ID를 보세요.

내 세션 확인하기

시각화는 대표 수치를 씁니다. 실제 사용량은 언제든 /context로 확인합니다. 카테고리별 실시간 내역과 최적화 제안, 어떤 CLAUDE.md·auto memory 파일이 로드됐는지까지 보여 줍니다. 그 파일들을 열어 편집하려면 /memory를 실행합니다.

체크리스트

• /context로 실제 컨텍스트 사용량과 로드된 CLAUDE.md·auto memory 파일을 확인했다.
• compaction 뒤에도 유지해야 하는 규칙은 paths: 없이 두거나 루트 CLAUDE.md로 옮겼다.
• 중요한 skill 지시를 SKILL.md 위쪽에 배치했다(skill당 5,000토큰 상한).
• 긴 새 작업 전에 /compact <초점>, 무관한 작업 전환 시 /clear를 쓴다.
• 큰 조사는 subagent로 위임한다.
• 필요하면 /autocompact로 자동 compaction 지점을 조정했다.

다음 단계

• Extend Claude Code: CLAUDE.md·skills·rules·hooks·MCP 중 무엇을 언제 쓸지
• Store instructions and memories: CLAUDE.md 계층과 auto memory
• Subagents: 조사를 별도 컨텍스트 창에 위임
• Best practices: 세션을 한 가지 일에 집중시키고 비용 낮추기
• Prompt caching: 어떤 동작이 캐시된 prefix를 무효화하는지
• Reduce token usage: 컨텍스트 사용량을 낮게 유지하는 전략

기준일

이 문서는 2026-11-03에 공식 Explore the context window 페이지를 기준으로 작성했습니다. 인터랙티브 타임라인은 공식 페이지에서만 볼 수 있습니다. 버전 표기(v2.1.198, v2.1.304)는 공식 원문에 있는 내용입니다.