ilhae.ai

EBOOK · 2026년 11월 8일

claude-mem 사용법: Claude Code 장기 기억 설치 가이드

김재우 지음 · 11장 · 읽는 시간 약 35분

Claude Code 세션을 닫을 때마다 맥락이 사라지는 문제를 claude-mem으로 해결하는 한국어 도입 가이드입니다. claude-mem은 작업 행동을 자동으로 기록해 다음 세션에 되돌려주는 플러그인입니다. 격리 환경에서 install(종료 코드 0), doctor 필수 체크 통과, worker 기동(포트 37700, 뷰어 HTTP 200)까지 실측했습니다(검증일 2026년 10월 30일, claude-mem 15.6.0). 가장 큰 함정인 "npm install -g로는 훅이 설치되지 않는다", 로그인을 건너뛰는 --provider claude 실측, 일본어 모드 code--ja, 프라이버시 보호 방법, Windows 주의점까지 담았습니다. 다만 실제 기억이 쌓이고 다음 세션으로 되돌아오는 부분은 로그인된 Claude Code가 필요해 검증하지 못했습니다. 이 실측 가이드는 그 부분을 다시 확인할 포인트도 명시해 두었습니다.

웹 뷰어에서만 읽을 수 있는 책입니다. 본문 복사·인쇄·저장은 막혀 있어요.

