🗜️

/compact — 컨텍스트 압축

Claude Code

대화 컨텍스트를 압축하여 토큰 절약

/compact는 현재까지의 대화 내용을 Claude가 자동으로 요약·압축하는 명령입니다.

왜 필요한가?

Claude Code는 대화가 길어질수록 컨텍스트 윈도우(토큰 한도)에 가까워집니다. 한도에 도달하면 초기 대화 내용이 잘리거나, 응답 품질이 저하될 수 있습니다. /compact를 실행하면 지금까지의 대화를 핵심만 남기고 압축하여, 새 세션을 시작하지 않고도 작업을 이어갈 수 있습니다.

사용 타이밍

  • 긴 디버깅 세션 후 다른 작업으로 전환할 때

  • 여러 파일을 수정한 뒤 컨텍스트가 무거워졌을 때

  • Claude가 이전 지시를 잊기 시작했다고 느낄 때

  • 상태 표시줄에서 남은 컨텍스트가 적어졌을 때

커스텀 프롬프트

/compact <프롬프트>로 압축 시 특정 내용을 강조할 수 있습니다.

/compact 현재 진행 중인 리팩토링 작업에 집중해서 요약해줘

이렇게 하면 Claude가 해당 맥락을 우선적으로 보존합니다.

사용 방법

1

/compact 입력 — 대화 전체를 자동 요약·압축

2

/compact <프롬프트> — 특정 맥락을 강조하며 압축 (예: /compact DB 마이그레이션 작업 위주로)

3

압축 후에도 핵심 결정사항, 변경 파일 목록, 현재 작업 상태는 유지됨

4

새 세션 시작(/clear)과 달리 작업 흐름이 끊기지 않음

Tags

#compact #context #compression #token #efficiency

Source

Anthropic Docs