Claude CodeのSubagentsに永続メモリ機能が追加、Frontmatterで設定可能に
Anthropicのコードアシスタント「Claude Code」の「Subagents」（サブエージェント）機能が、セッションを超えて知識を蓄積・再利用できる「永続メモリ」機能を獲得した。これにより、特定のプロジェクトやユーザーのコンテキストを学習し、よりパーソナライズされた支援が可能になる。一方で、この機能は単発のコード生成だけを求めるユーザーには、設定の複雑さが上回る可能性もある。
Subagentsのメモリ機能とは
公式ドキュメントによれば、Claude CodeのSubagentsは、特定のタスクに特化したカスタムエージェントを作成する機能だ。今回、このSubagentsの設定ファイル（Frontmatter形式）にmemoryフィールドが追加され、永続的なメモリのスコープを指定できるようになった。
メモリは~/.claude/agent-memory/<エージェント名>/ディレクトリに保存され、Subagentsはここに知識を書き込んで蓄積する。メモリの読み書きを可能にするRead、Write、Editツールが自動的に有効化され、エージェントは能動的にメモリファイルを更新する。システムプロンプトにはメモリの読み書き指示と、主要なメモリファイルMEMORY.mdの内容（最初の200行）が含まれる仕組みだ。
3種類のメモリスコープ：user、project、local
追加されたメモリ機能の核心は、その「スコープ」管理にある。公式情報によると、スコープは以下の3種類から選択可能だ。
- user: ユーザー全体で共有されるメモリ。すべてのプロジェクトで同じエージェント名を使用する場合、蓄積された知識が共通で活用される。
- project: プロジェクト単位のメモリ。プロジェクトのルートディレクトリに
.claude/agent-memory/が作成され、そのプロジェクト固有の情報（アーキテクチャ、重要なコードパスなど）を保持する。 - local: ローカルセッション限りのメモリ。セッション終了とともに破棄される一時的な記憶となる。
これらのスコープは、Subagents設定ファイルのFrontmatterにmemory: userのように記述するか、Claude Code内で/agentsコマンドを実行してSubagentsを作成する際に対話形式で指定することができる。
具体的な設定と活用方法
例えば、コードレビューを専門に行う「code-reviewer」エージェントを作成し、ユーザー全体でその知見を蓄積したい場合、以下のような設定ファイル（例：code-reviewer.md）を作成する。
---
name: code-reviewer
description: コードをレビューし、改善点を指摘する専門家
memory: user
---
あなたは経験豊富なシニアエンジニアです。
**Update your agent memory** as you discover codepaths, patterns, library locations, and key architectural decisions.
...このエージェントが複数のプロジェクトでコードレビューを行うと、発見したコードパターンや、そのユーザーがよく犯すミス、プロジェクト間で共通するベストプラクティスなどをMEMORY.mdに蓄積していく。次回のレビュー時には、過去の知見を参照できるため、より文脈を理解した深い指摘が可能になる。
プロジェクト固有の設定に詳しいエージェントを作りたい場合は、memory: projectを指定する。これにより、そのプロジェクトの複雑なモジュール構成や、非標準的なディレクトリ構造、独自の開発ルールなどを学習させ、オンボーディングや長期にわたる開発支援に活用できる。
誰にとっての機能か？想定される活用シーン
この永続メモリ機能は、Claude Codeを日常的に使い、特定のコードベースと長期間向き合う開発者にとって、特に価値が高い。
主な活用シーン
- 大規模・複雑なプロジェクトのオンボーディング: 新規参画者が、プロジェクト固有のアーキテクチャや規約を記憶したエージェントに質問することで、迅速に理解を深められる。
- 一貫性のあるコードレビューの自動化: チームのコーディング規約や過去の指摘事項を記憶したレビューアーエージェントが、一貫した指摘を行い、レビュー負荷を軽減する。
- レガシーコードの調査・解析支援: プロジェクト内の重要なコードパスや依存関係を探索しながら、その情報をメモリに記録。後から「あの処理はどこで行われているか？」といった質問に、蓄積した知識から即座に答えられる。
- 個人の開発スタイルの学習: ユーザーが好むユーティリティ関数の書き方や、よく使うライブラリのパターンを
userスコープで記憶し、コード提案のパーソナライゼーションを高める。
競合ツールとの比較とClaude Codeのアプローチ
GitHub CopilotやCursorといった他のAIコードアシスタントも、コンテキストの理解やエージェント的な機能を強化している。しかし、Claude Codeの今回のアプローチは「ファイルシステムベースの明示的なメモリ管理」という点で特徴的だ。
競合の多くは、モデルのコンテキストウィンドウ内で暗黙的にセッション履歴を利用したり、プロジェクトファイルをインデックス化したりするアプローチを取る。一方、Claude CodeはMEMORY.mdというマークダウンファイルをエージェント自身が読み書きするという、シンプルで開発者にとって可視化・管理しやすい方法を採用した。ユーザーはメモリファイルを直接編集して知識を修正・整理することも可能で、制御性の高さがメリットと言える。
ただし、この方式はエージェントがメモリを「どう整理し、どう参照するか」という新たな課題も生む。メモリが膨大になり、ノイズが増える可能性もあるため、今後のアップデートではメモリの要約や整理に関する機能強化が期待される。
まとめ：継続的な協働パートナーとしての進化
Claude CodeのSubagentsへの永続メモリ追加は、AIコードアシスタントを「単発のコード生成ツール」から「プロジェクトや開発者と共に成長する継続的な協働パートナー」へと昇華させる重要な一歩だ。設定には若干の手間がかかるが、複雑なプロジェクトに深く関わり、反復的な質問や作業が多い開発者にとっては、時間をかけて設定する価値が十分にある機能である。今後の開発動向としては、メモリの質的管理や、複数エージェント間でのメモリ共有など、さらに発展したコラボレーション機能の登場に注目が集まる。
Be First to Comment