클로드 코드 핸드오프를 위한 자동화된 세션 상태 관리

Claude 세션을 위한 자동화된 컨텍스트 보존

레딧 사용자가 Claude 대화에서의 컨텍스트 저하, 특히 대화 창이 커짐에 따라 발생하는 자동 압축 및 대화 중간 컨텍스트 손실 문제를 해결하는 솔루션을 공유했습니다. 이 시스템은 수동 개입 없이 세션 전반에 걸쳐 실시간 상태 파일을 자동으로 유지합니다.

작동 방식

이 솔루션은 수동 핸드오프 명령을 확장하여 추가 훅을 통합합니다:

• UserPromptSubmit 훅은 전송되는 모든 메시지에서 실행되어 Claude의 시스템 컨텍스트에 "중요한 일이 발생했는지 확인하고, 그렇다면 session-state.md를 업데이트하라"는 지시를 주입합니다
• PostToolUse 훅은 Claude가 편집하는 파일을 추적합니다
• session-state.md가 너무 길어지면 지시가 자동으로 "재작성 모드"로 전환되어 Claude에게 중요한 정보만 유지하라고 지시합니다
• 자동 압축 전에 PreCompact 훅이 전체 상태 덤프를 강제 실행하여 아무것도 손실되지 않도록 합니다
• 세션 시작 시 이전 세션의 상태가 다시 로드됩니다

구현 세부사항

자동화 시스템은 bash와 jq 외에 의존성이 없는 약 4개의 셸 스크립트로 구성됩니다. 설치 옵션은 다음과 같습니다:

• git 서브모듈로 설치
• 훅을 .claude/hooks/ 디렉토리에 복사

시스템은 세션 전반에 걸쳐 .claude/session-state.md에 실시간 상태 파일을 유지합니다. 또한 의도적인 체크포인트를 위한 수동 /handoff 명령을 포함하며, 이는 작업 추적, 버그 조사, 저하된 컨텍스트에서의 복구에 유용합니다.

이러한 유형의 도구는 Claude와 함께 복잡한 다중 세션 프로젝트를 진행하는 개발자에게 유용하며, 대화 간 컨텍스트를 유지하는 것은 연속성을 위해 중요하고 반복을 피하는 데 필수적입니다.