# 긴 작업의 컨텍스트 관리하기
id: claude-code-context · 종류: 워크플로 · 상태: 검수 대기 (사람 확인 전) · 주제: 개발
주소: https://opencurrent.ai/w/claude-code-context
기준일: 2026-11-21 (여기서 고친 날)
도구: Claude Code
걸리는 시간: 약 10분
평가 점수: 32/100 (확인 없음 · 검수 대기)

긴 작업에서 컨텍스트가 꽉 차 Claude Code가 앞 내용을 놓치는 일을 줄이고, 쓸데없이 쌓인 대화 때문에 늘어나는 비용도 아낄 수 있습니다.

설명: /context로 무엇이 자리를 차지하는지 보고, 같은 일을 이어 갈 때는 /compact에 남길 것을 적어 요약합니다. 관련 없는 일로 넘어갈 때는 /clear로 새로 시작하고, 넓은 조사는 서브에이전트에 맡겨 요약만 받습니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.

준비물: Claude Code 설치와 로그인

단계:
1. [명령 실행 · Claude Code] 지금 쓰는 양 보기 — /context는 컨텍스트 사용량을 색 격자로 보여 줍니다. /context all이면 항목별로 자세히 나옵니다.
   프롬프트:
   > /context
   기대 결과: 컨텍스트 사용 격자
   확인 방법: CLAUDE.md·도구·대화가 각각 얼마나 차지하는지 확인
2. [명령 실행 · Claude Code] 남길 것을 정해 요약 — 같은 작업을 이어 갈 때는 /compact 뒤에 무엇을 남길지 적습니다. CLAUDE.md에 "# Compact instructions" 제목과 한 줄을 두면 요약할 때마다 그 기준을 따릅니다.
   프롬프트:
   > /compact 바꾼 파일 목록, 남은 할 일, 실패한 테스트 이름은 꼭 남겨
   기대 결과: 요약된 대화
   확인 방법: /context로 사용량이 줄었는지 확인
3. [명령 실행 · Claude Code] 다른 일은 새 대화로 — 관련 없는 일로 넘어갈 때는 /clear로 비웁니다. 나중에 돌아올 대화는 먼저 /rename으로 이름을 붙이면 /resume에서 찾기 쉽습니다.
   프롬프트:
   > /rename 결제-버그
   > /clear
   기대 결과: 빈 대화
   확인 방법: /resume 목록에 이름 붙은 대화가 보이는지 확인
4. [AI에게 · Claude Code] 넓은 조사는 서브에이전트로 — 코드베이스 전체를 훑는 조사는 서브에이전트에 맡기면 긴 출력이 메인 대화에 쌓이지 않고 요약만 돌아옵니다.
   프롬프트:
   > 서브에이전트로 토큰 갱신이 어떻게 처리되는지 조사하고, 관련 파일과 흐름만 요약해 줘.
   기대 결과: 요약만 받은 조사 결과
   확인 방법: /context에서 대화 몫이 크게 늘지 않았는지 확인

주의:
- 요약하면 세부 내용이 빠질 수 있음. 꼭 필요한 값은 /compact 지시에 적기
- CLAUDE.md가 길면 모든 대화의 바닥 사용량이 올라감. 200줄 안쪽으로
- /clear 하면 /usage의 세션 합계도 처음부터 다시 셈

출처:
- Claude Code 문서: 비용 관리 https://code.claude.com/docs/en/costs
- Claude Code 문서: 내장 명령 https://code.claude.com/docs/en/commands
- Claude Code 문서: 자주 쓰는 작업 https://code.claude.com/docs/en/common-workflows