メインコンテンツへスキップ
AI Tools 27分で読める

Claude-Mem完全ガイド｜導入方法・仕組み・注意点をユーザー目線で解説【2026年】

#Claude Code#Claude-Mem#プラグイン#永続メモリ#AI開発ツール#セッション管理

「毎回ゼロから始まっていたセッションが嘘のよう。もうセッションを閉じることがなくなった」。あるclaude-memユーザーのレビュー記事にはこう書かれていた（LEXIA BLOG）。

Claude Codeを日常的に使っていれば、一度は経験があるはずだ。朝ターミナルを開き、昨日の続きを始めようとしたら、Claudeが何も覚えていない。プロジェクトの構成、昨日決めた設計方針、試して失敗したアプローチ。すべてゼロから説明し直す必要がある。

claude-memは、この「セッション切れ＝記憶喪失」問題を根本から解決するために作られたClaude Codeプラグインだ。GitHub Stars 29,000超、GitHub Trending #1 Repository of The Dayを獲得し、公開から半年で最も注目されるClaude Codeプラグインの一つになった。

筆者も実際にclaude-memを導入して運用している。その実体験を踏まえつつ、仕組み・導入方法・使用感・そして正直に伝えるべき注意点まで、すべてまとめた。

この記事はこんな人におすすめ
  • Claude Codeを使っていて、セッション間のコンテキスト喪失に悩んでいるエンジニア
  • claude-memの導入を検討しているが、メリットとデメリットの両面を知りたい方
  • CLAUDE.mdの手動管理に限界を感じている方

Claude-Memとは何か

Claude-Memは、Claude Codeに永続メモリを追加するプラグインだ。セッション中に行われた全操作を自動でキャプチャし、AIで圧縮して保存し、次のセッションで関連するコンテキストを自動注入する。

開発者はAlex Newman（GitHub: thedotmack）。2025年8月にリリースされ、公開24時間で949スターを獲得。「Claude Codeを本気で使ってる人ほど衝撃でかい」（@SuguruKun_ai、X）という反応に象徴されるように、ヘビーユーザーほど刺さるツールだ。

解決する問題

SYC TECH BLOGの岡本氏は、claude-mem導入前の課題をこう振り返っている。

「何度も同じ設計方針を説明させられる」「1週間ほどのプロジェクトでコンテキストが失われ、Claudeがまったく別の実装を始めてしまう」

この「迷走」問題は、Claude Codeユーザーなら心当たりがあるだろう。Zennのbookamasedo氏は「毎朝10〜15分かけてプロジェクトを再説明する必要があり、週に1時間以上の生産性ロスがあった」と報告している。

claude-memは、この再説明の手間をゼロにすることを目指している。

基本スペック

項目内容
GitHubスター29,000+
ライセンスAGPL-3.0
要件Node.js 18+、最新のClaude Code（プラグイン対応版）
ランタイムBun（未インストールの場合は自動導入）
データ保存SQLite 3（バンドル） + Chroma Vector DB
Web UIlocalhost:37777

Claude-Memのアーキテクチャ：永続メモリの仕組み

claude-memの仕組みを理解するには、3つの層を押さえればいい。データキャプチャ（どう記録するか）、ストレージ（どこに保存するか）、プログレッシブ検索（どう思い出すか）だ。

Claude-Memのアーキテクチャ。ライフサイクルフックでデータをキャプチャし、2つのDBに保存、3層検索で効率的に取得する

データキャプチャ：5つのライフサイクルフック

claude-memはClaude Codeのライフサイクルフックに接続し、セッション中のイベントを自動で記録する。

フックタイミング役割
SessionStartセッション開始時過去のコンテキストを自動注入
UserPromptSubmitユーザー入力時クエリを処理
PostToolUseツール実行後操作結果を観察データとして記録
Stopセッション一時停止時状態を保存
SessionEndセッション終了時サマリーを生成・保存

重要なのは、これらが完全に自動で動く点だ。ユーザーが意識的に「記録する」操作をする必要はない。

