claude-mem
세션이 끝나도 남는 코딩 에이전트 기억 계층
npm install -g claude-mem코딩 에이전트의 세션 기억을 저장하고 다음 세션에 되돌려 주는 도구입니다. 대화가 끝날 때 요약을 남기고 새 세션 시작 때 관련 기억만 꺼내 붙입니다. Claude Code 플러그인과 여러 에디터용 설치 경로를 제공합니다.
판단
이럴 때 씁니다
- 세션이 바뀔 때마다 프로젝트 배경을 다시 설명하는 일이 반복될 때
- 지난 작업에서 내린 결정을 에이전트가 기억하길 바랄 때
- 여러 에디터에서 같은 기억을 공유하고 싶을 때
- 컨텍스트 압축으로 사라지는 정보를 밖에 남겨 두고 싶을 때
이럴 땐 쓰지 마세요
- 프로젝트 문서에 배경을 적어 두는 방식으로 충분할 때
- 기억 저장소에 코드 맥락이 쌓이는 것이 정책상 곤란할 때
- 설치 항목을 늘리고 싶지 않을 때
차별점
- 세션 종료 시 요약을 남기고 다음 세션에서 관련 기억만 꺼내 붙입니다.
- 여러 에디터용 설치 경로를 제공해 도구를 옮겨도 기억이 이어집니다.
- 플러그인 마켓플레이스 설치를 지원합니다.
- 기여자와 이슈 활동이 활발해 문제 대응이 빠릅니다.
워크플로
- 01npm 으로 전역 설치하거나 플러그인 마켓플레이스에서 추가합니다.
- 02install 명령으로 사용하는 에디터에 연결합니다.
- 03세션이 끝날 때 요약이 저장되고 새 세션에서 관련 기억이 불려 옵니다.
- 04쌓인 기억은 주기적으로 확인해 오래된 결정이 남아 있지 않은지 정리합니다.
주요 명령
| 명령 | 설명 |
|---|---|
npm install -g claude-mem | 전역 설치합니다. |
npx claude-mem install | 기본 설치 경로로 연결합니다. |
/plugin install claude-mem | Claude Code 플러그인으로 설치합니다. |
함정
설치 전에 확인하세요
- 메이저 버전이 13 까지 올라와 있습니다. 변경이 잦으니 업데이트 뒤 동작을 확인하는 편이 좋습니다.
- 기억이 쌓이면 낡은 결정이 그대로 살아남아 잘못된 전제를 주입할 수 있습니다. 정리 주기가 필요합니다.
- 에디터별 설치 경로가 나뉘어 있습니다. 여러 도구를 쓴다면 각각 연결해야 합니다.
비교
프로젝트 규칙 파일에 배경을 적어 두는 방식과 목적이 겹칩니다. 차이는 자동 여부입니다. 규칙 파일은 사람이 관리하는 대신 내용이 정확하고, 이쪽은 자동으로 쌓이는 대신 낡은 정보가 섞일 수 있습니다. 둘을 함께 쓰되 규칙 파일을 진실의 출처로 두는 편이 안전합니다.
최근 변경
v13.24.0 은 설치 구조를 나눴습니다. 하나로 묶여 있던 플러그인을 에디터별 독립 플러그인으로 분리하고, install 명령에 대상 에디터를 지정하는 플래그를 넣었습니다. 두 대상을 함께 지정하는 것도 가능합니다.