Claude Code Memory

変更前

Claude がいつプロジェクト固有のルールを認識したのかをトリガーにして外部スクリプトを実行したり、読み込まれた指示の内容に基づいて動的な処理を行ったりする手段がありませんでした。

変更後

ルールの読み込み完了をフックできるようになったため、特定のルールが適用された際に通知を出したり、関連する依存関係のチェックを自動で行ったりすることが可能になります。

ユーザーへの恩恵

指示ファイル（CLAUDE.md）を中心とした開発ワークフローの自動化が進み、特定のコンテキストに合わせた柔軟な拡張が可能になります。

変更前

オートメモリのデータは常にデフォルトのディレクトリに保存されるため、特定のプロジェクトだけメモリを別の場所に隔離したり、ネットワークドライブなどで共有したりすることが不便でした。

変更後

環境変数一つで保存先を自由に変更できるようになったため、プロジェクトの要件に合わせた柔軟なデータ管理が可能になりました。

ユーザーへの恩恵

メモリデータのバックアップや共有、プロジェクトごとの厳格な分離が容易になり、ワークフローに合わせたデータ管理が実現します。

変更前

定義へのジャンプや型情報の取得を行うたびに、巨大なソースコードファイル全体が背後でロードされ、コンテキストを不必要に圧迫したり、動作が重くなったりすることがありました。

変更後

必要な差分やスニペットのみを抽出してコンテキストに組み込むようになったため、大規模なプロジェクトでも LSP 機能が軽量かつ高速に動作します。

ユーザーへの恩恵

大規模なコードベースにおいて、Claude の応答速度とコード理解の精度を両立させることができ、より洗練された開発支援が受けられます。

変更前

Git の作業ディレクトリ内に数GB規模の大きな（かつ .gitignore されていない）バイナリファイルが存在すると、Claude がコミット準備中にそれらをメモリに読み込もうとしてしまい、アプリがクラッシュしたりPCが重くなったりしていました。

変更後

ファイルの内容を無駄にメモリに展開しないように処理が最適化され、大きなアセットを含むプロジェクトでも安定して動作するようになりました。

ユーザーへの恩恵

動画、画像、機械学習モデルなどの巨大なファイルを扱うプロジェクトでも、環境に負荷をかけることなく快適に Claude Code を利用できます。

変更前

数日間にわたって Claude Code を立ち上げっぱなしにしたり、膨大な対話を行ったりすると、徐々にメモリ消費量が増えていき、最終的に動作が重くなる傾向がありました。

変更後

不要になった描画オブジェクトが正しくガベージコレクション（破棄）されるようになり、長期間の起動でもメモリ消費が一定に保たれるようになりました。

ユーザーへの恩恵

ツールを長時間開きっぱなしにする開発スタイルでも、パフォーマンスの低下を感じることなく安定して使い続けることができます。

変更前

エージェントチーム機能を使用している際、古い会話履歴が子エージェントの中でいつまでも残り続け、メモリを圧迫し続けるバグがありました。

変更後

履歴の参照範囲が適切に制限され、明示的に履歴を消去した際にはメモリも即座に解放されるようになりました。

ユーザーへの恩恵

大規模なチーム連携タスクを実行しても、PC のリソースを浪費することなく、より多くの並行処理が可能になります。

変更前

CLI を自動化スクリプト等で使用する非対話モードにおいて、プロジェクトの細かいルールやサブディレクトリ内の指示が無視されてしまい、対話モードと同じような賢い挙動が得られないことがありました。

変更後

プリントモードでも対話モードと同様にすべての指示ファイルが正しく探索・ロードされるようになり、一貫したルール適用が保証されるようになりました。

ユーザーへの恩恵

CI/CD などの自動化環境においても、プロジェクト独自のコーディング規約を Claude に確実に守らせることができます。

変更前

会話をリセットして新しく作業を始めようとしても、内部的に前の作業のキャッシュが一部残ってしまい、メモリ消費量が増えたままになる不都合がありました。

変更後

リセット処理が徹底され、不要なデータが完全に消去されるようになったため、新品の状態でセッションを再開できます。

ユーザーへの恩恵

長時間の開発作業の合間にセッションを切り替える際、リソースの蓄積による動作の重さを解消できます。

変更前

サブエージェントを使用する長時間セッションで、プログレスメッセージのペイロードがメモリを圧迫し、メモリ使用量が増加していました。

変更後

コンテキスト圧縮時に重いプログレスメッセージペイロードが除去されるようになり、サブエージェント利用時のメモリ効率が向上しました。

ユーザーへの恩恵

長時間にわたるサブエージェントの使用におけるメモリ効率が大幅に改善され、パフォーマンスが向上します。

変更前

gitルート検出キャッシュにメモリリークがあり、長時間セッション中にメモリ使用量が徐々に増加していました。

変更後

gitルート検出キャッシュのメモリリークが修正され、長時間実行時のメモリ消費量が改善されました。

