claude-mem 동작 원리 설명
claude-mem이 어떻게 기억을 저장하고 언제 주입하는지, 데이터가 어디에 있는지 알려주는 설명용 스킬입니다.
유틸리티입문★ 90,139⑂ 7,846AI 점수 5/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
이 스킬은 claude-mem 플러그인의 내부 동작을 사용자에게 쉬운 말로 설명해주는 '문서형' 스킬입니다.
- 관찰 수집: Claude가 수행하는 모든 Read, Edit, Bash 작업이 압축된 관찰(observation)로 기록되고, 세션이 끝나면 요약됩니다.
- 기억 주입 시점: 같은 프로젝트에서 두 번째 세션부터 관련 기억이 자동으로 프롬프트에 주입됩니다. 첫 세션은 기억을 심는 단계이며,
/learn-codebase로 저장소 전체를 한 번에(약 5분) 미리 학습시킬 수도 있습니다. - 데이터 위치: 모든 데이터(SQLite DB, 벡터 인덱스, 로그, 설정)는 로컬
~/.claude-mem디렉터리에 저장되며, 압축에 사용하는 AI 제공자(Claude/OpenRouter/Gemini) 호출을 제외하면 외부로 나가지 않습니다.npx claude-mem uninstall로 깔끔히 제거됩니다.
이런 분께 추천
- claude-mem을 막 설치해서 "이게 대체 뭘 하는 거지?"가 궁금한 초보자
- 회사 코드가 외부로 나가는지, 데이터가 어디 저장되는지 확인해야 하는 분
- 팀원에게 claude-mem 도입을 설명해야 하는 리드 개발자
활용 예시
- "claude-mem은 어떻게 동작해?"라고 물으면 관찰 수집 → 세션 종료 요약 → 다음 세션 자동 주입 흐름을 정리해 답합니다.
- "내 기억 데이터가 어디에 저장돼? 외부로 전송돼?"라고 물으면
~/.claude-mem로컬 저장과 AI 제공자 호출 예외를 설명합니다. - "왜 아직 아무 컨텍스트도 안 불러와?"라고 물으면 두 번째 세션부터 주입되며
/learn-codebase로 앞당길 수 있다고 안내합니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 thedotmack/claude-mem 의 plugin/skills/how-it-works 폴더를 내 ~/.claude/skills/how-it-works/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/thedotmack/claude-mem.git && mkdir -p ~/.claude/skills/how-it-works && cp claude-mem/plugin/skills/how-it-works/SKILL.md ~/.claude/skills/how-it-works/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 엽니다.
- 저장소를 내려받습니다:
git clone https://github.com/thedotmack/claude-mem.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills/how-it-works - 파일을 복사합니다:
cp claude-mem/plugin/skills/how-it-works/SKILL.md ~/.claude/skills/how-it-works/ - (권장) claude-mem 본체도 함께 사용하려면 저장소 README를 따라
npx claude-mem install을 실행합니다. - Claude Code를 다시 시작한 뒤 "claude-mem은 어떻게 동작해?"라고 물어 스킬이 응답하는지 확인합니다.
GitHub에서 원본 보기 ↗라이선스: Apache-2.0