FEATURE ARTICLE
claude-mem - Claude Code 영구 메모리
Claude Code를 위한 1줄 설치 메모리 시스템. 세션 간 컨텍스트 손실 방지. AI로 대화 압축 후 ChromaDB에 벡터 저장, 다음 세션에 자동 주입. 로컬 저장으로 프라이버시 보장. GitHub 12k 스타.
핵심 컨셉
Claude Code를 위한 영구 메모리 시스템. 세션이 끝나도 컨텍스트가 사라지지 않음. AI로 대화를 압축하고, 다음 세션에 관련 컨텍스트를 자동 주입.
주요 기능
- 자동 컨텍스트 캘처: Claude가 하는 모든 작업 기록
- AI 압축: Claude agent-sdk로 대화 압축
- 시맨틱 검색: ChromaDB 벡터 임베딩으로 과거 세션 검색
- 자동 주입: 새 세션 시작 시 관련 컨텍스트 자동 로드
- Smart Trash: 삭제된 데이터 복구 가능
- 세션 재개: SDK 세션 ID로 대화 재개 가능
아키텍처
| 컴포넌트 | 설명 |
|---|---|
| 5개 라이프사이클 훅 | SessionStart → UserPromptSubmit → PostToolUse → Summary → SessionEnd |
| Worker Service | Express API (port 37777), Bun 관리 |
| 데이터베이스 | SQLite (~/.claude-mem/claude-mem.db) |
| 벡터 저장소 | ChromaDB |
| Viewer UI | React (http://localhost:37777) |
설치
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem
# Claude Code 재시작
설치 후 이전 세션의 컨텍스트가 자동으로 새 세션에 나타남.
설정
~/.claude-mem/settings.json에서 구성:
- AI 모델
- Worker 포트
- 데이터 디렉토리
- 로그 레벨
- 컨텍스트 주입 설정
프라이버시
- 로컬 전용 저장: 모든 데이터가 내 컴퓨터에만 저장
- 영구 무료: 외부 API 비용 없음
프로젝트 정보
- GitHub: 12k 스타, 759 포크
- 라이선스: AGPL-3.0
- 제작자: Alex Newman (@thedotmack)
- 공식 문서: docs.claude-mem.ai