Claude Code는 세션이 끊기면 이전 작업 맥락을 잃는다. 같은 코드베이스에서 내일 다시 작업을 시작하면 어제 결정한 내용, 탐색한 파일, 발견한 패턴을 처음부터 다시 설명해야 한다. claude-mem은 이 문제를 해결하는 Claude Code 플러그인으로, 코딩 세션 중 Claude가 수행한 모든 것을 자동으로 캡처하고, Claude Agent SDK를 사용해 AI로 압축한 뒤, 다음 세션 시작 시 관련 컨텍스트를 자동으로 다시 주입한다. GitHub ★72,079를 기록했다.
동작 원리
세션 진행 중
↓ Claude가 파일 탐색·편집·결정·논의를 수행
↓ claude-mem이 모든 활동을 자동 캡처
세션 종료
↓ Claude Agent SDK로 캡처된 내용을 AI 압축
↓ 압축된 메모리를 영속 저장소에 기록
다음 세션 시작
↓ claude-mem이 현재 작업과 관련된 메모리를 조회
↓ 관련 컨텍스트를 Claude 세션에 자동 주입
→ Claude가 이전 작업 맥락을 이해한 상태로 작업 재개주요 특징
- 자동 캡처: 세션 중 별도 설정 없이 모든 활동 기록
- AI 압축: Claude Agent SDK 사용 — 중요한 내용은 유지하고 불필요한 반복은 제거
- 관련성 기반 주입: 전체 히스토리를 덤프하지 않고 현재 작업과 관련된 메모리만 선별해 주입
- 다국어 문서: 30개 이상 언어 README 제공
설치 (Claude Code)
# npm 전역 설치
npm install -g claude-mem
# 또는 Claude Code 플러그인으로 직접 설치
/plugin install claude-mem버전: 6.5.0 | 라이선스: AGPL 3.0 | Node.js 18+ 필요
누구에게 유용한가?
- 장기 프로젝트에서 Claude Code를 반복 사용하는 개발자: 매 세션마다 코드베이스 컨텍스트를 다시 설명하는 시간을 절약한다.
- 복잡한 코드베이스를 탐색하는 팀: Claude가 이미 파악한 아키텍처·패턴·결정사항을 기억해 중복 탐색을 줄인다.
- AI 에이전트 세션 연속성이 중요한 장시간 작업: 며칠·몇 주에 걸친 작업에서 컨텍스트 단절 없이 진행한다.
유사 도구와의 차이
| 도구 | 방식 | 특징 |
|---|---|---|
| claude-mem | 자동 캡처 + AI 압축 | Claude Code 전용, 제로 설정 |
| auto-memory | 수동 + 자동 메모리 관리 | 제로 의존성 CLI |
| mem0 | 범용 메모리 레이어 API | 다중 에이전트·앱 공유 메모리 |
| stash | Postgres + pgvector | 셀프호스팅 영속 메모리 |
라이선스
AGPL 3.0
관련 도구
- auto-memory — AI 코딩 에이전트에 세션 간 기억 능력을 추가하는 제로 의존성 CLI
- mem0 — AI 에이전트용 범용 메모리 레이어
- stash — Postgres + pgvector 기반 셀프호스팅 메모리 레이어
- claude-agent-sdk — Claude Agent SDK 런타임 활용
- context-mode — 컨텍스트 윈도우 98% 절약 MCP 서버
관련 문서
- claude-code-tips-plugin-stack — claude-mem·Superpowers·Everything Claude Code를 함께 설정하는 플러그인 스택 가이드
참고 자료
- thedotmack/claude-mem — GitHub 공식 저장소