AIツール活用

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

中島大介(なかじ)読了時間 約18分
CLAUDE.mdの書き方のアイキャッチバナー

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

本記事では、CLAUDE.mdの役割と置き場所・書き方のコツ・効かないときの確認方法までを公式仕様に沿って解説します。

この記事を読めば、AIが毎回ルールを守ってくれる指示書を自分で1枚作れます。結論から言うと、CLAUDE.mdの置き場所はプロジェクト直下の1枚から始め、分量は200行未満を目標にするのが公式ドキュメントの推奨です。

目次

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

CLAUDE.mdは、Claude Codeが毎回の作業前に読む指示書です。読み込まれるタイミングと効き方、たたき台の作り方を先に知っておくと、何をファイルに書き、何を設定に任せるかを分けて考えられます。CLAUDE.mdの基本は、以下の3つで押さえられます。

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

作業開始のたびに申し送りとして自動で読み込まれる

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

CLAUDE.mdの役割は、毎回の指示で繰り返し説明していた内容を1枚の文書に固定することです。書く内容は、プログラムの話に限りません。「報告書はこの形式で」「ファイル名はこの規則で」のような業務ルールでも機能します。読み込みの仕様は、Claude Codeの公式ドキュメントに掲載されています。

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

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

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

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

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

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

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

CLAUDE.mdは複数の場所に置けて、置き場所ごとに用途が分かれます。種類の違いと、複数あるときの読み込まれ方を知っておくと、どこに置けばよいかで迷いません。CLAUDE.mdの置き場所で押さえたい点は、以下の3つです。

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

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

Claude Codeの公式ドキュメントが定めるCLAUDE.mdの置き場所と用途は、以下の表のとおりです。

種類場所用途
プロジェクトプロジェクト直下のCLAUDE.md(または.claude/CLAUDE.md)チームで共有するルール(Git管理)
ローカル同じ場所のCLAUDE.local.md自分だけの個人メモ(共有しない)
ユーザー~/.claude/CLAUDE.md全プロジェクト共通の自分ルール
組織管理者が配布する組織共通ファイル会社として全員に配る方針

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

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

複数の場所にCLAUDE.mdがあるとき、どれかが勝つのではありません。Claude Codeの公式ドキュメントによると、広い範囲のファイルから順に、すべてが連結して読み込まれます。CLAUDE.mdが連結される順番は、以下のとおりです。

  1. 組織のファイル
  2. ユーザーのファイル
  3. プロジェクトのファイル

連結されたCLAUDE.mdは、全部がAIに渡ります。

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

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

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

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

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

CLAUDE.mdは、たくさん書くほど効くわけではありません。分量の目安と、書く行を選ぶ基準を知っておくと、AIに守られやすい文書になります。CLAUDE.mdの書き方の核心は、以下の3つです。

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

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

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

なお「200行を超えると切り捨てられる」と書く解説がありますが、誤りです。CLAUDE.mdは200行を超えても全文が読み込まれます。公式ドキュメントが示す上限は4MiBで、通常の文書では届かない大きさです。200行はあくまで、守られやすさのための目標値です。

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

CLAUDE.mdに何を書くかの判断基準として、Claude Codeの公式ドキュメントは「この行を消したらClaudeはミスをするか」という問いを勧めています。答えがノーの行は、削る対象です。

公式ドキュメントによると、守られない指示が1つあるときは、該当する行だけにIMPORTANTのような強調を付けると守られやすくなります。多くの行を強調すると効果は薄れます。なお、CLAUDE.mdは日本語で書いて問題ありません。

CLAUDE.mdの定期的な見直しには、削れる行のトリム提案をくれる/doctorコマンドが便利です。判断基準の原文は、Claude Code公式ドキュメントのベストプラクティスのページで確認できます。

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

Claude Codeの公式ドキュメントが勧める、CLAUDE.mdに書くべきことと書かないことは、以下の表のとおりです。

書くべきこと書かないこと
コードや構成から推測できない約束事コードを読めば分かること
プロジェクト独自のコマンドや手順一般的な言語や道具の常識
標準から外れた自分たちの流儀頻繁に変わる情報
環境の癖・注意点「丁寧に書いて」の類いの精神論

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

CLAUDE.mdを書いたのに効かないときの確認方法

CLAUDE.mdが守られないときは、読み込み・書き方・CLAUDE.mdの限界の順に原因を疑うと、直す場所を絞り込めます。「無視される」と感じたときの確認方法は、以下の3手順です。

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

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

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

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

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

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

書き方の問題への対処は、削ることと具体化することです。CLAUDE.mdを書き直すときの要点は、以下のとおりです。

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

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

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

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

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

CLAUDE.mdの基本に慣れてきたら、ファイルの分け方や、混同しやすい仕組みとの違いも知っておくと運用が楽になります。CLAUDE.mdの一歩進んだ使い方で押さえたいのは、以下の3つです。

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

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

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

@インポートの決まりは、以下のとおりです。

  • 取り込みは最大4段階まで連鎖できる
  • コードブロックの中に書いた@は無視される
  • インポートした内容も開始時に全部読み込まれる

