긴 작업의 컨텍스트 관리하기
긴 작업에서 컨텍스트가 꽉 차 Claude Code가 앞 내용을 놓치는 일을 줄이고, 쓸데없이 쌓인 대화 때문에 늘어나는 비용도 아낄 수 있습니다.
/context로 무엇이 자리를 차지하는지 보고, 같은 일을 이어 갈 때는 /compact에 남길 것을 적어 요약합니다. 관련 없는 일로 넘어갈 때는 /clear로 새로 시작하고, 넓은 조사는 서브에이전트에 맡겨 요약만 받습니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.
준비
- Claude Code 설치와 로그인
1. 지금 쓰는 양 보기
/context는 컨텍스트 사용량을 색 격자로 보여 줍니다. /context all이면 항목별로 자세히 나옵니다.
/context결과: 컨텍스트 사용 격자
확인: CLAUDE.md·도구·대화가 각각 얼마나 차지하는지 확인
2. 남길 것을 정해 요약
같은 작업을 이어 갈 때는 /compact 뒤에 무엇을 남길지 적습니다. CLAUDE.md에 "# Compact instructions" 제목과 한 줄을 두면 요약할 때마다 그 기준을 따릅니다.
/compact 바꾼 파일 목록, 남은 할 일, 실패한 테스트 이름은 꼭 남겨결과: 요약된 대화
확인: /context로 사용량이 줄었는지 확인
3. 다른 일은 새 대화로
관련 없는 일로 넘어갈 때는 /clear로 비웁니다. 나중에 돌아올 대화는 먼저 /rename으로 이름을 붙이면 /resume에서 찾기 쉽습니다.
/rename 결제-버그
/clear결과: 빈 대화
확인: /resume 목록에 이름 붙은 대화가 보이는지 확인
4. 넓은 조사는 서브에이전트로
코드베이스 전체를 훑는 조사는 서브에이전트에 맡기면 긴 출력이 메인 대화에 쌓이지 않고 요약만 돌아옵니다.
서브에이전트로 토큰 갱신이 어떻게 처리되는지 조사하고, 관련 파일과 흐름만 요약해 줘.결과: 요약만 받은 조사 결과
확인: /context에서 대화 몫이 크게 늘지 않았는지 확인
주의
- 요약하면 세부 내용이 빠질 수 있음. 꼭 필요한 값은 /compact 지시에 적기
- CLAUDE.md가 길면 모든 대화의 바닥 사용량이 올라감. 200줄 안쪽으로
- /clear 하면 /usage의 세션 합계도 처음부터 다시 셈
댓글