ストレージ：2つのデータベース

記録されたデータは2つのデータベースに保存される。

  • SQLite DB + FTS5: セッション情報、観察データ、サマリーを構造化して保存。全文検索（キーワードベース）に対応
  • Chroma Vector DB: 観察データをセマンティック埋め込みとして保存。「あの時のAPI実装」のような自然言語クエリに対応

キーワード検索と意味ベース検索のハイブリッド構成により、「何を検索すればいいかわからない」場面でも過去の文脈にたどり着ける。

プログレッシブ検索：3層でトークンを節約

claude-memの検索は一度に全データを取得しない。3段階で必要な深さだけ掘り下げる設計になっている。

層ツール返すものトークンコスト
1searchコンパクトな索引（IDリスト）~50-100トークン/件
2timeline時系列コンテキスト中間
3get_observations完全な観察データ~500-1,000トークン/件

GitHubのREADMEでは「約10倍のトークン節約」を謳っている。たとえば「先週のAPI設計の経緯」を調べる場合、まず層1で関連セッション5件のIDが返り（約100トークン）、その中から2件のタイムラインを取得し（層2）、最終的に必要な観察データ1件だけを取得する（層3）。全件を一括で取得する方式と比べて、必要な深さだけ掘り下げることでトークンを節約する仕組みだ。

Claude-Memの導入方法

導入は2コマンドで完了する。

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

Claude Codeを再起動すれば、次のセッションから自動的にコンテキストの記録・注入が始まる。

別の導入経路としてOpenClaw Gatewayもある。OpenClawはclaude-memの依存関係を自動でセットアップするインストーラスクリプトで、プラグインマーケットプレイスを使わない環境向けだ。

curl -fsSL https://install.cmem.ai/openclaw.sh | bash

curl | bash パターンに抵抗がある場合は、スクリプトの中身を事前に確認してから実行することを推奨する。

npm installでは動かない

npm install claude-mem はSDKライブラリのみをインストールする。ライフサイクルフックやWorker Serviceを含むプラグイン本体はインストールされないため、必ずプラグインマーケットプレイス経由で導入すること。また、npm版のClaude Code（npm install -g @anthropic-ai/claude-code）では動作が不安定との報告がある。ネイティブ版（公式バイナリ）の使用を推奨する。

導入後の確認

インストール後、http://localhost:37777 にアクセスするとWeb Viewer UIが開く。リアルタイムのメモリストリーム、セッションタイムライン、設定パネルが確認できる。

また、mem-searchスキルが自動的に利用可能になり、自然言語で「先週のAPIリファクタリングの経緯を教えて」のようなクエリを投げるだけで、関連する過去のコンテキストが返ってくる。

Claude-MemをGitHubで確認する

インストールコマンドやドキュメント、最新のリリースノートを確認できる。

GitHubリポジトリ →

Claude-Memの使用感：永続メモリは実用的か

筆者が運用して感じた変化を率直に述べる。

セッション再開の摩擦がなくなる

最も大きな恩恵はこれだ。筆者はAstro v5 + Tailwind CSS v4のテックブログを運用しており、記事執筆・SEO改善・ツール開発を日常的にClaude Codeで行っている。以前は新しいセッションのたびに「このプロジェクトはAstro v5で構築していて、記事はMDXで、カテゴリは8種あって……」と5〜10分かけて説明し直していた。

claude-mem導入後は、SessionStartフックが過去のコンテキストを自動注入するため、Claudeが最初から文脈を把握した状態で応答する。セッション冒頭の再説明がほぼ不要になり、すぐに本題に入れるようになった。

SYC TECH BLOGの岡本氏も「現在のところそういった’迷走’はほぼ発生していません」と報告している。筆者の体感でも、Claudeが突然別の設計方針を提案してくる頻度は明らかに減った。

セマンティック検索の実用性

