AI & IT · AI 뉴스 ·

Claude Code 기억력 확장! claude-mem 설치 및 사용법 완벽 정리

Claude Code를 사용하다 보면 새로운 세션을 시작할 때마다 이전 작업 내용과 개발 방향을 다시 설명해야 하는 경우가 있습니다. claude-mem은 Claude Code의 작업 기록을 자동으로 수집하고 기억해 다음 세션에서 필요한 내용을 다시 활용할 수 있도록 도와주는 장기 기억(Memory) 플러그인입니다.

별도로 매번 작업 내용을 정리하지 않아도 이전에 해결한 버그, 프로젝트 구조, 개발 결정 사항 등을 이어서 활용할 수 있습니다.

📌 claude-mem 핵심 요약

  • 이전 세션의 작업 내용과 개발 기록을 자동으로 수집합니다.

  • 작업 기록을 요약해 다음 세션에 필요한 정보를 제공합니다.

  • SQLite 기반 로컬 데이터베이스에 기억을 저장합니다.

  • MCP 검색 기능으로 과거 작업 내용을 찾아볼 수 있습니다.

  • Claude Code 플러그인 방식으로 설치할 수 있습니다.

🧠 claude-mem은 어떤 기능을 제공할까요?

claude-mem은 Claude Code가 작업하는 동안 도구 사용 기록과 결과를 관찰하고, 이를 검색할 수 있는 짧은 기록으로 정리합니다.

새로운 세션이 시작되면 이전 작업에서 현재 프로젝트와 관련된 정보를 찾아 Claude Code에 전달합니다.

예를 들어 이전 세션에서 로그인 기능을 JWT 방식으로 구현하고 토큰 만료 문제까지 해결했다면, 다음 세션에서도 관련 개발 결정과 작업 기록을 참고할 수 있습니다.

특히 여러 날에 걸쳐 하나의 프로젝트를 개발하거나 반복적으로 코드를 수정하는 개발자에게 유용합니다.

⚙️ claude-mem 설치 방법

가장 간단한 방법은 Claude Code 내부의 플러그인 마켓플레이스를 이용하는 것입니다.

Claude Code 터미널에서 다음 명령어를 순서대로 실행하세요.

/plugin marketplace add thedotmack/claude-mem

마켓플레이스가 등록되면 플러그인을 설치합니다.

/plugin install claude-mem

설치가 끝나면 Claude Code를 재시작하세요. 이후 새로운 세션부터 이전 작업의 기억을 불러오는 기능을 사용할 수 있습니다.

다른 설치 방법으로는 터미널에서 다음 명령어를 실행하는 방법도 있습니다.

npx claude-mem install

이 방식은 설치할 개발 도구를 선택하는 과정을 거칠 수 있으며, 기억을 생성하는 AI 제공자도 선택해야 합니다.

💻 설치 전 확인할 사항

  • Node.js 20.19 이상(20.x) 또는 22.12 이상이 필요합니다.

  • Bun과 uv는 설치 과정에서 자동으로 준비할 수 있습니다.

  • Windows에서는 Node.js와 npm이 PATH에 등록되어 있어야 합니다.

  • 설치 후 터미널과 Claude Code를 다시 실행하는 것이 좋습니다.

참고로 npm install -g claude-mem은 SDK 및 라이브러리 설치이므로 플러그인과 작업 기록 기능까지 설정하는 올바른 설치 방법이 아닙니다.

🔍 claude-mem은 어떻게 기억을 활용할까요?

작동 과정은 크게 세 단계입니다.

  1. 작업 기록 수집: Claude Code의 도구 사용과 작업 결과를 Hook으로 감지합니다.

  2. 기억 생성: 별도의 Observer가 작업 내용을 분석해 관찰 기록과 세션 요약을 생성합니다.

  3. 기억 불러오기: 다음 세션에서 관련 기록을 찾아 필요한 정보만 전달합니다.

기억 검색에는 세 가지 주요 MCP 도구가 사용됩니다.

  • search: 관련 기억의 간략한 목록을 검색합니다.

  • timeline: 특정 작업의 시간순 맥락을 확인합니다.

  • get_observations: 선택한 기록의 상세 내용을 가져옵니다.

🛠️ 설치 후 활용하면 좋은 기능

프로젝트를 여러 번 수정한다면 과거의 개발 결정이나 버그 해결 과정을 검색해 활용할 수 있습니다. 또한 작업 기록을 확인할 수 있는 웹 뷰어를 통해 저장된 기억과 세션 정보를 살펴볼 수 있습니다.

한국어로 기억을 생성하고 싶다면 ~/.claude-mem/settings.json에서 다음 설정을 사용할 수 있습니다.

{
  "CLAUDE_MEM_MODE": "code--ko"
}

설정 변경 후 Claude Code를 재시작하면 한국어 관찰 기록과 요약을 생성하도록 설정할 수 있습니다.

🔒 개인정보와 보안은 확인하세요

기억 데이터는 기본적으로 사용자 컴퓨터의 ~/.claude-mem에 저장되며 클라우드 동기화는 선택 사항입니다. 다만 익명 사용 통계는 기본적으로 활성화되어 있으므로 원하지 않는다면 다음 명령어로 끌 수 있습니다.

npx claude-mem telemetry disable

비밀번호, API 키, 인증 토큰 등 민감한 정보는 기억에 저장하지 않도록 주의해야 합니다. <private> 태그로 감싼 내용은 저장 대상에서 제외할 수 있습니다.

Claude Code의 반복적인 설명을 줄이고 프로젝트의 개발 맥락을 이어가고 싶다면 claude-mem을 활용해 보세요. 우선 Claude Code에서 플러그인 설치 명령어를 실행하고, 두 번째 세션에서 이전 작업 기록이 정상적으로 전달되는지 확인해 보시기 바랍니다.