코딩 에이전트가 세션 사이를 잊지 않고 이어 작업할 수 있게 하는 메모리 시스템
새로운 세션이 열릴 때마다 에이전트가 처음부터 파일을 다시 읽고 같은 실수를 반복하는 상황을 끝냅니다. Claude-Mem은 에이전트가 작업하는 동안 두 번째 에이전트가 메모를 받아, 다음 세션에서 필요한 맥락만 골라 주입하는 구조입니다. Claude Code, Codex, Cursor 등 다양한 에이전트와 함께 작동하며, 설치 후 별도 조작 없이 자동으로 메모리를 관리합니다.
세션 간 기억을 이어주는 방식
에이전트가 파일을 읽거나 코드를 수정할 때 발생하는 모든 활동이 로컬 워커로 전달됩니다. 관찰자 에이전트는 이 활동들을 짧은 관찰 기록으로 변환하고, 세션이 끝나면 요약을 작성합니다. 다음 세션이 시작되면 이 관찰 기록의 압축된 인덱스가 먼저 주입되고, 에이전트가 필요할 때만 상세 내용을 가져오도록 설계되어 있습니다. 이를 통해 토큰 사용량을 줄이면서도 중요한 맥락을 유지할 수 있습니다.
메모리 검색과 팀 공유 기능
mem-search 스킬을 통해 프로젝트 히스토리를 자연어로 검색할 수 있습니다. 검색은 인덱스 조회, 타임라인 확인, 상세 정보 가져오기의 세 단계로 진행되며, 필요한 정보만 선택적으로 불러와 토큰 효율을 높입니다. 팀원 간 공유를 원할 경우 TeamBrain을 통해 작업 목록과 기여자를 관리할 수 있으며, 개인적인 메모는 별도로 유지됩니다. 또한 Claude Desktop에서도 이 메모리를 검색할 수 있습니다.
설치와 요구 사항
Node.js 20.19 이상 또는 22.12 이상이 필요하며, Bun과 uv는 설치 과정에서 자동으로 처리됩니다. npx claude-mem install 명령을 실행하면 시스템에 설치된 에이전트를 감지하고 설정을 완료합니다. Claude Code를 사용하는 경우 플러그인 마켓플레이스를 통해 설치할 수도 있습니다. 메모리는 기본적으로 로컬의 ~/.claude-mem 디렉터리에 저장되며, 클라우드 동기화는 선택 사항입니다.
적용 전 확인 사항
이 도구는 Apache License 2.0으로 배포되어 상업적 사용이 가능합니다. 다만, 메모리 주입은 프로젝트 내 두 번째 세션부터 시작되므로 첫 세션에서는 효과가 없습니다. 전체 저장소를 빠르게 학습하려면 /learn-codebase 명령을 실행할 수 있습니다. 또한, <private> 태그로 감싼 내용은 저장되지 않으므로 민감한 정보 처리 시 이 기능을 활용해야 합니다. 사용 분석 데이터 수집은 기본 활성화되어 있어, 비활성화를 원할 경우 npx claude-mem telemetry disable 명령을 실행해야 합니다.
