Claude-Mem 플러그인 분석 - 설치할까, 말까?

Claude-Mem은 Claude Code의 모든 작업을 자동 캡처하고, 다음 세션에 관련 컨텍스트를 주입하는 메모리 플러그인입니다. 하지만 Windows에서 핵심 기능인 ChromaDB 벡터 검색이 비활성화 상태이고, 현재 CLAUDE.md + MEMORY.md 체계가 잘 동작 중이라면 설치를 보류하는 것이 합리적입니다.

작성일: 2026-02-06 | 최신 버전: v9.0.16 | 라이선스: AGPL-3.0

이 분석이 필요한 이유

Claude Code를 사용하다 보면 이런 경험을 합니다:

• “지난 세션에서 어디까지 했더라?” 매번 다시 설명하는 번거로움
• 프로젝트가 복잡해질수록 컨텍스트가 부족해지는 느낌
• MEMORY.md에 수동으로 기록하는 게 귀찮음

Claude-Mem은 이 문제를 자동화로 해결하겠다는 플러그인입니다. 하지만 정말 설치할 가치가 있을까요? 현재 내장 메모리 시스템과 비교해서 판단해 봅시다.

1. Claude-Mem이란?

Claude-Mem은 Claude Code용 오픈소스 플러그인으로, 코딩 세션에서 Claude가 수행한 모든 작업을 자동으로 캡처하고, AI로 압축한 뒤, 다음 세션에 관련 컨텍스트를 자동 주입하는 영구 메모리 시스템입니다.

• 개발자: Alex Newman (@thedotmack)
• GitHub: thedotmack/claude-mem
• 공식 문서: docs.claude-mem.ai
• 2026년 2월 3일 GitHub 트렌딩 1위 (24시간 만에 1,739 Stars)

쉽게 말하면? Claude Code를 쓸 때 내가 한 작업(파일 수정, 검색, 명령 실행 등)을 백그라운드에서 몰래 다 기록해두고, 다음에 Claude Code를 열면 “지난번에 이런 작업 하셨죠?” 하면서 자동으로 알려주는 플러그인입니다.

2. 핵심 기능

3. 아키텍처 (어떻게 동작하는가)

동작 원리 요약 Claude Code가 도구를 사용할 때마다 Hook이 발동 -> Worker 서비스(포트 37777)로 데이터 전송 -> AI가 요약 -> SQLite/ChromaDB에 저장 -> 다음 세션 시작 시 자동 주입

5개 Lifecycle Hook

Hook이란? Claude Code의 특정 이벤트(세션 시작, 도구 사용 후 등)에 자동으로 실행되는 스크립트입니다. Claude-Mem은 5개의 Hook을 등록해서 Claude Code의 모든 생명주기에 개입합니다.

AI Provider (3가지 선택 가능)

4. 설치 방법

요구사항

설치 명령

/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem
# Claude Code 재시작 후 자동 동작

데이터 저장 위치

~/.claude-mem/
├── claude-mem.db       # SQLite 메인 DB
├── vector-db/          # ChromaDB 벡터 DB
├── settings.json       # 설정 파일 (자동 생성)
├── logs/               # 로그
└── claude-mem.pid      # 프로세스 ID

5. 내장 메모리 vs Claude-Mem 비교 (핵심)

현재 사용 중인 Claude Code 내장 메모리 시스템

[우선순위 높음 → 낮음]

