Claude Codeのメモリ機能完全解説【2026年最新】：CLAUDE.md・auto memory・MEMORY.mdの仕組みと使い方

Claude Codeのメモリ機能完全解説【2026年最新】：CLAUDE.md・auto memory・MEMORY.mdの仕組みと使い方

前回はClaude CodeのHooks機能で自動化する方法を紹介しましたが、今回はセッションをまたいだ記憶の仕組み——つまり「Claude Codeのメモリ」を深掘りしていきます。

CLAUDE.mdファイルの仕組み

# プロジェクト概要
Next.js + TypeScript + Supabaseで構築したSaaSアプリ。
API routesはsrc/app/api/に集約している。

# ビルドコマンド
- 開発: npm run dev
- テスト: npm test
- ビルド: npm run build

# コーディング規約
- インデントは2スペース
- コンポーネントはsrc/components/に配置
- 型定義は必ず付ける

CLAUDE.mdを置く場所と優先順位

/initコマンドで自動生成する

.claude/rules/でルールを細分化する

---
paths:
  - "src/api/**/*.ts"
---

# APIルール
- 全エンドポイントに入力バリデーションを付ける
- エラーレスポンスは統一フォーマットで返す
- OpenAPIコメントを必ず書く

Auto memory（MEMORY.md）の仕組み

~/.claude/projects/<project>/memory/
├── MEMORY.md          # インデックスファイル（毎セッション先頭から読まれる）
├── debugging.md       # デバッグパターンのノート
├── api-conventions.md # API設計の決定事項
└── ...                # Claudeが必要に応じて作るトピックファイル

auto memoryが記録する内容

• ビルドコマンドやテスト実行手順
• デバッグで発見したパターンや注意点
• コード規約や命名ルールで発覚したこと
• 個人の好み（「npmよりpnpmを使う」など）

/memoryコマンドで内容を確認する

auto memoryの有効・無効を切り替える

{
  "autoMemoryEnabled": false
}

{
  "autoMemoryDirectory": "~/shared-memory-dir"
}

サブエージェントのメモリ管理

basic memoryとMCPでの外部メモリ連携

よくあるトラブルと解決法

CLAUDE.mdの指示が無視される

/compact後に指示が消える

auto memoryが膨らんで制限を超える

チームでのClaude Codeメモリ運用

• プロジェクトのCLAUDE.mdはgitで管理して全員同じものを使う
• 個人設定はCLAUDE.local.md（.gitignore済み）に書く
• CLAUDE.mdのレビューをPRプロセスに組み込む（誰でも追記できる状態は避ける）

まとめ：CLAUDE.mdとauto memoryの使い分け

よくある質問（FAQ）

claude code memory bankって何ですか？

「Memory Bank」はClaude Codeのビルトイン機能ではなく、コミュニティで広まったベストプラクティスの呼称です。プロジェクトルートにmemory-bank/というディレクトリを作り、プロジェクト概要・技術スタック・進捗・決定事項などをMarkdownで整理して保存する手法で、CLAUDE.mdからそれらをimportして使います。特定のツールやプラグインではなく、ファイル設計のパターンです。

CLAUDE.mdとMEMORY.mdの違いは何ですか？

CLAUDE.mdは人間が書く指示書で、コーディング規約・アーキテクチャ情報・ワークフローなどを記述します。MEMORY.mdはauto memoryの機能でClaudeが自動生成するファイルで、~/.claude/projects/<project>/memory/MEMORY.mdに保存されます。前者は人間が管理し後者はClaudeが管理する、という役割分担があります。

auto memoryを無効にすることはできますか？

できます。/memoryコマンドのトグル、設定ファイルの"autoMemoryEnabled": false、環境変数CLAUDE_CODE_DISABLE_AUTO_MEMORY=1の3つの方法があります。

claude code memory bankの設定方法を教えてください。

前述の通り、memory bankはビルトイン機能ではなく設計パターンです。memory-bank/ディレクトリを作成して、projectBrief.md（プロジェクト概要）・techContext.md（技術スタック）・progress.md（進捗）・decisionLog.md（決定事項）などのファイルを置き、CLAUDE.mdから@memory-bank/projectBrief.mdのようにimportします。

セッションをまたいでClaude Codeの記憶を維持するには？

CLAUDE.mdに重要なコンテキスト・ルールを書き、auto memoryを有効にしておくことが基本です。さらに確実に維持したい情報は毎セッション開始時に「前回の続きを確認してください」とCLAUDE.mdのパスを指定して読み込ませるか、メモリ系のMCPサーバー（basic memoryなど）を組み合わせる方法もあります。

出典

• Store instructions and memories - Claude Code公式ドキュメント
• Subagent configuration - Claude Code公式ドキュメント
• Settings reference - Claude Code公式ドキュメント