개요
Claude-Mem은 코딩 세션에서 Claude의 관찰 내용을 자동으로 캡처하고 압축하여 향후 컨텍스트 주입을 위해 저장합니다. AI 요약과 벡터 검색을 활용하여 관련 메모리를 검색함으로써 세션 간 연속성을 구현합니다.
README 미리보기
\n \n \n \n \n \n \n \n \n \n\n\n\n 🇨🇳 中文 •\n 🇹🇼 繁體中文 •\n 🇯🇵 日本語 •\n 🇵🇹 Português •\n 🇧🇷 Português •\n 🇰🇷 한국어 •\n 🇪🇸 Español •\n 🇩🇪 Deutsch •\n 🇫🇷 Français •\n 🇮🇱 עברית •\n 🇸🇦 العربية •\n 🇷🇺 Русский •\n 🇵🇱 Polski •\n 🇨🇿 Čeština •\n 🇳🇱 Nederlands •\n 🇹🇷 Türkçe •\n 🇺🇦 Українська •\n 🇻🇳 Tiếng Việt •\n 🇵🇭 Tagalog •\n 🇮🇩 Indonesia •\n 🇹🇭 ไทย •\n 🇮🇳 हिन्दी •\n 🇧🇩 বাংলা •\n 🇵🇰 اردو •\n 🇷🇴 Română •\n 🇸🇪 Svenska •\n 🇮🇹 Italiano •\n 🇬🇷 Ελληνικά •\n 🇭🇺 Magyar •\n 🇫🇮 Suomi •\n 🇩🇰 Dansk •\n 🇳🇴 Norsk\n\n\nPersistent memory compression system built for Claude Code.\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n\n\n\n \n \n \n \n \n \n \n\n\n\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n\n\n Quick Start •\n How It Works •\n Search Tools •\n Documentation •\n Configuration •\n Troubleshooting •\n License\n\n\n\n Claude-Mem seamlessly preserves context across sessions by automatically capturing tool usage observations, generating semantic summaries, and making them available to future sessions. This enables Claude to maintain continuity of knowledge about projects even after sessions end or reconnect.\n\n\n---\n\n## Quick Start\n\nInstall with a single command:\n\n```bash\nnpx claude-mem install\n```\n\nOr install for Gemini CLI (auto-detects `~/.gemini`):\n\n```bash\nnpx claude-mem install --ide gemini-cli\n```\nOr install for OpenCode:\n\n```bash\nnpx claude-mem install --ide opencode\n```\n\nOr install from the plugin marketplace inside Claude Code:\n\n```bash\n/plugin marketplace add thedotmack/claude-mem\n\n/plugin install claude-mem\n```\n\nRestart Claude Code or Gemini CLI. Context from previous sessions will automatically appear in new sessions.\n\n> **Note:** Claude-Mem is also published on npm, but
FAQ (5)
문제 해결claude-mem이 LM Studio에서 특정 모델을 자동으로 로드하여 높은 메모리 사용량을 유발하는 이유는 무엇인가요?
claude-mem은 이전에 기본 모델(예: claude-haiku-4-5-20251001)을 하드코딩하여, 필요하지 않을 때도 LM Studio가 해당 모델을 로드하도록 강제했습니다. claude-mem v13.4.0 이상으로 업데이트하십시오. 이 버전은 기본 CLAUDE_MEM_MODEL을 빈 문자열로 변경하여, 관찰자 세션이 상위 세션의 모델을 상속받고 불필요한 모델 로드를 방지합니다. 이전 버전의 경우 설정에서 CLAUDE_MEM_MODEL을 ""로 수동 설정하십시오.
문제 해결claude-mem에서 DeepSeek으로 전환하여 높은 AI 압축 비용을 어떻게 줄일 수 있나요?
claude-mem을 v13.4.0 이상으로 업그레이드하세요. 작업자(worker)의 제공자 드롭다운에서 기본 제공자로 DeepSeek을 선택하세요. DeepSeek API 키(sk-...)를 입력하세요. 모델 구성: 단순 티어에는 deepseek-v4-flash를, 요약 티어에는 deepseek-v4-pro를 사용하세요(DeepSeek 비용은 Claude Haiku의 약 1/10입니다). 또는 환경 변수를 설정하세요: CLAUDE_MEM_PROVIDER=deepseek, CLAUDE_MEM_DEEPSEEK_API_KEY=sk-xxx, CLAUDE_MEM_MODEL=deepseek-v4-flash. 이는 ~/.claude-mem/.env를 수동으로 편집하는 기존의 우회 방법을 대체합니다.
문제 해결claude-mem이 빈 CLAUDE.md 스켈레톤 파일로 디렉토리를 오염시키는 것을 방지하는 방법
claude-mem v13.4.0(PR #2701과 함께 릴리스됨)으로 업그레이드하세요. 이 버전은 .git, .venv, fixtures 등과 같은 디렉터리에서 스켈레톤 주입을 억제하기 위해 구성 가능한 deny-list를 도입합니다. v13.4.0 이전 버전의 경우 해결 방법으로 프로젝트의 .gitignore에 **/CLAUDE.md를 추가한 다음, 추적 중인 합법적인 CLAUDE.md 파일(예: !/CLAUDE.md)을 위해 ! 무시 해제 패턴을 사용하세요.
문제 해결claude-mem에서 하위 디렉터리에서 작업할 때 PreToolUse 중에 파일 관찰이 주입되지 않는 이유는 무엇인가요?
이 버그는 경로 불일치로 인해 발생했습니다. PostToolUse는 관찰 경로를 현재 작업 디렉토리 기준으로 저장했지만, PreToolUse는 프로젝트 루트 기준으로 조회했습니다. 이로 인해 작업 디렉토리가 변경될 때 컨텍스트 주입이 깨졌습니다. claude-mem v13.4.0에서 수정되었습니다. 해당 버전 이상으로 업그레이드하세요. 즉시 업그레이드할 수 없는 경우, 임시 해결책은 모든 파일 작업 중에 작업 디렉토리를 프로젝트 루트로 유지하는 것입니다.
문제 해결Unix 사용자 이름이나 프로젝트 경로에 점(.)이 포함되어 있으면 claude-mem의 마지막 메시지가 누락되는 이유는 무엇인가요?
claude-mem을 v13.4.0 이상으로 업그레이드하세요. 경로 인코딩 버그는 v13.4.0 릴리스에서 수정되었습니다. v13.0.1과 같이 영향을 받는 버전에서는 claude-mem이 현재 작업 디렉터리를 인코딩할 때 /만 치환했지만, Claude Code는 .도 -로 치환합니다. 이로 인해 마지막 메시지 조회가 잘못된 ~/.claude/projects/... 디렉터리를 대상으로 하게 되었습니다. 임시 해결 방법으로, 점이 포함된 경로에서 Claude Code의 대시 인코딩 경로로 symlink를 생성하세요:
ln -s ~/.claude/projects/-Users-first-last-Sites-my-project \
~/.claude/projects/-Users-first.last-Sites-my-project영향을 받는 각 프로젝트 디렉터리에 대해 이를 반복하세요. 이에 해당하는 코드 수정은 점을 대시로 인코딩하는 것입니다. 예를 들면:
function yUt(t){return t.replace(/[\/.]/g,"-")}마지막 요약은 claude-mem의 SQLite 데이터베이스에서 읽어 오기 때문에 여전히 표시될 수 있는 반면, 원문 그대로의 마지막 메시지는 Claude Code의 디스크에 저장된 JSONL 파일에서 읽어 옵니다.