개요
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에서 수정되었습니다. 해당 버전 이상으로 업그레이드하세요. 즉시 업그레이드할 수 없는 경우, 임시 해결책은 모든 파일 작업 중에 작업 디렉토리를 프로젝트 루트로 유지하는 것입니다.
문제 해결Windows에서 Claude Code에서 claude-mem hooks를 사용할 때 'printf: write error: Permission denied' 오류가 발생하는 이유는 무엇인가요?
이는 Windows에서 bash의 printf가 프로세스 치환 $() 내에서 실패하는 알려진 MSYS2 버그입니다. 해결 방법: 모든 hooks/hooks.json 파일(마켓플레이스 및 캐시된 복사본)에서 printf '%s\\n'를 echo로 대체하십시오. claude-mem을 재설치하면 변경 사항이 덮어쓰이므로 업데이트 후 다시 적용하십시오. 오류가 지속되면 Claude Code 설정에서 후크를 일시적으로 비활성화하십시오. 영구적인 수정은 이슈에서 추적되고 있습니다.