🚀 Claude Code /compact 고급 활용 가이드

 

2025.08.07 - [AI] - Claude 토큰 절약 완전 가이드 💰

Claude 토큰 절약 완전 가이드 💰

이전 토큰 절약 가이드에 이어서, 조금 더 상세하게 Compact를 활용하는 방법에 대한 포스팅입니다.

부제 : 토큰 효율과 생산성을 동시에 잡는 법

 

Claude Code를 쓰다 보면, 대화가 길어지고 컨텍스트가 쌓이면서 모델의 이해도가 떨어지거나 응답 속도가 느려지는 경험을 하게 됩니다. 이럴 때 /compact 명령은 필수 무기입니다.
이번 글에서는 /compact를 단순한 압축 명령이 아닌 전략적 툴로 활용하는 고급 테크닉과 예제들을 다룹니다.

 

1. /compact 기본 개념

/compact는 현재 세션의 대화 내용과 코드를 압축하여 토큰 점유를 줄이고, Claude가 이전 맥락을 잃지 않으면서도 더 빠르고 효율적으로 반응하게 합니다.

# 기본 사용법
/compact

 

기본 실행 시:

• 불필요한 설명과 중복 내용을 제거
• 코드의 의미를 유지하며 간결하게 변환
• 대화 내 결정 사항을 핵심만 남김

---

2. 정밀한 컨텍스트 압축

고급 옵션을 사용하면 압축 수준과 범위를 세밀하게 조정할 수 있습니다.

 

# 압축 레벨 지정 (1: 최소, 3: 최대)
# 레벨 1: 불필요한 공백/중복만 제거
# 레벨 3: 주석, 변수명 축소까지 진행
/compact --level 2

# 주석 유지 옵션
/compact --level 3 --keep-comments

# 특정 파일만 압축
/compact --file src/api/client.ts

 

💡 활용 팁

• 레벨 1: 디버깅 중 세션 유지가 필요할 때
• 레벨 2: 일반적인 기능 개발 중간 정리
• 레벨 3: 배포 전 코드/대화 전체를 최소화

---

3. 자동 압축 끄고 수동 타이밍 제어

기본 자동 압축(auto-compact)은 장점도 있지만,
개발 중 중요한 대화 흐름이 끊기거나 불필요한 요약이 발생할 수 있습니다.

# 자동 압축 비활성화
/settings compact auto off

 

추천 워크플로우

1. 큰 기능을 한 단위(모듈/컴포넌트)로 개발
2. 해당 단위가 끝날 때 /compact --level 2 실행
3. 다음 작업으로 넘어가기 전 /save로 백업

---

4. CLAUDE.md와 병행 사용

CLAUDE.md는 프로젝트 규칙, 아키텍처 설명, API 문서 등을 담아두는 파일로, Claude가 세션마다 참조할 수 있는 프로젝트 브레인 역할을 합니다.

# CLAUDE.md 예시
# 프로젝트 전역 규칙
- 변수명: camelCase
- 컴포넌트명: PascalCase
- API 요청: ofetch 사용, 에러 인터셉터 적용

 

활용법

• 중요한 결정 사항은 /compact 후 CLAUDE.md에 추가
• 새 세션 시작 시 CLAUDE.md 자동 로드 설정
• 장기 컨텍스트 유지 + 토큰 절약 효과

---

5. 모델 전환 전략과 토큰 효율

복잡한 설계 논의는 opus-4,
간단한 코드 수정·리팩터링은 sonnet-4 모델을 활용하면 비용과 성능을 최적화할 수 있습니다.

# 모델 전환
/model opus-4
/model sonnet-4

 

💡 /compact를 통해 토큰 점유를 줄여두면 모델 전환 시 이전 대화 유지 가능성이 높아집니다.

---

6. 워크플로우 분할 + 병렬 세션

• 하나의 거대한 기능을 여러 세션으로 쪼개 개발
• 각 세션 종료 시 /compact + /save 실행
• Git worktree나 브랜치별 Claude 세션 병행 가능

# 기능 1 세션
/compact --level 2
/save feature-1.json

# 기능 2 세션
/compact --level 2
/save feature-2.json

---

📌 /compact는 "청소"가 아니라 "정리"다

많은 사람들이 /compact를 단순한 대화 줄이기 도구로 생각합니다.

하지만 실제로는 프로젝트 문맥을 잃지 않고 유지하는 설계 전략입니다.
이 글에서 다룬 기법들을 적용하면, Claude Code와의 협업 효율이 눈에 띄게 향상될 것입니다.