Claude-Mem - 세션이 닫혀도 컨텍스트가 끊기지 않게 만드는 메모리 플러그인

Claude Code 플러그인 큐레이션 시리즈 · 5편 Claude-Mem

이 글에서 다루는 내용

Claude Code의 세션은 닫히면 끝납니다. 어제 한 세션에서 결정한 사항, 시도한 접근, 합의한 컨벤션은 새 세션에선 빈 상태로 시작합니다. Claude-Mem은 그 단절을 자동으로 메우는 플러그인입니다. 작업 도중 Claude가 어떤 도구를 어떻게 썼는지를 hook으로 관찰해 의미 단위 요약으로 압축한 뒤, 새 세션에선 관련된 부분만 골라 컨텍스트에 주입합니다. 이 글은 설치 명령(npx·플러그인·소스 빌드 세 가지 경로), 자동 캡처 동작, 검색 가능한 메모리 아카이브, 워크플로우 모드, 운영 팁을 정리합니다. 기준 시점은 2026년 4월입니다.

---

1. Claude-Mem의 자리

공식 README는 Claude-Mem을 다음 한 줄로 요약합니다.

"Automatically captures everything Claude does during your coding sessions, compresses it with AI, and injects relevant context back into future sessions."

흐름은 세 단계입니다.

1. 관찰 - Claude의 도구 호출(파일 편집, 셸 실행, 검색)을 hook으로 캡처
2. 압축 - Claude의 agent-sdk를 이용해 의미 단위 요약 생성
3. 주입 - 새 세션이 시작되면 현재 작업과 관련된 요약만 골라 컨텍스트에 주입

핵심은 관련 부분만 주입한다는 점입니다. 모든 과거 기록을 다 넣으면 컨텍스트가 무거워져 모델 품질이 떨어지므로(활용 매뉴얼 1번 항목 참고), 의미가 가까운 부분만 골라 가볍게 유지합니다.

---

2. 설치 - 세 가지 경로

2-1. npx로 설치 (권장)

가장 권장되는 방법입니다. plugin hook과 worker 서비스가 함께 등록됩니다.

npx claude-mem install

2-2. Claude Code 마켓플레이스에서 설치

Claude Code 세션 안에서 직접 설치할 수도 있습니다.

/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem

2-3. 소스에서 직접 빌드 (선택)

git clone https://github.com/thedotmack/claude-mem.git
cd claude-mem
npm install
npm run build

⚠️ npm install -g claude-mem 명령으로 설치하면 SDK 라이브러리만 깔리고 plugin hook과 worker 서비스가 등록되지 않습니다. 위 세 경로 중 하나를 사용해야 합니다.

2-4. 설정 위치

설치 후 첫 실행 시 ~/.claude-mem/settings.json이 기본값으로 자동 생성됩니다. 모델, worker 포트, 데이터 디렉터리, 로그 레벨, 컨텍스트 주입 설정을 이 파일에서 조정합니다.

---

3. 자동 캡처와 주입의 실제 동작

설치만 끝나면 추가로 할 일이 없습니다. Claude Code를 평소처럼 쓰면 Claude-Mem이 백그라운드에서 hook을 통해 작업을 관찰하고, 의미 단위로 요약된 메모리 조각을 누적해 둡니다. 새 세션을 열면 자동으로 관련 메모리가 주입됩니다.

3-1. 무엇이 캡처되는가

• 편집한 파일과 그 의도 (어떤 함수가 어떤 이유로 바뀌었는지)
• 실행한 명령과 출력 핵심 (성공·실패 여부, 핵심 메시지)
• 의사결정 (선택한 라이브러리, 컨벤션, 거절된 대안)
• 발견한 단서 (재현 조건, 의존성 충돌)

3-2. 새 세션에서 어떤 모습으로 보이는가

Claude가 세션 초반에 "이전 작업에서 X라는 결정을 했고, Y 이슈가 있었습니다"처럼 맥락을 자연스럽게 끌고 들어옵니다. 사용자가 "지난번 어디까지 했지?"를 묻지 않아도 됩니다.

---

4. 워크플로우 모드 - code / chill / investigation

Claude-Mem은 작업 성격에 맞춰 메모리를 다르게 다루는 모드를 제공합니다. CLAUDE_MEM_MODE 환경 변수로 설정합니다.

모드	언제 쓰는가
code	일반 코딩 작업 (기본값)
chill	대화·아이디에이션 위주, 캡처 부담 낮춤
investigation	디버깅·원인 추적, 단서를 더 촘촘히 기록

