← 보드로 돌아가기

thedotmack/claude-mem

Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More

GitHub에서 열기 ↗ aiai-agentsai-memoryanthropicartificial-intelligencechromadbclaudeclaude-agent-sdkclaude-agentsclaude-codeclaude-code-pluginclaude-skillsembeddingslong-term-memorymem0memory-engineopenmemoryragsqlitesupermemory
86,667
GitHub 스타
7,490
포크
JavaScript
언어
Apache-2.0
라이선스
2026.07.09
최근 푸시
2026.04.21
별표한 날

AI 분석

설치 난이도: 쉬움
큐레이터 노트
Claude-Mem은 AI 에이전트의 장기 기억을 자동으로 관리해주는 강력한 도구로, 특히 Claude Code 사용자에게 필수적입니다. 점진적 공개와 토큰 효율적인 검색 패턴이 돋보이며, 다양한 CLI 지원으로 확장성이 뛰어납니다. 다만 베타 기능의 구체적인 내용이 부족하여 추가 문서 확인이 필요합니다.

강점

  • 세션 간 컨텍스트를 자동으로 유지하여 AI 에이전트의 연속성을 크게 향상시킵니다.
  • MCP 도구를 통한 3계층 검색 패턴으로 토큰 사용량을 최대 10배 절약할 수 있습니다.
  • 다양한 CLI (Claude Code, Gemini CLI, OpenCode 등)와 OpenClaw 게이트웨이를 지원하여 폭넓은 호환성을 제공합니다.

약점

  • README에 Endless Mode와 같은 베타 기능에 대한 구체적인 설명이 부족하여 실제 동작을 파악하기 어렵습니다.
  • 설치 시 npx 명령어를 사용해야 하며, npm 전역 설치로는 플러그인이 완전히 설정되지 않아 혼란을 줄 수 있습니다.

주의사항

  • npm install -g claude-mem은 SDK만 설치하므로 반드시 npx claude-mem install 또는 /plugin 명령어를 사용해야 합니다.
  • 베타 채널 기능은 실험적이므로 프로덕션 환경에서 사용 시 주의가 필요합니다.
  • 개인정보 보호를 위해 민감한 내용은 <private> 태그로 감싸야 합니다.

