claude-mem
무엇인가
claude-mem은 코딩 에이전트에 세션 간 장기 기억을 붙이는 계층이다. 에이전트가 세션 중 수행한 작업을 수집해 압축하고, 이후 세션의 컨텍스트로 되돌려 넣는다. 배포 이름은 Grok Mem으로 바뀌었지만 npm 패키지명은 claude-mem을 유지한다.
어떻게 동작하나
동작은 라이프사이클 훅과 워커 서비스로 나뉜다. SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd 다섯 훅에 6개 훅 스크립트가 걸린다. 수집된 관찰은 AI로 압축되어 SQLite에 저장되고, FTS5 전문 검색과 Chroma 벡터 DB를 조합한 하이브리드 검색으로 조회된다. 워커는 Bun으로 관리되는 HTTP API 서비스이며, 시작 시 출력되는 URL에서 실시간 메모리 스트림을 보는 웹 뷰어를 제공한다. 관찰에는 ID가 붙어 워커 API로 인용할 수 있다.
무엇과 다른가
에이전트 자체의 메모리를 대체하지 않는다. Grok Bot의 내장 기억 옆에 나란히 놓여, 봇이 무엇을 했고 무엇을 결정했고 다음에 무엇을 할지를 기록하는 쪽을 맡는다. npm에 배포된 패키지와도 역할이 다르다. npm install -g claude-mem은 SDK/라이브러리만 설치하며 플러그인 훅 등록과 워커 서비스 구성은 하지 않는다.
어떻게 쓰나
설치는 npx claude-mem install 한 줄로 시작한다. 설치 스크립트가 의존성과 훅, 워커를 먼저 구성한 뒤 브라우저에서 이메일 매직 링크 로그인을 요청한다. 로그인하면 계정용 메모리 키가 발급되고 claude-mem 옵저버가 활성화된다. 이후 메모리 제공자로 claude-mem 옵저버, 자체 OpenRouter/Gemini 키, Anthropic 플랜 중 하나를 고른다. Claude Code 안에서는 /plugin 마켓플레이스로도 설치할 수 있고, OpenClaw 게이트웨이용 설치 명령이 별도로 제공된다. 설치 후 Claude Code를 재시작하면 이전 세션 컨텍스트가 새 세션에 나타난다.
전제와 한계
Grok Bot에는 호스트 훅이 없어 채팅 로그 파일을 감시하는 방식으로 동작한다. 기본 제공자는 호스팅 메모리인 CMEM Pro이며, 로컬 옵저버는 --provider host를 줘야 켜진다. 로그인을 건너뛰려면 --provider 플래그를 명시하거나 CLAUDE_MEM_ONLINE_OPTIN=false를 설정하거나 CI/비대화형 셸에서 실행한다. needle 관찰(decision, bugfix, security_alert, sensitive)을 해당 봇의 memory/log/YYYY-MM.md에 날짜 줄로 덧붙이는 awareness push 파일럿은 CLAUDE_MEM_GROK_BOT_AWARENESS_ENABLED=false로 끈다.
관련 논문 1
유사 도구
- agentmemory코딩 에이전트의 작업을 자동으로 수집·압축해 검색 가능한 장기 기억으로 저장하고, 다음 세션 시작 시 관련 컨텍스트를 주입하는 TypeScript CLI다.
- memU에이전트 세션 기록에서 재사용 가능한 스킬 Markdown을 자동 추출하고, 답변 전 관련 기억을 검색하도록 호스트 지시 파일에 상시 규칙을 심는 메모리 스킬 묶음이다.
- context-modeMCP 서버로 AI 코딩 에이전트의 도구 출력을 샌드박스에 격리해 컨텍스트 사용량을 98% 줄이고, 세션 기억을 SQLite에 남긴다.
- claude-brainClaude Code의 메모리·스킬·에이전트·규칙·설정을 git 원격 저장소로 동기화하고, 세션 시작·종료 훅에서 의미 기반 병합을 수행하도록 규정하는 플러그인이다.
- mempalace대화 기록을 원문 그대로 저장하고 의미 검색으로 꺼내는 로컬 우선 AI 메모리 CLI다. 요약 없이 계층 인덱스로 범위를 좁혀 검색한다.
- TencentDB-Agent-Memory대화·문서·코드를 Chat Memory, Skill, Wiki, CodeGraph 네 가지 자산으로 추출해 팀 단위로 공유·관리하는 에이전트 메모리 허브다.