概要
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を手動で""に設定してください。
トラブル対応DeepSeekに切り替えることで、claude-memの高いAI圧縮コストを削減する方法は？
claude-mem を v13.4.0 以降にアップグレードしてください。ワーカーの provider ドロップダウンで、ネイティブプロバイダーとして DeepSeek を選択します。DeepSeek API キー (sk-...) を入力します。モデル設定: simple ティアには deepseek-v4-flash を、summary ティアには 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 はプロジェクトルートからの相対パスで参照していました。このため、ワーキングディレクトリが変更された際に context injection が機能しなくなりました。claude-mem v13.4.0 で修正されましたので、このバージョン以降にアップグレードしてください。すぐにアップグレードできない場合の一時的な回避策としては、すべてのファイル操作中にワーキングディレクトリをプロジェクトルートに維持することです。
トラブル対応Windows上でClaude Codeのclaude-mem hooksを使用する際に、'printf: write error: Permission denied'というエラーが発生するのはなぜですか？
これは既知のMSYS2のバグで、Windows上でプロセス置換$()内でbashのprintfが失敗するものです。回避策: すべてのhooks/hooks.jsonファイル（マーケットプレイスおよびキャッシュされたコピー）内のprintf '%s\\n'をechoに置き換えてください。claude-memを再インストールすると変更が上書きされるため、アップデート後に再適用してください。エラーが続く場合は、Claude Codeの設定でフックを一時的に無効にしてください。恒久的な修正はissueで追跡されています。