시작 가이드

  • npx claude-mem install 명령어로 Claude Code에 플러그인을 설치하고 재시작하여 기본 동작을 확인합니다.
  • http://localhost:37777에서 웹 뷰어 UI를 열어 메모리 스트림을 실시간으로 모니터링합니다.
  • MCP 검색 도구(search, timeline, get_observations)를 사용하여 프로젝트 기록을 탐색하고 토큰 절약 효과를 경험합니다.
  • 공식 문서(https://docs.claude-mem.ai/)를 방문하여 컨텍스트 엔지니어링 및 점진적 공개 모범 사례를 학습합니다.

README 한국어 번역

이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.

Claude-Mem

Claude Code를 위한 지속적인 메모리 압축 시스템입니다.

빠른 시작

단일 명령어로 설치:

npx claude-mem install

또는 Gemini CLI용 설치 (자동으로 ~/.gemini 감지):

npx claude-mem install --ide gemini-cli

또는 OpenCode용 설치:

npx claude-mem install --ide opencode

또는 Claude Code 내부의 플러그인 마켓플레이스에서 설치:

/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem

Claude Code 또는 Gemini CLI를 재시작하세요. 이전 세션의 컨텍스트가 새 세션에 자동으로 나타납니다.

참고: Claude-Mem은 npm에도 게시되어 있지만, npm install -g claude-mem은 SDK/라이브러리만 설치합니다. 플러그인 훅을 등록하거나 워커 서비스를 설정하지 않습니다. 항상 npx claude-mem install 또는 위의 /plugin 명령어를 통해 설치하세요.

🦞 OpenClaw Gateway

단일 명령어로 OpenClaw 게이트웨이에 claude-mem을 지속적 메모리 플러그인으로 설치:

curl -fsSL https://install.cmem.ai/openclaw.sh | bash

설치 프로그램이 종속성, 플러그인 설정, AI 제공자 구성, 워커 시작, Telegram, Discord, Slack 등으로의 선택적 실시간 관찰 피드를 처리합니다. 자세한 내용은 OpenClaw 통합 가이드를 참조하세요.

주요 기능:

  • 🧠 지속적 메모리 - 컨텍스트가 세션 간에 유지됨
  • 📊 점진적 공개 - 토큰 비용 가시성을 갖춘 계층적 메모리 검색
  • 🔍 스킬 기반 검색 - mem-search 스킬로 프로젝트 기록 쿼리
  • 🖥️ 웹 뷰어 UI - http://localhost:37777에서 실시간 메모리 스트림
  • 💻 Claude Desktop 스킬 - Claude Desktop 대화에서 메모리 검색
  • 🔒 개인정보 보호 - <private> 태그를 사용하여 민감한 콘텐츠를 저장에서 제외
  • ⚙️ 컨텍스트 구성 - 주입할 컨텍스트에 대한 세밀한 제어
  • 🤖 자동 작동 - 수동 개입 불필요
  • 🔗 인용 - ID로 과거 관찰 참조 (http://localhost:37777/api/observation/{id}에서 접근하거나 http://localhost:37777의 웹 뷰어에서 모두 보기)
  • 🧪 베타 채널 - 버전 전환을 통해 Endless Mode와 같은 실험적 기능 시도

문서

📚 전체 문서 보기 - 공식 웹사이트에서 탐색

시작하기

모범 사례

아키텍처

구성 및 개발

작동 방식

핵심 구성 요소:

  1. 5개의 라이프사이클 훅 - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6개의 훅 스크립트)
  2. 스마트 설치 - 캐시된 종속성 검사기 (사전 훅 스크립트, 라이프사이클 훅 아님)
  3. 워커 서비스 - 포트 37777의 HTTP API, 웹 뷰어 UI 및 10개의 검색 엔드포인트, Bun으로 관리
  4. SQLite 데이터베이스 - 세션, 관찰, 요약 저장
  5. mem-search 스킬 - 점진적 공개를 통한 자연어 쿼리
  6. Chroma 벡터 데이터베이스 - 지능형 컨텍스트 검색을 위한 하이브리드 의미 + 키워드 검색

자세한 내용은 아키텍처 개요를 참조하세요.

MCP 검색 도구

Claude-Mem은 토큰 효율적인 3계층 워크플로 패턴을 따르는 4개의 MCP 도구를 통해 지능형 메모리 검색을 제공합니다:

3계층 워크플로:

  1. search - ID가 포함된 간결한 인덱스 가져오기 (~50-100 토큰/결과)
  2. timeline - 흥미로운 결과 주변의 시간순 컨텍스트 가져오기
  3. get_observations - 필터링된 ID에 대해서만 전체 세부 정보 가져오기 (~500-1,000 토큰/결과)
  • Claude는 MCP 도구를 사용하여 메모리 검색
  • search로 결과 인덱스부터 시작
  • timeline을 사용하여 특정 관찰 주변 상황 확인
  • get_observations로 관련 ID의 전체 세부 정보 가져오기
  • 세부 정보를 가져오기 전에 필터링하여 ~10배 토큰 절약

작동 방식:

사용 가능한 MCP 도구:

  1. search - 전체 텍스트 쿼리로 메모리 인덱스 검색, 유형/날짜/프로젝트별 필터
  2. timeline - 특정 관찰 또는 쿼리 주변의 시간순 컨텍스트 가져오기
  3. get_observations - ID로 전체 관찰 세부 정보 가져오기 (항상 여러 ID를 배치로 처리)

예제 사용:

// 1단계: 인덱스 검색
search(query="authentication bug", type="bugfix", limit=10)

// 2단계: 인덱스 검토, 관련 ID 식별 (예: #123, #456)

// 3단계: 전체 세부 정보 가져오기
get_observations(ids=[123, 456])

자세한 예제는 검색 도구 가이드를 참조하세요.

베타 기능

Claude-Mem은 베타 채널을 통해 Endless Mode (생체 모방 메모리...)와 같은 실험적 기능을 제공합니다.

원본 저장소: thedotmack/claude-mem

라이선스: Apache-2.0

게재 제외를 원하시면 삭제 요청을 보내주세요.