언어별 모드도 있습니다. code--ko, code--ja처럼 ISO 639-1 언어 코드를 붙이면 요약을 해당 언어로 생성합니다. 한국어 환경에서 작업한다면 code--ko로 두는 편이 검색·재활용에 좋습니다.

---

5. 활용 시나리오 세 가지

5-1. 며칠짜리 기능을 이어 가는 작업

한 기능을 3~5일에 걸쳐 작업하면 매번 첫 한 시간을 "지난번 어디까지 했지" 복기에 쓰게 됩니다. Claude-Mem이 깔려 있으면 그 한 시간이 사라집니다. 새 세션을 열고 바로 "다음 단계 진행" 같은 한 줄 지시로 들어갈 수 있습니다.

5-2. 결정 기록 자산화

"왜 이 라이브러리 대신 저걸 골랐지", "왜 이 패턴을 거절했지" 같은 결정 사유는 코드 자체에 잘 남지 않습니다. Claude-Mem은 Claude가 그 사유를 설명한 메시지까지 캡처해 두므로, 몇 주 뒤 같은 모듈을 다시 만질 때 의도를 즉시 복원할 수 있습니다.

5-3. 디버깅을 investigation 모드로

장애 추적은 "어떤 가설을 시험했고 어떤 결과가 나왔는지"가 핵심 자산입니다. investigation 모드로 두고 한 사이클을 돌리면, 다음 비슷한 장애가 났을 때 과거 추적의 단서가 그대로 살아납니다.

---

6. 시리즈 다른 회차와의 관계

회차	함께 쓸 때
1편 OMC	자연어 인터페이스 + 세션 메모리 — 사이드 프로젝트에 가장 강한 조합
2편 ECC	ECC 자체에도 메모리·컨텍스트 관리가 있어, 둘 다 깔면 hook이 겹칠 수 있음
3편 Superpowers	서로 영역이 달라 함께 쓰기 좋음
4편 Ralph Loop	반복 사이클의 진행을 메모리에 누적해 두면 다음 사이클의 출발점이 좋아짐

요컨대 OMC·Superpowers·Ralph Loop와는 잘 어울리고, 자체 메모리 시스템을 가진 ECC와는 신중하게 조합해야 합니다.

---

트러블슈팅

문제 1: 새 세션에서 메모리가 주입되지 않는다

npm install -g claude-mem으로만 깐 경우입니다. plugin hook과 worker가 등록되지 않아 캡처는 되어 있어도 주입이 동작하지 않습니다. npx claude-mem install 또는 마켓플레이스 설치로 다시 깔아야 합니다.

문제 2: 메모리가 너무 많이 주입되어 컨텍스트가 무거워진다

주입 임계점이 너무 관대하게 잡혀 있는 경우입니다. ~/.claude-mem/settings.json의 컨텍스트 주입 설정을 줄이거나, 한 세션의 작업 주제를 좁혀 두면 관련 메모리만 자연스럽게 골라집니다.

문제 3: 한국어 요약이 어색하다

기본 모드(code)는 영어를 우선합니다. 한국어 환경에서 작업하고 있다면 CLAUDE_MEM_MODE=code--ko로 변경하면 요약과 주입 문구가 한국어로 나옵니다.

문제 4: ECC와 함께 쓰니 동작이 어긋난다

ECC가 자체 메모리 시스템을 가지고 있어 hook이 겹칠 수 있습니다. 둘 중 하나는 비활성화하거나, ECC를 메인으로 두고 Claude-Mem은 다른 환경(노트·문서 정리용 별도 폴더)에서만 쓰는 식으로 분리합니다.

---

마무리

Claude-Mem의 가치는 시간이 지나야 보입니다. 첫 일주일은 거의 차이를 못 느끼다가, 한 달쯤 지나 같은 모듈로 돌아왔을 때 "Claude가 컨텍스트를 알고 있다"는 감각이 생깁니다. 사이드 프로젝트와 본업 코드를 같은 노트북에서 다루는 사용자, 한 기능을 며칠씩 이어 가는 작업이 많은 사용자에게 가장 효과가 큰 도구입니다.

다음 편에서는 카테고리를 한 번 더 바꿔, 도구 통합 영역의 대표인 Playwright MCP를 다룹니다. Claude Code가 직접 브라우저를 다루게 되는 순간을 보여 드리겠습니다.

•  
• Claude-Mem GitHub: github.com/thedotmack/claude-mem
• 공식 문서: docs.claude-mem.ai
• 이전 편: 4편 Ralph Loop
• 다음 편: 6편 Playwright
• 시리즈 인덱스: Claude Code 플러그인 큐레이션 시리즈