Claude Codeに記憶を設計する

01

毎回リセットされるAI、もったいなくないですか？

Claude Codeを使っていて、こんな経験はないだろうか。

「昨日やった作業の続きをお願い」と言っても、Claudeは何も覚えていない。プロジェクトの方針を説明し直し、ファイルの場所を教え直し、自分の好みを伝え直す。毎回、初対面からやり直し。

これは、Claude Codeの限界ではない。記憶の設計をしていないだけだ。

Claude Codeには「記憶を持たせる仕組み」がある。正しく設計すれば、セッションをまたいでもあなたのことを覚え、プロジェクトの文脈を理解し、あなたの好みに合わせて動く。

この記事では、実際に運用している5層メモリ構造を、初心者でもすぐに始められる形で解説する。

02

5層メモリ構造 — 全体像

Claude Codeの記憶を5つの層に分けて設計する。それぞれ役割が違い、読み込まれるタイミングも違う。

┌─────────────────────────────────────────────┐
│  CLAUDE.md        毎回読み込み・行動ルール    │
├─────────────────────────────────────────────┤
│  memory/          索引＋要約（自動読み込み）   │
│   ├ user_profile    → 誰のために動くか       │
│   ├ project_*       → 何をやっているか       │
│   ├ feedback_*      → どう振る舞うべきか     │
│   └ reference_*     → どこを参照するか       │
├─────────────────────────────────────────────┤
│  handoff.md       セッション引継ぎ（残タスク） │
├─────────────────────────────────────────────┤
│  外部ノート        全文・設計書（外部脳）      │
├─────────────────────────────────────────────┤
│  skills/          再利用可能なスキル定義       │
└─────────────────────────────────────────────┘

CORE PRINCIPLE

人間の記憶と同じ構造。 全部を丸暗記する必要はない。「何がどこにあるか」を知っていればいい。メモリには索引だけ置き、詳細は必要な時に読みに行く。

03

第1層：CLAUDE.md — 「どう振る舞うか」のルール

~/.claude/CLAUDE.md は、Claude Codeが毎セッション最初に読み込むファイル。ここに書いた内容は、Claudeの「性格」になる。

CLAUDE.md に書くこと毎回自動読み込み

・応答言語（日本語で簡潔に）
・保存ルール（変更したら必ずバックアップも更新）
・コミュニケーション方針（提案→確認→実行の順）
・環境情報（OS、ブラウザ、よく使うパス）
・セッション開始時にやること（引継ぎファイルを読む等）

注意：CLAUDE.mdは短く保つこと。 ここに設計書の全文を入れると、毎回大量のトークンを消費する。ルールと参照先だけを書き、詳細は他の層に任せる。

# CLAUDE.md の例（シンプル版）

## コミュニケーション
- 日本語で応答・簡潔に
- 保存前にユーザーへ提案してから実行

## セッション開始
handoff.md を読み込み、残タスクを報告する

## 環境
- OS: Windows 11
- Python: C:\Python312\python.exe

04

第2層：memory/ — 「何を覚えているか」の索引

~/.claude/projects/.../memory/ はClaude Codeの自動メモリ。 MEMORY.md という索引ファイルと、個別のメモリファイルで構成される。

ここには要点だけを置く。全文は入れない。

4種類のメモリ自動読み込み

user — ユーザーの役割・好み・知識レベル
project — 進行中プロジェクトの方針と状況
feedback — 「こうして/こうしないで」の行動指針
reference — 外部リソースへのポインタ

# MEMORY.md（索引の例）

## User
- [user_profile.md] — 個人投資家、株式利益10億円超

## Project
- [project_walking_library.md] — 歩く書庫設計書（詳細はObsidianに）

## Feedback
- [feedback_screenshot_path.md] — スクショはPictures/Screenshots/を確認

メモリには「歩く書庫プロジェクトがある。詳細はObsidianのここにある」と書く。
次のセッションでClaudeは索引を見て「あ、この設計書があるな」→ 必要な時だけ全文を読みに行く。