ユーザーへの恩恵

長時間にわたる開発セッションでのメモリ使用量が削減され、パフォーマンスと安定性が向上します。

変更前

JSON解析キャッシュにメモリリークがあり、長時間セッション中にメモリ使用量が無制限に増加していました。

変更後

JSON解析キャッシュのメモリリークが修正され、長時間実行時のメモリ消費量が大幅に改善されました。

ユーザーへの恩恵

長時間セッションでのリソース使用量が削減され、ツールの応答性と安定性が向上します。

変更前

MCPサーバーが頻繁に再接続するシナリオで、フェッチキャッシュが適切にクリアされず、メモリリークが発生していました。

変更後

MCPサーバー切断時のフェッチキャッシュクリア処理が修正され、メモリリークの問題が解消されました。

ユーザーへの恩恵

頻繁に再接続が発生する環境でのメモリ使用量が削減され、MCP関連機能の安定性が向上しました。

変更前

LSP診断データが適切に解放されず、セッションが長引くにつれてメモリ使用量が無制限に増加していました。

変更後

LSP診断データが配信後に確実にクリーンアップされるようになり、長時間のセッションでもメモリ使用量の増加が抑えられるようになりました。

ユーザーへの恩恵

メモリリークが解消され、長時間のセッションでも安定したパフォーマンスが維持されるようになります。これにより、リソースの消費を抑え、より快適な開発体験を提供します。

変更前

多数のタスクを実行すると、完了したタスクの出力がメモリに残り続け、セッションのメモリ使用量が増加していました。

変更後

完了したタスクの出力が適切にメモリから解放されるようになり、長時間のセッションでもメモリ使用量が過度に増加しなくなりました。

ユーザーへの恩恵

メモリリークが解消され、長時間のセッションでも安定したパフォーマンスを維持できます。リソースの消費を抑え、より効率的な開発環境を提供します。

変更前

長時間のセッションでファイル履歴のスナップショットが蓄積し続け、メモリ使用量が無制限に増加していました。

変更後

ファイル履歴スナップショットの数に上限が設けられ、長時間のセッションでもメモリ使用量が過度に増加しないようになりました。

ユーザーへの恩恵

メモリリークが解消され、長時間のセッションでも安定したパフォーマンスを維持できます。リソースの消費を抑え、より効率的な開発環境を提供します。

変更前

TaskOutputで、クリーンアップ後も最近の行データがメモリに残り続けるメモリリークが発生していました。

変更後

TaskOutputがクリーンアップ時に最近の行データを適切に解放するようになり、メモリリークが解消されました。

ユーザーへの恩恵

メモリリークが解消され、長時間のセッションでも不要なメモリ消費が抑えられます。これにより、安定したパフォーマンスを維持し、リソースを効率的に利用できます。

変更前

CircularBufferでクリアされたアイテムがバックエンド配列に残り続け、メモリリークを引き起こしていました。

変更後

CircularBufferでクリアされたアイテムが適切に解放されるようになり、メモリリークが解消されました。

ユーザーへの恩恵

メモリリークが解消され、CircularBufferのメモリ使用量が最適化されます。これにより、長時間のセッションでも安定したパフォーマンスを維持できます。

変更前

シェルコマンド実行後もChildProcessとAbortControllerの参照がメモリに残り続け、メモリリークを引き起こしていました。

変更後

シェルコマンド実行後、ChildProcessとAbortControllerの参照が適切に解放されるようになり、メモリリークが解消されました。

ユーザーへの恩恵

メモリリークが解消され、シェルコマンド実行時のメモリ消費が最適化されます。これにより、長時間のセッションでも安定したパフォーマンスを維持できます。

変更前

長期間実行されるセッションでは、APIストリームバッファ、エージェントコンテキスト、スキル状態などのリソースが解放されずに蓄積され、メモリ使用量が増加する問題がありました。

変更後

長期間実行されるセッションにおけるメモリ使用量が改善されました。APIストリームバッファ、エージェントコンテキスト、スキル状態などのリソースが、使用後に適切に解放されるようになりました。

ユーザーへの恩恵

長時間のセッションでもメモリ使用量が抑えられるため、Claude Codeのパフォーマンスが安定し、メモリ不足による予期せぬ終了や遅延を防ぐことができます。これにより、ユーザーはより快適に長時間の作業に取り組めます。

変更前

長期間実行されるエージェントセッションにおいて、プログレスアップデートの処理でメッセージがO(n²)で蓄積され、メモリ使用量が増大していました。

変更後

長期間実行されるエージェントセッションのメモリ使用量が改善されました。プログレスアップデートにおけるメッセージのO(n²)での蓄積がなくなり、メモリ効率が向上しました。

ユーザーへの恩恵

長時間のセッションでもメモリ使用量が最適化され、Claude Codeの安定性とパフォーマンスが向上しました。これにより、複雑なタスクや長時間の分析でも、メモリ不足による影響を受けにくくなりました。

