Claude Codeのメモリの使い分け|何をどこに書くか

Claude Codeのメモリの使い分け|何をどこに書くか

こんにちは、飯塚です!

「Claude Codeのメモリって、どこに何を書けばいいの?」と悩んでいませんか?

そんな方に向けて、私が実際に使っている「メモリの置き場所の分け方」をまとめました。

飯塚

この記事は、こんな人におすすめです!

  • CLAUDE.mdが長くなり、書いたことを守ってくれない
  • 自動メモリや.claude/rules/との違いが分からない
  • 同じ注意を、何度もAIに言い直している

大事なのは、AIに「毎回判断させる中身」と「手順として任せる作業」を、分けられているか。

判断の材料はCLAUDE.md、手順はスキル、確実に止めたい操作はフック。
分けられれば、置き場所はすぐに決まるんですね。

本記事では、ルールファイル・スキル・フックを自分で育ててきた私が、実際のファイルを見せながら解説します。

AIに同じ注意をくり返す時間を減らしたい方は、

ぜひ最後までご覧ください😊

目次

Claude Codeのメモリとは?持ち越す記憶

Claude Codeのメモリは、新しい会話にも持ち越す「記憶」の仕組みです。

Claude Codeは、会話を始めるたびに、まっさらな状態から動きます。
公式の案内では、記憶を持ち越す仕組みはCLAUDE.mdと自動メモリの2つ。

CLAUDE.mdの置き場所や書き方は、CLAUDE.mdの書き方の記事で紹介しました。
この記事では、その外にある3つの置き場所の使い分けを扱います。

自動メモリ・.claude/rules/・スキルを、CLAUDE.mdと比べると次のとおりです。

自動メモリ・rules・スキルの使い分けの表。比べる相手のCLAUDE.mdは毎回全部読まれる。rulesはpathsなしで毎回、pathsつきで合うファイルを触ったとき。自動メモリはClaudeが書きMEMORY.mdの先頭200行か25KBを毎回読む。スキルは説明がいつも、本文は使うときだけ読まれる

違うのは、だれが書くか、いつ読まれるか、向いている中身の3つ。
確実に止めたいことだけは、どれにも書かずにフックへ回します。

公式の詳しい説明は、Claude があなたのプロジェクトを記憶する方法へ。

rules・自動メモリ・スキルとフックの使い分け

テーマごとの決まりはrules、Claudeの学びは自動メモリ、手順はスキル、確実に止める操作はフックへ。

公式の目安は、CLAUDE.mdが1ファイル200行以内。
一部のファイルだけの決まりはrulesへ、何段もの手順はスキルへ移すよう勧めています。

3つの置き場所に書くこと。rulesはテーマごと・フォルダごとの決まり、自動メモリはあなたの直しや好みをClaudeが書く、スキルは何度もチャットに貼っている手順やチェックリスト。毎回要る事実はCLAUDE.md、確実に止めたい操作はフック

1. .claude/rules/:テーマごとに分けて、範囲を絞る

.claude/rules/は、決まりをテーマごとのファイルに分けて置く場所です。

pathsを書かないルールは、.claude/CLAUDE.mdと同じく毎回読まれます。
pathsを書くと、合うファイルを読んだり書いたりするときだけ読み込まれる仕組み。

---
paths:
  - "(フォルダ名)/**/*.md"
---


- (そのフォルダだけで守ってほしいこと)
  • 先頭の---で囲んだ部分は、ファイルの設定を書く欄(frontmatter)
  • **は、下の階層のフォルダもまとめて指す書き方
  • 1ファイルに1つのテーマ。ファイル名は中身が分かる名前にする
  • ユーザー用の~/.claude/rules/に置くと、すべてのプロジェクトで効く

一部のファイルだけの決まりをCLAUDE.mdから外せば、毎回の会話が軽くなります。

ユーザー用とプロジェクト用のルールがぶつかると、Claudeはどちらに従うか分かりません。
公式も、2つを食い違わせないよう勧めています。

私の個人のObsidian Vaultでは4本、すべてpathsなし。
範囲を絞らず、テーマで分けるためだけに使っています。

2. 自動メモリ:Claudeが自分で書くメモ

自動メモリは、あなたの直しや好みを、Claudeが自分でメモする仕組みです。

保存先は~/.claude/projects/(プロジェクト名)/memory/。
目次のMEMORY.mdと、話題ごとのファイルが並びます。

~/.claude/projects/(プロジェクト名)/memory/
├── MEMORY.md            目次。1行に1つのメモ
├── user_role.md         メモ1つ
└── feedback_testing.md  メモ1つ

会話の始めに読まれるのは、MEMORY.mdの先頭200行か25KBの、先に届いたほう。
話題ごとのファイルは、要るときだけ開かれます。

