CLAUDE.md とは何か、プロンプトとの違いを知る
ここまでの記事で、何度も出てきた CLAUDE.md。いったい、どんなファイルなのでしょうか。置き場所、読まれるタイミング、その場で頼むプロンプトとの違いをまとめ、中身の見本まで見せます。
CLAUDE.md はただの文章のファイル
CLAUDE.md は、特別なプログラムではありません。中身は、決まりごとや方針を書いた文章です。書き方は Markdown（マークダウン）という形式。簡単な記号で見出しや箇条書きを表して、整理します。
基本の置き場所は、Claude Code に作業させるフォルダです。ファイル名は、大文字で「CLAUDE.md」。部門のフォルダに置けば、その部門の規程になります。
チャットを始めるたびに読まれる
Claude Code はチャットを始めるたびに、フォルダにある CLAUDE.md を読み込みます。
CLAUDE.md に書いたことを毎回読んでから、仕事を始めてくれるわけです。
読まれる範囲には、上のフォルダと下のフォルダで違いがあります。詳しくは、こちらの記事で解説しています。
関連記事：Claude Code では方針と指示が上から下に流れる
プロンプトとの違い
チャットの入力欄に書いて送る頼みごとを、プロンプトといいます。プロンプトは、その会話の中だけのもの。
チャットの記録は残りますが、そこで伝えた指示は、新しいチャットには持ち越されません。新しいチャットを開けば、また一から伝え直すことになります。
一方、CLAUDE.md は毎回読まれます。一度だけ頼みたいことはプロンプトで、ずっと守ってほしい決まりは CLAUDE.md に。この使い分けが基本です。
同じチャットの中でも、会話が長くなると、初めのほうの細かい指示が抜けていくことがあります。詳しくは、こちらの記事で解説しています。
関連記事：チャット AI と Claude Code は何が違うのか
見本 ゲーム事業部の CLAUDE.md
部長との相談で決まったことは、部門の CLAUDE.md に残しておきます。
最初の相談の記事では、私がゲーム事業部の部長に、やりたいことを伝えた例を紹介しました。その相談を CLAUDE.md にまとめた形を、ストーリー仕立ての見本で見てみましょう（形は簡略にしています）。
ゲーム事業部の CLAUDE.md（見本）
【この事業部の役割】
・ゲームを作って公開する事業部【目指すところ】
・ゆくゆくは、スマホのアプリストアでゲームを販売する
・まずはブラウザで遊べる無料のゲームを作り、お客さんの反応を見ながら、ノウハウを貯める【決まったこと】
・最初の1本は、ブラウザで遊べるゲームにする
・無料のゲームは、広告で収益化する
・事業部の中を、ゲーム開発部、サイト運用部、SNS 広報部の3つの部に分ける【この事業部のルール】
・ゲームに関係のない話はしない
・分からないことは、推測で補わずに聞く
・決まったことは、ここに書き足す
役割、目指すところ、決まったこと、ルール。部長と話し合った中身が、この見本では部門の規程になっています。次のチャットでも、部長はこれを読んでから相談に乗ってくれます。
関連記事：最初は社長の考えを部長に相談する事から
CLAUDE.md に書くのは方針
CLAUDE.md に書くのは、部門の方針です。部門の規程、つまり社長が部長に渡す方針書のようなもの。その中のルールは、具体的に書きます。
一方、何段階もある作業の手順は、別のファイルに分けておけます。公式には、必要なときだけ読み込まれる「スキル」という手順書の仕組みがあります。
CLAUDE.md は、必ず守らせる命令ではありません。Claude Code が仕事の前に読む、前提の情報として扱われます。そのため、書き方しだいで守られやすさが変わります。
特に気をつけたいのが長さ。CLAUDE.md が長くなるほど、書いたことが守られず、抜け落ちやすくなります。方針は短くまとめ、手順は分けておくのがコツです。
分け方と、手順書（スキル）の仕組みは、それぞれこちらの記事で解説しています。
関連記事：スキルとは何か、CLAUDE.md との違いを知る
