Recall — Claude Code를 위한 완전 로컬 프로젝트 메모리 도구

Who Should Read

Claude Code를 구독해서 쓰는데 매 세션마다 프로젝트 배경을 다시 설명하느라 토큰을 낭비하고 있는 개발자. 특히 여러 프로젝트를 컨텍스트 스위칭하며 작업하는 경우에 유용하다.

Core Mechanics

• Claude Code는 세션 간 메모리가 없어서 매번 '콜드 스타트' 상태로 시작한다. Recall은 이 문제를 해결하기 위해 세션 로그를 로컬에 저장하고, 파이썬 기반 알고리즘으로 요약해 다음 세션에 주입한다.
• 요약 과정에 LLM을 전혀 사용하지 않는다. 'classical Python summarizer'로 로컬에서만 처리하기 때문에 요약 자체에 토큰이 소모되지 않는다.
• 프로젝트 루트 아래 .recall/ 디렉토리에 두 파일을 생성한다: history.md(세션 로그 누적)와 context.md(압축 요약본, 약 1~2K 토큰 분량).
• context.md는 약 1~2K 토큰 수준으로 압축되기 때문에, 세션마다 프로젝트를 처음부터 설명하는 것보다 훨씬 적은 토큰으로 컨텍스트를 복원할 수 있다.
• 외부 API 키나 로컬 모델 설치가 전혀 필요 없다. pip install도 필요 없고, 오프라인 환경에서도 동작하며 플러그인이 로드되는 순간 바로 작동한다.
• 코드 경로, 파일 내용, 경우에 따라 시크릿 등 민감한 정보가 포함될 수 있는 세션 트랜스크립트가 외부로 전송되지 않는다. 대부분의 '메모리' 도구들이 컨텍스트를 외부 API 엔드포인트로 전송하는 것과 대비된다.
• Claude Code 플러그인 형태로 동작하며 .claude-plugin 설정 파일을 통해 프로젝트에 통합된다. GitHub 저장소에는 벤치마크, 테스트, 훅 스크립트 등이 포함되어 있다.

Evidence

• 많은 댓글 참여자들이 'CLAUDE.md나 AGENTS.md가 이미 같은 역할을 한다'는 의견을 냈다. 실제로 Claude.md 파일에 프로젝트 컨텍스트를 정리해두고 에이전트가 작업 완료 시 자동으로 업데이트하게 하면 충분하다는 경험담이 여럿 공유됐다.
• 한 유저는 status_docs/ 폴더에 날짜별 마크다운 파일(예: 2026_06_21_status.md)을 만들어 LLM이 직접 작성하고 업데이트하게 하는 방식을 1년 이상 써왔다고 공유했다. 새 세션에서 가장 최근 상태 파일을 가리키면 빠르게 컨텍스트를 복원할 수 있어 여러 프로젝트를 오가는 상황에서 특히 효과적이라고 했다.
• '프로젝트 메모리에서 진짜 어려운 건 더 많이 저장하는 게 아니라 나중에 무엇을 믿지 말아야 할지 판단하는 것'이라는 날카로운 지적이 있었다. 오래된 계획이나 실패한 디버깅 시도가 조용히 에이전트를 오염시킬 수 있다는 우려다.
• PC가 완전히 망가진 경험을 가진 유저는 코드가 GitHub와 OneDrive에 있었음에도 새 PC에서 Claude를 다시 세팅하는 데 상당한 시간이 걸렸다며, 이런 도구의 필요성에 공감했다.
• Deepseek를 쓰는 유저는 마일스톤마다 직접 state.md를 생성하고 편집하는 방식을 쓰고 있다며, Recall의 접근법에 대해 '프라이버시 우선, 비용 최소화, 객관적 시맨틱 마커로 핵심 내용을 추려내는 점이 흥미롭다'고 평가했다. 다만 막다른 골목에 들어갔다 되돌아온 시도들이 요약에 포함될 경우 오히려 노이즈가 될 수 있다는 우려도 함께 제기했다.

