← ブログに戻る
Ai読了目安 12 分

claude-memがくれるのは記憶ではなく、書類棚と検索術だ

公開日 2026年11月2日
claude-memがくれるのは記憶ではなく、書類棚と検索術だ

コーディングエージェントには、共通の気まずい癖がある。認証ミドルウェアに触るなと説明し、レガシー設定がどこにあるかを教え、どの2つのテストがわざと不安定なのかを伝えるのに午後を丸ごと使う。そしてノートPCを閉じる。翌朝、エージェントは初対面の顔で挨拶し、触るなと言ったファイルをちょうどリファクタリングしようと提案してくる。

その隙間を狙ったのが claude-mem で、数字を見る限り多くの人が同じ穴を感じているらしい。リポジトリは約11万スター、直近1週間で約5,850を稼ぎ、GitHubの週間トレンド首位を何日も占めている。Alex Newmanによるこのプロジェクトは自らをClaude Code向けの「永続メモリ圧縮システム」と称していて、ここで重要なのは圧縮という言葉のほうだ。保存ではない。

実際に何が保存されるのか

仕組みは売り文句ほど魔法じみていない。claude-memはClaude Codeがもともと公開しているライフサイクルフックに自分を登録する。SessionStart、UserPromptSubmit、PreToolUse、PostToolUse、Stop、SessionEnd。各フックは claude-mem hook claude-code <event> という1本のコマンドで、インストーラがPATHに置く小さなランチャーが実行する。

作業中、ツール呼び出しは「observation」に変わる。エージェントが何をして何が起きたかについての、短い意味的なメモだ。Bunで管理されるバックグラウンドのワーカーサービスが、それをSQLiteに書き込む。新しいセッションが始まると、あなたが何か入力する前に、関連度の高いobservationがコンテキストへ注入される。

スタックにはセマンティック検索用のChromaベクトルデータベースもあり、キーワード検索用のSQLite FTS5と並んでいる。実際のところ、このハイブリッドが効く。「火曜日のあのマイグレーションスクリプト」はキーワード検索で、「トークンリフレッシュが黙って失敗するやつ」はセマンティック検索で、どちらも打つことになる。

2つの細部は特筆に値する。プロジェクトが実際に現場で使われてきた証拠だからだ。1つは <private> タグ。これで囲んだものは決して保存されない。もう1つはスクリーンショットで、オプトインかつ既定でオフ、しかも画像推論を別途有効にしない限りobserverモデルにも渡らない。記憶ツールが静かに監視ツールへ変わる失敗の仕方を、誰かがちゃんと考えている。

A wooden card catalog drawer pulled open, index cards fanned out under soft blue light

3段階の取得という工夫

私が素直に感心したのは検索の設計だ。記憶をコンテキストに放り込んでモデルが整理してくれることに賭けるのではなく、claude-memは3ステップのMCPワークフローを用意している。

search はID付きの簡潔な索引を返し、1件あたり50〜100トークン程度。timeline は当たりのあった項目の前後を時系列で見せてくれる。get_observations は1件500〜1,000トークンで詳細を取るが、選んだIDだけだ。READMEは「取得前に絞り込むことで約10倍のトークン節約」と主張している。主張の形としては正しい。能力の話ではなく、会計の話だからだ。

これが記憶システムとコンテキストウィンドウの違いだ。大きなウィンドウは毎ターン払う定額コスト。段階的開示は、探しに行ったときだけ払うコスト。長いセッションが古いツール出力でトークンを焼いていくのを見たことがある人なら、どちらがスケールするかはすぐ分かる。

インストールは1行、そこが要点

基本の流れはこうだ。

npx claude-mem install

--ide opencode、--ide t3code、--ide pi、--ide antigravity などに対応し、フックを持たないホスト向けにチャットログを監視するGrok Botモードもある。Claude Codeの中ならプラグインマーケットプレイス経由でも入る。

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

Node 20以降が必要だ。Bunとuvは無ければ自動で入る。Windowsではインストーラが %LOCALAPPDATA%\claude-mem\bin にランチャーを置き、ユーザーPATHに追加する。フックが実行ファイルが見つからないと文句を言う場合は、npx claude-mem doctor がトラブルシュートの入口になる。

READMEから繰り返しておきたい罠が1つ。npm install -g claude-mem はSDKを入れるだけだ。フックの登録もワーカーのセットアップも行わないので、何も起きず、ツールが壊れていると誤解することになる。

引っかかる部分

インストール中に、メールのマジックリンクでサインインするよう求められる。カードは不要だ。サインインするとメモリキーが発行され、30日トライアル付きのホスト型observerが使えるようになる。トライアルが切れると、購読しない限り記憶はAnthropicのプラン側に戻る。--provider を渡すか、CLAUDE_MEM_ONLINE_OPTIN=false を設定するか、CIで動かせば全部スキップできる。ここまでは問題ない。

ところがREADMEの下のほうに、「What About CMEM?」という節がある。CMEMは第三者が発行したトークンで、プロジェクトの作者が「公式に受け入れた」と説明されており、コントラクトアドレスまで載っている。

だからといってソフトウェアが悪いとは思わない。コードはApache-2.0で、アーキテクチャは文書化され、ライセンスの選択も開発者ツールに永続記憶を埋め込むことへの賭けとして明示的に正当化されている。ただ、ミームコインと一緒に配布され、記憶を始める前にサインインを求める記憶システムは、特定の種類の信頼を要求している。プライベートリポジトリに向ける前に、その信頼を与えるかどうかを決めたほうがいい。ローカル完結の経路は用意されている。事故ではなく、意識的にそちらを使うべきだ。

記憶は本当にエージェントを良くするのか

正直に言えば、繰り返しが減るだけだ。それは同じことではない。記憶されたobservationは過去についての主張であり、コードベースはたぶんその後に動いている。注入されたコンテキストが「マイグレーションは db/legacy.ts にある」と言っていて、3週間前に誰かがそのファイルを分割していたら、あなたはエージェントに知識を与えたのではなく、古い事実への自信を与えたことになる。

この点でclaude-mem自身の枠組みは助けになる。observationはIDで参照され、ワーカーのURLにあるローカルビューアで中身を確認できる。真実ではなくメモとして扱うこと。ここから価値を引き出せるのは、溜めるだけでなく剪定するプロジェクトだ。

二次的な効果もある。私が注視したいのはこちらだ。記憶は、エージェントが尋ねずに何をしてよいかを変える。履歴を持つエージェントは、先週引き継いだ前提の上を平気で進む。それは生産性の向上であり、そのまま非常に高価な誤解にもなる。

誰が使うべきか

セッションが短く自己完結しているなら、入れなくていい。オーバーヘッドに見合わないし、まっさらなコンテキストは機能のうちだ。

1つのリポジトリで何日も作業していて、同じアーキテクチャ上の決定を何度も説明し直していて、並行して走るエージェント同士が互いの結論を知る必要があるなら、いま存在するこのアイデアの実装としてはこれが最も完成度が高い。1行インストールなら、実験のコストは10分だ。

ただし期待値は正しく持っていくこと。claude-memはエージェントに記憶を与えるのではない。書類棚と、検索ツールと、書き留める習慣を与えるのだ。そのメモがまだ正しいかどうかは、いつも通りあなたの問題である。

関連記事