원문 캡처 · github.com
원문 캡처 · github.com

Claude Code 플러그인 claude-handoff-revive는 사용량 한도에 걸린 뒤 이전 대화 전체를 다시 불러오는 대신, 작업 요약 파일을 저장해 새 세션에서 이어가도록 돕는다. 제작자는 재개에 필요한 토큰을 기존 방식의 수만 개(긴 세션은 10만 개 이상)에서 약 1,000~3,000개로 줄인다고 설명한다.

플러그인은 목표, 완료·진행 중·미착수 작업, 다음 행동, 수정한 파일과 설계 결정 등을 .claude/handoff/current.md에 기록한다. 한도에 가까워졌을 때 /handoff-revive:save로 저장하고, 한도가 초기화되면 --resume을 쓰지 않고 새 세션을 연 뒤 /handoff-revive:resume을 실행하는 방식이다.

Claude Code 안에서 다음 명령으로 플러그인을 설치할 수 있다.

text
/plugin marketplace add sofumel/claude-handoff-revive
/plugin install handoff-revive@handoff-revive-marketplace

플러그인 기능을 지원하지 않는 환경에서는 저장소의 설치 스크립트를 사용할 수 있다. 수동 설치에서는 필요에 따라 HOOK_SETUP.md의 설정을 .claude/settings.json에 병합해야 한다.

사용량 90%에서 자동 저장하고 95%에서 긴급 알림과 함께 다시 저장하는 기능도 제공한다. 자동 저장은 세션별로 끄거나 환경 변수로 영구 비활성화할 수 있다. 이 기능과 턴 수 기반 저장 알림은 설정으로 조정할 수 있다.

제작자 설명에 따르면 데이터는 로컬에서 처리되며, 사용자가 /handoff-revive:share-to-pr을 실행하지 않는 한 외부로 전송되지 않는다. PR 공유 전에는 이메일과 절대 경로를 정리하고 알려진 형식의 키·토큰을 검사하지만, 일반 비밀번호나 접두사 없는 무작위 문자열은 감지하지 못하므로 미리보기를 확인해야 한다. 저장소는 MIT 라이선스로 공개됐다: claude-handoff-revive.