claude-mem이란? 클로드 코드 대화 기록 저장과 자동 기억 기능 활용법
Claude Code를 사용하다 보면 새로운 세션을 시작할 때마다 이전에 진행했던 작업이나 프로젝트의 중요한 결정 사항을 다시 설명해야 하는 경우가 있습니다. claude-mem은 이러한 문제를 해결하기 위한 오픈소스 메모리 플러그인입니다. Claude Code의 작업 기록을 자동으로 수집하고 핵심 내용을 요약해 저장한 다음, 다음 세션에서 관련 정보를 다시 불러올 수 있도록 도와줍니다.
💡 claude-mem 핵심 요약
- 이전 세션의 작업 내용과 주요 결정 사항을 자동으로 기록합니다.
- AI를 활용해 긴 작업 기록을 짧은 관찰 기록(Observation)으로 정리합니다.
- 새로운 세션에서 이전 프로젝트의 관련 정보를 자동으로 불러옵니다.
- 검색 기능을 통해 과거 작업 내용과 문제 해결 과정을 찾아볼 수 있습니다.
- 기본 데이터는 로컬 PC에 저장되며, 클라우드 동기화는 별도 선택 사항입니다.
claude-mem은 어떤 기능을 제공하나요?
claude-mem은 단순히 대화 내용을 파일로 저장하는 도구가 아닙니다. Claude Code의 작업 과정에서 발생하는 이벤트를 감지하고, 중요한 정보를 추출해 다음 작업에 활용할 수 있도록 구성되어 있습니다.
주요 기능은 다음과 같습니다.
🧠 자동 작업 기록: Claude Code가 파일을 읽거나 수정하고 명령어를 실행하는 과정 등을 기록합니다.
📝 작업 내용 요약: 긴 작업 기록을 핵심 내용 중심으로 압축해 저장합니다.
🔍 과거 기록 검색: 이전에 해결했던 오류, 코드 수정 내용, 프로젝트 관련 결정 사항 등을 검색할 수 있습니다.
🔄 세션 간 기억 유지: 새로운 세션을 시작하면 이전 작업에서 관련성이 높은 정보를 불러와 작업을 이어갈 수 있습니다.
예를 들어 웹사이트 로그인 기능을 개발하다가 작업을 종료한 뒤 며칠 후 다시 시작하더라도, 이전에 진행한 작업과 주요 변경 사항을 참고할 수 있습니다.
claude-mem 설치 방법
claude-mem은 Claude Code 플러그인 마켓플레이스를 이용하거나 공식 설치 프로그램을 통해 설치할 수 있습니다.
가장 간단한 방법은 Claude Code 터미널에서 다음 명령어를 순서대로 실행하는 것입니다.
/plugin marketplace add thedotmack/claude-mem
마켓플레이스 등록이 완료되면 플러그인을 설치합니다.
/plugin install claude-mem
설치 후 Claude Code를 재시작하고 새로운 세션을 시작하면 이전 작업의 관련 기억을 불러오는 기능을 사용할 수 있습니다.
별도의 설치 프로그램을 이용하려면 다음 명령어도 사용할 수 있습니다.
npx claude-mem install
이 방식은 필요한 실행 환경과 플러그인 구성 요소를 설치하는 과정을 안내합니다. Node.js 20 이상이 필요하며, Bun과 uv 등의 추가 실행 환경은 설치 과정에서 준비할 수 있습니다.
설치할 때 주의할 점은 npm install -g claude-mem 명령어를 사용하지 않는 것입니다. 이 명령어는 라이브러리 설치용으로, Claude Code의 플러그인 훅과 작업 서비스까지 등록하지 않습니다.
설치 후 실제로 어떻게 활용할까요?
claude-mem의 가장 큰 장점은 기억을 저장하기 위해 매번 별도의 명령어를 입력할 필요가 없다는 점입니다.
플러그인이 정상적으로 작동하면 Claude Code의 세션 시작, 도구 실행, 작업 종료 등의 이벤트에 연결된 훅(Hook)이 자동으로 실행됩니다.
예를 들어 다음과 같은 작업에 활용할 수 있습니다.
- 웹사이트 개발 중 이전에 수정했던 파일과 변경 이유 확인
- 반복적으로 발생했던 오류와 해결 방법 검색
- 프로젝트에서 사용하기로 결정한 기술과 개발 규칙 기억
- 여러 세션에 걸쳐 진행하는 복잡한 개발 작업 이어서 수행
또한 claude-mem은 검색 기능을 통해 과거 기록을 단계적으로 확인할 수 있도록 지원합니다.
개인정보와 저장 위치도 확인하세요
기본적인 메모리 데이터는 사용자 PC의 ~/.claude-mem/ 디렉터리에 저장됩니다. 주요 데이터베이스는 SQLite를 사용하며, 검색을 위한 추가 구성 요소도 활용합니다.
다만 AI 요약에 사용하는 모델과 메모리 제공자를 어떤 방식으로 설정했는지에 따라 데이터 처리 경로가 달라질 수 있습니다. 클라우드 동기화는 선택 사항이지만, 설치 과정의 분석 데이터 수집 설정도 확인하는 것이 좋습니다.
특히 회사 소스코드, API 키, 인증 정보 등 민감한 자료를 다룬다면 저장 범위와 외부 전송 여부를 먼저 확인하세요.
반복적인 설명을 줄이고 개발 흐름을 이어가세요
claude-mem은 Claude Code를 여러 날에 걸쳐 사용하거나 하나의 프로젝트를 장기간 개발하는 사용자에게 유용한 도구입니다.
특히 매번 프로젝트 구조와 이전 작업 내용을 설명하는 시간이 아깝다면 자동 기록과 검색 기능을 활용해 볼 만합니다.
우선 Claude Code에서 마켓플레이스를 등록하고 claude-mem을 설치한 다음, 새로운 세션에서 이전 작업의 기억이 정상적으로 불러와지는지 확인해 보세요.