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

​
타임라인이 보여주는 것

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

​
압축 후 유지되는 것

긴 세션이 압축될 때, Claude Code는 대화 기록을 요약하여 컨텍스트 윈도우에 맞춥니다. v2.1.198부터는 요약 요청이 세션의 확장 사고 구성을 상속하므로, 세션에서 사고가 활성화되어 있을 때는 사고를 활성화하여 추론하고 그렇지 않으면 비활성화된 상태로 유지됩니다. 사고는 요약이 생성되는 방식에만 영향을 미치며, 이후 세션 설정은 변경되지 않습니다. 사용자의 지시사항에 어떤 일이 발생하는지는 로드된 방식에 따라 달라집니다: 경로 범위 규칙 및 중첩 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 및 자동 메모리 파일을 확인하세요. 타임라인에 표시된 기능에 대한 더 깊은 내용은 다음 페이지를 참조하세요: