Claude CodeのSubagentsが「記憶」を獲得、プロジェクト知識を蓄積する永続メモリ機能を追加
Anthropicのコード支援ツール「Claude Code」の「Subagents」（サブエージェント）機能に、永続的なメモリ機能が追加された。これにより、AIエージェントがユーザーやプロジェクトごとに知識を学習・蓄積し、繰り返しの作業を効率化できるようになる。単発のコード生成だけではなく、プロジェクトに深く関与する「学習するパートナー」としての進化を示すアップデートだが、日常的に複雑なプロジェクトを扱う開発者でなければ、その真価を実感する機会は少ないかもしれない。
Subagentsの永続メモリとは？
Claude CodeのSubagentsは、コードレビューや特定の開発タスクに特化したカスタムAIエージェントを作成できる機能だ。これまでは各セッション（対話）ごとのコンテキストしか持てなかったが、今回のアップデートで、セッションを超えて知識を保持する「永続メモリ」が利用可能になった。
公式ドキュメントによれば、この機能はSubagentsの設定ファイル（Frontmatter形式）にmemory: userなどの一行を追加するだけで有効化できる。有効にすると、Subagentsは作業中に得たコードパターン、ライブラリの場所、アーキテクチャの重要なポイント、デバッグの知見などを自動的にメモリとして記録し、後の作業で参照するようになる。
3種類のメモリスコープと具体的な仕組み
メモリには3つのスコープが用意されており、用途に応じて使い分ける。公式ドキュメントの説明を基にまとめると以下の通りだ。
- user: ユーザー全体で共有されるメモリ。すべてのプロジェクトでこのSubagentsが学習した内容を利用できる。
- project: 特定のプロジェクト内でのみ有効なメモリ。プロジェクト固有の規約やディレクトリ構造などを学習させるのに適している。
- local: 現在のローカルセッションのみで有効な一時的なメモリ。従来の動作に近い。
これらのメモリは、ファイルシステム上の.claude/agent-memory/<エージェント名>/ディレクトリ内にMEMORY.mdというMarkdownファイルとして保存される。Subagentsはこのファイルを読み書きし、知識を蓄積していく。メモリが200行を超えると、エージェントは自動的に内容を要約・整理（キュレーション）し、最も関連性の高い情報を保持する。
設定方法と使い始め方
既存のSubagentsにメモリ機能を追加するには、その設定ファイル（通常は~/.claude/agents/ディレクトリなどに保存されたYAML frontmatter付きMarkdownファイル）を編集し、memory:フィールドを追加すればよい。
---
name: my-code-reviewer
description: プロジェクトAのコードをレビューする専門家
memory: project
---新しいSubagentsを作成する際は、Claude Codeのチャットで/agentsコマンドを実行し、対話形式でエージェントを作成する過程でメモリスコープを指定できる。
具体的な活用シーン：コードレビューエージェントの例
この機能が威力を発揮する典型的な例は、定期的なコードレビューだ。例えば、あるプロジェクトで「コードレビュー専門」のSubagentsを作成し、メモリスコープをprojectに設定する。初期段階では、開発者が「この関数はパフォーマンスに問題がある」「このエラーハンドリングは不十分だ」といった指摘を逐一与える必要がある。
しかし、何度かレビューを重ねるうちに、SubagentsはMEMORY.mdに「このプロジェクトでは◯◯という関数がボトルネックになりがち」「△△という例外クラスを使ったハンドリングが推奨パターン」といった知見を蓄積する。次回のレビュー時には、蓄積されたメモリを参照し、過去の指摘と類似したパターンを自主的に指摘したり、プロジェクト固有のベストプラクティスに沿ったアドバイスを提供したりできるようになる。これにより、レビューの一貫性が向上し、開発者とエージェントの間で無駄な説明が減っていく。
競合ツールとの比較と独自性
GitHub CopilotやCursorにも、コードベースの理解を深めるコンテキスト機能やエージェント的な機能は存在する。しかし、Claude CodeのSubagentsの永続メモリは、単にファイルを読み込むのではなく、エージェント自身の「経験」を構造化された形で積み重ね、能動的に更新・活用する点に特徴がある。
これは、ツールが「プロジェクトについて学び、成長するデジタルなチームメンバー」として振る舞うことを可能にする第一歩と言える。設定可能なスコープ（user/project/local）によって、知識の適用範囲を柔軟に制御できるのも実用的だ。個人の開発癖から大規模プロジェクトの複雑な規約まで、階層的に知識を管理できる設計になっている。
まとめ：誰が使うべき機能か？
この永続メモリ機能は、Claude Codeを日常的に使い、特に中〜大規模なプロジェクトのメンテナンスや、定型化されたコードレビュー作業に多くの時間を費やす開発者にとって、大きな効率化をもたらす可能性を秘めている。プロジェクト固有の知識が蓄積されればされるほど、エージェントの支援は的を射たものになる。
一方で、単発のコードスニペット生成や、都度異なる小さなプロジェクトを扱うユーザーにとって、この機能のメリットは限定的だろう。メモリが効果を発揮するには、ある程度の時間と相互作用が必要だからだ。AIエージェントの進化が「一時的なアシスタント」から「継続的な学習パートナー」へとシフトしつつあることを示す、注目すべきアップデートである。
Be First to Comment