Claude Codeを使っていると、毎回同じことを打っていませんか。「日本語で答えて」「結論から言って」「勝手に大きく変更しないで」——。この”毎回の指示”を一度書いて置いておけば、AIが起動時に自動で読んでくれる。それがCLAUDE.mdです。
1. 結論:CLAUDE.mdは「置いておく設定用プロンプト」
CLAUDE.mdを一言でいうと、毎回打たなくて済むように、AIへあらかじめ渡しておく「設定用のプロンプト」です。Claude Codeは起動するたびに、このファイルを自動で読み込んでから動き出します。つまり、毎回手で打っていた前提を、ファイルに書いて置いておくだけ。
この記事で押さえるのは、次の4つです。
- 置き場所は2種類ある(全プロジェクト共通の「ジェネラル」と、プロジェクトごと)
- 階層で重ねて読み込まれる(上が土台、下ほど具体的)
/contextで、今どれが読み込まれているか確認できる- 中身は「設定用プロンプト」。まず置くとよい最小の内容も紹介します
2. 理由:同じ指示を毎回打つのは、もったいない
AIは賢いですが、何も言わなければ毎回まっさらな状態から始まります。あなたの「日本語で」「結論から」「仮想環境の中で作業して」といった約束事は、伝えなければ毎回ゼロです。だから毎回打つことになる。これは地味に手間ですし、打ち忘れると思わぬ動きをされます。
CLAUDE.mdは、その約束事を一度だけ書いて、ファイルとして外に置いておく仕組みです。頭の中や毎回のチャットに留めるのではなく、文章にして残す。こうしておけば、次のセッションでも、別の日でも、AIは同じ前提から動き出します。「毎回言わなくても分かってくれる」状態を作る、それがCLAUDE.mdの役割です。
3. 具体例:置き場所・読み込み・中身
置き場所は2種類(ジェネラルとプロジェクトごと)
CLAUDE.mdは、置く場所によって「効く範囲」が変わります。大きく2つです。
- ジェネラル(全プロジェクト共通):ホームフォルダの中の
.claudeフォルダに置きます(~/.claude/、WindowsならC:\Users\ユーザー名\.claude\)。ここに置いた内容は、どのプロジェクトで作業しても毎回読み込まれます。「日本語で」「結論から」のような、いつでも守ってほしい約束事はここへ。 - プロジェクトごと:そのプロジェクトのフォルダの直下に
CLAUDE.mdを置きます(./CLAUDE.md)。そのプロジェクト特有のルール(使っている技術、フォルダ構成、このプロジェクトだけの約束事)はここへ。
使い分けはシンプルです。「いつも守ってほしいこと」はジェネラル、「このプロジェクトだけのこと」はプロジェクトごと。迷ったら、まずジェネラルに最小限を置くところから始めれば十分です。
階層で重ねて読み込まれる
この2種類は、どちらか一方ではなく重ねて読まれます。イメージは、土台の上に積み木を重ねる感じです。
- まずジェネラル(全体の土台)が読まれる
- 次にプロジェクトごと(そのプロジェクトの上乗せ)が読まれる
- さらにサブフォルダにも置けて、そのフォルダで作業しているときだけ読まれる
上ほど広く効く土台、下ほど具体的、という関係です。もし上と下で内容がぶつかったときは、より具体的な(下の)指示が優先されると考えておけば大丈夫です。ただし、わざと矛盾させるより、矛盾しないように書くのが基本です。順番で勝たせるより、はっきりしたルールを書くほうが安全に効きます。
/context で「今、何が読み込まれているか」を確認する
「ちゃんと読み込まれているのかな?」と不安になったら、Claude Codeで/contextと打ちます。すると、今のセッションで何がどれだけコンテキスト(AIが一度に見ている内容)を占めているかが、種類別に表示されます。その中のMemory filesが、読み込まれているCLAUDE.mdです。画像の下のファイルになります。

この画面で、置いたはずのファイルが一覧に出ていれば、ちゃんと効いている証拠です。逆に、ルールを書いたのにAIが従わないときは、ここを見て「そもそも読み込まれているか」を確認できます。「効かないな」と思ったら、まず/context——これを覚えておくと安心です。
CLAUDE.mdは毎回読み込まれるため、長く書くほどコンテキストを圧迫します(/contextの画面で、Memory filesが何トークン使っているか見えます)。あれもこれもと盛らず、本当に毎回守ってほしいことだけを、簡潔に。これが長く使うコツです。
中身は「設定用プロンプト」──まず置くとよい最小版
では、何を書けばいいのか。難しく考える必要はありません。毎回チャットで打っていた指示を、そのまま箇条書きにするだけです。最初の一歩として、ジェネラル(~/.claude/)に置くとよい最小限の内容を挙げます。これをコピーして、自分用に足し引きしてください。
# 基本ルール
- 必ず日本語で対応する。
- まず結論、その後に理由や手順を簡潔に述べる。
- 分からないことは推測で埋めず、「分からない」と明示する。
- いきなり大きく変更せず、まず最小限の変更で進める。
- Python は仮想環境(.venv)の中で実行する。グローバルに入れない。
- 削除・上書き・外部API・課金が発生する操作は、実行前に必ず確認する。たったこれだけでも、毎回の指示の大半が要らなくなります。最初から完璧を目指さず、まずこの6行から。使っていて「これも毎回言ってるな」と気づいたら、その都度1行ずつ足していく。それがCLAUDE.mdの育て方です。
砂糖さん育てていくって言ってもプロンプト作るの大変だよ



きっかけがあったとき、Claude Codeにプロンプトを追加してほしいと依頼すると良いですよ。トラブルの再発防止、忘れてはいけない重要な作業をCLAUDE.mdに書いてほしいというと助けてくれます。
4. まとめ:小さく置いて、育てていく
CLAUDE.mdは、AIに毎回同じ説明をする手間をなくす「置いておく設定用プロンプト」でした。要点はこれだけです。
- いつも守ってほしいことはジェネラル(
~/.claude/)、プロジェクト固有のことはプロジェクトごと(./CLAUDE.md) - これらは重ねて読まれる。読み込み状況は
/contextで確認できる - 中身は毎回の指示を箇条書きにするだけ。まずは最小の6行から
使い込むと、このファイルはどんどん育ちます。たとえば本格的に運用すると、「危険な操作は必ず止めて確認する」「変更したらドキュメントも更新する」「大量実行の前に少数で試す」「テストはこう書く」といった章立てまで育てられます。ただ、最初からそこを目指す必要はありません。まずは6行置いて、毎回の手間が一つ減る感覚を味わってみてください。育てるのは、それからで十分です。




コメント