Claude Code に永続メモリを追加する OSS「claude-mem」
Claude Code は強力なコーディングエージェントですが、セッションをまたいだ記憶は基本的には持ちません。毎回プロジェクト背景や設計意図を説明し直す、というのは地味に消耗する作業です。
claude-mem は、この課題に対して「ローカル完結の永続メモリ」を差し込む OSS です。GitHub 上の thedotmack/claude-mem で公開されており、2026 年 4 月時点で 89,000 Stars を超える注目を集めています。
claude-mem が解く課題
生成 AI を日常的に使っていると、次のような不満が溜まります。
- 長期プロジェクトの前提を毎回説明し直している
- 以前合意したコーディング規約を、AI がすぐ忘れる
- 毎セッション同じファイルを貼り付けていて、入力トークンが無駄
- 個人の趣味嗜好や過去の決定を、AI 側に蓄積できない
claude-mem は、過去のやりとりを要約・構造化してローカルに保存し、必要なときに検索して Claude に渡すことで、この「忘却問題」に取り組みます。
アーキテクチャ概要
README ベースで整理すると、claude-mem の内部構造は次のようになっています。
1. ローカル SQLite（構造化メタデータ）
セッション情報・要約・タグ・タイムスタンプといった構造化されたメタデータを SQLite に保存します。軽量で依存が少なく、個人 PC 上に素直に置ける選択です。
2. ChromaDB（ベクトル検索）
要約本文や会話断片はベクトル化し、ChromaDB に格納します。これにより「キーワードが一致しなくても、意味的に近い過去の記憶」を検索できます。「前に似たようなバグ直したよね？」を引っ張ってこられるのがベクトル検索の強みです。
3. MCP（Model Context Protocol）統合
Claude Code との接続は、Anthropic が提供する MCP を通じて行われます。Claude Code 側から見ると、claude-mem は1 つのツール（記憶の読み書き）を提供するサーバーとして振る舞います。
4. バックグラウンド HTTP API（ポート 37777）
claude-mem はバックグラウンドで HTTP API を提供する構成になっており、既定ポートは 37777。他ツール・スクリプトからも記憶にアクセスしやすい設計です。
5. Web 閲覧 UI
蓄積した記憶を人間が確認・編集するための Web UI も用意されています。AI に預けっぱなしにせず、ユーザー自身が中身を覗いて整えることが可能です。
導入は 1 行
公式 README に従うと、導入は次の 1 行で済む設計になっています。
npx claude-mem installこのコマンドで、Claude Code 側の設定・バックグラウンドプロセス・ローカル DB の準備が一括で行われます。以降は Claude Code を普段どおり使うだけで、会話の要約と記憶の更新が裏側で進みます。
具体的なコマンド・オプションは更新される可能性があるため、最新の GitHub README を必ず確認してください。
トークン消費が減る理由
Claude Code の入力トークンは、「過去の文脈をどれだけ貼り直すか」で大きく変わります。claude-mem のように記憶を外部化しておくと、次のような違いが出ます。
- 従来：毎回プロジェクトの README・設計メモ・規約をそのまま貼る
- claude-mem 併用：関連する記憶だけをベクトル検索で取り出し、必要な分だけ差し込む
結果として、コンテキストのサイズを抑えつつ、必要な情報はきちんと届く状態を目指せます。長期プロジェクトほど、この差は効いてきます。
プライバシーとローカル完結
claude-mem は「記憶」を扱うツールだからこそ、ローカル完結が重要な設計方針になっています。
- SQLite・ChromaDB ともにユーザー PC 上で動作
- Web UI もローカルに立ち上がる
- Claude 本体との通信は、Claude Code 自身の仕組みに従う
会社のコード・個人の日記・センシティブな設計メモなどを扱う場合、「記憶がどこに置かれているか」が透明であることは大きな安心材料です。具体的な取り扱いは、リポジトリのプライバシー関連記載を確認するのが確実です。
どんな人に向くか
向いている人：
- Claude Code を長期プロジェクトで毎日使っている
- 「毎回同じ前提説明」に消耗している
- 機密性の高いコード・文書で作業している
- 入力トークン消費を抑えたい
- ローカルで完結するツールを好む
あまり必要ない人：
- Claude Code をごく軽い単発用途でしか使わない
- プロジェクト間の記憶共有を全く必要としない
活用イメージ
- claude-mem 導入 → 既存プロジェクトで Claude Code を普段どおり利用
- 数週間運用し、記憶データが蓄積
- 新しいタスクを頼むと、関連する過去の議論や決定が自動で参照される
- Web UI で記憶を眺め、不要なものを整理
- 長期運用ほど「説明コスト」が下がっていく
FAQ
Q. claude-mem とは何ですか？
Claude Code のセッションをまたいで記憶を保持するためのオープンソースツールです。GitHub リポジトリ thedotmack/claude-mem で公開されており、2026 年 4 月時点で 89,000 を超える Star を集めています。
Q. どうやって導入しますか？
公式 README に従い、npx claude-mem install の 1 行で導入できる設計です。導入後は Claude Code と連携し、会話履歴の要約・保存・検索がバックグラウンドで行われます。
Q. どんな仕組みで動いていますか？
ローカルの SQLite に構造化メタデータを、ChromaDB にベクトル化した本文を保存し、必要に応じて検索して Claude にコンテキストとして渡す設計です。MCP を通じて Claude Code と統合されます。
Q. データは外部に送信されますか？
claude-mem 自体はローカル完結を志向しており、記憶データはユーザー PC 内に保存されます。Claude 本体との通信は通常の Claude Code の仕組みに従います。詳細はリポジトリのプライバシー記載を確認してください。
Q. なぜトークン消費が減るのですか？
毎セッション過去のやりとりをまるごと貼り直すのではなく、関連する記憶だけを検索して差し込むためです。必要なものだけをコンテキストに乗せるので、無駄な入力トークンを抑えられます。
まとめ
- claude-mem は Claude Code に永続メモリを追加する OSS（89K+ Stars）
- SQLite + ChromaDB + MCP + HTTP API(37777) + Web UI の構成
- npx claude-mem install の 1 行で導入
- ローカル完結志向で、記憶データは PC 内に保存
- 長期運用でトークン消費と説明コストを同時に削減
「AI が昨日の続きから話せる」は、使ってみるとあっさり戻れない体験です。長く Claude Code と付き合う予定があるなら、claude-mem のような記憶レイヤーを早い段階で足しておく価値は十分にあります。
✍️ この記事を書いた人
チケットナビ編集部
先払い買取・金券売買の最新情報を初心者にもわかりやすくお届けします。業者の比較、買取率、トラブル対策など、安全に現金化するための情報を徹底調査して発信しています。
コメント