06 メモリ — セッションClaude Codeの1回の対話単位。起動から終了までの会話と作業状態のこと。長く使うと内容が混ざるため、トピックの区切りで新セッションに引き継ぐ運用をするを超えた記憶

💡 章の核: memoryは個人用の覚え書き。作業/短期/長期の役割分担で使い、永久保存はSSOT正典へ。

メモリとは

Claude Codeはセッションを超えて記憶を保持する仕組みを持つ。新しいセッションを開始しても、前回の文脈の一部を引き継げる。

graph TD subgraph "🧠 メモリシステム" AUTO["Auto Memory
~/.claude/projects/"] USER["User Memory
~/.claude/CLAUDE.md"] PROJ["Project Memory
repo/CLAUDE.md"] IDX["MEMORY.md
インデックス"] end AUTO --> T1["user: 役割・目標"] AUTO --> T2["feedback: 指導"] AUTO --> T3["project: 決定事項"] AUTO --> T4["reference: 外部参照"] IDX --> AUTO

メモリの種類

<a id="auto-memory"></a>Auto Memory（自動メモリ）

Claude Codeが自動的に保存するプロジェクト単位の記憶。

場所: ~/.claude/projects/<path>/memory/
形式: Markdownファイル（frontmatter付き）
自動保存: セッション中に学んだことを自動的に記録
自動読込: 次回セッション開始時に自動的にロード

記録される内容の例:

ユーザーの役割・好み
プロジェクトの状況・決定事項
フィードバック（「この方法はやめて」等）
外部システムへの参照（Linear, Grafana等）

<a id="user-memory"></a>User Memory（ユーザーメモリ）

~/.claude/CLAUDE.md に記述されたルール。

場所: ~/.claude/CLAUDE.md
形式: Markdown
スコープ: 全プロジェクト共通
内容: 基本ルール、LLM利用ポリシー、コーディング原則等

<a id="project-memory"></a>Project Memory（プロジェクトメモリ）

各リポジトリの CLAUDE.md に記述されたルール。

場所: <repo>/CLAUDE.md
形式: Markdown
スコープ: そのプロジェクト内のみ
内容: プロジェクト固有の構造・ルール・コマンドターミナルに入力してコンピュータに与える一行の指示。lsやcdのように『プログラム名+補足指定』で構成される

<a id="memory-md"></a>MEMORY.md（インデックス）

Auto Memoryの目次ファイル。

場所: memory/MEMORY.md
役割: 各メモリファイルへのポインタ（1行に1エントリ）
自動ロード: セッション開始時に必ず読み込まれる
制限: 200行以降は切り捨てられる

メモリの4つのタイプ

Auto Memoryには4つのタイプがある。

タイプ	説明	保存タイミング
`user`	ユーザーの役割・目標・知識レベル	ユーザー情報を学んだ時
`feedback`	ユーザーからの指導（「こうして」「これはやめて」）	指摘・確認を受けた時
`project`	プロジェクトの状況・決定事項	重要な決定をした時
`reference`	外部システムへのポインタ	外部リソースを知った時

メモリのライフサイクル

セッション開始
  │
  ├─ MEMORY.md を読み込み（インデックス）
  ├─ 関連するメモリファイルを読み込み
  │
  ▼
セッション中
  │
  ├─ 新しい情報を学ぶ → メモリに保存すべきか判断
  ├─ ユーザーからフィードバック → feedback メモリに保存
  ├─ プロジェクトの決定 → project メモリに保存
  │
  ▼
セッション終了
  │
  └─ 保存されたメモリは次回セッションで利用可能

メモリの管理

確認

ユーザーが「記憶を確認して」と言う → MEMORY.mdを読み込む
/memory コマンド → メモリ管理画面

保存

ユーザーが「これを覚えて」と言う → 即座に保存
Claude Codeが「これは記憶すべき」と判断 → 自動保存

削除

ユーザーが「これを忘れて」と言う → 該当メモリを削除
古い・不正確なメモリ → 更新または削除

月次棚卸し（定期メンテナンス）

毎月1回、durable cronクロン。Linuxで「毎日6時」「30分ごと」等の定期実行を予約する仕組み。予約実行の登録表（crontab）に書いて運用するの発火を契機にメモリを棚卸しする
1. 常時読み込みの基本ルール（CLAUDE.md等）と重複した個人のフィードバックは削除（削除前に中身を正典側へ移植・バックアップ必須）
2. 近い内容のメモリは統合（索引行は80文字目安・失敗の「なぜ」は本文に保持）
3. 削除済み項目が正典側に実在するかの抜き打ち照合・実例系メモリの重複チェック
4. 件数と索引行数を実測して報告

注意点

メモリは古くなる可能性がある — 鵜呑みにせず、必要に応じて現状を確認
コードのパターンやファイル構造はメモリに保存しない（コードから直接読めるため）
Git履歴もメモリに保存しない（git logが正）
メモリは無料ではない — MEMORY.md + 各ファイルが毎ターン読み込まれ、トークンAIにとっての「文字数」のようなもの。AIは文章をトークンという小片に区切って処理する。課金や入力上限（コンテキストウィンドウ）はこの単位で数えられるを消費。増えすぎると数千トークン/ターンの固定消費になる → 12_現場の知見

CLAUDE.mdの3層構造（Instruction Memory）

CLAUDE.md（User/Project Memory）は3層構造で運用すると、肥大化と「読むか怪しい間接リンク」のジレンマを解決できる（Z.AIベストプラクティス準拠）。

層	場所	読み込み	役割
層1 常時展開	`CLAUDE.md` + `rules/_shared/`	セッション起動時に全プロジェクトで自動	核心ルール・共通ルール原本
層2 パススコープ	`rules/*.md`（frontmatter `globs`）	該当ファイル操作時に自動	言語/作業別ルール
層3 スキルClaude Codeで「特定の作業手順」をパッケージ化したもの。SKILL.mdに手順を書いておくと、対応する場面でAIがその手順を読み込んで従う。経験を再利用する仕組み/参照	`skills/` + 参照資料	トリガー/強指示	スキル・詳細参照

層1の一元管理（@import）

共通ルール（セキュリティ・コーディング原則・記録・LLMルーティング）は rules/_shared/ に1箇所まとめ、グローバルCLAUDE.mdから @import で取り込む。

共通ルールの変更が1箇所で済む（DRY）
各プロジェクトのCLAUDE.mdは固有内容だけ（重複ゼロ）
グローバルで1回importすれば全プロジェクトに自動で届く

層2のパススコープ（globグロブ。ファイル名を「＊（任意の文字列）」等のワイルドカードで指定する書き方。「*.md」＝すべてのmdファイル、のような使い方s）

rules/*.md のfrontmatterに globs: ["**/*.py"] のように指定すると、該当拡張子ファイル名の末尾の「.md」「.py」等の部分。ファイルの種類を示す目印のファイル操作時にだけ読み込まれる。Python・Dart・TypeScript等、言語別ルールを必要な時だけ自動ロードできる。

設計原則

200行以下 — メインCLAUDE.mdは核心のみ（展開後も維持）
具体命令化 — 「詳細: 〇〇.md参照」より @import常時展開が確実
パス指定ロード — 言語別ルールは層2（必要時だけ）
Instruction vs Learning分離 — CLAUDE.md（人間が書く）と memory/（AI蓄積）を混在させない

詳細: 3層メモリ構造・3層メモリ再設計

💡 やさしい補足（初心者向け）

Claudeは「記憶」を持てる: 会話をまたいで「こういう決まり」「こういう好み」を覚えられる
CLAUDE.md = 毎回読むルールブック: ここに書いたことは毎回自動で読み込まれる。長すぎると毎回料金がかさむので簡潔に
3つの記憶の置き場所: 全体共通・プロジェクト固有・自動保存。目的に応じて使い分け
古いメモは整理: メモが増えすぎると毎回の読み込みで料金が膨らむ。たまに見直して要らないものを消す

SSOT検索スキル（ssot-search/v2=RAGRetrieval-Augmented Generation（ラグ・検索拡張生成）の略。AIに答えさせる前に、自分の文書から関連箇所を検索して渡し、その内容に基づいて答えさせる仕組み主経路）

SSOT横断検索の正典は ssot-search スキル。自然文クエリは v2（RAG意味検索）、型番・固有名は v1（字句検索）。

経路使い分け

クエリ型	経路	コマンド
自然文・概念・語彙が不定	v2（主）	`cd ~/projects/ssot-search-v2 && .venv/bin/python3 cli.py "<クエリ>" --top 5`
型番・固有名・エラー文の正確コピー	v1（サブ）	`python3 ~/.claude/scripts/ssot/search.py "<クエリ>" --top 5`
両方広く	v2 hybrid	`cli.py "<クエリ>" --mode hybrid`

索引保守

差分変更前後の違い。git diffのように「何がどう変わったか」を示すもの更新は */30 cron 自動稼働（~/bin/update_rag_index.sh）
鮮度確認: tail -2 ~/.local/share/ssot-search-v2/update.log・48h超で🚨警告
詳細: 19_ssot-search.md

層1ルールとの接続

層1 rules/_shared/LLMサボりバイアス防止.md のタスク再着手検索節は v2(RAG)を主経路、v1(字句)はサブ。grepグレップ。ファイルやテキストの中から、指定したパターンを含む行を抜き出すコマンド。大量のファイルから目的の言葉を探す時の定番単独での「ゼロ件」断定は禁止（語彙違いを吸収できないため、誤断定が起きやすい・2026-10-17実測）。