claude-mem 소개
claude-mem은 Anthropic의 CLI 도구인 Claude Code를 위해 설계된 오픈 소스 플러그인으로, 세션 간의 영구적인 기억(Persistent Memory) 기능을 제공합니다. 기본적으로 Claude Code는 대화 세션이 종료되거나 /clear 명령어를 사용하면 이전 대화의 문맥(Context)을 모두 잊어버리는, 즉, 상태 값을 저장하지 않는 'Stateless' 특성을 가집니다. claude-mem은 이 문제를 해결하기 위한 목적으로 개발된 도구로, Claude가 사용자의 프로젝트, 코딩 스타일, 이전 작업 내역을 기억하고 이를 다음 세션에 자동으로 연동해 줍니다.
또한, claude-mem은 단순히 대화 로그를 저장하는 것을 넘어, Claude의 Agent SDK를 활용하여 중요 정보를 압축하고 요약하여 저장합니다. 덕분에 수천 줄의 로그를 매번 다시 읽어들이는 비효율을 줄이고, 토큰 비용을 절약하면서도 프로젝트의 연속성을 유지할 수 있습니다. 사용자가 "지난번에 우리가 어디까지 작업했지?"라고 물으면, claude-mem은 저장된 기억을 검색하여 즉시 답변하고 작업을 이어갑니다.
주요 특징으로는 완전 자동화된 문맥 주입(Context Injection), 로컬 웹 뷰어(Web Viewer) 제공, 그리고 프라이버시 중심의 로컬 저장 방식이 있습니다. 모든 데이터는 사용자의 로컬 머신(~/.claude-mem)에 저장되며, 외부 서버로 전송되지 않아 보안이 중요한 개발 환경에서도 안심하고 사용할 수 있습니다.
claude-mem의 주요 기능
┌─────────────────────────────────────────────────────────────┐
│ Session Start → Inject recent observations as context │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ User Prompts → Create session, save user prompts │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ Tool Executions → Capture observations (Read, Write, etc.) │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ Worker Processes → Extract learnings via Claude Agent SDK │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ Session Ends → Generate summary, ready for next session │
└─────────────────────────────────────────────────────────────┘
자동화된 기억 수집 및 주입 (Automatic Memory)
claude-mem은 Claude Code의 수명 주기(Lifecycle) 훅(Hook)을 사용하여 작동합니다. 별도의 명령어를 입력하지 않아도 백그라운드에서 다음 작업들을 수행합니다:
- 관찰(Capture): 도구 사용(Tool Use) 결과를 캡처합니다.
- 압축(Compress): 세션이 종료되거나 중단될 때, AI를 사용하여 대화 내용을 '요약(Summary)'과 '관찰(Observation)' 형태로 압축 저장합니다.
- 주입(Inject): 새로운 세션이 시작되면, 최근 요약과 관련 정보를 자동으로 Claude의 컨텍스트에 밀어 넣습니다.
로컬 웹 뷰어 (Web Viewer UI)
claude-mem을 설치한 다음, http://localhost:37777 에 접속하면 현재 claude-mem이 기억하고 있는 데이터 스트림을 실시간으로 확인할 수 있습니다:
- 실시간 업데이트: Claude가 생각하고 기억하는 과정을 시각적으로 보여줍니다.
- 프로젝트 관리: 저장된 기억을 프로젝트별로 구분하여 볼 수 있습니다.
- 상태 모니터링: 현재 대기 중인 메시지 수나 SDK 생성기 상태 등을 배지(Badge) 형태로 확인할 수 있습니다.
강력한 검색 기능 (Mem-Search Skill)
단순한 키워드 매칭이 아닌, 의미 기반 검색(Semantic Search)과 필터링을 지원하는 툴을 제공합니다. 사용자가 자연어로 질문하면 Claude가 알아서 아래와 같은 도구들을 호출합니다:
- Search Observations: 모든 관찰 기록에 대한 전체 텍스트 검색 (FTS5 활용).
- Search Sessions: 세션 요약본 검색.
- By Concept: 특정 개념(버그 수정, 기능 추가, 디자인 패턴 등) 태그로 검색.
- By File: 특정 파일과 관련된 기억 검색.
프라이버시 및 제어 (Privacy Control)
- Dual-Tag System:
<private>태그를 사용하여 특정 정보가 기억 저장소에 남지 않도록 세밀하게 제어할 수 있습니다. - Local Only: 모든 데이터는 사용자의 홈 디렉터리 내 SQLite DB와 파일로 저장되며 외부로 유출되지 않습니다.
claude-mem 설치 방법
claude-mem은 Claude Code 환경에서 플러그인 형태로 설치하는 것을 권장합니다. 이를 위해 Claude Code 터미널 세션 내에서 다음과 같은 플러그인 설치 명령어를 입력합니다:
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem
또는, npm을 통해 전역으로 설치 후 초기화하는 방법도 사용할 수도 있습니다:
npm install -g claude-mem
claude-mem install
설치가 완료되면 Claude Code를 재시작하세요. 이후부터는 자동으로 기억 기능이 활성화됩니다.
라이선스
claude-mem 프로젝트는 AGPL-3.0 라이선스로 공개 및 배포되고 있습니다. 즉, 이 프로젝트를 기반으로 만든 파생 저작물 또한 오픈 소스로 공개해야 함을 유의하세요.
claude-mem 프로젝트 GitHub 저장소
이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. 
파이토치 한국 사용자 모임
이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일
로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)
아래
쪽에 좋아요
를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ 