概要
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 で修正されましたので、このバージョン以降にアップグレードしてください。すぐにアップグレードできない場合の一時的な回避策としては、すべてのファイル操作中にワーキングディレクトリをプロジェクトルートに維持することです。
トラブル対応Unixユーザー名またはプロジェクトパスにドットが含まれている場合、claude-memの最後のメッセージが消えるのはなぜですか？
claude-mem を v13.4.0 以降にアップグレードしてください。パスエンコーディングのバグはリリース v13.4.0 で修正されました。v13.0.1 などの影響を受けるバージョンでは、claude-mem はカレントワーキングディレクトリをエンコードする際に / のみを置換していましたが、Claude Code は . も - に置換します。このため、最後のメッセージの検索が誤った ~/.claude/projects/... ディレクトリを対象にしていました。一時的な回避策として、ドットを含むパスから Claude Code のダッシュでエンコードされたパスへのシンボリックリンクを作成してください:
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 ファイルから読み取られます。