Recall은 Claude Code 세션을 프로젝트 안에 로컬 Markdown으로 기록하고, 다음 세션에서 읽을 요약 컨텍스트를 만들어 주는 플러그인이다. 외부 API나 별도 LLM summarizer를 쓰지 않고, 고전적인 Python summarizer로 .recall/context.md를 생성한다.
어떤 문제를 푸는가
Claude Code의 --continue/--resume은 이전 대화를 다시 불러올 수 있지만 긴 transcript를 그대로 싣기 때문에 토큰 비용이 커질 수 있다. CLAUDE.md는 사람이 직접 관리하는 규칙·메모에 적합하지만, 실제 세션에서 무엇을 했는지 자동 기록하지 않는다.
Recall은 그 사이를 채운다.
| 파일 | 역할 |
|---|---|
.recall/history.md | 세션 중 프롬프트, 답변, touched files, commands를 append-only로 기록 |
.recall/context.md | 다음 세션에 읽힐 goal, summary, next steps, open threads 요약 |
작동 방식
Stop/SessionEndhooks가 세션 활동을 history에 추가한다.SessionStarthook이 저장된 context를 이어받을지 묻는다.- 사용자가
/recall:save를 실행하거나auto_save_context: "on_end"를 켜면 context가 재생성된다. - 비밀값 형태는 redaction으로 제거하는 옵션을 제공한다.
어디에 적합한가
- Claude Code를 subscription 기반으로 쓰며 매번 프로젝트 설명을 반복하고 싶지 않은 사용자
- 팀과 공유 가능한 plain text 작업 기록이 필요한 프로젝트
- 외부 memory API에 코드·경로·비밀이 섞인 transcript를 보내고 싶지 않은 환경
- 긴 작업을 여러 날에 걸쳐 이어가되 전체 대화 replay 비용을 줄이고 싶은 경우
관련 문서
- claude-code — Claude Code 개요
- claude-mem — Claude Code 세션 간 기억을 압축·주입하는 메모리 플러그인
- stash — AI 에이전트를 위한 셀프호스팅 영속 메모리 레이어
참고 자료
- raiyanyahya/recall — GitHub 공식 저장소