catnap은 Claude Code가 대화창이 거의 찬 뒤 작업 중간에 대화를 압축하는 대신, 컨텍스트 사용량 50%부터 알림을 보내 작업을 마친 시점에 압축하도록 돕는 플러그인이다. Claude가 다음 단계를 적은 인계 메모를 만들고 압축 후 작업을 이어가므로 사용자가 직접 입력할 필요가 없다.
설치는 Claude Code v2.1.287 이상에서 가능하며, 데스크톱 앱에서는 v2.1.286도 지원한다. 새 세션은 플러그인을 자동으로 불러오지만, 이미 열린 세션에서는 /reload-plugins를 실행해야 한다.
claude plugin marketplace add LippInc/catnap
claude plugin install catnap@lippinc
설치 전 체험하거나 자신의 기록을 확인하려면 Node 18 이상 환경에서 npx github:LippInc/catnap을 실행할 수 있다. Claude Code 안에서는 /catnap:check로 확인한다. 이 도구는 로컬 로그에서 토큰 수와 타임스탬프 등 숫자만 읽으며, 메시지 내용은 읽지 않고 데이터를 전송하지 않는다고 프로젝트는 설명한다. 작업 중 언제든 /catnap:compact를 입력해 압축을 요청할 수도 있다. catnap 저장소와 설치 안내
기본 설정은 50%에서 작업을 마칠 준비를 알리고, 60%에서 압축을 재촉하며, 70%에서 Claude Code의 자동 압축을 백업으로 둔다. 제작자가 공개한 자체 실험에서는 실제 장시간 세션 9개를 기본 자동 압축과 비교했을 때 다시 읽는 컨텍스트가 33% 줄었다. 합성 코딩 작업 벤치마크에서는 기본 자동 압축보다 1M 컨텍스트 창에서 토큰을 56%, 200K 창에서 17% 적게 사용했다. 제작자는 이 절감이 주로 더 일찍 압축한 데서 나온다고 설명하며, 자동 압축을 같은 지점에 설정한 경우 작업 완료까지의 토큰 총량은 두 방식 간 측정 오차 범위에 있었다고 밝혔다. 실제 세션 재생 결과 · 작업 완료 기준 벤치마크
압축 과정에서 Claude의 인계 메모가 기본적으로 Claude Code의 요약을 대신한다. 따라서 메모에 빠진 내용은 요약이 보완해주지 않을 수 있다. 설정을 바꾸면 Claude Code의 요약을 유지할 수 있으며, 작업 상태를 파일에 저장하는 명령도 연결할 수 있다. Claude가 알림을 따라야 작동하고, 각 알림은 수백 토큰을 사용한다. 조직이 관리하는 Claude Code 환경에서는 일부 기능이 제한될 수 있으며, macOS와 VS Code 확장 등은 테스트되지 않았다. 자세한 설정과 한계는 catnap 문서에 있다.
댓글 (0)
로그인하면 이 기사에 내 생각을 남길 수 있어요