CLAUDE.mdの書き方とは？置き場所・読み込まれる順番・書く内容と200行の目安、/initでの作り方を解説【2026年11月】
CLAUDE.mdとは、Claude Codeが作業を始めるたびに読み込む「決まりごと」のファイルで、その書き方しだいでAIの動き方が安定します。
Claude Codeは、会話が変わると前の会話の内容を覚えていません。毎回同じ説明をしているなら、それをCLAUDE.mdに書いておくと、説明を省けます。
本記事では、CLAUDE.mdの置き場所、読み込まれる順番、書く内容、長さの目安を整理します。公式ドキュメント（2026年11月12日時点）をもとに、株式会社Pdienが日々の業務で使っている立場からお伝えします。
- CLAUDE.mdは、毎回の作業の最初に読まれる決まりごとのファイルです
- 置き場所は、個人用・プロジェクト用・組織用などに分かれています
- 1ファイル200行未満を目安に、具体的で確かめられる書き方にします
この記事の結論
- CLAUDE.mdは、作業のたびに読み込まれる「決まりごと」のファイルです。
- 置き場所で、自分だけか、チームで共有するかが決まります。
- 書き方の基本は、具体的に・見出しと箇条書きで・200行未満です。
- 手順はスキル、確実に止めたい操作はフックに分けます。
▲ CLAUDE.mdは、毎回読まれる決まりごとを書くファイルです
「自社の決まりごとをAIにどう伝えればよいか」といったご相談を承っています。AI内製化（自社でAIを使いこなす体制づくり）のご相談はこちらからどうぞ。
CLAUDE.mdとは？何のためのファイル？
CLAUDE.mdとは、Claude Codeに毎回伝えたい指示を書いておく、Markdown形式のファイルです。
公式ドキュメントでは、Claude Code メモリ（会話をまたいで指示を引き継ぐ仕組み）のひとつとして説明されています。
Claude Codeは会話ごとに、まっさらな状態から始まります。CLAUDE.mdがあると、会話の最初にその内容が読み込まれます。
たとえば、次のような内容を書きます。
- よく使うコマンド（動かし方・確かめ方）
- 書き方の決まり（命名やフォルダの分け方）
- 「いつもこうする」という約束ごと
▲ 毎回同じ説明をしているなら、CLAUDE.mdに書く合図です
出典: How Claude remembers your project（Claude Code Docs）（2026年11月12日時点）
Claude Code自体の始め方は、Claude Codeとは？できること・始め方にまとめています。
CLAUDE.mdの置き場所はどこ？
CLAUDE.mdは、置く場所によって効く範囲が変わります。公式ドキュメントでは、次の4種類が挙げられています。
| 種類 | 置き場所（公式表記） | 効く範囲 |
|---|---|---|
| 組織 | macOS: /Library/Application Support/ClaudeCode/CLAUDE.md | 組織のすべての利用者 |
| 個人 | ~/.claude/CLAUDE.md | 自分のすべてのプロジェクト |
| プロジェクト | ./CLAUDE.md または ./.claude/CLAUDE.md | チーム（git で共有） |
| ローカル | ./CLAUDE.local.md | 自分だけ・そのプロジェクトだけ |
▲ 共有したいか、自分だけかで置き場所を選びます
組織用の置き場所は、Linux・WSL では /etc/claude-code/CLAUDE.md です。Windows では C:\Program Files\ClaudeCode\CLAUDE.md です。
CLAUDE.local.md は、自分だけの設定を書くファイルです。公式ドキュメントでは、.gitignore に入れて共有しないように案内されています。
チームで同じ決まりを使うならプロジェクト用、自分の好みは個人用かローカル用に書くと、混ざりません。
CLAUDE.mdはどの順番で読み込まれる？
CLAUDE.mdは、上書きではなく「つなげて」読み込まれます。作業を始めたフォルダと、その上にあるフォルダのCLAUDE.mdが、すべて読まれます。
順番は、上の階層から作業中のフォルダへ向かってです。同じフォルダでは、CLAUDE.local.md が CLAUDE.md の後に足されます。
▲ どれかが他を消すのではなく、全部がつながって読まれます
- 起動時：作業中のフォルダと、その上の階層を読む
- 下のフォルダ：中のファイルを触ったときに読む
- 矛盾がある場合：どちらかが選ばれるおそれがある
公式ドキュメントでは、指示どうしが矛盾すると、Claudeがどちらかを任意に選ぶことがあると書かれています。定期的に見直して、古い指示を消しておくことがすすめられています。
CLAUDE.mdには何を書く？
CLAUDE.mdに書くのは、毎回の作業で知っておいてほしい事実と決まりです。公式ドキュメントは、コマンド・決まりごと・フォルダの構成・「いつもこうする」というルールを例に挙げています。
▲ 毎回必要なことだけを書き、それ以外は別に分けます
| 書く | 別に分ける |
|---|---|
| よく使うコマンド | 何段階もある作業の手順（スキルへ） |
| 書き方・命名の決まり | 一部のファイルだけの決まり（ルールへ） |
| フォルダの構成 | 確実に止めたい操作（フックへ） |
| 「いつもこうする」約束 | 長い参考資料 |
何段階もある手順や、一部のファイルにしか関係しない内容は、別の仕組みに移すよう案内されています。手順をまとめる仕組みは、Claude Codeのスキル（Skills）とは？で解説しています。
CLAUDE.mdの上手な書き方は？
CLAUDE.mdの書き方のコツは、具体的に、短く、整理して書くことです。公式ドキュメントは、1ファイル200行未満を目安にしています。
長いファイルは読み込む量が増え、指示が守られにくくなると説明されています。
▲ 確かめられる言い方で書くと、指示が伝わりやすくなります
- 具体的に書く：「きれいに整える」ではなく「インデントは2スペース」
- 見出しと箇条書きで、まとまりごとに分ける
- 1ファイル200行未満を目安にする
- 矛盾する指示を残さない（定期的に見直す）
公式ドキュメントでは、良い例として「Use 2-space indentation」が挙げられています。だれが見ても守れたか判断できる書き方が、伝わりやすい書き方です。
CLAUDE.mdにパスワードやAPIキーなどの秘密の情報は書かないようにします。プロジェクト用のファイルは、チームで共有されることがあります。
CLAUDE.mdの書き方や、AI社員（AIエージェント）に任せる業務の決まりづくりを、自社の状況に合わせてご相談いただけます。
CLAUDE.mdは/initで作れる？
/init で、最初のCLAUDE.mdを自動で作れます。Claude Codeが中のファイルを調べ、コマンドや決まりごとを書き出します。
すでにCLAUDE.mdがあるときは、上書きせずに改善案を出すと説明されています。
中身を調べて、最初のCLAUDE.mdを作る
違う内容や足りない決まりを直す
同じ指摘を2回したら書き足す
▲ 自動で作った後に、自社の決まりを書き足します
書いたCLAUDE.mdは、/memory で一覧を確かめて開けます。/memory は、読み込まれているCLAUDE.mdなどの置き場所を一覧にするコマンドです。
長くなったCLAUDE.mdはどう分ける？
長くなったCLAUDE.mdは、別ファイルの読み込みか、.claude/rules/ のフォルダに分けられます。どちらも公式ドキュメントで紹介されている方法です。
▲ 分けても、読み込まれる量が減るとは限らない点に注意します
| 方法 | 書き方 | 読み込まれるとき |
|---|---|---|
| 別ファイルの読み込み | @path/to/import | CLAUDE.mdと一緒に読む |
| ルールのフォルダ | .claude/rules/ に .md を置く | 起動時（paths 指定なし） |
| 対象を絞ったルール | 先頭に paths を書く | 対象のファイルを触ったとき |
@ で読み込んだファイルは、CLAUDE.mdと一緒に読まれます。そのため、分けても読み込む量は減らないと説明されています。読み込みは、最大4段階までたどれます。
読み込む量を減らしたいときは、paths で対象を絞ったルールが向いています。対象のファイルを触ったときだけ読まれます。
CLAUDE.mdで止めきれないことはある？
CLAUDE.mdは、守ってほしい内容を伝えるものです。公式ドキュメントでは、強制する設定ではなく「文脈（context）」として扱われると書かれています。
どうしても止めたい操作は、フック（PreToolUse フック）を使うよう案内されています。
▲ 「伝える」はCLAUDE.md、「確実に止める」はフックに分けます
- CLAUDE.md：守ってほしい決まりを伝える
- スキル：手順を、使うときだけ読み込む
- フック：決まった操作を、確実に止める・確実に動かす
ほかのAIツールで使う AGENTS.md も、CLAUDE.mdから @AGENTS.md と書けば読み込めると紹介されています。Codexでの AGENTS.md の扱いは、Codexの初期設定とは？で触れています。
当社でも、部署ごとにCLAUDE.mdを置き、守る決まりと作業の入口を書いています。手順はスキルに、確実に止めたい操作はフックに分けて運用しています。
よくある質問（FAQ）
Q. CLAUDE.mdとは何ですか？
Claude Codeが作業を始めるたびに読み込む、決まりごとのファイルです。毎回伝えたいコマンドや決まりを書いておくと、説明を省けます。
Q. CLAUDE.mdはどこに置けばよいですか？
チームで共有するならプロジェクトの ./CLAUDE.md、自分のすべてのプロジェクトで使うなら ~/.claude/CLAUDE.md に置きます。
Q. CLAUDE.mdは何行くらいまで書けますか？
公式ドキュメントでは、1ファイル200行未満が目安です。長いほど読み込む量が増え、指示が守られにくくなると説明されています。
Q. CLAUDE.local.mdは何に使いますか？
自分だけ・そのプロジェクトだけの設定を書くファイルです。.gitignore に入れて、共有しないように案内されています。
Q. CLAUDE.mdは自動で作れますか？
/init を実行すると、中のファイルを調べて最初のCLAUDE.mdを作ります。すでにある場合は、改善案を出します。
Q. CLAUDE.mdに書いたことは、いつも守られますか？
守られない場合もあります。CLAUDE.mdは文脈として扱われます。確実に止めたい操作は、フックで設定するよう案内されています。
Q. CLAUDE.mdとスキルはどう使い分けますか？
毎回必要な事実や決まりはCLAUDE.md、何段階もある手順はスキルに書きます。スキルは使うときだけ中身が読み込まれます。
まとめ
CLAUDE.mdは、Claude Codeが毎回読む決まりごとのファイルです。書き方の基本は、置き場所を選び、具体的に、200行未満で書くことです。
▲ 毎回の決まりはCLAUDE.md、それ以外は別の仕組みに分けます
- 置く：共有するならプロジェクト用、自分だけなら個人用
- 書く：具体的で、確かめられる言い方にする
- 保つ：200行未満を目安に、古い指示を消す
- 分ける：手順はスキル、確実に止める操作はフック
▲ 書く前に、この3つを確かめると迷いません
▲ 作って終わりではなく、使いながら直していきます
Claude Codeの料金プランは、Claude Codeの料金はいくら？で解説しています。
株式会社Pdienは、愛知県岡崎市の会社です。AIエージェントを使ったAI内製化の支援や、SNS運用の自動化を行っています。ご相談はお問い合わせフォームから受け付けています。
CLAUDE.mdの書き方から、AI社員（AIエージェント）の導入、会社での使い方のルールづくりまで、自社に合わせた進め方をご相談いただけます。
