Claude Codeのファイルベースメモリシステム：ベクトルDBに代わる実用的な選択肢

Claude Codeは、典型的なベクトルデータベースと埋め込みのセットアップを置き換える、ファイルベースのアプローチをエージェントメモリに採用しています。完全なRAGの代わりに、名前、説明、タイプ情報を含む小さなフロントマターセクションを持つ.mdファイルとしてメモリを保存し、インデックスとして機能するMEMORY.mdファイルを使用します。

システムの仕組み

実行時、システムはすべてを埋め込んだり検索したりしません。以下のプロセスに従います：

• メモリファイルをスキャン（約200ファイルに制限、新しいものから順に）
• 最初の約30行（主にメタデータ）のみを読み取る
• 軽量なマニフェストを構築
• 小さなモデルを使用して上位約5つの関連メモリを選択
• 選択されたメモリのみをコンテキストにロード（サイズ制限あり）

主な利点

この設計には、いくつかの実用的な利点があります：

• コスト効率が良い：ファイル数、トークン数が制限され、予測可能なコスト
• 高速：埋め込みや類似性検索の操作が不要
• 制御可能：少数のメモリのみを注入し、あらゆる場所で厳格な上限を設定
• 人間が読みやすい：すべてがマークダウンファイルとして保存される
• 不要な情報が少ない：リポジトリから既に導き出せる情報の保存を明示的に回避

このシステムは、メモリを「絶対的な真実」ではなく「古くなっている可能性があるもの」として扱い、エージェントメモリ管理に新鮮なアプローチを提供します。この設計は、ほとんどの「メモリ」が大規模な知識ベースではなく、設定、コンテキスト、外部参照で構成されるコーディングやデバッグエージェントに特に実用的です。

このアプローチはすべてのユースケースでRAGを置き換えるものではありませんが、包括的な知識検索よりもシンプルさと予測可能性が重要な開発エージェントにとって、堅実なトレードオフを表しています。