Claude Codeのセッション間でのコンテキスト喪失を解決するオープンソース永続メモリシステム

開発者がClaude Code向けに永続的なメモリシステムを作成し、会話間でコンテキストが失われるという一般的な問題に対処しました。このシステムはプラグインやAPIキーを必要とせず、Claude Codeと並行して動作します。

仕組み

このシステムは3つの主要コンポーネントを通じて動作します：

• 会話中、Claudeは重要な決定、認証情報、学んだ教訓をキャプチャするためにmemory/inbox.mdに1行のメモを書き込みます
• 毎夜のcronジョブが会話の記録（~/.claude/projects/にJSONLファイルとして保存）を抽出し、インボックスのエントリと組み合わせて日次ログを作成します
• 新しい会話が始まるたびに、ClaudeはCLAUDE.mdルールを通じて過去2日分のログを読み込みます

セットアップ手順

セットアップには最小限の手順が必要です：

git clone https://github.com/Sunnyztj/claude-code-memory.git
cd claude-code-memory
./setup.sh ~/projects/memory
# メモリルールをCLAUDE.mdに追加
# 毎夜のcronジョブを設定

自動的に記憶される内容

• アーキテクチャの決定（例：「MongoDBからPostgreSQLに切り替え」）
• デプロイメントの詳細（例：「VPSのIPが変更され、新しいNginx設定」）
• 学んだ教訓（例：「Docker COPYはデフォルトでroot:600、chmodが必要」）
• アカウント情報、APIキー、プロジェクトのマイルストーン

主要な設計上の決定

• ファイルベースのアプローチ（データベースではない）— Claudeが直接読み書きでき、Gitに適し、オフラインでも動作
• インボックスパターン — 1行ごとのエントリで、キャプチャに全く手間がかからない
• 増分型JSONL抽出 — バイトオフセットを追跡し、古い会話を再処理しない
• Cronベース（プロセス内ではない）— プラグインなしの標準的なClaude Codeで動作

このシステムはあらゆるClaude Codeセットアップで動作し、ClaudeClaw（デーモンモード）ユーザー向けのオプションのcronジョブテンプレートを含みます。開発者は、本番ワークフローで毎日使用し、コンテキスト保持に大幅な改善が見られたと報告しています。