메인 콘텐츠로 건너뛰기
Claude Code의 컨텍스트 윈도우는 Claude가 세션에 대해 알고 있는 모든 것을 보유합니다: 사용자의 지시사항, 읽은 파일, Claude 자신의 응답, 그리고 터미널에 나타나지 않는 콘텐츠입니다. 아래 타임라인은 시작부터 압축까지 전체 세션을 재생합니다: 사용자가 입력하기 전에 무엇이 로드되고, 각 파일 읽기, 규칙, 훅이 Claude가 작업할 때 무엇을 추가하는지, 그리고 서브에이전트가 어떻게 대용량 읽기를 컨텍스트 밖으로 유지하는지 보여줍니다. 동일한 콘텐츠를 목록으로 보려면 작성된 분석을 참조하세요.

​
타임라인이 보여주는 것

세션은 대표적인 토큰 수를 포함한 현실적인 흐름을 따릅니다:
  • 아무것도 입력하기 전: CLAUDE.md, 자동 메모리, MCP 도구 이름, 그리고 스킬 설명이 모두 컨텍스트에 로드됩니다. 사용자의 설정에 따라 출력 스타일 또는 --append-system-prompt의 텍스트와 같이 시스템 프롬프트와 동일한 방식으로 들어가는 추가 항목이 있을 수 있습니다.
  • Claude가 작업할 때: 각 파일 읽기가 컨텍스트에 추가되고, 경로 범위 규칙이 일치하는 파일과 함께 자동으로 로드되며, PostToolUse 훅이 각 편집 후에 실행됩니다.
  • 후속 프롬프트: 서브에이전트가 자신의 별도 컨텍스트 윈도우에서 연구를 처리하므로 대용량 파일 읽기가 사용자의 윈도우에서 벗어납니다. 요약과 작은 메타데이터 트레일러만 돌아옵니다.
  • 끝에서: /compact가 대화를 구조화된 요약으로 바꿉니다. 대부분의 시작 콘텐츠는 자동으로 다시 로드됩니다. 아래 표는 각 메커니즘에 어떤 일이 발생하는지 보여줍니다.

​
압축 후 유지되는 것

긴 세션이 압축될 때, Claude Code는 대화 기록을 요약하여 컨텍스트 윈도우에 맞춥니다. 사용자의 지시사항에 어떤 일이 발생하는지는 로드된 방식에 따라 달라집니다:
메커니즘압축 후
시스템 프롬프트 및 출력 스타일변경되지 않음; 메시지 기록의 일부가 아님
프로젝트 루트 CLAUDE.md 및 범위 미지정 규칙디스크에서 다시 주입됨
자동 메모리디스크에서 다시 주입됨
paths: 프론트매터가 있는 규칙일치하는 파일을 다시 읽을 때까지 손실됨
하위 디렉토리의 중첩 CLAUDE.md해당 하위 디렉토리의 파일을 다시 읽을 때까지 손실됨
호출된 스킬 본문다시 주입됨, 스킬당 5,000 토큰 및 총 25,000 토큰으로 제한됨; 가장 오래된 것부터 삭제됨
훅해당 없음; 훅은 컨텍스트가 아닌 코드로 실행됨
경로 범위 규칙 및 중첩 CLAUDE.md 파일은 트리거 파일을 읽을 때 메시지 기록에 로드되므로 압축은 다른 모든 것과 함께 이들을 요약합니다. Claude가 일치하는 파일을 다시 읽을 때 다시 로드됩니다. 규칙이 압축 전체에서 유지되어야 하는 경우 paths: 프론트매터를 삭제하거나 프로젝트 루트 CLAUDE.md로 이동하세요. 스킬 본문은 압축 후 다시 주입되지만 큰 스킬은 스킬당 제한에 맞게 잘리고, 총 예산을 초과하면 가장 오래된 호출된 스킬이 삭제됩니다. 잘림은 파일의 시작을 유지하므로 SKILL.md의 맨 위에 가장 중요한 지시사항을 배치하세요.

​
컨텍스트가 가득 찰 때

Claude Code는 제한에 접근할 때 자동으로 압축하므로 컨텍스트 윈도우가 가득 차도 세션이 끝나지 않습니다. 자동 패스는 타임라인의 /compact 단계와 동일한 방식으로 작동합니다. 컨텍스트가 가득 찰 때에서 보존되는 항목을 참조하세요. 자동 패스가 실행되기 전에 조치를 취할 수도 있습니다:
  • 포커스를 맞춰 압축: 긴 새 작업을 시작하기 전에 /compact focus on the auth bug fix와 같은 지시사항과 함께 /compact를 실행하세요. 요약은 자동 패스가 추측하는 중요한 항목 대신 사용자가 선택한 항목을 유지합니다.
  • 작업 간 지우기: 관련 없는 작업으로 전환할 때 /clear를 실행하세요. 오래된 대화는 다음에 필요한 파일을 밀어내고 모든 메시지에서 토큰을 소비합니다.
  • 대용량 읽기 위임: 연구를 서브에이전트에 보내 파일 콘텐츠가 사용자의 컨텍스트 윈도우가 아닌 서브에이전트의 컨텍스트 윈도우에 유지되도록 하세요.
더 작은 대화보다 더 큰 윈도우가 필요한 경우 Fable 5, Sonnet 5, Opus 4.6 이상, Sonnet 4.6은 100만 토큰 컨텍스트 윈도우를 지원합니다. 플랜별 가용성 및 [1m] 모델 변형을 선택하는 방법은 확장 컨텍스트를 참조하세요. Sonnet 5는 선택할 [1m] 변형 없이 1M으로 실행됩니다. 자동 압축 임계값 및 LLM 게이트웨이 예외에 대해서는 Sonnet 5 컨텍스트 윈도우를 참조하세요. 압축은 더 큰 제한에서도 동일한 방식으로 작동합니다.

​
자신의 세션 확인

시각화는 대표적인 숫자를 사용합니다. 언제든지 실제 컨텍스트 사용량을 보려면 /context를 실행하여 카테고리별 라이브 분석과 최적화 제안을 확인하세요. /memory를 실행하여 시작 시 로드된 CLAUDE.md 및 자동 메모리 파일을 확인하세요. 타임라인에 표시된 기능에 대한 더 깊은 내용은 다음 페이지를 참조하세요: