ilhae.ai

CHAPTER 01 / 11

1. 들어가며 — claude-mem이 해결하는 문제와 3단계로 끌어오는 검색 구조

『claude-mem 사용법: Claude Code 장기 기억 설치 가이드』 · 김재우 · 2026년 11월 8일

이 책은 claude-mem 한국어 도입 가이드입니다. Claude Code 세션을 닫을 때마다 맥락이 사라지는 문제를 플러그인 claude-mem(thedotmack/claude-mem)으로 해결하는 방법을 다룹니다.

미리 읽기

이 책에 대해

이 책은 claude-mem 한국어 도입 가이드입니다. Claude Code 세션을 닫을 때마다 맥락이 사라지는 문제를 플러그인 claude-mem(thedotmack/claude-mem)으로 해결하는 방법을 다룹니다.

  • 대상 독자: Claude Code를 매일 쓰지만 세션을 닫을 때마다 맥락이 사라져 곤란한 사람
  • 검증일: 2026년 10월 30일 / 검증한 버전: claude-mem 15.6.0(npx로 받은 버전)
  • 대상 저장소: thedotmack/claude-mem(https://github.com/thedotmack/claude-mem)

이 가이드는 공식 README의 번역이 아닙니다. 공식 정보를 1차 자료로 확인한 다음 필자가 격리한 홈 디렉터리에서 직접 설치와 진단, worker(상주 서비스) 기동까지 해봤습니다. 그 과정에서 일어난 일을 제 말로 정리한 절차입니다. 필자는 여러분의 실제 ~/.claude는 건드리지 않았고, 여러분도 처음에는 검증용 환경에서 시험해보길 권합니다.

claude-mem이 해결하는 문제

Claude Code의 맥락은 세션 단위입니다. 터미널을 닫는 순간 "어제 어디까지 했는지", "그 버그를 어떻게 고쳤는지"는 사라지고, 다음 세션에서는 매번 처음부터 다시 설명해야 합니다. 프로젝트가 며칠 규모로 커지면 이 재설명에만 토큰과 시간을 계속 쓰게 됩니다.

claude-mem은 세션에서 일어난 일을 자동으로 기록하고, 요약해서 저장했다가, 다음 세션 시작 시점에 관련된 부분만 되돌려주는 플러그인입니다. 구조는 다음 부품으로 구성됩니다.

이 장의 나머지 내용은 읽기 화면에서 이어서 볼 수 있어요.

이어서 읽기

이 장에서 다루는 것

  1. 이 책에 대해
  2. claude-mem이 해결하는 문제
  3. 검색은 3단계: 먼저 좁히고 나서 상세를 가져온다
  4. 필요한 것
  5. 이 책의 검증 방침
  6. 업데이트 이력

ilhae.ai 안내 도우미대기 중

글자를 치면 사이트 자료를 바로 찾아요. AI 대화는 하루 20번까지이고, 질문 앞부분은 서비스 개선을 위해 30일 보관해요. 개인정보는 적지 마세요.