컨텍스트 창 탐색하기

Claude Code의 컨텍스트 창은 세션이 진행되면서 어떤 내용이 로드되고, 언제 가득 차며, 통합(compaction) 후 무엇이 살아남는지가 핵심입니다. 이 문서는 대표적인 토큰 수치로 흐름을 보여주는 타임라인과, 통합 후 유지/재주입되는 메커니즘, 그리고 컨텍스트가 가득 찼을 때 대처하는 방법을 정리합니다. 컨텍스트를 잘 관리하는 것이 장기 세션의 품질과 비용을 좌우합니다.

출처: 공식문서

본문

타임라인이 보여주는 것

대표적인 토큰 수치로 현실적인 흐름을 보여줍니다:

아무것도 입력하기 전: CLAUDE.md, 자동 메모리, MCP 도구 이름, 스킬 설명이 모두 컨텍스트에 로드됩니다. 설정에 따라 output style이나 --append-system-prompt 텍스트가 추가될 수 있습니다.
Claude가 작업하는 동안: 파일을 읽을 때마다 컨텍스트가 늘어나고, 경로 범위 규칙(path-scoped rules)이 해당 파일과 함께 자동 로드되며, 편집 후 PostToolUse 훅이 실행됩니다.
후속 프롬프트: 서브에이전트가 자체 컨텍스트 창에서 조사를 처리하므로 큰 파일 읽기는 내 컨텍스트에서 빠져나갑니다. 요약과 작은 메타데이터 꼬리만 돌아옵니다.
마지막에: /compact가 대화를 구조화된 요약으로 바꿉니다. 대부분의 시작 콘텐츠는 자동으로 다시 로드됩니다.

통합(compaction) 후 살아남는 것

긴 세션이 통합되면 Claude Code가 대화 히스토리를 컨텍스트 창에 맞게 요약합니다. v2.1.198부터 요약 요청은 세션의 extended thinking 설정을 상속받습니다. 각 콘텐츠의 처리 방식은 다음과 같습니다:

메커니즘	통합 후
시스템 프롬프트·output style	계속 적용됨
프로젝트 루트 CLAUDE.md, 범위 없는 규칙	디스크에서 재주입
자동 메모리	디스크에서 재주입
plan 모드에서 Claude가 쓴 계획	디스크에서 재주입
`paths:` 프론트매터를 가진 규칙	해당 파일을 읽을 때 다시 로드
하위 디렉토리의 중첩 CLAUDE.md	그 파일을 읽을 때 다시 로드
Claude가 읽거나 편집한 파일	최근 수정 순으로 최대 5개 재읽기
호출된 스킬 본문	재주입, 스킬당 5,000 토큰·총 25,000 토큰 상한, 오래된 것부터 제거
훅이 추가한 컨텍스트	나머지 대화와 함께 요약됨
`compact` 소스와 일치하는 SessionStart 훅	실행되어 요약 컨텍스트에 추가

경로 범위 규칙과 중첩 CLAUDE.md는 트리거 파일이 읽힐 때 메시지 히스토리로 로드되므로, 통합 시 다른 내용과 함께 요약됩니다. 통합 직후 Claude Code는 세션에서 읽거나 편집한 파일 중 최근 수정된 최대 5개를 재읽고, 그 파일에 적용되는 규칙·중첩 CLAUDE.md를 다시 로드합니다. 5,000 토큰을 넘는 파일은 내용 대신 경로 참조(Referenced file)로 돌아옵니다. 규칙이 통합을 넘어 지속되어야 한다면 paths: 프론트매터를 제거하거나 프로젝트 루트 CLAUDE.md로 옮기세요.

스킬 본문은 통합 후 재주입되지만, 큰 스킬은 스킬당 상한에 맞게 잘리며 총 예산을 초과하면 가장 오래된 스킬이 제거됩니다. 잘림은 파일 앞부분을 유지하므로 SKILL.md의 중요한 지침은 상단에 두세요.

컨텍스트가 가득 찼을 때

Claude Code는 한계에 근접하면 자동으로 통합하므로 세션이 끝나지 않습니다. 자동 통합은 타임라인의 /compact 단계와 같은 방식으로 동작합니다. 자동 통합 이전에 직접 할 수 있는 일:

초점을 둔 통합: 새 작업 전에 /compact focus on the auth bug fix처럼 지시어와 함께 /compact 실행. 자동 통합이 추측하는 대신 원하는 내용을 요약에 유지.
대화 일부만 통합: /rewind 후 메시지를 선택하고 Summarize from here 또는 Summarize up to here 선택.
더 일찍 통합: /autocompact 500k처럼 토큰 수와 함께 실행해 자동 통합 전까지의 컨텍스트 가득참 수준 설정.
작업 사이 정리: 무관한 작업으로 전환할 때 /clear 실행. 오래된 대화가 다음에 필요한 파일을 밀어내고 매 메시지 토큰을 소모.
큰 읽기 위임: 조사를 서브에이전트로 보내 파일 내용을 내 컨텍스트가 아닌 서브에이전트 창에 유지.

더 큰 컨텍스트가 필요하다면 Fable 모델, Sonnet 5, Opus 4.6 이상, Sonnet 4.6은 100만 토큰 컨텍스트 창을 지원합니다. [1m] 모델 변형을 선택하세요. Sonnet 5는 기본 1M 창으로 실행되며 선택할 [1m] 변형이 없습니다.

자동 통합이 실행되는 지점은 모델·구성에 따라 다릅니다. 모델별 경계는 기본 자동 통합 임계값을 참고하고, LLM 게이트웨이 별칭처럼 모델 ID에 대해 창 크기가 잘못 가정되면 교정하세요.

자신의 세션 확인하기

시각화는 대표 수치를 사용합니다. 실제 컨텍스트 사용량을 보려면 /context를 실행해 카테고리별 실시간 분석과 최적화 제안(로드된 CLAUDE.md·자동 메모리 포함)을 확인하세요. /memory로 해당 파일을 열고 편집할 수 있습니다.

컨텍스트 창 탐색하기