Cmd. /compact
긴 컨텍스트를 요약·압축하여 세션 품질을 유지하는 명령
명령어 원본 선언
/compact [focus-topic]공식 설명 요약
/compact는 긴 대화 컨텍스트를 요약·압축해 세션의 응답 품질과 속도를 유지하는 명령입니다.
컨텍스트 윈도우가 커지면서 발생하는 성능 저하를 방지하는 핵심 도구입니다.
Improved
/compact: preserves images in summarizer request for prompt cache reuse. Resuming after compaction no longer produces preamble recap.
최소 지원 버전
- 초기 내장(legacy) 명령
v2.1.69: 이미지 보존 개선, compaction 후 resume 시 preamble 생략, VS Code에서 접을 수 있는 "Compacted chat" 카드 표시v2.1.72:--continue가 compact 후 가장 최근 지점에서 재개되지 않는 문제 수정
사용법
/compact특정 주제에 초점을 맞추어 압축할 수도 있습니다:
/compact auth 리팩터링/compact API 마이그레이션 진행 상황좋은 사용 예
- 긴 디버깅 세션 중 컨텍스트가 비대해졌을 때 핵심만 보존
- 특정 주제(예:
auth 리팩터링)에 집중하여 관련 없는 맥락 제거 - 응답 속도가 느려졌을 때 컨텍스트 크기 최적화
--continue로 재개하기 전 컨텍스트 정리- compact 뒤 session recap으로 복귀 비용 줄이기
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/compact | 컨텍스트 요약·압축 | 세션 품질 유지·속도 개선 |
/clear | 대화 완전 초기화 | 처음부터 새로 시작 |
/context | 컨텍스트 파일 관리 | 참조 파일 추가·제거 |
활용 사례
- 장시간 페어 프로그래밍 세션에서 주기적으로 컨텍스트 정리
- 대규모 리팩터링 작업 중 단계별로 이전 맥락 압축
- 응답에서 hallucination이 느껴질 때 컨텍스트 리프레시
주의사항
- compact 후에는 이전 대화의 세부 내용에 접근할 수 없음 — 중요한 결정사항은 미리 메모리(
/memory)에 저장 - focus topic을 지정하면 해당 주제 외의 맥락이 더 많이 제거되므로 의도적으로 사용
- v2.1.69 이상에서는 이미지가 보존되어 prompt cache 재사용 효율이 향상됨
- VS Code에서는 압축된 내용이 접을 수 있는 "Compacted chat" 카드로 표시됨
- compact 직후
--continue사용 시 v2.1.72 이상 권장 (이전 버전에서는 최근 지점 복원 버그 있음) - 최신 릴리스에서는 compact 뒤 session recap이 기본 경로에 더 넓게 쓰이므로, 중요한 의사결정은 요약이 아니라 메모리/문서에 남기는 편이 안전