CLAUDE.md（クロード・エムディー）

CLAUDE.mdとは、AIコーディングツール「Claude Code」に対して、プロジェクト固有のルールや前提知識を伝えるための設定ファイルです。プロジェクトのフォルダに置いておくと、AIが作業を始める際に自動的に読み込んでその内容に従って動いてくれます。

イメージとしては、CLAUDE.mdは新しく加わったメンバーに渡す業務マニュアルです。「この現場ではこういう書き方をする」「この手順は必ず守ってほしい」といった決まりごとをまとめておけば、毎回口頭で説明しなくても、読んだ人が同じように動いてくれます。AIに対しても、まったく同じ考え方が当てはまります。

ファイル名のとおり、中身はマークダウンという書式で書かれた、ただのテキストファイルです。特別なプログラムの知識は必要なく、普通の文章で指示を書けるのが大きな特徴です。

CLAUDE.mdに書く内容

決まった形式はありませんが、よく書かれる内容を整理すると次のとおりです。

CLAUDE.mdを使うメリット

最大の利点は、毎回同じ説明を繰り返さなくて済むことです。指示を一度ファイルに書いておけば、以降の作業ではAIがそれを前提に動いてくれます。結果として、指示の伝え漏れが減り、成果物の品質も安定します。

また、ファイルとして残るためチーム全員で共有できるのも重要な点です。誰が作業しても同じルールのもとでAIが動くようになり、人によって成果物がばらつくのを防げます。プロジェクトのルールを明文化する機会にもなります。

書くときのコツ

効果的なCLAUDE.mdにするコツは、具体的に、かつ簡潔に書くことです。「きれいなコードを書く」といった曖昧な表現より、「関数名は英語の動詞で始める」のように、判断に迷わない書き方が望まれます。一方で、内容を詰め込みすぎると重要な指示が埋もれてしまうため、本当に必要なルールにしぼることも大切です。

最初から完璧を目指す必要はありません。実際に使ってみて「うまく伝わらなかった」点を書き足していく育てる姿勢が、結果的によいファイルにつながります。

配置場所の工夫

CLAUDE.mdは、プロジェクトの一番上のフォルダに置くのが基本です。加えて、フォルダの階層ごとに別のCLAUDE.mdを置くこともできます。こうしておけば、その部分の作業をするときにだけ関連するルールが読み込まれ、無関係な指示で処理が重くなるのを避けられます。

大きなプロジェクトほど、この使い分けが効いてきます。全体に関わる決まりごとは一番上に、特定の領域だけのルールはその場所に——と整理しておくと、指示が伝わりやすくなります。

あわせて知っておきたい用語

• Claude（クロード）：
  Anthropic社が開発・提供している対話型のAIサービス
• SKILL.md：
  AIに特定の手順を教えるためのファイル
• マークダウン（Markdown）：
  記号で見出しや装飾を表す記法
• AIエージェント：
  自律的に作業を進めるAI