「あの時どう決めたっけ？」を即座に解消できるのは想像以上に便利だ。たとえば「CSSグリッドのレスポンシブ修正」と検索すると、数日前に minmax(0, 1fr) で解決した経緯が観察データとして返ってくる。来栖川電算のXアカウントも「会話履歴やAIエージェントの検索過程を自動で記録・サマリー化してくれるため、長期プロジェクトでの『あの時どう決めたっけ？』を即座に解消できます」と評価している。

Web Viewer UIの利便性

localhost:37777 で開くWeb Viewerは、記録された観察データをタイムラインで閲覧できる。設定パネルからstable/betaの切り替えも可能で、実験的なEndless Mode（長時間セッション向けのバイオミメティックメモリ）を試すこともできる。

Claude-Mem導入前に知っておくべき注意点

ここからは、導入前に知っておくべき問題点を正直に書く。

トークン消費の増加

claude-memの最大の批判点は、SessionStartフックによる自動コンテキスト注入がトークンを消費することだ。

Zennのyasuhito氏は「SessionStartで過去の文脈を注入するたびにトークンを消費する点が最大の批判点」と指摘しており、tenormusica氏の検証では「20x Maxプランが30分で枯渇した」という報告もある。SessionStart時に注入されるコンテキストは、蓄積されたセッション数やプロジェクトの規模によって変動するが、数千〜数万トークン規模になることがある。API従量課金で運用している場合、1セッションあたりのコスト増を見込んでおく必要がある。

3層プログレッシブ検索で節約する設計とはいえ、自動注入される情報が不要な場合、そのトークンは無駄になる。結果として、手動でCLAUDE.mdを管理する方がコスト効率が良いケースもある。

トークンコストに注意

claude-memは「情報を自動で注入する」仕組みのため、セッション開始時のトークン消費が増える。API利用プラン（特にMaxプラン）を使っている場合は、導入前後のトークン消費量を比較することを推奨する。

リソースリーク問題

GitHub Issue #1168では、数日の通常使用後に157個のゾンビプロセスが8.4GBのRAMを消費していたという報告がある。セッションごとに5〜7個のobserverプロセスが蓄積し、Stopフックが適切にクリーンアップしないことが原因とされている。

Hacker Newsでも「大量のRAMを消費し、各Claude Codeセッションが大きなリソースホグになっていた」という声があり、この問題をきっかけにシンプルなローカルメモリシステムを自作したユーザーもいる。

定期的に ps aux | grep claude でプロセスを確認し、不要なものは手動で終了させる運用が現時点では必要だ。

プラットフォーム制限

  • Windows 11: 複数のPowerShellポップアップが発生し、入力を妨害する問題が報告されている（GitHub Issue #367）
  • npm版Claude Code: プラグインのロード失敗、ワーカーの頻繁な再起動が発生。ネイティブ版の使用が強く推奨される
  • Cursor IDE: Claude Code CLIでは動作するが、Cursor IDE内のClaude Code Extensionでは動作しない（GitHub Issue #345）

AGPL-3.0ライセンスの制約

claude-memはAGPL-3.0でライセンスされている。このライセンスは、ネットワーク経由でサービスを提供する場合にソースコード開示義務が発生する。Google等の大企業はAGPLコードの全面使用禁止をポリシーとしており、企業の開発環境に導入する際はライセンスポリシーの確認が必須だ。

$CMEMトークンについて

ここで触れておかなければならない事実がある。

claude-memのGitHubリポジトリのREADMEには、$CMEMという暗号通貨トークンのリンクとSolanaブロックチェーン上のコントラクトアドレスが掲載されている。

Claude-MemのGitHub README
Claude-MemのGitHub READMEに記載された$CMEMトークン情報（2026年2月時点）

$CMEMトークンはSolana上の分散型取引所で取引されている。ソフトウェアとトークンの機能的な統合関係は不明確で、「promotional rather than functionally integrated」（宣伝的であり機能統合ではない）との分析もある。

