$ /plugin marketplace add thedotmack/claude-mem && /plugin install claude-mem copy
왜 필요한가?
Claude Code 세션을 새로 시작할 때마다 이전 대화의 결정, 수정한 파일, 해결한 버그 등을 다시 설명해야 합니다. 세션이 길어지면 컨텍스트 윈도우를 다 써버려 /compact로 압축하는 수밖에 없고, 그 과정에서 중요한 세부가 손실됩니다.
Claude-Mem은 세션 중 Claude가 수행한 작업을 백그라운드 관찰자 에이전트가 실시간으로 기록·분류하고, AI로 압축해 저장합니다. 다음 세션이 시작되면 프로젝트 히스토리에서 관련 항목만 자동으로 주입되어, 반복 설명 없이 작업을 이어갈 수 있습니다.
주요 기능
- 실시간 관찰(Observation) — 전담 관찰자 에이전트가 세션 중 검색 가능한 “관찰”을 생성. 의사결정·버그 수정·기능 추가·발견 등으로 자동 분류
- Progressive Disclosure — 세션 시작 시 가벼운 인덱스(~2.1k 토큰)만 로드, 필요할 때 상세 관찰(~850 토큰)을 추가 로드. 토큰 비용 가시화
mem-search스킬 — 자연어로 프로젝트 이력 질의 (예: “token refresh 관련 결정 찾아줘”, “index.ts에 영향 준 결정은?”)- Web Viewer —
http://localhost:37777에서 메모리 스트림 실시간 확인 및 관리 - Claude Desktop 스킬 — Desktop 앱 대화에서도 동일한 메모리 검색 사용 가능
- Privacy 제어 —
<private>태그로 감싼 내용은 저장에서 제외 - Citation — 관찰 ID로 과거 기록 참조. 어디서 온 정보인지 추적 가능
- 자동 작동 — 설치 후 추가 조작 없이 백그라운드에서 동작
지원 환경
| 클라이언트 | 지원 |
|---|---|
| Claude Code | ✓ (플러그인 또는 NPX) |
| Claude Desktop | ✓ (메모리 검색 스킬) |
| Gemini CLI | ✓ (--ide gemini-cli) |
| OpenCode | ✓ (--ide opencode) |
| Cursor IDE | ✓ (문서 내 통합 가이드 제공) |
요구 사항
- Node.js 18.0.0 이상
- Claude Code (플러그인 지원 버전)
- Bun, uv, SQLite 3 — 설치 과정에서 자동 설치/번들
알아두면 좋은 점
- 작성자는 Alex Newman(@thedotmack), 공식 문서에서 아키텍처·통합 가이드·고급 설정 확인
- 라이선스는 AGPL-3.0 — 네트워크 서비스 형태로 배포 시 소스 공개 의무 발생. 단,
ragtime/디렉토리는 PolyForm Noncommercial License 적용 - 베타 채널에서 Endless Mode 등 실험적 기능 사용 가능
- claude.com/plugins에 등록된 플러그인이 아니므로 마켓플레이스 추가(
/plugin marketplace add thedotmack/claude-mem) 후 설치 필요