Claude-Mem — Persistent Memory for Claude Code

PERSISTENT MEMORY

Claude-Mem
Context Survives

5 Hooks · SQLite · Chroma · Web UI

Claude Code 세션을 자동 캡처하고 AI로 압축해 다음 세션에 주입. 매번 프로젝트 상태를 다시 설명할 필요가 없습니다.

59.3k

GitHub Stars

+2.3k

Today

10x

Token Savings

v6.5

Latest

▼ SCROLL

세션이 끝나면 기억이 사라진다

claude-code's amnesia problem

PROBLEM

세션마다 프로젝트 구조, 결정 이유, 최근 변경을 다시 설명

→

CLAUDE-MEM

세션 종료 시 자동 캡처 · 압축 · 다음 세션에 관련 컨텍스트 주입

PROBLEM

과거 기록을 전부 불러오면 토큰 비용 폭발

→

CLAUDE-MEM

3-레이어 progressive disclosure로 필요한 만큼만 노출

PROBLEM

지난 결정의 근거를 다시 찾지 못함

→

CLAUDE-MEM

citation 시스템으로 과거 observation을 ID로 참조

5개 라이프사이클 훅

session lifecycle capture

SessionStart

시작 시 관련 기억 자동 주입

UserPromptSubmit

유저 프롬프트 기록

PostToolUse

툴 실행 결과 관찰 기록

Stop

응답 종료 시점 캡처

SessionEnd

세션 요약 · 압축 · 저장

구성 요소 6가지

HOOKS

Lifecycle Hooks

5개 자동 훅
세션 전체 기록

SessionStart / UserPromptSubmit
PostToolUse / Stop / SessionEnd
사람이 수동 저장할 필요 없음

WORKER

Web UI Service

localhost:37777
실시간 메모리 스트림

HTTP API + 웹 뷰어
백그라운드 worker 상시 구동
저장된 기억 바로 확인

STORAGE

Dual Database

SQLite + Chroma
구조 + 벡터

SQLite: 세션 · observation · summary
Chroma: semantic + keyword 하이브리드
정확성 + 의미 검색 동시

SKILL

mem-search

자연어 검색
토큰 10배 절약

Claude가 직접 호출하는 스킬
필터 후 상세 로드 패턴
비용 가시화 내장

PRIVACY

Tag Control

<private> 태그
민감 정보 제외

태그로 감싸면 저장 안 됨
프롬프트에 직접 명시
API 키 · 비밀번호 보호

INSTALL

One Command

npx claude-mem
install

Smart Install · 의존성 캐시 체크
Node 18+ · Bun · SQLite 3
Gemini CLI도 지원

3-Layer Progressive Disclosure

filter before fetching details

LAYER 1

~50-100 tokens

ID가 포함된 압축 인덱스. 후보를 먼저 추려냄.

LAYER 2

timeline

chronological

결과 주변 시간순 컨텍스트. 흐름을 확인.

LAYER 3

get_observations

~500-1,000 tokens

선별된 ID만 상세 조회. 비용을 알고 쓴다.

스택 & 요구사항

📝

TypeScript

Language

💻

Node 18+

Runtime

🍳

Bun

Executor

💾

SQLite 3

Structured

🧠

Chroma

Vector DB

🔑

AGPL-3.0

License

Claude Code가
기억하기 시작한다

npx claude-mem install 5 hooks · 3-layer search · 10x token savings sessions remember themselves

github.com/thedotmack/claude-mem

Claude-MemContext Survives

세션이 끝나면 기억이 사라진다

5개 라이프사이클 훅

구성 요소 6가지

3-Layer Progressive Disclosure

스택 & 요구사항

Claude Code가기억하기 시작한다

Claude-Mem
Context Survives

Claude Code가
기억하기 시작한다

Claude-Mem: Claude Code에 영구 기억을 부여하는 플러그인

Reference Links

Comments (0)