claude-mem 설치 가이드 — 클로드 코드가 어제 한 작업을 기억하게 + 지난 작업 찾는 질문 30개

클로드 코드는 창을 닫으면 방금까지 한 작업을 다 잊어버려요. 클로드 멤(claude-mem)을 깔면 작업하는 동안 읽은 파일과 고친 내용을 자동으로 요약해서 저장하고, 새 창을 열면 지난 작업을 알아서 불러와요. 무료 오픈소스(Apache-2.0), 깃허브 별 11.4만(2026-11-07 기준).
이 페이지에 README 공식 설치 명령어, 실제로 돌려 본 화면, 지난 작업 찾는 질문 30개, 비밀번호·개인정보를 저장에서 빼는 법을 정리했어요.

한눈에 보기

설치 — 명령어 한 줄

터미널에서 (README 공식 명령, 모든 프로젝트에 적용)

npx claude-mem install

• 필요한 프로그램(Bun, uv)이 없으면 알아서 깔아요. Node.js 20 이상이 필요해요.
• 설치가 끝나면 브라우저에서 claude-mem 로그인(이메일 링크)을 하라고 나와요. 로그인하면 claude-mem 관찰기 30일 무료 체험이 열리고, 체험이 끝나면 내 Anthropic 요금제로 자동으로 돌아가요.
• 로그인 없이 바로 쓰고 싶으면 이렇게 깔아요. 요약은 내 클로드 요금제로 만들어요.

npx claude-mem install --provider claude

클로드 코드 안에서 입력해도 돼요

/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem

• 설치한 뒤에는 클로드 코드를 껐다 켜세요. 기억은 두 번째 세션부터 들어가요(첫 세션에서 쌓고, 다음 창에서 불러와요).
• npm install -g claude-mem은 라이브러리만 깔려서 동작하지 않아요. 꼭 위 명령으로 설치하세요.
• 기억을 한국어로 남기려면 ~/.claude-mem/settings.json에 아래 한 줄을 넣고 클로드 코드를 다시 켜세요.

"CLAUDE_MEM_MODE": "code--ko"

실제로 써 봤어요

1) 첫 번째 창에서 버그 고치기 — login.js의 로그인 버그를 고쳐 달라고 했어요. 클로드가 일하는 동안 claude-mem이 "원인 파악", "login.js 비교 로직을 trim 호출과 엄격한 비교로 수정", "수정된 함수 검증" 3개 기록을 자동으로 남겼어요. 로컬 뷰어(http://127.0.0.1:37701/viewer, 포트는 설치 화면에 나와요)에서 바로 볼 수 있어요.

2) 창을 닫고 새 창에서 — 아무 설명 없이 물어봤어요.

지난번에 하던 작업 어디까지 했지? 세 줄로

3) 예전 기록 검색

로그인 버그 어떻게 고쳤지? 세 줄로

지난 작업 찾는 질문 30개

새 창에서 그대로 붙여 넣으세요. 파일·기능 이름만 내 프로젝트에 맞게 바꾸면 돼요. 더 확실하게 하려면 앞에 /mem-search를 붙이세요.

이어서 시작할 때

1. 지난번에 하던 작업 어디까지 했지? 세 줄로 정리해 줘
2. 어제 이 프로젝트에서 뭘 고쳤는지 시간 순서대로 알려 줘
3. 지난 세션에서 끝내지 못한 일이 있어? 이어서 할 순서를 정해 줘
4. 마지막으로 수정한 파일 목록이랑 왜 고쳤는지 알려 줘
5. 이번 주에 이 프로젝트에서 한 일을 팀 보고용 5줄로 요약해 줘
6. 지난번 작업에서 테스트를 안 돌린 부분이 있으면 알려 줘

버그·오류

1. 로그인 버그 어떻게 고쳤지?
2. 예전에 'require is not defined' 오류 났을 때 어떻게 해결했어?
3. 지난달에 결제 쪽에서 고친 버그 목록 보여 줘
4. 같은 오류가 또 났어. 예전에 고친 기록을 찾아서 같은 방법으로 고쳐 줘
5. 이 파일에서 예전에 발견한 주의할 점이 있었어?
6. 버그 고친 기록만 골라서 최근 10개 보여 줘

결정과 이유

1. 데이터베이스를 왜 이걸로 정했었지?
2. 이 함수 구조를 바꾼 이유가 기록에 있어?
3. 지난번에 시도했다가 버린 방법이랑 그 이유 알려 줘
4. 이 라이브러리를 고른 결정 기록 찾아 줘
5. API 응답 형식 정할 때 어떤 선택지를 비교했었지?
6. 화면 색이나 레이아웃을 바꾼 이유가 뭐였지?

