메모리 엔진 (Memory Engine)
Claude Code 세션의 기억을 훅으로 자동 저장·복원하고, 반복 실수까지 학습시키는 메모리 관리 시스템.
유틸리티중급★ 132⑂ 27AI 점수 9/10마지막 업데이트: 2026. 5. 11.
무엇을 해주나
- 스마트 컨텍스트: 현재 작업 디렉터리를 감지해 해당 프로젝트의 메모리를 세션 시작 시 자동 로드합니다.
- 자동 학습(함정 감지): 재시도, 에러 후 수정, 사용자 정정 같은 패턴을 컨텍스트 압축 직전에 잡아내
~/.claude/skills/learned/에 문제와 해결책을 함께 저장합니다. 같은 실수가 3회 이상 반복되면 영구 규칙으로 승격을 제안합니다. - 학생 루프(/reflect): 8단계 학습 사이클(기록 → 연결 → 패턴 탐지 → 리뷰 → 정제 → 재분석 → 정리 → 보고서)로 메모리를 계속 다듬습니다.
- 세션 핸드오프(/handoff): 진행 상황·결정·미완료 작업을 파일로 남겨 다른 Claude Code 창에서 이어받게 합니다.
- 교정 사이클(/analyze): 에러 로그에 남지 않는 "사용자가 직접 고친 부분"을 오답 노트로 축적합니다.
- 저장 시점이 3중(20메시지마다, 압축 직전, 세션 종료)이라 명령어를 잊어도 기록이 남습니다.
이런 분께 추천
- 긴 작업을 여러 세션에 나눠 진행하다 컨텍스트가 날아가 답답했던 분
- 여러 프로젝트를 오가며 프로젝트별 규칙과 맥락을 따로 관리하고 싶은 분
- 여러 기기(회사/집)에서 Claude Code를 쓰며 메모리를 GitHub로 동기화하고 싶은 분
- Claude가 같은 실수를 반복하는 걸 규칙으로 굳혀서 막고 싶은 분
활용 예시
- 작업 도중 컨텍스트가 가득 찼을 때 →
/handoff로 진행 상황을 남기고 새 창을 열면 시작 시 자동으로 인수인계 내용을 읽어옵니다. - 한 주간 삽질을 정리하고 싶을 때 →
/reflect를 실행해 최근 7일 기록을 리뷰하고, 반복된 실수를 영구 규칙으로 승격시킵니다. - 집 노트북에서 이어 작업할 때 →
/sync(memory-backup.sh sync)로 GitHub 백업 저장소와 양방향 동기화한 뒤/reload로 메모리를 불러옵니다. - MEMORY.md가 비대해졌을 때 →
/memory-health로 용량 경고를 확인하고 오래된 내용을 개별 파일로 분리합니다.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/HelloRuru/claude-memory-engine/HEAD/skill/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 HelloRuru/claude-memory-engine 의 skill 폴더를 내 ~/.claude/skills/memory-engine/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/HelloRuru/claude-memory-engine.git /tmp/claude-memory-engine && mkdir -p ~/.claude/skills/memory-engine && cp -r /tmp/claude-memory-engine/skill/* ~/.claude/skills/memory-engine/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 저장소를 클론합니다:
git clone https://github.com/HelloRuru/claude-memory-engine.git - 클론한 폴더로 이동합니다:
cd claude-memory-engine - 저장소의 README에 설치 스크립트가 있는지 먼저 확인합니다(있다면 그것을 사용하는 편이 가장 안전합니다).
- 기존 설정을 백업합니다:
cp -r ~/.claude ~/.claude.bak - 스킬을 복사합니다:
mkdir -p ~/.claude/skills/memory-engine && cp -r skill/* ~/.claude/skills/memory-engine/ - 훅 스크립트와 명령어 파일을 각각
~/.claude/scripts/hooks/,~/.claude/commands/로 복사합니다(저장소 내 해당 디렉터리 참고). ~/.claude/settings.json에 SessionStart, SessionEnd, PreCompact, UserPromptSubmit, PreToolUse 훅을 등록합니다.- 백업 기능을 쓰려면 메모리용 GitHub 저장소를 만들고
memory-backup.sh에 연결한 뒤memory-backup.sh push로 테스트합니다. - Claude Code를 재시작하고
/overview또는/check를 실행해 정상 동작을 확인합니다.
GitHub에서 원본 보기 ↗라이선스: MIT