CLAUDE.md は「毎回読んでもらう置き手紙」
Claude Code を使っていると、こんな経験をしませんか。「このプロジェクトではセミコロンは付けない方針です」と伝えて直してもらう。翌日、新しいセッションを立ち上げてコードを書いてもらうと、また元通りセミコロンが付いている。
これは Claude Code が忘れっぽいというより、セッションが変わると前回の会話が引き継がれないからです。毎朝出勤してくる新しいアルバイトさんに、毎回同じ説明をしている状態に近い。
そこで役に立つのが CLAUDE.md です。プロジェクトの中に置いておく Markdown ファイルで、Claude Code はセッションを始めるときにこれを読み込みます。つまり、作業場の壁に貼ってある「作業マニュアル」のようなもの。新しいアルバイトさんも、出勤したらまず壁の紙を読むので、いちいち口で説明しなくてよくなるわけです。
何を書くのか
書く内容は「毎回言うのが面倒なこと」全部、と考えるとイメージしやすいと思います。ヒントとして挙がっている代表例は次のようなものです。
- コーディング規約(命名ルール、フォーマットの方針など)
- アーキテクチャに関する決定事項(なぜこの構成なのか、どこに何を置くのか)
- 「常に○○する」という運用ルール
たとえば「テストを追加したら必ず実行する」「新しい依存を勝手に追加しない」といった約束事です。口頭で言えば1回で済むけれど、セッションをまたぐと消えてしまう。だから書いておく。
内容は普通の Markdown なので、見出しと箇条書きで素直に書けば十分です。特別な記法を覚える必要はありません。
置き場所は1か所じゃない
CLAUDE.md はプロジェクトルートに置く ./CLAUDE.md が基本ですが、それ以外の場所にも置けます。よく使われるのが、ホームディレクトリ配下の ~/.claude/CLAUDE.md です。
この2つの違いは「誰のためのルールか」で分かれます。
| 置き場所 | 性格 |
|---|---|
./CLAUDE.md(プロジェクト内) | そのプロジェクト固有のルール |
~/.claude/CLAUDE.md(ホーム配下) | 自分がどのプロジェクトでも守ってほしい好み |
会社の就業規則(全社共通)と、部署ごとのローカルルール(その部署だけ)の関係に似ています。「日本語で説明してほしい」みたいな個人的な好みはホーム配下に、「このリポジトリでは package manager は npm を使う」みたいな話はプロジェクト内に。そう分けると、他の人とリポジトリを共有しても自分の好みを押し付けずに済みます。
複数ある場合はどうなる?
「両方に書いたらどっちが読まれるの?」というのは自然な疑問ですが、答えは「両方読まれる」です。複数のスコープに置かれた CLAUDE.md は、広いスコープから狭いスコープの順に連結されるという挙動になっています。
つまり片方が捨てられるのではなく、全部つながって Claude Code に渡る。就業規則を読んだ上で部署ルールも読む、という感覚ですね。後から読まれる狭いスコープの方が「そのプロジェクトの事情」を語っているので、実務上はそちらがより具体的な指示として効きやすくなります。
最初につまずきやすいところ
正直、最初は「とにかく全部書けばいい」と思って長大な CLAUDE.md を作りがちです。ただ、ここに書いた内容は毎回読み込まれるものなので、あれもこれもと詰め込むと、本当に守ってほしいルールが埋もれます。
おすすめは、小さく始めて育てること。作業中に「あ、また同じ説明をしている」と気づいたら、その1行を CLAUDE.md に追記する。この繰り返しで、自分のプロジェクトに合ったマニュアルが自然に出来上がっていきます。
もうひとつ。CLAUDE.md は「メモ帳」ではなく「指示書」です。日記や進捗ログを書く場所ではなく、Claude Code に守ってほしいことを書く場所、と割り切った方が効果を実感しやすいはずです。
より詳しい仕様は公式ドキュメント(https://code.claude.com/docs/ja/memory)に整理されているので、慣れてきたら一度目を通してみてください。
このページは役に立ちましたか？