AIコーディング助手の「記憶喪失」を解決！セッションを超えて文脈を保持する永続メモリシステム — claude-mem

アーキテクチャ・仕組み

claude-memは以下の主要コンポーネントで構成されています：

• 5つのライフサイクルフック: SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd の各タイミングで自動的に動作
• ワーカーサービス: Bunランタイムで管理されるHTTP APIサーバー（ポート37777）。Web UIとメモリ検索用の10個のエンドポイントを提供
• SQLiteデータベース: セッション、観察記録、要約をローカルに永続保存
• Chroma ベクトルデータベース: セマンティック検索（意味に基づく検索）とキーワード検索を組み合わせたハイブリッド検索を実現

主要機能一覧

• 永続メモリ: セッション終了後も文脈が保存され、次回セッションに自動注入
• 段階的開示（Progressive Disclosure）: トークンコストを表示しながら、3段階でメモリを取得（検索→タイムライン→詳細取得）
• MCP検索ツール: search、timeline、get_observations の3つのツールで過去の記録を効率的に検索（トークン消費を約10分の1に削減）
• Web Viewer UI: http://localhost:37777 でリアルタイムのメモリストリームを閲覧可能
• プライバシー制御: <private> タグで囲んだ内容はストレージに保存されない
• 引用機能: 過去の観察記録をID付きで参照可能
• ベータチャンネル: Endless Mode（長時間セッション向けのバイオミメティックメモリアーキテクチャ）などの実験的機能を試せる

対応環境

• Node.js: 18.0.0以上
• Bun: JavaScriptランタイム（未インストールの場合は自動インストール）
• uv: Pythonパッケージマネージャー（ベクトル検索用、自動インストール）
• SQLite 3: バンドル済み
• 対応IDE/ツール: Claude Code、Gemini CLI、OpenCode、OpenClaw Gateway
• OS: Windows対応（Node.js/npmのPATH設定が必要な場合あり）

多言語対応

CLAUDE_MEM_MODE 設定で、生成される観察記録の言語を切り替え可能：

設定ファイル ~/.claude-mem/settings.json で変更します。

設定オプション

~/.claude-mem/settings.json で以下の項目を設定可能：

• AIモデルの選択
• ワーカーポート番号
• データディレクトリ
• ログレベル
• コンテキスト注入の制御

ライセンス

• 本体: AGPL-3.0（自由に使用・改変・配布可能。ネットワークサーバーでの改変版デプロイ時はソースコード公開が必要）
• ragtime/ ディレクトリ: PolyForm Noncommercial License 1.0.0（非商用利用のみ）

技術スタック

• TypeScriptで開発
• Claude Agent SDKを活用したAI圧縮
• SQLite + FTS5（全文検索）
• Chromaベクトルデータベース（セマンティック検索）
• Bunランタイムによるワーカープロセス管理

インストール手順

1コマンドでインストールできます：

npx claude-mem install

Gemini CLI向けにインストールする場合：

npx claude-mem install --ide gemini-cli

OpenCode向けにインストールする場合：

npx claude-mem install --ide opencode

Claude Codeのプラグインマーケットプレイスからもインストール可能です：

/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem

インストール後、Claude CodeまたはGemini CLIを再起動すれば、過去のセッションの文脈が自動的に新しいセッションに反映されます。