Context Window
Claude 의 가장 중요한 한계 — 그리고 관리하는 법
⏱ 예상 ~5분
01 · 읽기
Claude 의 context window 는 책상 같아요. Claude가 생각하는 모든 게 이 책상 위에 올라와야 해요 — 여러분의 대화, 읽은 파일 내용, 명령 출력, CLAUDE.md, 로드된 skill, MCP 도구 설명, 시스템 지시까지요.
책상이 꽉 차면 Claude 는 새로운 걸 위해 자리를 만들려고 오래된 걸 밀어내야 해요. 그때 Claude 는 여러분이 앞서 준 지시를 잊거나, 어떤 파일을 읽었는지 놓칠 수 있어요.
이건 Claude Code를 효과적으로 쓰는 데 가장 중요한 개념이에요.
💡 상상해 봐요초능력 같은 동료와 일한다고 상상해요. 그의 책상은 50 페이지만 올라가요. 새 문서를 줄 때마다 오래된 게 떨어져요. 새 파일을 계속 주면 결국 원래 지시도 책상 밖으로 미끄러져 나가요. 이 한계를 이해하는 게 생산성 있는 session 의 열쇠예요.
핵심 정리
- Context window 는 Claude가 "생각하는" 모든 걸 담아요
- 대화, 파일, 명령 출력, CLAUDE.md, skill, MCP 도구 포함이에요
- 꽉 차면 오래된 내용이 자동으로 제거돼요
- 그래서 CLAUDE.md 가 중요해요 — 압축 후에도 항상 다시 로드돼요
02 · 읽기
모든 게 같은 양의 context 를 쓰는 건 아니에요. 큰 파일을 읽으면 전체 내용을 윈도우에 쏟아 넣어요. 긴 명령 출력은 토큰을 소비해요. 각 MCP 도구 설명은 자리를 차지해요 (그래서 Tool Search 가 있는 거예요).
대략적인 가이드 — CLAUDE.md 는 크기에 따라 2-5k 토큰. 각 파일 읽기 는 파일 크기에 비례한 토큰. 명령 출력 (테스트 결과나 build 에러 같은) 은 예상 외로 클 수 있어요. Skill 은 필요시 로드되고, 활성화될 때만 토큰을 써요. MCP 도구 는 설명 때문에 토큰을 소비해요.
핵심 인사이트 — 초기 context 는 작게 유지하고 Claude가 필요한 걸 로드하게 두세요.
핵심 정리
- CLAUDE.md: 2-5k 토큰 (200 줄 이내로 유지)
- 파일 읽기: 파일 크기에 비례
- 명령 출력: 클 수 있어요 (테스트 스위트, build log)
- Skill: 필요시 — 활성화 전 비용 0
- MCP 도구: 설명이 토큰을 써요 (Tool Search 가 도와줘요)
03 · 코드 예제
Claude Code 는 context 사용량을 모니터링하고 필요할 때 자리를 비울 수 있는 도구를 줘요.
context 사용량 보기
/context
focus 지시로 압축하기
/compact Focus on the API changes and test failures
관련 없는 작업 사이에 비우기
/clear
/context 로 윈도우가 얼마나 찼는지 봐요. 빡빡하면 /compact 로 대화를 요약하면서 중요한 걸 유지해요 — focus 지시를 더해서 Claude에게 뭘 남길지 알려줘요. 완전히 관련 없는 작업 사이에는 /clear 로 전부 리셋해요 (단, CLAUDE.md 는 자동으로 다시 로드돼요).
04 · 읽기
Context가 너무 차면 Claude Code 는 자동으로 압축해요. 대화를 요약하면서 최근 작업과 핵심 결정은 유지하고, 오래된 교류는 압축해요.
압축 후 — 자동이든 수동이든 — Claude 는 디스크에서 CLAUDE.md 를 다시 읽어요. 즉 CLAUDE.md 에 있는 건 압축 후에도 살아남아요. 대화 이력에만 있는 건 안 그럴 수 있어요.
이게 중요한 규칙을 대화에서만 말하지 말고 CLAUDE.md 에 넣어야 하는 근본적인 이유예요.
핵심 정리
- Claude 는 한계에 가까워지면 자동으로 압축해요
- 압축은 오래된 대화를 요약하고 최근 작업을 유지해요
- 압축 후 CLAUDE.md 는 항상 다시 읽혀요
- CLAUDE.md 규칙은 살아남아요; 구두 지시는 아닐 수 있어요
- 자동 압축이 발동하기 전에 미리 /compact 를 써요
05 · 퀴즈
긴 session 시작에서 Claude에게 "항상 Bun 을 쓰고 npm 은 쓰지 마" 라고 했어요. 자동 압축 후 Claude가 npm 을 쓰기 시작해요. 왜일까요?
- Claude가 의도적으로 지시를 무시했어요
- Bun 은 Claude Code 와 호환되지 않아요
- 지시가 적용되려면 Claude Code를 재시작해야 해요
- 구두 지시는 압축 때 사라져요 — CLAUDE.md 에 넣으세요
06 · 분류 드래그
각 종류의 내용이 context window 에 어떻게 영향을 주는지 생각해 봐요. context 효율 좋은 순서대로 가장 효율적인 것부터 가장 비효율적인 것까지 정렬하세요.
(이 섹션은 인터랙티브해요 — JavaScript를 켜 주세요.)
⚠ 전체 인터랙티브 경험에는 JavaScript가 필요해요. JavaScript를 켜고 새로 고침해 주세요.
※ 이 사이트는 독립 운영되는 교육 프로젝트로, Anthropic의 공식 제품이 아니에요. Claude™ 는 Anthropic, PBC 의 상표예요.