thedotmack/claude-mem — AI 에이전트 세션을 넘나드는 지속적 메모리

AI 요약

Claude-Mem은 AI 에이전트가 세션을 마친 뒤에도 프로젝트의 작업 맥락을 이어가도록 돕는 지속 메모리 플러그인입니다. 도구 사용 중 발생한 관찰 내용을 저장하고 AI로 요약한 뒤, 이후 세션에서 관련 기록을 다시 불러옵니다. 저장소는 Claude Code를 기본으로 설명하지만 OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode 등 여러 에이전트 환경도 지원한다고 안내합니다.

구성과 데이터 흐름

Claude-Mem은 SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd 등 세션 생명주기 훅으로 동작합니다. 훅이 관찰 기록을 만들면 로컬 Worker가 이를 처리하고, Worker는 HTTP API와 웹 뷰어, 검색 엔드포인트를 제공합니다. 기록은 세션·관찰 내용·요약을 담는 SQLite 데이터베이스에 저장합니다. 검색에는 Chroma 벡터 데이터베이스와 키워드 검색을 결합한 하이브리드 방식을 사용합니다. Worker와 의존성 관리는 Bun을 활용하며, 벡터 검색에는 uv가 필요합니다. 설치 과정에서 관련 도구가 없으면 자동 설치한다고 프로젝트는 설명합니다.

검색은 세 단계로 좁힙니다

메모리 검색은 결과를 한꺼번에 모두 가져오기보다 필요한 기록을 순서대로 좁히는 방식입니다. 먼저 search로 간단한 결과 목록을 받고, timeline으로 선택한 기록 주변의 시간 순서 맥락을 확인합니다. 마지막으로 get_observations에 필요한 ID만 전달해 상세 내용을 가져옵니다. 프로젝트 문서는 검색 결과 하나당 요약 목록에 약 50~100토큰, 상세 기록에 약 500~1,000토큰이 든다고 안내합니다. 세부 기록을 가져오기 전에 후보를 걸러 토큰을 약 10분의 1로 줄이는 것이 설계 목표입니다. 검색은 자연어 질의를 지원하며 유형, 날짜, 프로젝트 기준으로 필터링할 수 있습니다.

설치와 설정

기본 설치 명령은 npx claude-mem install입니다. 설치 뒤 브라우저에서 이메일 매직 링크로 로그인하면 claude-mem observer를 설정할 수 있으며, 로그인하지 않으려면 --provider를 지정하거나 CLAUDE_MEM_ONLINE_OPTIN=false를 설정하면 됩니다. 메모리 제공자는 claude-mem observer, 사용자의 OpenRouter 또는 Gemini 키, Anthropic 플랜 가운데 선택합니다. Claude Code 플러그인 마켓플레이스에서도 설치할 수 있고, OpenCode·Antigravity CLI·Oh My Pi용 설치 명령도 제공합니다.

설정 파일은 ~/.claude-mem/settings.json입니다. AI 모델, Worker 포트, 데이터 디렉터리, 로그 수준, 세션에 주입할 맥락을 조정합니다. 기본 설정에서는 세션 시작 때 현재 에이전트 환경의 기록만 불러옵니다. Claude Code와 Codex의 기록을 모두 포함하려면 CLAUDE_MEM_SESSION_START_INCLUDE_ALL_SOURCES를 활성화합니다. <private> 태그로 민감한 내용을 저장 대상에서 제외하는 기능도 제공합니다.

사용 시 확인할 점

프로젝트는 npm install -g claude-mem이 SDK와 라이브러리만 설치하며 플러그인 훅이나 Worker를 등록하지 않는다고 명시합니다. 기능을 사용하려면 npx claude-mem install 또는 플러그인 명령으로 설치해야 합니다. 저장소는 Apache License 2.0을 적용하며 main을 안정 버전 배포에 사용합니다. core-dev와 community-edge는 소스에서 실행하는 별도 브랜치입니다.

원문: GitHub / 번역·요약: Trawling