CLAUDE.mdとは？書き方と置き場所を徹底解説！効かないときの直し方も紹介

Claude Codeを使っていると、「このプロジェクトではこう書いて」と毎回同じ説明を繰り返している自分に気づきます。それを解決するのがCLAUDE.mdですが、調べると置き場所の説明も行数の目安も記事ごとにばらばらで、どれが正しいのか分からなくなっていないでしょうか。答えはすべて公式ドキュメントに揃っています。

この記事では、CLAUDE.mdの役割と置き場所・書き方のコツ・効かないときの確認方法までを公式仕様に沿って解説します。読み終えるころには、AIが毎回ルールを守ってくれる1枚を自分で作れるはずです。結論から言うと、置き場所はプロジェクト直下の1枚から、分量は200行未満を目標にするのが公式の推奨です。

CLAUDE.mdとは【Claude Codeが毎回読む指示書】

まず役割を以下の3つで押さえます。

• 作業開始のたびに自動で読み込まれる申し送りファイル
• 強制の設定ではなく「お願い」として働く
• 最初の1枚は/initコマンドで自動生成できる

作業開始のたびに自動で読み込まれる申し送りファイル

CLAUDE.mdは、Claude Codeがセッションの開始時に自動で読み込むMarkdownファイルです。プロジェクトのルール・フォルダ構成・よく使うコマンド・注意点を書いておくと、AIは毎回CLAUDE.mdを前提に作業を始めます。

毎回の指示で繰り返し説明していた内容を、1枚の文書に固定するのが役割です。書く内容はプログラムの話に限らず、「報告書はこの形式で」「ファイル名はこの規則で」のような業務ルールでも機能します。

強制の設定ではなく「お願い」として働く

理解しておきたいのが、CLAUDE.mdの効き方です。公式ドキュメントによると、内容は会話の文脈として渡されるもので、設定のように動作を強制する仕組みではありません。長すぎたり曖昧だったりすると、守られない指示も出てきます。

絶対に守らせたい禁止事項は、強制力のあるフックや権限設定の担当です。CLAUDE.mdは「習慣を伝える文書」、設定は「破れないルール」という役割分担で考えると、書く内容に迷いません。

最初の1枚は/initコマンドで自動生成できる

ゼロから書く必要はありません。Claude Codeのセッションで/initコマンドを実行すると、プロジェクトを分析したたたき台のCLAUDE.mdが生成されます。すでにファイルがある場合は、上書きせず改善の提案をくれる動作です。

生成された内容はあくまで下書きです。自分たちの実態に合わせて手直しし、使いながら育てる前提で始めてください。

CLAUDE.mdの置き場所と種類【まずはプロジェクト直下】

置き場所の疑問は以下の3つで解消します。

• 置き場所は4種類あり用途で分かれる
• 複数あるときは上書きではなく連結される
• まずはプロジェクト直下の1枚で十分になる

置き場所は4種類あり用途で分かれる

公式ドキュメントが定める置き場所を整理します。

基本になるのはプロジェクト直下の1枚です。CLAUDE.local.mdを使う場合は、共有リポジトリに入らないよう自分で除外設定(.gitignore)に追加する決まりになっています。

複数あるときは上書きではなく連結される

複数の場所にCLAUDE.mdがあるとき、どれかが勝つのではありません。公式仕様では、広い範囲のファイルから順にすべて連結して読み込まれます。組織→ユーザー→プロジェクトの順で、全部がAIに渡る形です。

プロジェクトの下の階層(サブフォルダ)に置いたCLAUDE.mdだけは扱いが違い、AIがそのフォルダのファイルに触れたときに読み込まれます。「優先順位で上書きされる」と説明する解説がありますが、公式仕様は連結です。

まずはプロジェクト直下の1枚で十分になる

種類が多くて迷いますが、始め方はシンプルです。プロジェクト直下にCLAUDE.mdを1枚置き、チームのリポジトリにコミットする。これだけで大半の用途は足ります。

全プロジェクトに効かせたい自分の好みが出てきたらユーザー用を、会社として統一したい方針が出てきたら組織配布を、と必要になってから増やせば十分です。置き場所の設計に時間をかけるより、中身を育てる方に時間を使ってください。

CLAUDE.mdの書き方【200行未満を目標に】

書き方の核心は以下の3つです。

• 分量は1ファイル200行未満を目標にする
• 書く内容は「消したらミスするか」で選ぶ
• 書くべきことと書かないことを対比で覚える

分量は1ファイル200行未満を目標にする

公式ドキュメントは、1ファイル200行未満を目標にするよう案内しています。理由は、長くなるほど個々の指示が守られにくくなるためです。詰め込むほど効く、の逆が起こります。

なお「200行を超えると切り捨てられる」と書く解説がありますが、誤りです。CLAUDE.mdは長くても全文が読み込まれます。200行はあくまで、守られやすさのための目標値です。

書く内容は「消したらミスするか」で選ぶ

何を書くかの判断基準として、公式は「この行を消したらClaudeはミスをするか」という問いを勧めています。答えがノーなら、その行は削る対象です。

とくに重要な指示は、IMPORTANTのような強調を付けると守られやすくなると公式に案内されています。日本語で書いて問題ありません。定期的な見直しには、削れる行のトリム提案をくれる/doctorコマンドが便利です。

書くべきことと書かないことを対比で覚える

公式の推奨を対比で整理します。

もう1つ、公式ブログが明記する禁止事項が、APIキーやパスワードなどの機密情報を書かないことです。CLAUDE.mdは共有される文書であり、秘密の置き場ではありません。

書いたのに効かないときの確認方法

「無視される」と感じたら、以下の3手順で切り分けます。

• /contextで読み込まれているかを確かめる
• 従わない指示は短く具体的に書き直す
• 確実に守らせたい事項はフックや設定に移す

/contextで読み込まれているかを確かめる

最初の切り分けは、そもそも読み込まれているかの確認です。セッションで/contextコマンドを実行すると、読み込まれているメモリファイルの一覧を確かめられます。

一覧にない場合は、ファイル名や置き場所の間違いが原因です。よくあるのは、サブフォルダに置いたCLAUDE.mdが「そのフォルダに触れるまで読み込まれない」仕様を、無視されたと誤解するケースです。

従わない指示は短く具体的に書き直す

読み込まれているのに守られない場合は、書き方の問題を疑います。長い文書の中の曖昧な一文は、最も無視されやすい形です。

対処は削ることと具体化することです。関係の薄い行を削って全体を短くし、守らせたい指示は「関数名はキャメルケースで」のように具体例つきで1行にします。矛盾する指示が2箇所にあると迷いのもとになるため、重複も掃除してください。

確実に守らせたい事項はフックや設定に移す

書き直しても破られる指示は、CLAUDE.mdの限界を超えています。「本番ブランチに直接コミットしない」のような絶対のルールは、操作を機械的に止めるフック(hooks)や権限設定の担当です。

お願いの文書と、破れない仕組みの2階建てで考えるのが公式の設計思想です。CLAUDE.mdだけで統制しようとしないことが、結果的にCLAUDE.mdを効かせるコツになります。

一歩進んだ使い方【インポート・自動メモリ・AGENTS.md】

慣れてきたら、以下の3つを押さえると運用が楽になります。

• @インポートでファイルを分割して整理できる
• 自動メモリはClaudeが自分で書く別のメモになる
• AGENTS.mdとはインポートやリンクで共存できる

@インポートでファイルを分割して整理できる

CLAUDE.mdの中に@ファイルパスと書くと、別ファイルの内容を取り込めます。ルールが増えてきたら、テーマ別のファイルに分割して、CLAUDE.mdからインポートする整理が可能です。

取り込みは最大4段階まで連鎖でき、コードブロックの中に書いた@は無視されます。注意点として、インポートした内容も開始時に全部読み込まれます。分割は整理のためであって、読み込み量の節約にはなりません。

自動メモリはClaudeが自分で書く別のメモになる

CLAUDE.mdと混同しやすいのが自動メモリです。こちらはClaude Codeが作業から学んだこと(ビルドの手順やつまずきの記録)を自分で書き溜める仕組みで、人が書くCLAUDE.mdとは別の場所に保存されます。

自動メモリは既定でオンになっており、/memoryコマンドで内容の確認や停止ができます。「自分が教えるルールはCLAUDE.md、AIが学んだ記録は自動メモリ」という分担です。

AGENTS.mdとはインポートやリンクで共存できる

他のAIツールで使われる指示書ファイルにAGENTS.mdがあります。公式ドキュメントによると、Claude CodeはAGENTS.mdを直接読みません。共存させたい場合は、@AGENTS.mdと1行書いたCLAUDE.mdを置くか、リンク(シンボリックリンク)でつなぐのが公式の案内です。

他ツールの設定をまとめて取り込む/importコマンドも用意されています。AGENTS.md側の書き方は次の記事で解説しています。

AGENTS.mdとは？Codexでの書き方や置き場所・優先順位までわかりやすく解説

CLAUDE.mdに関するよくある質問

迷いやすい点へ、3つ回答します。

• Gitで共有すべきですか？
• 200行を超えたら読み込まれなくなりますか？
• 非エンジニアの業務でも使えますか？

Gitで共有すべきですか？

プロジェクト直下のCLAUDE.mdは、リポジトリにコミットしてチームで共有するのが公式の推奨です。全員のAIが同じルールで動くため、成果物のばらつきが減ります。

自分だけのメモはCLAUDE.local.mdに分け、除外設定に追加して手元に留めます。共有する1枚と個人の1枚、の2枚持ちが実務の形です。

200行を超えたら読み込まれなくなりますか？

読み込まれます。CLAUDE.mdは長さにかかわらず全文が読み込まれ、切り捨ては発生しません。200行未満はあくまで「守られやすさ」のための公式の目標値です。

切り捨ての仕様があるのは、別物の自動メモリの側です。この2つの混同から生まれた誤解が、解説記事の間に広がっています。

非エンジニアの業務でも使えますか？

使えます。CLAUDE.mdの中身は日本語の箇条書きで書けるため、プログラミングの知識は不要です。報告書の形式・ファイル名の規則・使ってよい資料の場所のような業務マニュアルを書けば、資料整理やデータ集計の作業でもAIがルールを守ります。

非エンジニアの活用の全体像は、次の記事で解説しています。

Claude Codeは非エンジニアでも使える？初心者の始め方と活用例も紹介

CLAUDE.mdは200行未満の1枚から書き始めましょう

CLAUDE.mdは、Claude Codeが毎回の作業前に読む指示書で、置き場所はプロジェクト直下の1枚から始めれば十分です。書き方の要点は、200行未満を目標に、「消したらミスするか」の基準で絞り込むことに尽きます。

効かないと感じたら、/contextでの読み込み確認・短く具体的への書き直し・絶対ルールのフックへの移動の順で直せます。まずは/initでたたき台を作り、毎回説明していたことを3行書き足すところから育てていきましょう。