Claude-Mem：Claude Codeのための永続メモリ完全ガイド

AIコーディングエージェントを使用しているすべての開発者が経験したことがあるでしょう。プロジェクトのアーキテクチャ、好み、規約をClaude Codeに1時間かけて説明したとします。セッションが終了し、新しいセッションを開始すると、そこにあるのは 白紙の状態です。 Claude-Mem はこの問題を解決するオープンソース・プラグインであり、AIコーディング・エコシステムで最も人気のあるツールの1つになりました。私たちは GitHub、Reddit、Twitter/X、そしてソースコード自体 を通じて調査を行いました — これがその決定版ガイドです。

1. なぜ重要なのか

Claude-Memは、 最も多くのスターを獲得しているプラグインの1つです。 Claude Code エコシステムにおいて、数万件の GitHub スター、数百件のリリース、数千件のフォークを獲得しています。AI コーディングエージェントに実質的にメモリを追加するプラグインとしては、驚異的な普及を遂げています。これはフレームワークでもライブラリでもありません — これは 行動拡張（behavioral augmentation） （Claude Code 用）です。

このプロジェクトは主に TypeScript、および JavaScript、 シェルスクリプト、そして HTML Web ビューア用として構成されています。ライセンスは AGPL-3.0です。これは、自由に利用・改変できますが、ネットワーク上で公開される派生作品もオープンソースにする必要があることを意味します。

2. 誕生の背景

Claude-Mem は Alex Newman によって作成されました。、オンラインでは @thedotmackとして知られています。Newman氏のバックグラウンドは、AIプロダクトマネジメント、ソリューションアーキテクチャ、フォワードデプロイエンジニアリングにわたります — この経歴の組み合わせが、claude-memがホビープロジェクトというよりも、本番環境のインフラのように感じられる理由を物語っています。

このプロジェクトは、あるシンプルな気づきから始まりました。Claude Codeは非常に強力ですが、すべてのセッションをまるで初対面であるかのように扱います。Newman氏は自身の悩みを解決するためにclaude-memを構築しました — そして、それは開発者コミュニティから大きな支持を得ることとなりました。

このプロジェクトには公式のX/Twitterアカウント（@Claude_Memory）、 Discordコミュニティ、そして claude-mem.ai には包括的なドキュメントが用意された公式サイトもあります。

3. 解決する課題

Claude CodeやCursor、あるいは何らかのAIコーディングエージェントを1日以上使ったことがあれば、その苦労がわかるはずです。

Claude-Memはこれら4つの問題をすべて解決します。バックグラウンドで静かに動作し、Claudeが 行ったこと （あなたが 言ったこと）だけでなく、それらの観察結果をセマンティックな要約に圧縮し、新しいセッションの開始時に関連するものを注入します。

4. 仕組み

Claude-Memは、 6つのコアコンポーネントを通じて動作し、これらすべてが連携してシームレスなメモリレイヤーを構築します：

ライフサイクルフロー

一般的なセッション中に実行される処理は以下の通りです：

ここでの重要な洞察は、 PostToolUse。Claude-Memは単にメッセージを記録するだけではありません — エージェントが何を 行ったか：読み取ったファイル、記述したコード、実行したテスト、発生したエラーなどを記録します。これにより、会話ログのみの場合よりもプロジェクトの状態をはるかに深く理解できるようになります。

5. 段階的開示（Progressive Disclosure）

これはclaude-memの最も革新的なデザインパターンです。すべてのメモリをコンテキストウィンドウに投入してトークンコストを増大させるのではなく、 3層のリトリーバルシステムを使用しています：

これが claude-mem を大規模環境で実用的にするためのアーキテクチャです。段階的な情報開示（progressive disclosure）がなければ、メモリシステムはトークンを消費しすぎる（高コストで、フォーカスを分散させる）か、取得が少なすぎる（重要なコンテキストを逃す）かのどちらかになります。Claude-mem's の 3 レイヤーシステムにより、エージェント自身が関連性を判断できるようになります。

6. MCP 検索ツール

Claude-Mem は 4 つの MCP ツールを公開しており、 Claude はこれを使用して自身のメモリをクエリできます：

例：メモリの検索

このワークフローにより、Claudeはデータベース内のすべてのデータではなく、実際に必要なobservationに対してのみトークンコストを支払うことになります。検索レイヤーは フィルターとして機能し、リトリーバルレイヤーは 深さを提供します。

7. インストール方法

Claude-Memは3つのインストール方法を提供しています：

オプションA：npx（推奨）

最も速い方法 — コマンド1つで完了します：

オプションB：プラグインマーケットプレイス（Claude Code内）

オプション C: OpenClaw Gateway

システム要件

インストール後、Claude CodeまたはGemini CLIを再起動してください。以前のセッションのコンテキストは新しいセッションに自動的に表示されます — 手動での操作は不要です。

8. 主要機能の深掘り

🧠 永続メモリ

コア機能：セッションをまたいでコンテキストが維持されます。新しいセッションを開始すると、Claudeは以前どのファイルで作業したか、どのバグを修正したか、どのような設計上の決定を下したか、そしてどのようなパターンを好むかをすでに把握しています。

🖥️ WebビューアーUI

ブラウザで http://localhost:37777 にアクセスすると、リアルタイムのメモリストリームを確認できます。オブザベーションの閲覧、履歴の検索、claude-memがキャプチャしている内容の監視が可能です。また、ビューアーからはベータ機能へのアクセスやバージョンの切り替えも行えます。

🔒 プライバシーコントロール

コンテンツを <private> タグで囲むことで、保存対象から除外できます。APIキー、認証情報、個人情報 — これらのタグ内のデータは一切永続化されません。データはSQLite形式で完全にローカルマシン内に保持されます。

🔗 引用

すべてのオブザベーションには一意のIDが付与されます。IDを使用して過去のオブザベーションを参照し、以下を介してアクセスできます http://localhost:37777/api/observation/{id}。これにより、 正確に なぜClaudeが特定の決定を下したのかを追跡できます。

🧪 Beta Channel: Endless Mode

The experimental “Endless Mode” implements a biomimetic memory architecture designed for extended sessions that run for hours. It uses a different compression strategy that prevents context window saturation during marathon coding sessions. Switch between stable and beta from the web viewer UI.

⚙️ Context Configuration

Settings are managed in ~/.claude-mem/settings.json. You can configure the AI model used for compression, the worker port, the data directory, log level, and fine-grained control over what context gets injected and when.

9. Architecture Overview

Claude-Mem's architecture has evolved significantly through multiple major versions. Here's how the pieces fit together:

デュアルデータベース戦略

Claude-Memは2つのデータベースを組み合わせて使用します：

• SQLite with FTS5 — 構造化クエリ、完全一致検索、時間ベースのフィルタリング用。高速、ローカル、zero-config。
• Chroma Vector Database — セマンティック類似性検索用です。Claudeが“認証システムについて何をしたっけ？”と尋ねると、Chromaは正確な単語が一致しなくても、概念的に関連する観察結果を見つけ出します。

これらを組み合わせることで、以下を提供します： ハイブリッド検索：SQLiteによる完全一致と、Chromaによる曖昧/セマンティック一致です。これは、本番環境のRAGシステムで使用されているものと同じ検索アーキテクチャパターンであり、ローカル利用向けに小型化されています。

10. コミュニティの反応

以下のプラットフォームでの議論を調査しました： Reddit (r/ClaudeAI, r/ClaudeCode)、Twitter/X、および技術記事。コミュニティのコンセンサスは以下の通りです：

“白紙状態”キラー

Redditでの圧倒的な意見：claude-memは“白紙状態”問題に対する最良の解決策です。ユーザーの報告によると、これは 摩擦を大幅に軽減し、 プロジェクトのアーキテクチャを再説明する手間を省き、時間、トークン、そしてフラストレーションを削減します。r/ClaudeCodeの複数のスレッドでは、“必須”のプラグインとして紹介されています。

トークンエコノミーに関する議論

一部のユーザーは当初、トークンコストを懸念していました — AI呼び出しを使用して観察結果を圧縮するアクティブメモリシステム自体がトークンを消費する可能性があるためです。コミュニティのコンセンサスは以下の通りです： 段階的開示アーキテクチャ により、実質的にプラスとなります。コンテキストを再説明しないことで節約されるトークンは、メモリ圧縮に費やされるトークンをはるかに上回ります。

“ヘビー vs ライト”の分断

claude-memはフル機能のシステム（Bun、ベクトル検索用のPython、バックグラウンドワーカーサービスが必要）であるため、一部の開発者は以下のようなより軽量な代替案を作成しています： claude-mem-lite および memsearchこれらはよりシンプルなテキストベースのストレージを使用し、LLMの呼び出しを最小限に抑えます。コミュニティでは、これらを補完的なものと捉えています。数週間にわたる本格的なプロジェクトにはclaude-mem、迅速な実験にはより軽量なツール、といった使い分けです。

ワークフロー統合レイヤー

Redditのパワーユーザーは、claude-memを次のように表現しています。 基盤レイヤー カスタムワークフローのための基盤です。ユーザーはその上に特化した“スキル”を構築します。永続メモリをカスタムルールやドメイン固有の知識と組み合わせることで、特定のプロジェクトを深く理解するAIエージェントを作成しています。

11. 結論：Claude-Memは使う価値があるか？

次のような場合に適しています：

• 複数のセッション（数日、数週間、数ヶ月）にわたるプロジェクトに取り組んでいる場合
• セッションごとにプロジェクトのアーキテクチャを説明し直すのに疲れている場合
• 過去の決定事項、バグ修正、却下されたアプローチなどをClaudeに覚えておいてほしい場合
• 依存関係のフットプリント（Node.js、Bun、ベクトル検索用のPython）を許容できる場合

