컨텍스트 윈도우는 Claude가 한 번에 볼 수 있는 정보의 총량입니다. 대화 내용, 읽은 파일, 명령 출력, 시스템 지침이 모두 여기에 들어갑니다.
왜 관리가 필요한가
용량이 크더라도 무한하지 않습니다. 그리고 채우면 채울수록 좋아지지 않습니다. 관련 없는 파일이 잔뜩 들어가면 정작 중요한 부분에 대한 집중이 흐려집니다.
목표는 "많이 담기"가 아니라 "필요한 것만 정확히 담기" 입니다.
컨텍스트를 잡아먹는 주범
| 원인 | 증상 | 대응 |
|---|---|---|
| 거대한 로그 출력 | 한 번의 명령으로 수천 줄 | head, tail, grep으로 잘라서 실행 |
| 전체 파일 반복 읽기 | 같은 파일이 여러 번 등장 | 필요한 구간만 지정해 읽기 |
| 목적 없는 탐색 | 관련 없는 디렉터리 순회 | 조사 범위를 먼저 지정 |
| 한 세션에 여러 주제 | 앞 작업 맥락이 계속 남음 | 주제가 바뀌면 세션 분리 |
실전 전략 네 가지
1. 범위를 먼저 좁힌다
components/checkout/ 안에서만 찾아줘.2. 조사는 서브 에이전트에게 맡긴다
파일을 많이 읽어야 하는 조사는 별도 에이전트에 위임하면, 메인 세션에는 결론만 돌아옵니다.
3. 주제가 바뀌면 세션을 새로 연다
"결제 버그 수정"과 "새 랜딩 페이지 작업"은 서로 도움이 되지 않습니다. 섞으면 양쪽 다 흐려집니다.
4. 프로젝트 지침을 짧게 유지한다
CLAUDE.md는 매 세션 시작 시 항상 로드됩니다. 길수록 매번 비용을 냅니다. 자주 쓰지 않는 상세 설명은 별도 문서로 빼고, 지침에는 링크만 남기세요.
프롬프트 캐싱
반복되는 앞부분(시스템 지침, 프로젝트 지침, 자주 참조하는 문서)은 캐시에 올라가 재사용됩니다. 그래서 자주 바뀌는 내용은 뒤쪽에, 고정된 내용은 앞쪽에 두는 편이 유리합니다.
자세한 내용은 프롬프트 캐싱을 참고하세요.
세션이 길어졌을 때 신호
- 앞에서 이미 정한 결정을 다시 물어본다
- 이미 고친 파일을 원래 상태로 되돌린다
- 답변이 점점 일반론으로 흐른다
이 신호가 보이면 지금까지의 결정 사항을 짧게 정리해 새 세션으로 옮기는 편이 빠릅니다.
컨텍스트토큰성능
팀에 Claude Code를 도입하려면 실제 코드베이스에 맞춘 설계가 필요합니다.
기업교육 · 도입 상담하기