memory-log.md 하나를 흡수하면서 레벨 1 → 100이 되는 Claude
세션이 끝나면 Claude는 그 대화를 전부 잊습니다. 다음 세션에서 "우리 어디까지 했었지?"를 처음부터 설명해야 하는 상황이 계속 아쉬웠어요. 그 문제를 해결하면서 4단계를 밟아왔습니다. 레벨 1은 파일 하나, 레벨 4는 완전 로컬 RAG입니다. 지금 있는 단계에서 딱 한 단계만 올려도 Claude가 완전히 달라집니다.
레벨 1 — memory-log.md 하나로 시작
설치도 API 키도 없이 파일 두 개만으로 세션 간 기억이 이어집니다.
CLAUDE.md 규칙 하나를 프로젝트 루트에 두면, Claude가 세션이 끝날 때 자동으로 요약을 남기고 다음 세션에서 관련 항목만 찾아 읽습니다. 같은 CLAUDE.md로 반복 작업을 줄이는 쪽은 스킬 트리거 문구를 다듬은 기록에 따로 정리해뒀습니다.
## 기억 라우팅 (로컬 파일 기반)
- **자동 요약**: 세션에서 실질적인 작업(파일 생성·수정, 결정, 배포 등)이
있었고 세션이 마무리되는 시점이면, 무슨 작업을 했고 어떤 결론·결정을
냈고 남은 일이 뭔지 핵심만 정리해서 memory-log.md 맨 위(최신순)에
새 항목으로 추가한다. 항목 제목 형식: "## YYYY-MM-DD — 제목".
사용자가 "요약"이라고 명시적으로 말하면 그 즉시도 실행한다.
- **세션을 새로 시작할 때**: 지금 하려는 작업과 관련된 과거 맥락이
필요하면 memory-log.md에서 관련 항목만 찾아 읽는다. 전체를 다
읽지 않는다.
- **압축**: memory-log.md의 "## " 항목이 10개를 넘으면
compress-memory-log.mjs로 오래된 항목을 memory-log-archive.md로
옮기고, memory-log.md엔 최신 10개 + 한 줄 인덱스만 남긴다.# 기억 로그
CLAUDE.md의 규칙으로 쌓이는 세션 요약. 최신 항목이 위.
새 세션에서 관련 맥락이 필요할 때 여기서 관련 항목만 찾아 읽는다.
---이게 전부입니다. Claude Code는 작업 중인 폴더의 CLAUDE.md를 자동으로 읽어들이기 때문에 별도 설정이 없어요. 다음 세션부터 Claude가 알아서 기억을 남기고 꺼내 씁니다.
이런 소식, 남들보다 먼저 받으실 분?
직접 돌려보고 되는 것만 골라 매주 보내드립니다. 광고성 하이프는 거릅니다.
레벨 2 — memory/*.md 주제별 분리
시간순 요약과 주제별 지식을 분리하면, 같은 버그를 두 번 고치지 않습니다.
memory-log.md 하나에 모든 걸 쌓으면 점점 무거워집니다. 특히 "채널 게시 서버는 포트 3791", "카드뉴스 릴스 CTA는 카드 높이 65% 이하에" 같은 영구 지식은 시간순 로그보다 주제별 파일에 두는 게 훨씬 낫습니다.
| 파일 | 역할 |
|---|---|
memory-log.md | 세션 요약 (시간순, 최신 10개 유지) |
memory/blog-pipeline.md | 블로그 CSS 규칙, 배포 순서, 버그 해결법 |
memory/cardnews-pipeline.md | 카드뉴스 체크리스트, 릴스 CTA 규칙 |
memory/channel-publisher.md | 채널 연결 현황, publish.json 형식 |
memory/tools.md | 도구 목록, 이미지 생성 서비스 현황 |
CLAUDE.md에 이 규칙을 추가합니다.
## 주제별 지식 파일 (memory/ 폴더)
작업 중 새로운 버그 해결법·규칙·패턴을 발견하면
해당 주제의 memory/*.md 파일에 즉시 추가한다.
memory-log.md는 시간순 요약, memory/*.md는 영구 지식 저장소.레벨 2부터는 Claude가 새 세션 시작 시 관련 memory 파일을 먼저 읽고 들어옵니다. 같은 실수를 반복하지 않고, 프로젝트 규칙이 자동으로 지켜집니다.
레벨 3 — NotebookLM 클라우드 연동
"이번 달에 채널 게시 관련 결정이 있었나?" 같은 자연어 질문으로 과거 기록을 검색합니다.
레벨 2까지는 파일을 직접 읽어야 합니다. 레벨 3은 NotebookLM MCP를 연동해서 Claude가 자연어로 과거 기억을 검색할 수 있게 합니다.
처음에 연동이 안 됐던 이유: 구글이 notebooklm.google.com → notebook.google.com으로 리브랜딩하면서 MCP 패치가 필요했습니다. tools/notebooklm-patch/의 도메인 패치 + 한국어 선택자 패치 2개를 적용했더니 작동했습니다.
설정이 완료되면 세션 종료 시 add_source(type:text)로 요약을 저장하고, 다음 세션에서 ask_question으로 검색합니다. "지난달 틱톡 캡션 반려 규칙이 뭐였지?"처럼 물어보면 Claude가 노트북에서 바로 찾아줍니다.
레벨 4 — claude-mem 로컬 RAG (오늘 완성)
세션 기록이 로컬 벡터 DB에 쌓이고, Claude가 시작할 때 자동으로 관련 맥락을 불러옵니다.
claude-mem은 Claude Code 세션에서 쌓인 관찰(observation)을 로컬 벡터 DB에 저장하고, 새 세션 시작 시 현재 작업과 관련된 과거 맥락을 자동으로 주입하는 MCP입니다. 클라우드에 데이터가 올라가지 않고, 파일 기반이라 언제든 직접 확인할 수 있습니다.
설치는 Bun 런타임이 필요합니다.
# Bun 설치 (Windows)
winget install Oven-sh.Bun
# claude-mem 서버 시작 (Claude Code 재시작 전에 먼저 실행)
npx claude-mem@latest start
# 코퍼스 빌드 (처음 한 번)
# Claude Code에서 mcp__plugin_claude-mem_mcp-search__build_corpus 호출레벨 4가 레벨 1-3과 다른 점은, Claude가 파일을 능동적으로 "읽는" 것이 아니라 시스템이 알아서 관련 맥락을 "주입"한다는 점입니다. 사람이 어떤 파일을 읽으라고 알려줄 필요가 없어요.
4단계 비교
| 단계 | 도구 | 특징 | 설치 난이도 |
|---|---|---|---|
| 레벨 1 | memory-log.md | 파일 하나, 즉시 시작 가능 | 없음 |
| 레벨 2 | memory/*.md | 도메인 지식 영구 보존 | 없음 |
| 레벨 3 | NotebookLM MCP | 자연어 검색, 클라우드 백업 | 중간 |
| 레벨 4 | claude-mem + Bun | 완전 자동 맥락 주입 | Bun 설치 필요 |
지금 레벨 1조차 없다면 레벨 1부터 시작하세요. CLAUDE.md 규칙 하나, memory-log.md 파일 하나면 충분합니다. 막히는 것 없이 오늘 바로 할 수 있어요. 레벨 2, 3, 4는 그다음에 하나씩 올리면 됩니다.
메모리 로그가 길어지면 — 압축 스크립트
항목이 10개를 넘으면 오래된 것을 memory-log-archive.md로 옮기는 스크립트입니다. 내용은 절대 삭제되지 않고 이동만 됩니다.
node compress-memory-log.mjs memory-log.md 10
