handoff-compact, autocompact가 실행될 때마다 handoff + /clear 루틴을 자동으로 수행해 주는 모드
handoff-compact, a mod that does the handoff + /clear routine for you every time autocompact fires
핵심 요약
Claude Code의 autocompact 시 handoff와 /clear를 자동화하여 컨텍스트 관리 효율을 높이는 모드 소개.
- 자동화 모드 — autocompact 트리거 시 handoff와 /clear 루틴을 자동으로 실행함.
- 컨텍스트 최적화 — 긴 세션에서 불필요한 토큰 사용을 줄이고 컨텍스트 오염을 방지함.
- 커스텀 제어 — 기존 요약 기능보다 상세한 상태 정보와 다음 단계를 포함한 문서로 세션을 전환함.
- 설치 방법 — Claude Code 2.1.287+ 버전에서 플러그인 명령어로 설치 가능함.
난 Claude Code로 긴 세션을 자주 돌리는데, 측정해보니까 토큰 절반이 컨텍스트 200k 넘은 상태에서 나오더라. 매 단계마다 컨텍스트 전체를 다시 보내니까 돈도 엄청 깨지고, 컨텍스트 오염 때문에 성능도 씹창남.
수동으로 해결하려면 뻔하지. 핸드오프 요청하고, /clear 때리고, 다시 먹여주는 거. 200k에서 autocompact 켜면 컨텍스트는 짧아지는데, 뭘 넘길지 통제가 안 됨. Claude Code가 autocompact 걸리기 전에 훅 써서 핸드오프 문서 쓰게도 해봤는데, 모딩하니까 훨씬 낫더라.
Handoff-compact는 내장 요약기 대신 autocompact 트리거를 가로챔. 세션 포크(전체 컨텍스트)가 핸드오프 문서(목표, 현재 상태와 근거, 다음 단계, 결정 사항과 이유, 배제한 접근법, 미해결 질문, 파일 및 커밋, 검증 명령어, 마지막 프롬프트 10개 원문)를 작성하고, 대화 내용을 이걸로 싹 갈아치움. 사람이 키보드 앞에 없어도 세션 중간에 핸드오프 + /clear를 알아서 해주는 거임.
당연히 대충 감으로 짠 거니까, 아이디어나 모드 가져다가 니 환경에 맞게 알아서 커스텀해라.
모딩은 진짜 신이야.
설치:
/plugin marketplace add trytofly94/handoff-compact
/plugin install handoff-compact@handoff-compact
저장소: https://github.com/trytofly94/handoff-compact (MIT). Claude Code 2.1.287 이상 버전에서 모드 활성화해야 돌아감. "/compact classic" 치면 내장 요약 기능 한 번 쓸 수 있음.