05

第3層：handoff.md — 「今どこまでやったか」の引継ぎ

~/.claude/handoff.md は、セッション間の作業引継ぎファイル。人間の仕事で言えば「引継ぎノート」そのものだ。

セッション終了時にClaudeが自動で更新し、次のセッション開始時に読み込む。これがあるだけで、「前回の続きから」が一言で始まる。

handoff.md に書くこと毎回自動読み込み

・完了済みタスク一覧（日付付き）
・残タスク一覧（優先度別）
・次回最優先でやること
・重要ファイルの場所
・ブランド設定やプロジェクトのサマリー

# handoff.md の例

最終更新：2026-03-30

## 完了済み
| タスク | 詳細 |
|---|---|
| GitHub公開 | ✅ https://example.github.io/my-site/ |

## 残タスク
### 最優先
- [ ] トップページのデザイン修正
### 高
- [ ] SNS投稿の自動化設定

06

第4層：外部ノート — 「全文を置く外部脳」

設計書、構想ノート、長い仕様書。これらをメモリに入れるとトークンを浪費する。

解決策：外部のノートアプリ（Obsidian、Notion等）にフルテキストを置き、メモリには「どこにあるか」だけ記録する。

Claude Codeはローカルファイルを読めるので、 ObsidianのVaultパスを教えておけば、必要な時にReadコマンドで詳細を読みに行ける。

WHY THIS WORKS

人間も同じだ。すべてを暗記する必要はない。
「あの資料はあのフォルダにある」と知っていれば、必要な時に開けばいい。
Claude Codeの記憶も、この原則で設計する。

07

第5層：skills/ — 「繰り返す作業を定型化」

~/.claude/skills/ に定義ファイルを置くと、 /コマンド名で呼び出せるようになる。

毎朝のルーティン、メモの保存、投稿文の生成。繰り返す作業はスキルにして、一言で実行できるようにする。

# skills/btw/btw.md の例

---
name: btw
description: 作業中の気づきを即座にメモ保存
user_invocable: true
---

ユーザーが /btw に続けてメモを入力したら、
タイムスタンプ付きでObsidianに保存する。

これで /btw キーエンスの直販モデルを調べたいと打つだけで、日時付きでメモが保存される。作業を中断せずに思いつきを捕まえられる。

08

今日から始める — 3ステップ

5層すべてを一度に作る必要はない。まず3つだけ始めればいい。

CLAUDE.md を作る（5分）

~/.claude/CLAUDE.md に「日本語で応答」「簡潔に」と2行書くだけでいい。これだけでClaudeの振る舞いが変わる。

handoff.md を作る（3分）

~/.claude/handoff.md に「# 作業引継ぎ」と書き、セッション終了時にClaudeに「引継ぎ保存して」と頼む。次回から自動で読み込まれる。

Claudeに「覚えて」と言う（0分）

会話中に「これ覚えて」と言えば、Claudeが自動でmemory/に保存する。特別な設定は不要。Claudeのauto memory機能が動く。

START SMALL

完璧な設計は要らない。CLAUDE.md + handoff.md の2ファイルだけで、 Claude Codeは「使い捨てのAI」から「昨日の続きができる相棒」に変わる。 残りの層は、必要になったら足せばいい。

09

投資家の視点 — AIの記憶設計は「時間への投資」

バフェットは言った。「人生で最も重要な投資は、あなた自身への投資だ。」

AIの記憶を設計する時間は、毎日5分の自己投資だ。その5分が、明日以降のすべてのセッションで複利で効いてくる。

毎回10分の説明が不要になれば、年間で60時間以上の時間が生まれる。その時間で本を読み、企業を分析し、思考を深められる。

AIを育てることは、自分の時間を取り戻すことだ。 そしてそれは、最もリターンの高い投資のひとつだと思う。

Claude Code CLAUDE.md メモリ設計 handoff.md skills 時間への投資

Claude Codeに記憶を設計する— AIを「使い捨て」から「育つ相棒」に変える5層構造