メモの種類は4つです。

  • user:あなたの役割・得意なこと・働き方の好み
  • feedback:あなたが直したこと、よしとしたやり方
  • project:進めている仕事・期限・決めたこと
  • reference:課題の一覧など、外の情報の置き場所

コードから分かる中身や、CLAUDE.mdにもう書いてある話はメモしません。
毎回書くわけでもなく、次の会話で役立つかどうかで決めています。

「覚えておいて」と頼むと自動メモリに、「CLAUDE.mdに足して」と頼むとCLAUDE.mdに書かれます。
/memoryを開けば、中身を見たり、オンとオフを切り替えたりできますよ。

3. スキル:何段もある手順は、使うときだけ読む

何段もある手順は、CLAUDE.mdではなくスキルに分けます。

公式の目安は、同じ手順やチェックリストを、何度もチャットに貼っているとき。
CLAUDE.mdの一部が、事実ではなく手順に育ってきたときも、移す合図です。

いつも読まれるのはスキルの説明(description)だけで、本文は使うときに読み込まれます。
手順が長くても、使うまでは会話をほとんど重くしないんですね。

rulesとの違いは、読み込まれる時。

rulesは毎回か、合うファイルを触ったとき。スキルは、呼んだときか要ると判断されたときだけです。

置き場所は2つあります。

~/.claude/skills/(スキル名)/SKILL.md   自分用(すべてのプロジェクト)
.claude/skills/(スキル名)/SKILL.md     プロジェクト用

くわしくは、公式のスキルの案内へ。

置き分けの考え方は、公式ブログのSteering Claude Codeが参考に。

要の一文は「Procedures belong in skills.」(手順はスキルに)。

4. フック:どれにも書かず、仕組みで止める

例外なく守らせたい決まりは、CLAUDE.mdではなくフックに書きます。

公式の説明では、CLAUDE.mdは会話の材料で、守らせる設定ではありません。
フックは決まった場面で毎回動くコマンドで、AIが選ぶのを待たないんですね。

例えばPreToolUseのフックは、道具を使う前に動き、その操作を止められます。
書き方は、公式のフックの使い方を見てください。

何をどこに書くか決める手順

同じ注意を2回したら、次の順に問いかけて置き場所を決めます。

上から順に問いかけて、「はい」が出たところが置き場所。

何をどこに書くか決める順番の図。同じ注意を2回したら書き出し、確実に止めたいならフック、何段もある手順ならスキル、一部のフォルダやファイルだけならrulesとpaths、残った事実だけをCLAUDE.mdへ

STEP
2回目の注意で書き出す

同じ間違いが2回目に起きたら、書き出す合図です。
前の会話と同じ直しを、もう一度チャットに打ったときも同じ。

STEP
確実に止めたいなら、フックにする

「〇〇は禁止」と強く書きたくなったら、フックの出番です。
私も、手順書の3か所に書いて止まらなかったミスを、フックに移しました。

STEP
何段もある手順なら、スキルにする

何段もある作業は、SKILL.mdに手順として書き出しましょう。
CLAUDE.mdには、スキルの名前と場所だけを残せば十分です。

STEP
一部のファイルだけなら、rulesにする

特定のフォルダだけの決まりは、.claude/rules/にpathsつきで置きます。
テーマで分けたいだけなら、pathsなしでも置けます。

STEP
残った事実だけをCLAUDE.mdに書く

最後に残った「毎回要る事実」だけを、CLAUDE.mdに書きます。

STEP
読み込まれたかを確かめる

会話の中で/context allと打ち、「Memory files」の一覧にファイルがあるかを見ます。

/context all
  • 一覧に無いファイルは、Claudeには見えていない
  • pathsつきのルールは、合うファイルを触るまで読まれない

私のClaude Codeのメモリの実例

私は、毎回読むファイルを薄くして、手順と止め役を外に出しています。

チームと個人、2つのObsidian Vaultで、どこに何行あるかを並べました。

私のClaude Codeのメモリの一覧。チームのObsidian Vaultはスキル48本で、メールとブログ記事は作る役と点検する役を分け、CLAUDE.mdは3行、自動メモリはオフ。個人のObsidian Vaultはrules 4本41行・PreToolUseのフック4つ・自動メモリはオフでMEMORY.mdは1行・CLAUDE.md 51行

動かし始める手順は、ObsidianとClaude Codeの連携の記事にまとめました。

チームのObsidian VaultのCLAUDE.mdは3行で、本体のAGENTS.md(60行)を読み込むだけ。
毎回読む分を薄くして、決まりや手順は外に出しています。

1. 毎回守る決まりは、rulesに4本

個人のObsidian Vaultでは、毎回守ってほしい決まりを.claude/rules/に4本置いています。