파일·코드

1. auth.js 파일을 마지막으로 건드린 게 언제고 뭘 바꿨어?
2. 환경 변수 설정을 바꾼 기록 있어?
3. 테스트 파일을 추가하거나 고친 기록 보여 줘
4. 배포 스크립트 관련해서 했던 작업 찾아 줘
5. 지난번에 만든 컴포넌트 이름이 뭐였지?
6. README 고친 내용만 모아서 보여 줘

정리·회고

1. 이 프로젝트에서 자주 막혔던 문제 TOP 3 알려 줘
2. 지난 2주 동안 한 작업을 날짜별 표로 만들어 줘
3. 새로 합류한 사람에게 지금까지 진행 상황을 설명하는 글을 써 줘
4. 기록을 보고 다음에 할 일 5개를 추천해 줘
5. 내가 반복해서 시킨 작업 중에 스킬로 만들 만한 걸 골라 줘
6. 지난주 작업 중에 다시 확인해야 할 위험한 변경이 있었어?

비밀번호·개인정보를 저장에서 빼는 법

방법 1. <private> 태그로 감싸기 — 태그 안의 내용은 이번 세션에서 클로드가 보고 쓰지만, 기억에는 저장되지 않아요.

이 오류 원인 찾아 줘
<private>
DB 주소: internal-db.company.com
사용자: admin / 비밀번호: ********
</private>

방법 2. 자동 가리기 켜기 — API 키, 깃허브 토큰 같은 흔한 비밀 값 35종을 저장 전에 <redacted/>로 바꿔요. ~/.claude-mem/settings.json에 넣으세요.

"CLAUDE_MEM_REDACT_ENABLED": "true"

• 비밀번호처럼 정해진 모양이 없는 값은 자동으로 못 잡을 수 있어요. 비밀번호는 방법 1로 감싸는 걸 기본으로 하세요.
• 이미 저장된 기록은 뷰어에서 카드의 휴지통 버튼으로 지울 수 있어요.

이렇게 쓰면 좋아요

1. 프로젝트 폴더별로 기억이 쌓여요. 같은 폴더에서 클로드 코드를 열어야 그 프로젝트 기억을 불러와요.
2. 하루 시작할 때 "지난번에 하던 작업 어디까지 했지?" 한 줄로 시작하세요.
3. 뷰어를 브라우저에 띄워 두면 기록이 쌓이는 걸 실시간으로 볼 수 있어요.
4. 오래된 큰 저장소는 /learn-codebase로 처음에 한 번 읽혀 두면 좋아요(약 5분).

왜 중요한가요

• 매번 "이 프로젝트는 이렇고, 어제 여기까지 했고…"를 다시 설명하지 않아도 돼요.
• 지난 기록 전체를 넣는 게 아니라 필요한 것만 골라 꺼내서, 토큰을 아껴요.
• 기록이 내 컴퓨터에 남아서, 어떤 걸 기억하는지 뷰어로 직접 확인하고 지울 수 있어요.

비용

• 프로그램은 무료 오픈소스예요.
• 요약을 만들 때 AI를 써요. 로그인하면 30일 무료 체험(claude-mem 관찰기)을 쓰고, 그 뒤나 --provider claude로 깔면 내 클로드 요금제 사용량으로 만들어요. 사용량이 걱정되면 "CLAUDE_MEM_MODE": "code--chill"(꼭 필요한 것만 기록)도 있어요.

자주 묻는 질문

• 새 창을 열었는데 기억이 안 나와요 → 첫 세션에서는 기록만 쌓여요. 두 번째 세션부터 들어가요. 클로드 코드를 완전히 껐다 켜고, 같은 프로젝트 폴더에서 여세요.
• 명령이 안 먹어요 / 'claude-mem' 명령을 못 찾아요 → 터미널을 새로 열고 npx claude-mem doctor를 돌려 보세요.
• 클로드 앱(채팅)에서도 되나요? → 이 플러그인은 클로드 코드용이에요. 클로드 데스크톱용 검색 스킬은 따로 있어요.
• 원래 있는 클로드 코드 기억 기능은요? → 설치할 때 그대로 켜 둬요. 둘 다 같이 써도 돼요.
• 지우고 싶어요 → 뷰어에서 기록을 하나씩 지우거나, 클로드 코드에서 /plugin으로 플러그인을 끌 수 있어요.

링크

• 저장소: https://github.com/thedotmack/claude-mem
• 한국어 README: https://github.com/thedotmack/claude-mem/blob/main/docs/i18n/README.ko.md
• 공식 문서: https://docs.claude-mem.ai