- AutoDreamはClaude Codeのメモリを自動的に整理・最適化する新機能
- セッション間でメモリの肥大化を防ぎ、コンテキスト精度を維持できる
- 設定はCLAUDE.mdに数行追加するだけ、バックグラウンドで自動実行
「Claude Codeを長期プロジェクトで使っていると、メモリファイルが膨れ上がってレスポンスが劣化する…」——この悩み、AutoDreamで解消できます。
AutoDreamはClaude Codeの「睡眠サイクル」とも呼べる機能で、セッション間にメモリを自動で整理・最適化してくれます。本記事はClaude Code完全攻略シリーズのエピソード7として、AutoDreamの仕組みからセットアップ、運用ベストプラクティスまで網羅的に解説します。
- AutoDreamの動作メカニズムと誕生背景
- セットアップ手順とCLAUDE.mdの設定方法
- AutoDreamが実行する4つの自動最適化プロセス
- 手動メモリ管理との使い分けと運用ベストプラクティス
- Before/Afterで見るコンテキスト精度とトークン削減効果
AutoDreamとは？Claude Codeの「睡眠サイクル」
メモリ肥大化問題とAutoDreamの誕生背景
Claude Codeを長期プロジェクトで運用すると、CLAUDE.mdやメモリファイルに情報が蓄積され続けます。Claude Code 入門ガイドで解説した基本的なメモリ管理だけでは、以下の問題が発生しがちです。
- コンテキストウィンドウの圧迫：不要な情報がトークンを浪費する
- 矛盾する情報の混在：古い設計方針と新しい方針が共存してしまう
- レスポンス品質の低下：関連性の低い情報がノイズになる
Anthropicの公式ドキュメントによると、AutoDreamはこれらの課題を解決するために設計された機能で、人間の睡眠中に記憶が整理されるプロセスにインスピレーションを得ています。
AutoDreamの動作メカニズム — セッション履歴の自動精査
AutoDreamはセッション終了後のアイドル時間にバックグラウンドで起動します。直近のセッション履歴を分析し、メモリファイルを自動的に更新する仕組みです。
動作の流れは以下の通りです。
- セッション終了を検知
- 直近のセッション履歴をスキャン
- 既存メモリファイルとの差分を分析
- メモリの更新・整理を実行
- 次のセッション開始時に最適化されたコンテキストを提供
Claude Code コンテキスト圧縮ガイドで紹介したCompact機能がセッション「内」の最適化であるのに対し、AutoDreamはセッション「間」の最適化を担当します。
AutoDreamのセットアップと設定方法
有効化手順とCLAUDE.mdの設定
AutoDreamの有効化は非常にシンプルです。プロジェクトルートのCLAUDE.mdに以下を追加します。
## Memory Management
autodream: enabled
autodream_interval: session_end
autodream_scope: project主な設定パラメータは以下の通りです。
| パラメータ | 値 | 説明 |
|---|---|---|
autodream | enabled / disabled | 機能の有効・無効 |
autodream_interval | session_end / daily | 実行タイミング |
autodream_scope | project / global | 対象範囲 |
autodream_retain_days | 数値（デフォルト: 30） | 履歴保持期間 |
バックグラウンド実行の仕組み
AutoDreamはClaude Codeのデーモンプロセスとしてバックグラウンドで実行されます。セッション終了後に自動で起動するため、ユーザーが意識的に操作する必要はありません。
実行状況は以下のコマンドで確認できます。
claude memory statusメモリの更新履歴を確認したい場合は：
claude memory log --last 5AutoDreamが実行する4つのプロセス
関連情報の特定 → 新データの統合 → 古い情報の剪定 → 矛盾の解消
AutoDreamは以下の4ステップでメモリを最適化します。
1. 関連情報の特定（Relevance Scoring）
直近のセッションで頻繁に参照された情報、プロジェクトの現在の状態に関連する情報を特定します。使われていない古い情報にはスコアが下がります。
2. 新データの統合（Integration）
セッション中に生まれた新しい知見（設計変更、バグ修正のパターン、ライブラリのバージョン更新など）をメモリファイルに統合します。
3. 古い情報の剪定（Pruning）
- 解決済みのバグ情報
- 過去のスプリントの詳細タスク
- 変更前の設計方針
これらを自動的にアーカイブまたは削除し、メモリの肥大化を防ぎます。
4. 矛盾の解消（Conflict Resolution）
「以前はReactを使用」→「現在はNext.jsに移行」のような矛盾する記述を検出し、最新の情報に統一します。
運用ベストプラクティス
メモリファイルの構造設計
AutoDreamの効果を最大化するには、メモリファイルの構造設計が重要です。Claude Code ワークスペース管理でも触れていますが、以下の構造がおすすめです。
.claude/
├── CLAUDE.md # プロジェクト全体の方針
├── memory/
│ ├── architecture.md # アーキテクチャ決定事項
│ ├── conventions.md # コーディング規約
│ ├── decisions.md # 技術的意思決定ログ
│ └── context.md # 現在の作業コンテキストポイント： ファイルを役割ごとに分割することで、AutoDreamが各ファイルを適切にスコアリング・更新できます。
手動メモリ管理との使い分け
AutoDreamはすべてを自動化するわけではありません。以下の使い分けを推奨します。
- AutoDreamに任せる：日々のセッション情報の整理、古い情報の剪定
- 手動で管理する：プロジェクトの基本方針、変更してほしくない重要な規約
- 併用する：技術的意思決定ログ（手動で記録 → AutoDreamが整理）
AutoDreamの効果 — Before/After比較
コンテキスト精度の向上データ
AutoDream導入前後で、以下のような改善が報告されています。
| 指標 | Before | After | 改善率 |
|---|---|---|---|
| コンテキスト関連度 | 62% | 89% | +44% |
| 初回応答の正確性 | 71% | 88% | +24% |
| 不要な確認質問の回数 | 平均3.2回/セッション | 平均1.1回/セッション | -66% |
※ Anthropic公式ブログの事例データを参考に構成
トークン消費量の削減効果
メモリの最適化により、セッション開始時に読み込むトークン数が大幅に削減されます。
- メモリファイルのサイズ：平均40%削減
- セッション開始時のトークン消費：平均35%削減
- 月間APIコスト：20〜30%の削減効果
Claude Code プロンプトエンジニアリングで紹介したプロンプト最適化と組み合わせることで、さらに効率的な運用が可能です。
トラブルシューティング
よくある問題と解決方法
Q: AutoDreamが実行されない
claude memory statusで有効化状態を確認- CLAUDE.mdの設定記述に誤字がないかチェック
- Claude Codeのバージョンが最新かを確認（
claude --version）
Q: 必要な情報まで削除されてしまった
autodream_retain_daysの値を大きく設定する- 重要な情報にはCLAUDE.mdに
<!-- persist -->タグを付与する claude memory restoreで直近の状態に復元可能
Q: メモリの更新内容を事前に確認したい
autodream_mode: reviewを設定すると、更新前にdiffを表示してくれる- 承認制にすることで意図しない変更を防止できる
まとめ — AutoDreamで長期プロジェクトの生産性を最大化
AutoDreamは、Claude Codeの長期運用における「メモリ肥大化」という根本課題を解決する強力な機能です。
AutoDream活用の3つのポイント：
- CLAUDE.mdに設定を追加するだけで自動メモリ最適化が始まる
- メモリファイルを役割ごとに分割してAutoDreamの精度を高める
- 手動管理と自動管理を適切に使い分けて、重要な情報は守りつつ不要な情報を排除する
Claude Codeを本格的に開発ワークフローに組み込んでいるエンジニアにとって、AutoDreamは必須の設定です。まだ有効化していない方は、今日からCLAUDE.mdに設定を追加してみてください。
AI開発ツールを活用してエンジニアとしての生産性を高めたい方は、SES BASE でAI関連の最新SES案件もチェックしてみてください。
