セッションを閉じると、文脈は消える

Claude Codeの文脈はセッション単位です。ターミナルを閉じた瞬間に「昨日どこまでやったか」「あのバグをどう直したか」は消え、次のセッションでは毎回説明し直しになります。プロジェクトが数日規模になると、この再説明だけでトークンと時間を払い続けることになります。

これを解くプラグインが claude-mem（thedotmack/claude-mem）です。セッションの出来事をライフサイクルhookで自動記録し、要約してローカル（SQLite＋ベクトルDB）に保存し、次のセッションの冒頭で関係する分だけ差し戻します。検索は「索引だけ先に引く→前後を見る→詳細を取る」の3段階で、全件差し戻しに比べてトークンを抑える設計（段階的開示）になっています。

最大の罠：`npm install -g` で入れてはいけない

導入で一番踏みやすい失敗を先に書きます。

npm install -g claude-mem   # ← これはダメ

この方法で入るのはSDK／ライブラリだけで、プラグインのhook登録もworkerサービスの設定も行われません。コマンド自体は成功して見えるので、「入れたのに何も記録されない」という状態に静かに陥ります。これは公式READMEが注意書きで明示している仕様です。

正しい入れ方は次のどちらかです。

npx claude-mem install

または、Claude Codeの中で:

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

どちらで入れる場合も、入れたあとはClaude Codeの再起動が必要です。

実測して分かったこと（筆者の検証範囲）

筆者は隔離したホームディレクトリで、claude-mem 15.6.0 を実際に導入検証しました（2026-10-30、Linux、Node v24.22.1）。

npx claude-mem install --provider claude --no-auto-start は終了コード0で完了。サインイン（claude-mem observerの試用案内）は --provider の明示で省けた
最後に出る「Could not start the optional claude-mem sign-in」は失敗ではない
npx claude-mem doctor で必須チェック合格を確認できる
workerはポート 37700 で起動し、ビューアがHTTP 200を返した（古い解説記事の37777とは違う）

ただし、正直に書いておくこと

筆者の検証環境にはログイン済みのClaude Codeが無かったため、実際のセッションで記憶が蓄積し、次のセッションへ差し戻される部分は未検証です。status に degraded（Claude CLI setup required）と出ることも含め、「claude-memは単体で完結せず、ログイン済みClaude Codeが先に要る」という順序の問題までは確認しました。その先は、導入する人の環境で初めて成立する部分として線を引いています。

有料版ガイドで扱っていること

導入の判断材料はこの記事と公式READMEで足ります。有料の実践ガイドでは、以下を実測と未検証の区別つきで手順化しています。

インストール手順全文（サインインの扱い、置かれる場所の一覧）
doctor／workerの実測と、degradedの切り分け
使い始めと日本語モード（code--ja）の設定
記録されたくない内容を外す <private> タグ、テレメトリの止め方、Windowsでの注意
検証済み／未検証の全記録と、自分の環境で確認するための再確認チェックリスト

▶ note有料記事「claude-mem実践ガイド」（1,480円）
https://note.com/0x000x7f/n/n3c51df2b290e
▶ BOOTH「claude-mem実践ガイド PDF＋設定テンプレート＋チェックリスト」（1,480円）
https://0x000x7f.booth.pm/items/9077084

シリーズについて

同じ方針（実測ベース、未検証は明記）で、AI生成UIの「癖」を検出する impeccable のガイド（Zenn Book、900円、公開中）と、教材を根拠に教えるAIチューター DeepTutor のガイドも用意しています。

▶ Zenn Book「impeccable実践ガイド」
https://zenn.dev/ikahan/books/impeccable-guide