목차

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

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

    읽기
    절 6개 보기
    • 이 책에 대해
    • claude-mem이 해결하는 문제
    • 검색은 3단계: 먼저 좁히고 나서 상세를 가져온다
    • 필요한 것
    • 이 책의 검증 방침
    • 업데이트 이력
  2. 2. 가장 큰 함정 — `npm install -g`로 설치하면 안 된다

    가장 밟기 쉬운 실패부터 먼저 적겠습니다. 이 장에서 다루는 것: 실패 카탈로그의 첫 번째 · 올바른 설치 방법은 두 가지 · 이후 장에서 다룰 실패도 미리 예고해 둔다

    읽기
    절 3개 보기
    • 실패 카탈로그의 첫 번째
    • 올바른 설치 방법은 두 가지
    • 이후 장에서 다룰 실패도 미리 예고해 둔다
  3. 3. 설치 절차 전체 — 로그인 처리와 설치 위치

    필자도 이 형태로 실행했고 종료 코드 0으로 완료됐습니다. 이 장에서 다루는 것: 대화형 입력 없이 진행하는 경우의 명령어 · 로그인 처리 · 설치 후 파일이 놓이는 위치(Linux/macOS, 필자 실측)

    읽기
    절 3개 보기
    • 대화형 입력 없이 진행하는 경우의 명령어
    • 로그인 처리
    • 설치 후 파일이 놓이는 위치(Linux/macOS, 필자 실측)
  4. 4. 설치 여부는 doctor로 판정한다 — worker 기동과 포트 37700

    필자 환경에서는 Bun / uv / 플러그인 / tree-sitter CLI / 훅 런처 / marketplace 항목이 모두 ✓였고 "All required checks passed"가 나왔습니다. 유일하게 ✗였던 건 worker 데몬인데, --no-auto-start로 기동을 생략했기 때문입니다("start…

    읽기
    절 2개 보기
    • doctor
    • worker 기동·확인·정지
  5. 5. 사용 시작과 일본어 모드 — 먼저 겪은 주의점 "degraded"의 의미

    필자 검증 환경에는 Claude Code 본체(claude 명령)가 설치돼 있지 않아서, status에서는 의존성이 degraded(Claude CLI setup required)로 표시됐고 doctor에서도 "Claude Code version: not detected"가 나왔습니다.

    읽기
    절 3개 보기
    • 필자가 직접 겪은 주의점: Claude CLI가 없으면 "degraded"가 된다
    • 사용 시작
    • 일본어 모드
  6. 6. 프라이버시(기록되지 않았으면 하는 것 빼기)와 Windows 주의점

    알아서 전부 기록하는 도구인 만큼, 빼는 방법을 먼저 알아두세요. 이 장에서 다루는 것: 프라이버시: 기록되지 않았으면 하는 것 빼기 · Windows 주의점(공식 Windows 안내 기준)

    읽기
    절 2개 보기
    • 프라이버시: 기록되지 않았으면 하는 것 빼기
    • Windows 주의점(공식 Windows 안내 기준)
  7. 7. 그 밖의 설치 경로(--ide)와 유지보수 명령어

    배포 대상은 Claude Code만이 아닙니다. 설치 프로그램의 --ide로 OpenCode(1.3.4 이상 / 2.x), T3 Code, Antigravity CLI, Pi, DeepSeek Harness(dsh), Gemini CLI, Cursor 등을 고를 수 있습니다.

    읽기
    절 3개 보기
    • Claude Code 외의 설치 경로
    • 유지보수 명령어
    • 버전이 빨리 올라가는 데 대한 대비
  8. 8. 검증한 것 / 검증하지 못한 것 전체 기록과 재확인 체크리스트

    검증 환경: Linux 격리 홈 디렉터리, claude-mem 15.6.0, Node v24.22.1. 이 장에서 다루는 것: 검증한 것(필자가 2026년 10월 30일 격리 홈 디렉터리에서 실행한 것) · 검증하지 못한 것(공식 정보 기반이지만 필자가 실행으로 확인하지 않은 것) · 독자용 재확인 체크리스트 ·…

    읽기
    절 5개 보기
    • 검증한 것(필자가 2026년 10월 30일 격리 홈 디렉터리에서 실행한 것)
    • 검증하지 못한 것(공식 정보 기반이지만 필자가 실행으로 확인하지 않은 것)
    • 독자용 재확인 체크리스트
    • 라이선스
    • 출처
  9. 부록 A. [추가] Claude Code 내장 자동 메모리(auto memory)와는 무엇이 다른가

    원문이 전제로 삼는 "세션을 닫으면 맥락이 모두 사라진다"는 설명은 지금의 Claude Code에는 절반만 맞습니다. Claude Code에는 사용자가 쓰는 CLAUDE.md와 별도로, Claude가 스스로 메모를 남기는 자동 메모리(auto memory)가 기본으로 켜져 있습니다. claude-mem을 도입하기 전에…

    읽기
  10. 부록 B. [추가] 국내 기업 환경(개인정보보호법·망분리)에서 쓸 때의 체크포인트

    claude-mem은 "로컬 도구"로 소개되지만, 관찰을 압축·요약하는 단계에서는 선택한 프로바이더로 작업 내용이 전송됩니다. --provider claude라면 Anthropic, OpenRouter/Gemini 키를 쓰면 해당 서비스, observer를 쓰면 claude-mem 측 호스팅 서비스입니다. 반면 저장은…

    읽기
    절 4개 보기
    • 데이터가 어디로 가는지부터 확인한다
    • 폐쇄망·사내 LLM으로 요약을 돌리는 구성
    • 국내 개인정보 패턴을 자동 마스킹에 추가한다
    • 기록하면 안 되는 저장소는 통째로 뺀다
  11. 부록 C. [추가] 본문 [추가] 항목의 상세

    npx claude-mem install은 npm 레지스트리에서 패키지를 받는 것 외에, Bun과 uv가 없으면 이것들도 외부에서 내려받아 설치합니다.

    읽기
    절 6개 보기
    • C-1. 사내 프록시·인증서 환경에서 설치하기
    • C-2. 실제 포트 확인과 뷰어 갱신 문제
    • C-3. 모드 체인과 동작 확인
    • C-4. 보완: 자동 마스킹과 텔레메트리 일괄 차단
    • C-5. Windows의 "bun" is not recognized 오류
    • C-6. 기억 DB 백업과 복원
claude-mem 사용법claude-memClaude Code 장기 기억Claude Code 메모리Claude Code 플러그인Claude Code 훅세션 맥락 유지auto memorydoctor전자책ebook

독자 평가

이 책 어땠나요?

별점과 함께 좋았던 점, 보완하면 좋을 점을 남겨 주세요. 저자가 모두 읽고, 골라서 답변과 함께 이 페이지에 싣습니다. 이름·연락처 같은 개인정보는 적지 마세요.

별점 (필수)

ilhae.ai 안내 도우미대기 중

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