---

Claude Code를 쓰다 보면 질문 7~8개만에 컨텍스트가 70%를 넘기는 경험을 한다. /compact로 압축해도 근본적인 해결이 안 되고, 결국 /clear로 날리게 된다.

이 글에서는 컨텍스트가 빨리 차는 원인과 실전에서 바로 쓸 수 있는 관리 팁을 정리한다.

컨텍스트가 빨리 차는 이유

1. 시스템 프롬프트가 이미 크다

Claude Code는 세션 시작 시점부터 다음을 컨텍스트에 올린다:

• CLAUDE.md (글로벌 + 프로젝트)
• 활성화된 MCP 서버들의 도구 목록
• auto memory 파일
• 시스템 프롬프트 자체

MCP 서버를 많이 연결할수록 (Notion, Gmail, Calendar, GitHub, Playwright 등) 시작부터 상당한 공간을 점유한다.

2. 큰 파일 직접 읽기 = 컨텍스트 오염

가장 큰 원인이다. 이미지, 스크린샷, 긴 로그 파일, 대형 소스 파일을 Claude Code에 직접 읽히면 그 내용이 통째로 컨텍스트에 들어간다.

❌ "이 스크린샷 봐줘" (이미지 붙여넣기)
❌ "이 로그 파일 전체 읽어봐"
❌ "프로젝트 파일 다 살펴봐"

3. Bash 출력이 길어지는 경우

빌드 로그, 테스트 결과, git log 등의 출력이 길면 그대로 컨텍스트에 쌓인다.

해결법 1: 서브에이전트 위임

서브에이전트(Agent 도구)는 별도의 컨텍스트 윈도우에서 실행된다. 작업이 끝나면 결과 요약만 메인으로 돌아오기 때문에, 메인 컨텍스트가 오염되지 않는다.

사용법: “서브에이전트로” 를 붙이면 된다

이렇게 하면 컨텍스트 오염	이렇게 하면 절약
”이 파일 읽어봐"	"서브에이전트로 이 파일 분석하고 요약해줘”
스크린샷 바로 붙여넣기	”에이전트 띄워서 이 이미지 분석해줘"
"프로젝트 전체 구조 알려줘"	"에이전트로 프로젝트 탐색하고 핵심만 알려줘"
"이 에러 로그 봐줘"	"에이전트로 로그 분석해서 원인만 알려줘”

예시

"서브에이전트로 C:\projects\my-app의 src 폴더 구조를 분석하고
핵심 아키텍처만 요약해줘"

"에이전트 띄워서 이 500줄짜리 에러 로그에서
root cause만 찾아줘: /tmp/build.log"

이렇게 하면 서브에이전트가 파일을 읽고 분석하는 과정은 별도 컨텍스트에서 일어나고, 메인에는 요약된 결과만 남는다.

해결법 2: 안 쓰는 MCP 비활성화

/context를 실행하면 현재 컨텍스트 구성을 볼 수 있다. MCP 서버가 많으면 도구 목록만으로도 컨텍스트를 상당히 점유한다.

실제로 쓰는 MCP만 남기자. 프로젝트별로 필요한 MCP가 다르므로, 글로벌보다는 프로젝트 설정(.claude/settings.json)에서 관리하는 것이 좋다.

해결법 3: /compact vs /clear 구분

• /compact: 대화를 요약 압축. 맥락은 유지되지만, 이미 들어온 큰 파일 내용이 완전히 사라지진 않음
• /clear: 완전 초기화. auto memory와 CLAUDE.md만 남음

컨텍스트가 70% 이상이면 /clear하고 새로 시작하는 게 낫다. /compact는 중간 정도일 때 맥락을 유지하면서 공간을 확보하는 용도로 쓴다.

해결법 4: 작은 습관들

• 파일 읽을 때 범위 지정: “이 파일의 100~150번 줄만 읽어줘”
• Bash 출력 제한: 긴 출력이 예상되면 | head -20 등으로 제한
• 한 세션에 하나의 작업: 주제가 바뀌면 /clear 후 새 세션
• CLAUDE.md 다이어트: 불필요한 지시사항 정리

핵심 원칙

메인 에이전트 오염 최소화

Claude Code의 메인 컨텍스트는 의사결정과 대화의 흐름을 유지하는 공간이다. 무거운 분석, 탐색, 파일 읽기는 서브에이전트에 위임하고, 메인에는 결과만 받는 구조로 쓰면 같은 컨텍스트 윈도우로 2배 이상 길게 작업할 수 있다.

2026년 3월 11일

← All posts