Recall: Claude Code용 로컬 프로젝트 메모리

Recall: Claude Code용 로컬 프로젝트 메모리

Recall은 Claude Code용 완전 로컬 프로젝트 메모리 플러그인으로, 사용자가 매 세션마다 프로젝트 컨텍스트를 다시 설명해야 하는 "콜드 스타트" 문제를 해결합니다. 활동 로그를 로컬에 유지하고 이를 이력서용 요약으로 압축함으로써, Recall은 개발자가 모델 토큰을 낭비하거나 프라이버시를 손상시키지 않고 작업을 재개할 수 있게 합니다.

로컬 요약 및 토큰 효율성

Recall은 외부 LLM이나 API 키 없이도 지속 가능한 메모리를 제공합니다. TF‑IDF와 TextRank를 결합한 고전적인 Python 기반 추출 요약 알고리즘을 사용해 세션에서 가장 핵심적인 문장을 식별합니다. 이 접근 방식은 프로젝트 메모리를 업데이트하는 데 모델 토큰을 전혀 사용하지 않음을 보장합니다.

세션을 재개할 때 Recall은 전체 대화 기록을 재생하는 대신 일반적으로 1–2K 토큰 규모의 context.md 파일을 로드합니다. 이는 토큰 소비를 크게 줄여 구독 사용 한도를 늘리거나 API 비용을 낮춥니다.

Recall이 프로젝트 메모리를 관리하는 방법

Recall은 프로젝트 루트의 .recall/ 디렉터리 안에 두 개의 주요 파일을 사용합니다:

  • history.md: 세션마다 프롬프트, AI 응답, 수정된 파일, 실행된 명령 등을 캡처하는 추가 전용 로그.
  • context.md: 프로젝트 목표, 진행 상황 요약, 다음 단계, 열려 있는 스레드, 최근 변경 사항의 git diff --stat 등을 포함한 압축 요약.

운영 워크플로우

단계 동작
세션 중 Stop 및 SessionEnd 훅이 새로운 활동을 history.md에 점진적으로 추가합니다.
세션 시작 SessionStart 훅이 context.md를 표시하고 사용자가 저장된 컨텍스트에서 재개하고 로그를 계속 기록할지 묻습니다.
세션 마무리 사용자가 /recall:save를 실행해 로컬 요약기를 트리거하거나, auto_save_context가 "on_end" 로 설정된 경우 자동으로 수행됩니다.

내장 Claude Code 메모리와의 비교

Recall은 기존 Claude Code 기능을 대체하기보다 보완합니다. 수동 지시와 전체 대화 재생 사이의 격차를 메웁니다.

기능 CLAUDE.md / # --continue / --resume Recall
성격 손으로 작성한 규칙/노트 전체 대화 재생 자동 캡처 로그 + 로컬 요약
유지 관리 수동 없음 자동
내용 따를 지시사항 전체 이전 대화 목표, 파일, 명령, 다음 단계
재개 비용 작음 큼 (토큰 많이 소모) 작음 (~1–2K 토큰)
포맷 편집 가능한 Markdown 로컬 세션 상태 .recall/ 내 평문
Claude의 처리 방식 지시사항으로 대화로 신뢰할 수 없는 참조 데이터로

프라이버시 및 보안 아키텍처

Recall은 "제로 네트워크" 아키텍처로 설계되었습니다. 네트워크 호출을 전혀 하지 않으며, API 키가 필요 없고, 제3자 모델을 로드하지도 않습니다. 모든 처리는 사용자의 로컬 머신에서 이루어집니다.

보안 조치

  • 비밀 정보 마스킹: 최선의 노력으로 일반적인 비밀 형태(API 키, PEM 키, .env 할당 등)를 디스크에 기록하기 전에 제거합니다.
  • 강화된 Git 통합: 악성 레포지토리가 git config를 통해 코드를 실행하는 것을 방지하기 위해 git diff와 log를 core.fsmonitor, diff.external, 훅 비활성화 상태에서 실행합니다.
  • 제한된 쓰기: output_dir은 프로젝트 디렉터리로 제한되어 절대 경로나 상위 디렉터리로의 무단 쓰기를 방지합니다.
  • 신뢰 경계: context.md가 레포지토리에 커밋될 수 있기 때문에 신뢰할 수 없는 데이터로 취급합니다. Claude에게 이 경계를 알리고, 저장된 컨텍스트를 사용할 때 사용자의 확인을 요구합니다.

설치 및 구성

Recall은 Claude Code 마켓플레이스를 통해 설치할 수 있습니다:

/plugin marketplace add raiyanyahya/recall
/plugin install recall@recall

주요 구성 옵션 (recall.config.json)

  • auto_save_context: 세션 종료 시 요약을 자동으로 재생성하려면 "on_end" 로 설정합니다.
  • summary_sentences: 추출 요약기가 유지할 문장 수를 제어합니다(기본값은 8).
  • include_git: context.md 파일에 git diff --stat와 최근 커밋을 포함할지 토글합니다.
  • redact: 로그에서 비밀 정보를 제거할지 여부를 설정합니다.

SUMMARY:

Recall은 세션을 자동으로 기록하고 로컬 Python 요약기를 사용해 압축된 토큰 효율적인 컨텍스트 다이제스트를 생성함으로써, Claude Code용 완전 로컬 플러그인으로 지속 가능한 프로젝트 메모리를 제공합니다.

TITLE:

Recall: Claude Code용 로컬 프로젝트 메모리

Sources