LLM Wiki

claude-mem — Claude Code용 영구 메모리 압축 시스템

2 min read

claude-mem — Claude Code용 영구 메모리 압축 시스템

Claude Code의 세션 간 컨텍스트를 자동 보존하는 영구 메모리 플러그인. 도구 사용 관찰 자동 캡처, 의미 요약, 이후 세션에서 활용.

개요

Claude Code / Gemini CLI / OpenClaw 게이트웨이에서 동작하는 영구 메모리 시스템. 세션이 끝나도 프로젝트 지식이 유지.

핵심 기능

  • 영구 메모리 — 세션 간 컨텍스트 유지
  • Progressive Disclosure — 토큰 비용 가시성과 계층적 메모리 검색
  • mem-search 스킬 — 자연어로 프로젝트 히스토리 질의
  • Web Viewer UI — localhost:37777에서 실시간 메모리 스트림
  • Privacy Control — <no-mem> 태그로 민감 콘텐츠 제외
  • Citations — 과거 관찰 ID로 참조

아키텍처

  1. 5 Lifecycle Hooks: SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd
  2. Worker Service: HTTP API (port 37777) + Web Viewer + 10개 검색 엔드포인트
  3. SQLite DB: 세션, 관찰, 요약 저장
  4. Chroma Vector DB: 하이브리드 시맨틱 + 키워드 검색
  5. MCP Search Tools: 4개 MCP 도구 (3-layer progressive disclosure)

설치

# Claude Code
npx claude-mem install
 
# Gemini CLI
npx claude-mem install --ide gemini-cli
 
# OpenClaw 게이트웨이
curl -fsSL https://install.cmem.ai/openclaw.sh | bash
 
# 플러그인 마켓플레이스
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem

관련 노트

그래프 뷰

백링크