率直に言えば、OSSのGitHubリポジトリに暗号通貨トークンの宣伝を掲載するのは一般的なプラクティスではなく、筆者としても懸念を持っている。事実として以下を認識しておくべきだ。

  • OSSリポジトリのREADMEにトークン売買へのリンクを掲載すること自体が異例である
  • AI関連ツール名を冠した暗号通貨には過去に問題事例がある（$CLAWDトークンの急騰・暴落など）
  • トークンの存在がソフトウェア自体の品質を否定するわけではないが、プロジェクトの動機や持続性に疑問を抱く判断材料にはなりうる

ソフトウェアの評価とトークンの評価は切り離して判断すべきだ。claude-memはOSSとして機能するプラグインであり、$CMEMトークンを購入しなくても利用できる。ただし、この事実を知った上で導入を判断してほしい。

claude-mem vs CLAUDE.md：どちらを使うべきか

claude-memに対する最も多い反論は「CLAUDE.mdで十分」というものだ。Hacker Newsのminimaxir氏は「非常に詳細なCLAUDE.mdだけでOpus 4.5で十分うまくいっている」と述べ、Zennのyasuhito氏は「手動のMEMORY.md管理の方がコスト対効果で優れることが多い」と結論づけている。

両者は性質が異なるツールであり、単純な上下関係ではない。

観点claude-memCLAUDE.md（手動）
導入コスト2コマンドファイル作成のみ
自動化全自動（操作記録・圧縮・注入）完全手動
トークン消費増加（自動注入分）最小限（読み込み分のみ）
検索性セマンティック検索対応不要（必要な情報だけを自分で記述）
リソースWorker常駐 + DBテキストファイルのみ
企業利用AGPL-3.0制約あり制約なし
メンテナンス自動（ゾンビプロセス監視は必要）手動更新が必要

どんな人にclaude-memが向いているか

  • 長期プロジェクトを複数並行している（過去の意思決定を頻繁に参照する）
  • セッションを頻繁に切り替えるワークフロー
  • 「毎朝の再説明」に週1時間以上を費やしている
  • トークンコストより時間の節約を優先できる

どんな人にCLAUDE.mdが向いているか

  • 小〜中規模プロジェクトが中心
  • トークン消費を最小限に抑えたい
  • 企業のライセンスポリシーでAGPLが使えない
  • プロジェクトの方針や規約を自分の言葉で管理したい

実際には、両方を併用するのが現実的な選択肢だ。claude-memで自動記録を行いつつ、CLAUDE.mdにはプロジェクトの方針や規約を手動で書く。自動記録と手動指針という異なる役割で共存できる。

claude-memは、Claude Codeの「記憶喪失」という本質的な弱点に正面から取り組んだ永続メモリプラグインだ。29,000スターという数字は、それだけ多くの開発者がこの問題を抱えていた証拠でもある。

ただし、万能ではない。トークン消費の増加、リソースリークの可能性、$CMEMトークンの存在。これらを理解した上で導入を判断すべきだ。

まずは自分のワークフローでCLAUDE.mdの手動管理を試し、それでも「毎朝の再説明」が負担になるなら、claude-memを検討する。その順序が最もリスクの低い導入パスだと考える。

Claude Codeの最新機能やAIコーディングツールの動向に興味がある方は、以下の記事も参考にしてほしい。

Claude-Memを試す

GitHubリポジトリからインストール方法やドキュメントを確認できる。

Claude-Mem GitHub →

本記事の情報は2026年2月20日時点のものです。claude-memの機能・仕様・$CMEMトークンの状況は随時変更される可能性があります。最新情報はGitHubリポジトリおよび公式ドキュメント（docs.claude-mem.ai）でご確認ください。本記事は情報提供のみを目的としており、暗号資産（仮想通貨）の購入・売却・投資を推奨・助言するものではありません。暗号資産の取引には価格変動リスクがあります。Claude Code、ClaudeはAnthropic, PBCの商標です。SolanaはSolana Foundationの商標です。その他、記事中に記載された製品名・サービス名は各社の商標または登録商標です。

Sources:

Share