How to Apply

• 매일 여러 프로젝트를 오가며 Claude Code를 쓰고 있다면, Recall을 도입하기 전에 먼저 CLAUDE.md 파일에 프로젝트 핵심 컨텍스트를 정리하고 에이전트에게 작업 완료 시 해당 파일을 업데이트하도록 지시하는 방식을 먼저 시도해볼 수 있다. 이것만으로도 Recall이 해결하려는 문제의 상당 부분을 커버할 수 있다.
• 외부 API로 컨텍스트를 보내는 게 부담스러운 보안 민감 프로젝트(내부 코드베이스, 환경 변수 포함 설정 파일 등)에서 세션 메모리가 필요하다면, Recall을 적용하면 데이터가 외부로 나가지 않으면서도 세션 간 컨텍스트를 유지할 수 있다.
• Recall 없이 수동으로 비슷한 효과를 내고 싶다면, status_docs/ 같은 폴더에 날짜별 상태 파일을 만들고 세션 종료 전 LLM에게 해당 파일을 업데이트하게 하는 워크플로우를 적용할 수 있다. 다음 세션 시작 시 최신 상태 파일을 컨텍스트로 주입하면 된다.
• Obsidian 기반 문서 볼트를 프로젝트 레포 안에 두고 obsidian-cli로 Claude가 읽고 쓸 수 있게 연결하면, 새 세션에서 빈 컨텍스트로 시작해도 몇 문장만으로 LLM이 필요한 정보를 스스로 찾아오는 수준의 메모리 시스템을 구축할 수 있다.

Terminology

관련 논문

• Oak – AI 에이전트를 위해 설계된 Git 대안 VCS

  AI 에이전트가 코드 작업을 더 효율적으로 수행할 수 있도록 설계된 새로운 버전 관리 시스템(VCS)으로, lazy mount, JSON-first CLI, 멀티 레포 에이전트 워크스페이스 등을 제공한다. 다만 커뮤니티에서는 Git 대비 실질적 우위가 충분히 증명되지 않았다는 회의적 반응이 많다.

• Show HN: 거절 대신 펜 테스트를 수행하도록 post-training한 모델

  Kimi K2.6 모델을 post-training해서 보안 거부 응답 없이 실제 취약점 스캔과 펜 테스트를 수행하는 CLI 도구 ArgusRed를 공개했다. 오픈 모델을 조금만 조정하면 AI 기반 해킹 도구를 누구나 만들 수 있다는 점에서 보안 커뮤니티에 논란이 되고 있다.

• LedgerAgent: Policy를 준수하는 Tool-Calling 에이전트를 위한 구조화된 State 관리

  고객서비스 AI 에이전트가 정책을 위반하는 tool call을 실행 전에 차단하는 '원장(Ledger)' 기반 상태 관리 방법론

• Sovereign Execution Broker: AI 에이전트의 클라우드 인프라 변경을 Certificate로 강제 통제하는 런타임 경계

  LLM 에이전트가 AWS/K8s를 직접 건드리지 못하게, 모든 인프라 변경을 암호화 인증서로 묶어 중간 브로커가 강제 검증하는 보안 아키텍처.

• Data Intelligence Agents:자율 Coding Agent로 엔터프라이즈 데이터 해석·모델링·쿼리하기

  SQL 한 줄 못 써도 CSV 올리면 DB 만들고 자연어 질문에 SQL 자동 생성·검증까지 해주는 3-에이전트 시스템, 7개 벤치마크 모두 SOTA 달성.

• TREX: 코드를 직접 실행하는 AI 코드 리뷰어

  Greptile가 PR 리뷰 시 코드를 실제로 실행해서 런타임 버그까지 잡아주는 TREX를 공개했다. 정적 분석만으로는 발견할 수 없는 race condition, UI 회귀, 상태 의존 로직 버그까지 커버한다.

Related Resources

• raiyanyahya/recall GitHub 저장소 (원본)
• arjunkmrm/recall (댓글에서 언급된 유사 프로젝트)