AI 에이전트의 메모리를 영구 보존하는 claude-mem

핵심 요약

• Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot 등 다양한 AI 에이전트와 호환되는 메모리 압축 시스템으로, 세션 중 에이전트의 모든 활동을 캡처하고 AI로 압축한 후 이후 세션에 관련 맥락을 주입한다.
• 5개의 생명주기 훅(SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd)과 스마트 설치 기능으로 작동하며, Bun 기반 워커 서비스가 로컬 HTTP API와 웹 뷰어 UI를 제공한다.
• SQLite 데이터베이스에 세션과 관찰 내용을 저장하고, Chroma 벡터 데이터베이스를 통해 하이브리드 의미론적 검색과 키워드 검색을 지원하는 mem-search 기능으로 프로젝트 히스토리를 자연어로 쿼리할 수 있다.
• 4개의 MCP 도구(search, timeline, get_observations, 스킬 기반 검색)를 제공하며, 토큰 효율성을 위해 3계층 워크플로우(인덱스 조회 → 시간 맥락 확인 → 상세 정보 조회)를 따른다.
• npx claude-mem install 명령으로 설치하면 종속성 확인, 훅 등록, 워커 서비스 시작 등 모든 것을 자동으로 처리하며, 이메일 매직 링크로 가입한 후 메모리 제공자를 선택할 수 있다.
• 태그로 민감한 내용을 저장 제외할 수 있고, ~/.claude-mem/settings.json에서 AI 모델, 워커 포트, 로그 레벨, 맥락 주입 설정 등을 세밀하게 제어할 수 있다.
• code, code--zh(중국어), code--ja(일본어) 등 다양한 워크플로우 모드와 언어를 지원하며, 각 모드는 자동 생성되는 관찰의 동작과 언어를 제어한다.
• Node.js 20.0.0 이상, Claude Code 최신 버전, Bun, uv, SQLite 3를 필요로 하며, main(안정 릴리스), core-dev(초기 수정), community-edge(커뮤니티 통합) 세 브랜치에서 배포된다.
• Apache License 2.0 라이선스를 적용했으며, agentic 메모리가 개발자 도구, 로컬 에이전트, MCP 서버, 엔터프라이즈 시스템, 로보틱스 스택에 쉽게 임베드될 수 있도록 설계했다.
• 공식 X 계정(@Claude_Memory), Discord 채널, GitHub Issues로 지원하며, 저자는 Alex Newman(@thedotmack)이다.