# claude-mem - Claude Code 세션 간 컨텍스트 유지용 메모리 압축 시스템

> Clean Markdown view of GeekNews topic #25824. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=25824](https://news.hada.io/topic?id=25824)
- GeekNews Markdown: [https://news.hada.io/topic/25824.md](https://news.hada.io/topic/25824.md)
- Type: news
- Author: [xguru](https://news.hada.io/@xguru)
- Published: 2026-01-15T09:31:01+09:00
- Updated: 2026-01-15T09:31:01+09:00
- Original source: [github.com/thedotmack](https://github.com/thedotmack/claude-mem)
- Points: 8
- Comments: 1

## Summary

**claude-mem**은 Claude Code의 세션이 종료돼도 프로젝트 맥락을 자동으로 보존하도록 설계된 메모리 압축 시스템입니다. 세션 훅을 통해 프롬프트와 툴 사용 기록을 수집하고, 이를 **의미 중심 요약**으로 재구성해 다음 세션에 단계적으로 주입합니다. SQLite·FTS5와 Chroma를 결합한 하이브리드 검색 구조와 `mem-search` 스킬을 통해 과거 작업이나 의사결정 이력을 자연어로 탐색할 수 있으며, `<private>` 태그를 이용한 프라이버시 제어도 지원합니다.

## Topic Body

- Claude Code 세션이 종료돼도 **프로젝트 맥락을 자동으로 보존**하기 위해 개발된 플러그인  
- 세션 라이프사이클 훅을 활용해 **프롬프트·툴 사용·종료 시점의 컨텍스트를 자동 수집**  
- 저장된 관찰 데이터를 기반으로 **의미 중심 요약과 단계적 컨텍스트 주입** 수행  
  - 토큰 비용을 가시화한 **Progressive Disclosure 전략** 적용  
- `mem-search` 스킬을 통해 **자연어로 과거 작업·버그·의사결정 이력 검색** 가능  
- SQLite + FTS5와 **Chroma 벡터 데이터베이스를 결합한 하이브리드 검색 아키텍처**  
- MCP 기반 **3단계 검색 워크플로(search → timeline → get_observations)** 로 약 10배 토큰 절감   
- 로컬 HTTP 워커 서비스와 **웹 뷰어 UI(37777 포트)** 를 통해 메모리 스트림과 관찰 ID 실시간 확인 가능  
- `<private>` 태그로 **민감한 컨텍스트를 저장 대상에서 제외**하는 프라이버시 제어 기능 제공  
- 설정 파일을 통해 **컨텍스트 주입 범위·모델·저장 위치를 세밀하게 제어** 가능  
- AGPL-3.0 라이선스

## Comments



### Comment 49387

- Author: kaydash
- Created: 2026-01-17T19:12:16+09:00
- Points: 1

좋네요 대화이력 관리를 fts로도 하고 vector로도 하고.