とくに注意したいのは、インポートした内容も全部読み込まれる点です。ファイルの分割は整理のためであって、読み込み量の節約にはなりません。

読み込み量自体を減らしたい場合は、.claude/rules/フォルダに分けたルールファイルを置く方法が、Claude Codeの公式ドキュメントの案内です。ファイルの種類やフォルダを指定したルールは、該当するファイルを扱うときだけ読み込まれます。

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

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

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

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

他のAIツールで使われる指示書ファイルにAGENTS.mdがあります。Claude Codeの公式ドキュメントによると、Claude CodeはAGENTS.mdを直接読みません。公式ドキュメントが案内する、AGENTS.mdとCLAUDE.mdを共存させる方法は、以下のとおりです。

  • @AGENTS.mdと1行書いたCLAUDE.mdを置く
  • リンク(シンボリックリンク)でつなぐ

Claude Codeには、他ツールの設定をまとめて取り込む/importコマンドも用意されています。AGENTS.md側の書き方は、Codexでの書き方や置き場所を解説したAGENTS.mdの記事で紹介しています。

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

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

CLAUDE.mdを使い始める前に迷いやすい点を、共有の仕方・ファイルの長さ・非エンジニアの使い道の順にまとめました。CLAUDE.mdに関するよくある質問は、以下の3つです。

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

Gitで共有すべきですか?

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

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

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

CLAUDE.mdは、200行を超えても途中で切り捨てられず、全文が読み込まれます。Claude Codeの公式ドキュメントが示す上限は1ファイル4MiBで、上限を超えるファイルだけが読み込まれません。200行未満はあくまで「守られやすさ」のための公式の目標値です。

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

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

CLAUDE.mdは、非エンジニアの業務でも使えます。中身は日本語の箇条書きで書けるため、プログラミングの知識は不要です。CLAUDE.mdに書ける業務マニュアルの例は、以下のとおりです。

  • 報告書の形式
  • ファイル名の規則
  • 使ってよい資料の場所

業務マニュアルを書けば、資料整理やデータ集計の作業でもAIがルールを守ります。

非エンジニアによるClaude Codeの活用の全体像は、初心者の始め方と活用例を解説した記事で紹介しています。

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

まとめ

CLAUDE.mdは、Claude Codeが毎回の作業前に読む指示書です。置き場所は、プロジェクト直下の1枚から始めれば十分です。

CLAUDE.mdの書き方の要点は、200行未満を目標に「消したらミスするか」の基準で絞り込むことに尽きます。効かないと感じたら、/contextでの読み込み確認・短く具体的な書き直し・絶対ルールのフックへの移動の順で直せます。

まずは/initでたたき台を作り、毎回説明していたことを3行書き足すところから育てていきましょう。200行未満の1枚から、CLAUDE.mdを書き始めてみてください。

参考リンク

この記事の監修者

中島大介(なかじ)

中島大介(なかじ)

株式会社メリル 代表取締役 / 記事監修

株式会社メリル代表取締役。SEO歴20年以上。最新AIやセキュリティについて発信するYouTube「ウェブ職TV」は登録者15万人以上。著書「ChatGPT & Copilotの教科書」は10万部突破!

プロフィールを見る

関連する記事

Cursorのプラグイン「pstack」の使い方を解説する記事のアイキャッチ
AIツール活用

pstackの使い方|Cursor・Claude Codeへの入れ方と頼み方

pstackを使ってみたい方は必見!この記事では、pstackの入れ方と/poteto-modeでの頼み方を解説します。実は、pstackで最初に覚えるコマンドは2つだけです。記事を読めば、AIに確かめさせながら作業を任せられます。

中島大介(なかじ)監修 / Touch AI編集部25 分で読めます
MetaのAIエージェント「Muse」の使い方を解説する記事のアイキャッチ
AIツール活用

Museの使い方|Meta Museの始め方・初期設定・料金を解説

Museを使い始めたい方は必見!この記事では、Meta Museの始め方・初期設定・料金を解説します。実は、Museとのやり取りをAIの学習に使う設定は最初からオンです。記事を読めば、任せる範囲を決めてから使い始められます。

中島大介(なかじ)監修 / Touch AI編集部26 分で読めます
Claude Codeで複数ファイルを一括置換する方法を解説する記事のアイキャッチ
AIツール活用

複数ファイルの文字列を一括置換するには?Claude Codeで残す語を指定

製品名の変更で複数のファイルを直したい方は必見!この記事では、Claude Codeで複数のファイルの文字を一括置換する手順を解説します。実は、残す語を決めてから置き換えられます。記事を読めば、コピーから元に戻す方法も分かります。

中島大介(なかじ)監修 / Touch AI編集部19 分で読めます

次のステップ

最新動向を学びに変える

話題のAIアップデートを、現役講師が背景と実務への影響まで解きほぐします。Touch AI の最新講座で、変化に追いつくための視点を得てください。

受講できる講座を見る