.claude/rules/
├── execution-discipline.md  実行の決まり
├── gotchas.md               教訓の書き方
├── memory.md                記憶の読み書き
└── vault-io.md              ファイルの読み書き

4本ともpathsなしなので、毎回の会話で読まれる決まり。
合わせて41行で、テーマごとに1枚ずつ分けています。

本体は.agents/rules/にあり、.claude/rules/は本体を指すリンク(シンボリックリンク)。

2. 自動メモリはオフ。記憶は自分のフォルダに

私は自動メモリをオフにして、記憶は自分で作ったフォルダに置いています。

ユーザー設定のautoMemoryEnabledをfalseにしているので、自動メモリは書かれません。

個人のObsidian Vaultの自動メモリのMEMORY.mdも、1行だけ。
「このプロジェクトの記憶は.agents/memories/に統合済み」とあります。

記憶の本体は、Obsidian Vaultの中の.agents/memories/です。
長期記憶のMEMORY.md、引き継ぎのHANDOFF.md、日ごとの記録が並びます。

自動メモリは、公式の説明でもそのパソコンの中だけのもの。
Obsidianの中に置くと、自分でも読み返せて、ほかのAIからも同じ記録を読めます。

自動メモリは、はじめからオンになっています。
まずはオンのまま使い、/memoryで何がたまるかを見てから決めましょう。

3. 手順は、作る役と点検する役のスキルに分ける

何段もある作業は、スキルにして、作る役と点検する役を分けています。

チームのObsidian VaultにあるSKILL.mdは、48本。
Claude Codeから使うものは、.claude/skills/にリンクを置いて18本。

例えばメールとブログ記事は、作る手順のスキルと、点検する手順のスキルが別々です。

記事を点検する役には「直さず差し戻すだけ」と決め、書いてよいファイルを点検の記録1つに絞っています。

私の会社では、AIが自分の作ったものを自分で点検して終わりにしない、と決めているからです。

4. 11回くり返したミスは、フックで止めた

手順書に何度書いても止まらなかったミスは、フックにして止めました。

個人のObsidian Vaultには、「Markdownは決まった道具で1ファイルずつ読む」という決まりがあります。

ところが、違う読み方がAIの自動実行で7回、合わせて11回くり返されたんです。

手順書の3か所に書いても、止まりませんでした。
そこでPreToolUseのフックを作り、違う読み方のコマンドを、動く前に止めるようにしています。

個人のObsidian Vaultの設定には、PreToolUseのフックが4つ。
文で頼んでも守られないことは、仕組みに移すのがいちばん確かです。

つまずきやすいところ

つまずきやすいのは、「書いたのに守らない」と「そもそも読まれていない」の2つ。

つまずいたら確かめる3つ。書いたファイルが読まれているかは/context all、自動メモリが何を覚えたかは/memory、ぶつかる指示や古い指示は/doctor prompt-audit

1. CLAUDE.mdに書いたのに、守ってくれない

守ってほしい度合いで、置き場所を変えるのが近道です。

オブ君
CLAUDE.mdに「毎回〜する」と書いたのに、ときどき守ってくれません…
飯塚
例外なく守らせたい決まりは、フックにしよう!CLAUDE.mdは、判断の材料だと思っておくといいよ。

公式にも、CLAUDE.mdは会話の材料として渡され、厳密に守られる保証はないとあります。
あいまいな指示や、ぶつかる指示ほど守られにくくなるんです。

2つの指示がぶつかると、Claudeはどちらかを勝手に選ぶことがあります。

/doctor prompt-auditと打てば、古い指示やぶつかる指示を探してくれます。
直す案まで出す機能で、使えるのはv2.1.283以降。

2. 書いたルールが、そもそも読まれていない

Claude Codeが自動で読むのは、.claude/rules/の.mdのファイルです。

オブ君
ルールのファイルを作ったのに、Claudeが知らないみたいです…
飯塚
まずは/context allで、読まれているかを確かめよう!.claude/rules/の中に、.mdのファイルで置けているかも見てね。

置き場所や拡張子が違うファイルは、自動では読まれません。
CLAUDE.mdに文で「〇〇を読んで」と書くだけだと、Claudeが自分で開いたときしか中身を見ないんです。

毎回読ませたいなら、@で読み込む形にします。
@で書いたファイルは、CLAUDE.mdと一緒に毎回読まれる仕組み。

pathsつきのルールや、サブフォルダのCLAUDE.mdは、会話の始めの一覧には出ません。
合うファイルを触ったときに読み込まれるので、一覧に無くても困らない場合があります。

3. 自動メモリが、何を覚えたか分からない

/memoryでフォルダを開けば、覚えた中身をそのまま読めます。

オブ君
Claudeが何を覚えたのか分からなくて、ちょっと不安です…
飯塚
/memoryでフォルダを開けば、全部読めるよ!要らないメモは、消してしまって大丈夫。

