CLAUDE.mdとメモリ

この記事で分かること

Claude Code は、新しい会話を始めるたびに、まっさらな状態からスタートします。前回の会話の内容は引き継がれません。毎朝、記憶がリセットされるアルバイトさんのようなものです。

そこで役に立つのが「引き継ぎノート」です。Claude Code には2種類あります。

CLAUDE.md は、Claude に毎回読んでもらう指示書です。中身はふつうの文章で、Markdown という書き方で書きます。職場の壁に貼ってある「この店のルール」のようなものです。

置き場所	効く範囲
作業フォルダの直下の `CLAUDE.md`（または `.claude/CLAUDE.md`）	そのフォルダでの作業。チームで共有する用
`~/.claude/CLAUDE.md`	自分のすべての作業
作業フォルダの直下の `CLAUDE.local.md`	そのフォルダでの、自分だけの設定

~ は「自分のホームフォルダ」を表す記号です。はじめは、作業フォルダの直下に CLAUDE.md を1つ置くだけで十分です。

公式ドキュメントでは「そうしないと毎回説明し直すことになる内容」を書く場所だと説明されています。たとえば次のようなものです。

# このフォルダについて
家族向けのレシピサイトを作っています。

## ルール
- 説明は日本語で、専門用語を使わずに書く
- 文章は「です・ます」調にする
- 写真は images フォルダに入れる
- ファイルを消す前に、必ず理由を説明する

書き方のコツは3つです。

方法は3つあります。

/init を使う。 入力欄に /init と打つと、Claude がフォルダの中を調べて、たたき台の CLAUDE.md を作ってくれます。すでにある場合は、上書きせずに改善案を出してくれます。
Claude に頼む。 「このルールを CLAUDE.md に追加してください」と書きます。
自分で書く。 メモ帳などで CLAUDE.md という名前のファイルを作ります。

Claude は作業のなかで気づいたことを、自分でメモに残します。これが自動メモリです（Claude Code のメモリ機能のひとつ）。公式ドキュメントによると、自分のパソコン上で使う場合は最初からオンになっています。

ターミナルでは /memory と入力すると、CLAUDE.md や自動メモリの一覧を見たり、自動メモリのオン・オフを切り替えたりできます。

Claude が一度に見渡せる情報の量には上限があります。これをコンテキストウィンドウと呼びます。作業机の広さだと思ってください。

会話、読んだファイル、CLAUDE.md、メモ。すべてがこの机の上に並びます。机がいっぱいになると、古い内容は自動的に要約されて場所を空けます。そのとき、最初のほうに伝えた細かい指示が抜け落ちることがあります。

だから、次の習慣が効きます。

やること	方法
話題が変わったら新しい会話にする	ターミナルは `/clear`、デスクトップアプリは + New session
続けたいが机を片づけたい	`/compact` と入力して、これまでを要約してもらう
ずっと守ってほしいことは会話でなく CLAUDE.md に書く	作業フォルダ直下の CLAUDE.md は、要約のあとも読み直されます

書いたのに守ってくれない。 内容があいまいか、長すぎることが多いです。具体的に、短く書き直してみてください。ターミナルでは /context で、CLAUDE.md が読み込まれているか確かめられます。
何でも CLAUDE.md に書きたくなる。 手順の長い作業は、CLAUDE.md よりスキルに向いています。次の章で説明します。
自動メモリに何が入っているか不安。 /memory からメモのフォルダを開けば、すべて読めます。不要なものは消してかまいません。