次の場合はスキップしてください：

• Claude Codeを単発のクイックなタスクにのみ使用する場合
• 最小限のツール構成を好み、バックグラウンドサービスを一切動かしたくない場合
• CursorやWindsurfを使用している場合（claude-memはClaude Code、Gemini CLI、OpenClawでのみ動作します）
• 適切にメンテナンスされた CLAUDE.md ファイルがあれば、あなたのワークフローには十分です

12. 代替案と比較

AIエージェントにメモリを持たせる他の手法と、claude-memはどう比較されますか？

本格的なマルチセッションプロジェクトに取り組む多くの開発者にとって、 claude-mem は最も充実した機能セットを提供します。迅速な実験や、最小限のツールを好む開発者の場合は、 適切に管理された CLAUDE.md ファイル とスキルファイル（ Karpathy's skillsなど）の組み合わせで十分な場合があります。

13. 大きな展望

ステートレスからステートフルなエージェントへ

Claude-Mem は、AI コーディングエージェントに対する考え方の転換を象徴しています。第一世代の AI アシスタントは ステートレス — 各インタラクションが毎回リセットされていました。claude-mem のようなツールが登場した現在の世代は、 ステートフル — つまり、時間の経過とともにプロジェクトに関する知識を蓄積していくエージェントへと進化しています。

これには重大な意味があります。ステートフルなエージェントは、単にコードを書くだけではありません — それは あなたのコードベースを理解します。どのパターンが有効で、どれが却下されたのか、そしてその理由も把握しています。過去の移行時の制約により、認証システムが特定のトークン形式を使用していることも記憶しています。2週間前にパフォーマンスの問題をデバッグしたため、データベースクエリに特定のインデックスが必要であることも覚えています。

コンテキストエンジニアリングのエコシステム

Claude-Memは、より広範な “コンテキストエンジニアリング” エコシステムの一部であり、急速に成熟しつつあります：

• CLAUDE.md / Rules ファイル — 静的コンテキスト（プロジェクトの規約、コーディング標準）
• スキル / プラグイン — 振る舞いのガイドライン（Karpathy氏のスキルファイルのようなもの）
• メモリプラグイン — 動的コンテキスト（claude-mem、セッション履歴）
• MCP サーバー — 外部知識（データベース、API、ドキュメント）

これらのレイヤーが組み合わさることで、エージェントは 特定のプロジェクトや開発者に深くカスタマイズ されたものになります。緩やかで構造化されていないAIとの対話である “vibe coding” の時代は、 “agentic engineering” — コンテキスト管理がプロンプトそのものと同じくらい重要となる、規律ある実践へと進化しています。

今後の展望

v12において、claude-memはすでにClaude Code、Gemini CLI、およびOpenClawゲートウェイをサポートしています。その軌道が指し示す先は、 ユニバーサル・エージェント・メモリ — あらゆるAIコーディングツール、エディタ、プラットフォームで動作する永続的なナレッジレイヤーです。$CMEMトークン（開発者が公式に採用したコミュニティ主導のSolanaトークン）は、リアルタイムのエージェントデータ共有や開発者間のコラボレーションに向けた、さらに野心的な計画を示唆しています。

14. よくある質問

15. すべての情報源 & リンク

この記事は、以下のリサーチに基づいて作成されました。 マルチソース・リサーチ GitHub、Reddit、Twitter/X、Web記事、そしてソースコード自体を横断したリサーチです。以下にすべての主要な情報源を記載します。

主要な情報源

• GitHub: thedotmack/claude-mem — リポジトリ
• claude-mem.ai — 公式サイト & ドキュメント
• アーキテクチャの概要 — システム構成 & データフロー
• Progressive Disclosure ドキュメント — コンテキスト・プライミングの哲学
• Context Engineering ガイド — AIエージェントの最適化原則

コミュニティ & ソーシャル

• @Claude_Memory — 公式X/Twitterアカウント
• Discordコミュニティ — 公式Discordサーバー
• Reddit r/ClaudeAI — AIメモリソリューションに関するコミュニティの議論
• Reddit r/ClaudeCode — プラグインアーキテクチャ、トークン管理に関する技術スレッド

技術リファレンス

• アーキテクチャの進化 — v3からv5+への変遷
• Hooksアーキテクチャ — claude-memにおけるライフサイクルHooksの活用方法
• 検索アーキテクチャ — Chromaを使用したハイブリッド検索
• 検索ツールガイド — MCPツールの使用例

著者

• Alex Newman (@thedotmack) — claude-mem の開発者

当サイトの関連記事

• Karpathy の CLAUDE.md スキルファイル：完全ガイド
• Karpathy の LLM Wiki：アイデアファイルの完全ガイド
• AI IDE でスキルをセットアップする方法
• AI エージェント向けシステムプロンプトの完全ガイド
• エージェントスキルをマスターする