変更前

Windows環境において、ドライブレターの大文字・小文字の表記が異なる場合、同じCLAUDE.mdファイルが二重にロードされてしまう問題がありました。

変更後

Windows環境でドライブレターの大文字・小文字が異なる場合でも、同じCLAUDE.mdファイルが二重にロードされる問題が修正されました。

ユーザーへの恩恵

Windows環境でのCLAUDE.mdファイルのロードが正確になり、ドライブレター表記の違いによる意図しない挙動を防ぎました。これにより、設定の一貫性が保たれます。

変更前

以前のClaude Codeでは、エージェントのセッション間で特定の情報を永続的に記憶させる標準的なメカニズムが不足していました。特に、サブエージェントは親会話からスキルを継承せず、セッション終了後に学習内容を保持する機能がなかったため、同じタスクを繰り返す際に過去のコンテキストを失うという非効率性がありました。

変更後

エージェントのフロントマターにmemoryフィールドが追加され、user、project、localの3つのスコープでエージェントに永続的な記憶機能を持たせることが可能になりました。これにより、エージェントはセッションを跨いで学習し、過去の経験に基づいて振る舞いを改善できるようになります。例えば、projectスコープを設定すれば、そのプロジェクト固有の知識をエージェントが長期的に保持できます。

ユーザーへの恩恵

この改善により、エージェントはより賢く、より効率的に作業できるようになります。セッションを跨いで知識やコンテキストを保持できるため、反復的なタスクや長期にわたるプロジェクトにおいて、エージェントが毎回ゼロから学習し直す必要がなくなります。これにより、開発者はエージェントのパフォーマンスと生産性の向上を享受できます。

変更前

多数のセッションを管理している場合、--resumeコマンド実行時のメモリ使用量が大きくなっていました。

変更後

セッションインデックスのロード方法が最適化され、--resume時のメモリ使用量が大幅に削減されました。

ユーザーへの恩恵

多数のセッションを管理しているユーザーでも、セッションの再開がより軽量かつ高速になり、メモリリソースを節約できます。

変更前

これまでは、プロジェクト固有の指示やコンテキストを定義する CLAUDE.md ファイルは、プロジェクトのルートディレクトリ(.claude/CLAUDE.md)やユーザーのホームディレクトリ(~/.claude/CLAUDE.md)に限定されていました。モノレポ構成や共有された設定を持つ環境では、CLAUDE.md ファイルを別の場所に配置して読み込むことができませんでした。

変更後

--add-dir フラグと CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 環境変数を設定することで、指定した追加ディレクトリに存在する CLAUDE.md ファイルを読み込むことができるようになりました。これにより、より柔軟なプロジェクト構成や共有設定が可能になります。

ユーザーへの恩恵

これにより、開発者はモノレポ環境で各パッケージ固有の CLAUDE.md ファイルを使用したり、組織全体で共有されるガイドラインを別のディレクトリに集約したりすることが可能になります。プロジェクトの構造に合わせてClaude Codeの動作をより細かく制御できるようになり、大規模なプロジェクトや複雑なワークフローでの利便性が向上します。

変更前

コンテキストが上限に近づくと警告が表示されますが、/compact コマンドで手動でコンテキストを圧縮・整理した後も、その警告が画面に残り続けていました。

変更後

/compact コマンドの実行によってコンテキスト容量に余裕ができた場合、即座に警告表示が消えるようになります。

ユーザーへの恩恵

現在のコンテキストの状態が正確に画面へ反映されるようになり、不要な警告に惑わされずに作業を継続できるようになります。

変更前

手動で /compact コマンドを実行してコンテキストを整理した後も、画面上に「自動要約が必要」という警告メッセージが残り続けていました。

変更後

コンテキストの圧縮が完了した時点で、不要になった警告表示が即座に消えるよう挙動が改善されました。

ユーザーへの恩恵

画面上のステータス情報が常に現在の状況を正しく反映するようになり、不必要な警告に惑わされることがなくなります。

変更前

外部 CLAUDE.md ファイルをインポートする際、どのファイルがインポートされるのか、またその出典が不明確で不安がありました。

変更後

承認ダイアログでインポートされるファイル名と出典が明示されるようになり、安心してインポートを承認できます。

ユーザーへの恩恵

インポートプロセスにおける透明性が向上し、意図しないファイルや設定の読み込みを防ぐのに役立ちます。

変更前

プロジェクトの指示書である CLAUDE.md でファイルをインポートする際、テキスト以外のバイナリファイルまで読み込まれ、コンテキスト(メモリ)を無駄に消費していました。

変更後

インポート対象がテキストファイルに限定されるようになり、不要なバイナリデータがコンテキストを圧迫して Claude の精度を低下させることを防ぎます。

ユーザーへの恩恵

限られたコンテキストウィンドウを有効に活用でき、大規模なプロジェクトでも Claude とのやり取りがより効率的かつ正確になります。