Claude Code 완전 가이드: Part 4 - 컨텍스트 관리의 예술

Claude Code를 사용할 때 가장 중요한 것은 '컨텍스트(작업 기억)' 관리입니다. 대화가 길어질수록 AI의 집중력이 흐트러지는 문제를 방지하고, 최상의 퍼포먼스를 유지하는 핵심 팁들을 정리했습니다.

---

1. HANDOFF.md를 활용한 선제적 압축

대화가 50k 토큰을 넘어가면 Claude의 반응 속도가 느려지거나 정확도가 떨어집니다. 이때 HANDOFF.md 기법을 사용해 컨텍스트를 초기화하세요.

 

✅ 워크플로우:

1. /context: 현재 토큰 사용량 확인 (50k 이상 시 진행)
2. HANDOFF 요청: "지금까지 내용을 HANDOFF.md로 정리해줘. 시도한 것, 성공/실패, 다음 단계를 포함해줘."
3. /clear: 현재 세션 종료 및 컨텍스트 초기화
4. 로드: @HANDOFF.md 이 파일을 읽고 작업을 이어가줘

---

2. 터미널 탭 분리 (멀티태스킹 전략)

하나의 대화창에서 여러 작업을 섞으면 컨텍스트가 오염됩니다. 3~4개의 터미널 탭을 열어 Claude에게 독립적인 '두뇌'를 부여하세요.

탭 구분	주요 용도	예시
탭 1	메인 개발	새 기능 구현, 핵심 로직 작성
탭 2	버그 수정	긴급 핫픽스, 에러 디버깅
탭 3	리서치/실험	라이브러리 테스트, 기술 조사
탭 4	DevOps/배포	CI/CD 설정, 환경 변수 관리

 

💡 Tip: 인증 시스템을 작업하다가 갑자기 UI 수정을 요청하지 마세요. 작업 성격이 바뀌면 새 탭을 쓰는 것이 유리합니다.

---

3. Clone & Half-Clone (dx 플러그인)

대화를 복제하거나 절반으로 줄여 효율을 높이는 고급 기술입니다.

• /clone: 현재 대화를 그대로 복제. A/B 테스트를 하거나 위험한 변경 전 백업용으로 사용합니다.
• /half-clone: 대화의 후반부만 유지하고 전반부는 삭제. 핵심 맥락은 유지하면서 토큰 사용량을 즉시 절반으로 줄입니다.

🛠 설치 방법 (ykdojo dx 플러그인):

claude plugin marketplace add ykdojo/claude-code-tips
claude plugin install dx@ykdojo

---

4. /context로 토큰 사용량 진단

/context 명령어를 통해 무엇이 공간을 많이 차지하는지 파악하고 최적화하세요.

• Conversation History: 비중이 높다면 HANDOFF.md 후 /clear 수행
• MCP Servers: 사용하지 않는 도구는 /mcp로 비활성화 (80개 미만 유지 권장)
• Memory Files: CLAUDE.md의 불필요한 설명을 제거하여 슬림하게 유지

---

5. realpath로 정확한 경로 지정

디렉토리 구조가 복잡할 때 상대 경로(../../)는 Claude를 혼란스럽게 합니다. 절대 경로를 사용해 실수를 방지하세요.

❌ 나쁜 예시: ../../config/database.ts 확인해줘

✅ 좋은 예시:

1. !realpath ../../config/database.ts 명령어로 절대 경로 확인
2. @/Users/project/config/database.ts 이 파일을 확