claude-mem
claude-mem은 AI coding assistant의 세션 관찰을 자동 저장, 압축, 검색, 재주입하는 persistent memory plugin이다.
2026-04-17
왜 중요한가
- 실무 기준으로는 에이전트의 약점은 세션이 바뀔 때 맥락이 쉽게 증발한다는 점이다.
- claude-mem은 이 문제를 transcript 누적이 아니라 관찰 압축과 search-first retrieval 방식으로 다룬다.
- Claude Code뿐 아니라 Gemini CLI, OpenCode, Codex CLI, OpenClaw까지 지원 범위를 넓히는 점도 실용적이다.
핵심 관찰
- 로컬 Windows 환경에서 repo를 직접 clone했다.
package.json기준 현재 버전은12.1.6, Node 요구사항은>=18.0.0, Bun 요구사항은>=1.0.0이었다.npm view claude-mem에서도 latest가12.1.6으로 확인됐다.npm pack --dry-run결과 배포물 안에dist/npx-cli/index.js, Claude plugin hooks, skills, UI viewer, OpenClaw plugin 파일이 포함돼 있었다.- 특히 tarball 안에
openclaw/openclaw.plugin.json,openclaw/SKILL.md,openclaw/install.sh가 포함돼 있어 OpenClaw 연동이 실제 패키지 수준에서도 확인됐다. npx claude-mem --help를 직접 실행했더니 install/update/uninstall 외에start,stop,status,search,transcript watch같은 런타임 명령과claude-code,gemini-cli,opencode,openclaw,codex-cli등의 IDE 식별자가 실제로 노출됐다.- Claude plugin hook 설정은
SessionStart,UserPromptSubmit,PostToolUse,PreToolUse,Stop,SessionEnd단계에서 worker service와 context injection을 호출하도록 되어 있었다. - OpenClaw plugin manifest에는
syncMemoryFile,workerPort,project,observationFeed같은 설정이 정의돼 있었고 라이브 observation feed도 지원하도록 설계돼 있었다. - README 배지와 실제 package 버전 표기가 다르게 보여 문서 동기화는 완벽하지 않아 보였다.
해석
claude-mem은 AI coding assistant의 세션 관찰을 자동 저장, 압축, 검색, 재주입하는 persistent memory plugin이다.
누구에게 도움이 되나
- Claude Code/Gemini CLI 사용자: 긴 프로젝트에서 세션 단절 비용 감소
- 소규모 개발팀: 작업 맥락과 의사결정의 다음 세션 전달
- 운영팀: 반복 조사나 장애 대응의 관찰 기록 보존
어디에 바로 써볼 수 있나
- agent memory를 관찰 압축, 검색, 재주입으로 다루는 설계 사례 연구
- 장기 개발/운영 세션에서 맥락 손실 감소와 회수 품질 개선 실험
- OpenClaw assistant에 cross-session memory, observation feed, search-first retrieval를 붙일 때 참고
- 긴 프로젝트에서 세션 단절 비용 감소
- 작업 맥락과 의사결정의 다음 세션 전달
- 반복 조사나 장애 대응의 관찰 기록 보존
주요 출처
공식 repo / docs
주의점
- 자동 메모리는 privacy 통제가 중요하다.
- worker service, Bun, hook 구조까지 포함돼 운영 복잡도가 있다.
- 과거 맥락이 잘못 압축되면 현재 판단을 오염시킬 수 있다.
- README와 실제 패키지 버전 표기 차이처럼 문서 동기화 이슈도 보인다.
다음에 볼 포인트
- 세션 메모리와 장기 메모리의 범위 분리가 더 명시적인 제품 기본값으로 굳어지는지 볼 것.
- skills, orchestration, writable memory를 어떤 정책 경계로 나누는지 비교할 것.