メモは普通のMarkdownで、読むのも直すのも消すのも自由です。

画面に「Saved 2 memories」と出たら、Claudeがメモを書いた合図。

MEMORY.mdが200行か25KBを超えると、超えた分は次の会話で読まれません。
長くなったら、1行1つに縮めるようClaudeに頼みましょう。

よくある質問

自動メモリは、チームや別のパソコンに共有されますか?

共有されません。自動メモリはそのパソコンの中だけにあり、別のパソコンやクラウドには渡らない仕組みです。

同じリポジトリ(Gitで管理するフォルダ)の中なら、サブフォルダでも1つのメモリを使います。
チームで同じ決まりを持ちたいなら、プロジェクトのCLAUDE.mdに書きましょう。

メモリが古くなったり、食い違ったりしたら?

ときどき見直して、古い指示やぶつかる指示を消すのが基本。
/doctor prompt-auditなら、探して直す案まで出してくれます。

自動メモリは、自分かClaudeが直すか消すまで残るファイル。
Claudeが書いた時刻はmodifiedの欄に入るので、古さの目安になります。

APIキーや顧客の情報を書いてもいいですか?

プロジェクトのCLAUDE.mdは、Git(変更を記録して共有する道具)などでチームに渡る前提のファイル。
人に渡したくない情報は、書かないようにしましょう。

自分だけの設定はCLAUDE.local.mdに分け、.gitignoreに足すよう公式も勧めています。
.envなどに触れさせたくないなら、フックで止める例が公式の案内にあります。

何をどこに書くかは、AIに何を判断させるか

何をどこに書くかは、AIに何を毎回判断させ、何を手順として任せるかを決めることです。

私は自分のObsidian Vaultで、判断を3つに分けて残しています。
迷って決めた記録の「判例」、迷ったときの比べ方の「判断軸」、迷わず守る線の「ルール」。

似た迷いが3回たまると判断軸に、同じ側に3回傾いたらルールに固めます。
決めて残すのは人で、AIは候補を並べるだけなんですね。

判断の育ち方とAIへの渡し方の図。人の正本はルール・判断軸・判例で、人が決めて残す。AIに実行させるルールだけをCLAUDE.mdや.claude/rules/へ一方向に写し、それでも破られる線だけをフックに上げる

  • 迷いの記録と比べ方(判例・判断軸):人の正本に残し、最後に決めるのは人
  • 固まったルール:AIに実行させるものだけを、CLAUDE.mdや.claude/rules/に写す
  • それでも破られる線:フックに上げ、AIの判断を待たずに止める

写す向きは、ルールから指示書への一方向。
指示書のほうが先に生まれることはありません。

例えば個人のCLAUDE.mdには、決まった場面の依頼でだけ、ルールの手引きを読ませる1行があります。

目印に触れていたら、実行の前に1行で伝えるだけ。
止めず、代わりに決めず、戻せない操作だけは返事を待ちます。

AIには写したルールを材料に毎回判断させ、何段もの手順はスキルに任せる。
守られない線だけを、フックの仕組みに上げています。

置き場所に迷ったら、「判断させたいのか、手順どおりに任せたいのか、確実に止めたいのか」と問いかけてみてください。

まとめ

以上、Claude Codeのメモリの使い分けを紹介しました!それでは、今回の内容をおさらいします。

まとめ
  • テーマごとの決まりは.claude/rules/、手順はスキル、確実に止める操作はフック
  • 自動メモリは、Claudeが自分で書く学びのメモ。/memoryで見直す
  • 毎回要る事実だけをCLAUDE.mdに残す
  • 同じ注意を2回したら、順に問いかけて置き場所を決める
  • 何をどこに書くかは、AIに何を判断させ、何を手順に任せるかを決めること

置き場所は、AIに任せる仕事の分け方で決まります。

まずは/memoryを開き、今のCLAUDE.mdと自動メモリの中身を見てみてください。

AIに任せる仕組みを作りたい方へ

何を判断させ、何を任せるかが決まったら、次はAIが読む中身をObsidianに育てる段階です。

情報の集め方からAIとの使い方まで、通して知りたい方に向けて無料の動画を用意しました。

無料プレゼント:10Xロードマップ

元医師の私が、20分の動画で次の5つを話しています。

  • 情報に溺れないための、情報処理のやり方
  • 自分の頭を鍛えながら、AIを使いこなす方法
  • 情報を思考に、思考を知的資産に変えるシステムの全体像
  • 自分らしさを入れて、量産型のAIコンテンツから抜け出す方法
  • 自分の右腕になるAIエージェントを育てる仕組み

10Xロードマップ(無料動画)

メールアドレスを登録すると、すぐに見られます。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
目次