1. 조직 정책       C:\Program Files\ClaudeCode\CLAUDE.md (미사용)
2. 프로젝트 메모리  CLAUDE.md (950+ 줄, 매우 상세)
3. 프로젝트 규칙    .claude/rules/*.md (미사용)
4. 사용자 메모리    ~/.claude-work/CLAUDE.md (PowerShell 규칙)
5. 프로젝트 로컬    CLAUDE.local.md (미사용)
6. Auto Memory     memory/MEMORY.md (프로젝트 진행 메모)

상세 비교표

한 줄 요약: Claude-Mem은 “자동화"와 “검색"에서 우위, 내장 메모리는 “안정성”, “투명성”, “팀 공유"에서 우위입니다.

6. Windows 환경 이슈 (중요)

현재 PC 환경: Windows (MINGW32_NT-6.2) Windows에서 Claude-Mem을 사용할 때 알아야 할 주요 이슈들입니다.

Windows 핵심 제약: ChromaDB(벡터 검색)가 비활성화되어 시맨틱 검색 불가, 키워드 검색만 동작합니다. 이는 Claude-Mem의 핵심 차별점인 “자연어 검색"이 Windows에서는 사실상 사용 불가능함을 의미합니다.

7. 장단점 종합

장점

1. 완전 자동화 – 세션 기록이 자동으로 캡처/압축/주입
2. 토큰 효율 – 3-Layer Progressive Disclosure로 필요한 것만 로드
3. 과거 작업 검색 – 자연어로 “지난주에 수정한 파일” 같은 검색 가능
4. 세션 연속성 – “어디까지 했었지?” 문제 해결
5. Endless Mode (Beta) – 장시간 세션에서 컨텍스트 윈도우 절약

단점

1. Windows 호환성 불완전 – ChromaDB 비활성화, 과거 팝업 이슈
2. 백그라운드 프로세스 – Worker 서비스가 항상 실행 (포트 37777)
3. 블랙박스 – 어떤 컨텍스트가 주입되는지 직접 확인하기 어려움
4. 추가 의존성 – Bun, uv(Python), SQLite, ChromaDB
5. AGPL-3.0 라이선스 – 상용 환경에서 제약 가능
6. 디스크 사용 – SQLite DB + 벡터 DB가 지속적으로 증가
7. 안정성 – 프로세스 크래시, 타임아웃 등 이슈 지속 발생
8. 내장 메모리와 중복 – Auto Memory (MEMORY.md)와 역할 겹침

8. 현재 환경에 대한 판단

현재 잘 동작하고 있는 것

Claude-Mem이 추가로 해결할 수 있는 것

9. 결론: 설치를 보류하자

현재 상황에서는 설치를 보류하는 것을 권장합니다

보류 이유 4가지

1. Windows 호환성 미성숙 – ChromaDB(핵심 기능) 비활성화 상태. 키워드 검색만으로는 내장 메모리 대비 큰 이점 없음
2. 현재 메모리 체계가 충분 – CLAUDE.md(950+ 줄) + MEMORY.md(Auto Memory)로 프로젝트 컨텍스트가 잘 관리되고 있음
3. 추가 복잡성 대비 이점 불명확 – Worker 프로세스 관리, 포트 충돌, 프로세스 크래시 등의 리스크를 감수할 만한 이점이 현 시점에서는 부족
4. 안정성 우려 – v9.0.x에서도 타임아웃, 인증 실패, 좀비 프로세스 등 버그가 계속 수정되고 있음 (빠른 릴리즈 주기 = 아직 안정화 중)

재검토 시점

• Windows에서 ChromaDB가 재활성화될 때
• v10.x 등 메이저 안정화 릴리즈 이후
• 프로젝트가 더 복잡해져서 MEMORY.md 수동 관리가 한계에 도달할 때
• Endless Mode가 정식 릴리즈될 때

10. 대안: 현재 메모리 체계 강화

Claude-Mem 없이도 현재 내장 메모리를 더 효과적으로 활용할 수 있습니다.

(1) .claude/rules/ 디렉토리 활용

주제별로 규칙 파일을 분리하면 관리가 쉬워집니다:

.claude/rules/
├── database.md        # DB 관련 규칙
├── jsp-rules.md       # JSP 컴포넌트 규칙
├── security.md        # 보안 규칙
└── testing.md         # 테스트 규칙

(2) CLAUDE.md @import 활용

외부 문서를 참조하여 CLAUDE.md를 깔끔하게 유지:

# 프로젝트 규칙
- JSP 컴포넌트 규칙 @doc/JSP_COMPONENT_GUIDELINES.md
- 보안 가이드 @tips/guides/core/security_guide.md

(3) MEMORY.md 구조화

프로젝트별, 주제별 섹션으로 더 세분화하여 활용도를 높일 수 있습니다.

(4) CLAUDE.local.md 활용

개인 환경 설정 (DB 접속정보, 테스트 데이터 등)을 별도로 관리:

# 나만의 설정
- 로컬 DB: localhost:3306/chemisys_dev
- 테스트 계정: test_user / test1234

참고 자료

• Claude-Mem GitHub
• Claude-Mem 공식 문서
• Claude-Mem DeepWiki 아키텍처
• Claude Code 내장 메모리 공식 문서
• Claude-Mem CHANGELOG
• Claude-Mem 리뷰 (byteiota)
• Top 10 Claude Code 플러그인 2026
• Claude-Mem Windows 이슈 #367
• Claude-Mem 비활성화 이슈 #781