CLAUDE.mdとは——Claude Codeが毎回読む「あなたの指示」と、Claudeが書く「メモ」の違い
「CLAUDE.mdって、設定ファイルですよね？」
Claude Codeを使い始めた方から、よくこう聞かれます。
半分は合っていて、半分は違います。
公式ドキュメントは、CLAUDE.mdをこう位置づけています。あなたが書く、毎セッション読まれる指示。そして同じページに、もう1つの仕組みが並んでいます。Claudeが自分で書くメモ（auto memory）です。
この記事では、CLAUDE.mdとは何か、という1つの問いに答えます。
出典はClaude Code公式ドキュメント「How Claude remembers your project」。2026年9月10日に本文を確認しました。定義、もう1つの仕組みとの違い、何を書くか、読まれたかの確かめ方まで、この順で置きます。
CLAUDE.mdとは——公式の定義は「あなたが書く、毎回読まれる指示」
公式の説明はこうです。
Claude Codeの各セッションは、まっさらな文脈から始まる。セッションをまたいで知識を運ぶ仕組みが2つあり、1つがCLAUDE.mdファイル＝Claudeに持続的な文脈を与えるために、あなたが書く指示。もう1つがauto memory＝あなたの訂正や好みをもとに、Claudeが自分で書くメモ。
つまりCLAUDE.mdとは、次のセッションでも同じことを言い直さなくて済むように、先に書いておく文章です。
ファイルの中身は普通のMarkdown。ビルドの手順、命名の決まり、フォルダの意味、「必ずこうする」の規則。公式が挙げている中身は、どれも「毎回説明していたこと」です。
CLAUDE.mdとauto memoryの違い——誰が書くか
ここが、この記事でいちばん伝えたいところ。
公式ページには、2つを並べた表があります。要点だけ抜き出すと、こうなります。
CLAUDE.mdは、あなたが書く。中身は指示と規則。範囲はプロジェクト・ユーザー・組織。
auto memoryは、Claudeが書く。中身は学びとパターン。範囲はリポジトリ単位。
どちらも毎セッションの最初に読み込まれます。ただしauto memoryは、索引ファイルの先頭200行または25KBまでが読まれる、と書かれています。
なぜ2つあるのか。
公式の説明では、CLAUDE.mdは「Claudeの振る舞いを導きたいとき」に使い、auto memoryは「手を動かさずに、あなたの訂正からClaudeが学ぶ」ためのもの。書く人が違うので、置く内容も違います。
「pnpmを使って、npmは使わないで」と会話で頼むと、公式の説明ではauto memoryに保存されます。CLAUDE.mdに入れたいなら「CLAUDE.mdに足して」と言うか、自分で編集する。この線引きを知らないと、「言ったのにCLAUDE.mdに無い」と混乱します。
CLAUDE.mdは「設定」ではない——守られないことがある理由
冒頭の「設定ファイルですよね」に戻ります。
公式は、はっきり書いています。Claudeは両方を文脈として扱い、強制される設定としては扱わない。何があっても止めたい操作は、CLAUDE.mdではなく別の仕組み（PreToolUse hook）で止める、と。
いや、書いたのに守られないって困るでしょ？
私もそう思っていました。でも個人的には、ここを「欠陥」と読むと使い方を間違えると思います。
公式のトラブルシューティングには、CLAUDE.mdの内容はシステムプロンプトの後に、ユーザーのメッセージとして渡されるとあります。Claudeはそれを読んで従おうとするが、曖昧な指示や矛盾する指示では厳密な遵守は保証されない。
だから、書き方が効きます。公式が挙げる例は具体的です。「コードをきれいに整える」ではなく「インデントは2スペース」。「変更をテストする」ではなく「コミット前に npm test を実行」。確かめられる粒度で書く。これが、CLAUDE.mdを「守られる文章」にする条件です。
うちでも、指示書に「送信前に確認」とだけ書いて素通りされた経験があります。直したのは文章の強さではなく、確認の手順と、止める側の仕組みでした。CLAUDE.mdは前者の置き場で、後者は別の場所。役割を混ぜないのが、公式の言う「文脈であって強制ではない」の実務的な読み方だと思います。
何を書くか——公式が挙げる「足すとき」の4つの合図
「何を書けばいいか分からない」という方へ。公式は、足すタイミングを4つ挙げています。
同じ間違いを2回目にしたとき。コードレビューで「このコードベースなら知っているべきこと」が指摘されたとき。前のセッションと同じ訂正をチャットに打ったとき。新しいチームメイトにも同じ前提が要るとき。
逆に、書かないものも決まっています。複数手順の手続きや、コードベースの一部にしか関係しないことは、skillsや、パスごとの規則ファイルへ移す。CLAUDE.mdに残すのは、毎セッション持っていてほしい事実だけ。
長さの目安は1ファイル200行未満。長いほど文脈を消費し、従われにくくなる、と書かれています。
置き場所と読まれる順——短く
置き場所は4種類。公式の表は、読み込まれる順に並んでいます。
組織全体の管理ポリシー、ユーザー用（~/.claude/CLAUDE.md）、プロジェクト用（./CLAUDE.md または ./.claude/CLAUDE.md）、ローカル用（./CLAUDE.local.md・gitignoreに入れる）。
作業フォルダとその上の階層にあるCLAUDE.mdは起動時に読まれ、上書きではなく連結されます。下の階層のファイルは、Claudeがそのフォルダのファイルを読んだときに読み込まれる。
別のファイルを取り込みたいときは @path/to/file の書き方。取り込みは最大4段まで。すでに AGENTS.md を使っているなら、@AGENTS.md と1行書いたCLAUDE.mdを置けば、両方の道具が同じ指示を読みます。
置き場所ごとの詳しい話は別の記事に書いたので、ここでは「連結される」「下の階層は後から読まれる」の2点だけ覚えてください。
読まれたかを確かめる——/context と /memory
書いたら、読まれたかを確かめます。ここを推測で済ませないでください。
公式の手順は、セッションで /context を実行し、Memory files の一覧に自分のCLAUDE.mdが載っているかを見る。載っていなければ、Claudeには見えていません。
/memory は、ユーザー用・プロジェクト用のCLAUDE.mdやauto memoryの場所を一覧にして、開いて編集できるコマンド。まだ存在しないファイルを選ぶと、その場で作られます。
最初の1枚を作るなら /init。Claudeがコードベースを読んで、ビルドやテストの手順を含んだ下書きを作ります。すでにCLAUDE.mdがあれば、上書きせず改善案を出す、とあります。
CLAUDE.mdとは何かを、一言で
あなたが書く、毎回読まれる指示。Claudeが自分で書くメモとは別物。設定ではなく文脈なので、確かめられる粒度で、200行未満で書く。読まれたかは /context で見る。
今日、5分でできること。
いま使っているプロジェクトで /context を打って、Memory filesに何が載っているかを見てください。何も載っていなければ /init。載っていれば、その中に「前のセッションでも同じ訂正をした1行」があるかを探す。無ければ、それが最初に足す1行です。
▶ 関連記事: CLAUDE.mdとskillsの違い——長い手順書を「いつ使うか」で分けてみる
▶ 関連記事: Claude Codeとは何か——ターミナルの道具だと思っていた人が読み直す5つの入口
Claude Codeを実務で使うための6大特典
導入時の考え方や日々の運用を整理したい方へ、Claude Code実務活用の6大特典をご案内しています。
