CLAUDE.mdとは？Claude Code設定ファイルの役割と書き方を解説

「CLAUDE.mdって何のこと？」「Claude Codeを使い始めたけど、設定ファイルの話がよく分からない」——そんな疑問を持って検索した方に向けた記事です。

CLAUDE.mdは、ひとことで言うと「AIへの申し送りメモ」です。仕事の引き継ぎ書に近いもので、あらかじめ書いておくと、AIが毎回同じミスをしたり、的外れな提案をしたりするのを防げます。

この記事では、そもそもCLAUDE.mdとは何か、何を書けばいいのか、どこに置くのかを、専門知識なしでも分かるようにやさしく整理します。「今すぐ使う予定はないけど概要だけ知りたい」という方も、最初のセクションだけ読めば全体像がつかめます。

そもそもCLAUDE.mdとは何？なぜわざわざ用意するの？

CLAUDE.mdは、Claude Code（Anthropic社が提供するAIコーディングツール）に対して「こういうルールで作業してね」と伝えるためのテキストファイルです。ファイル名の「.md」はMarkdown（マークダウン）という書式の拡張子で、メモ帳のように箇条書きや見出しを付けられる軽い文書形式です。今は「メモ帳の親戚」くらいの理解で十分です。

なぜ必要かというと、Claude Codeは会話が変わるたびに前の指示を忘れてしまうからです。たとえば職場に毎日違う派遣スタッフが来る状況を想像してください。口頭で「うちのルールはこうだよ」と伝えても、翌日にはまた別の人が来て同じ説明をする羽目になります。

CLAUDE.mdはこの「毎回やる説明」を紙のマニュアルにまとめておくようなものです。Claude Codeは作業を始める前にこのファイルを自動で読み込むので、毎回同じ指示を打ち直す手間が省けます。結果として、AIの出力のブレが減り、やり直しの回数も減ります。

つまり、CLAUDE.mdが役に立つのは「Claude Codeに繰り返し作業を頼む場面がある人」です。一度きりの簡単な質問にしか使わないなら、今すぐ用意しなくても困りません。ただし、プロジェクト単位でコードを書かせたい場合や、チームで共有するルールがある場合は、早めに作っておくと後が楽になります。

CLAUDE.mdには何を書けばいい？まず押さえたい3つの内容

白紙のファイルを目の前にすると「何を書けばいいか分からない」と手が止まりがちです。最初は次の3つだけ書いておけば実用上は十分です。

• プロジェクトの概要——「このフォルダは何のためのプロジェクトか」を1〜2行で書きます。たとえば「社内の勤怠管理ツールのバックエンド（サーバー側の処理部分）」のように、目的とざっくりした範囲を伝えます。これがあるだけで、AIが見当違いなコードを提案する頻度がぐっと下がります。
• コーディングルール——「変数名は英語で書く」「インデント（行頭の空白）はスペース2つ」など、チームや自分が守っているお作法です。人間同士でも「書き方のルール」を決めておかないとバラバラになりますよね。AIも同じで、ルールを明文化すると出力が安定します。
• やってほしくないこと——「既存のデータベース構造を勝手に変えない」「外部サービスへの接続を追加しない」など、禁止事項を書いておくのも大切です。AIは指示がなければ「良かれと思って」大きな変更を加えることがあります。引っ越し業者に「この箱は開けないで」と貼り紙するのと同じ発想です。

書き方はむずかしく考える必要はありません。Markdownの見出し（#）と箇条書き（-）を使って、上の3項目を並べるだけで基本形は完成します。完璧を目指すより、まず短くてもいいので作っておき、使いながら足りない項目を追記していくのが現実的です。

この3つを書いておくと得をするのは、「AIの出力を毎回手直ししている人」です。手直しが多い原因の多くは「前提条件がAIに伝わっていない」ことなので、CLAUDE.mdで前提を共有するだけで修正回数を減らせます。

ファイルはどこに置く？置き場所で届く範囲が変わる仕組み

CLAUDE.mdは置く場所によって「どの範囲のAI作業に反映されるか」が変わります。ここが少し分かりにくいポイントなので、身近なたとえで整理します。

まず、プロジェクトのフォルダ直下に置くパターンです。これはそのプロジェクト専用の申し送りメモです。たとえば「Aプロジェクト」のフォルダに入れれば、Claude CodeがAプロジェクトのファイルを操作するときだけ読み込まれます。会社の部署ごとに掲示されているルール表のようなイメージです。

次に、ホームディレクトリ（パソコン全体のユーザーフォルダ）に置くパターンです。こちらは、どのプロジェクトで作業しても共通で読み込まれる「全社共通ルール」にあたります。「自分はどのプロジェクトでも日本語でコメントを書きたい」といった個人の好みを書いておくのに向いています。

つまり、共通ルールはホームディレクトリ、プロジェクト固有のルールは各フォルダ直下、と使い分けるのが基本の考え方です。両方にCLAUDE.mdがある場合は、Claude Codeが両方を読み込んで合わせて適用します。矛盾する内容がある場合はプロジェクト側が優先される仕組みです。

置き場所の判断で迷ったら、まずはプロジェクトフォルダの直下に1つ作るところから始めてください。全プロジェクト共通のルールが必要だと感じた段階で、ホームディレクトリ用を追加すれば十分です。

チームで使う場合は、プロジェクトフォルダのCLAUDE.mdをGit（ソースコードのバージョン管理ツール）に含めて共有すると、メンバー全員が同じルールでClaude Codeを動かせます。Gitになじみがない方は、「チーム共有フォルダにマニュアルを入れておく」のと同じ効果がある、とだけ覚えておけば大丈夫です。

まとめ——CLAUDE.mdは「AIへの引き継ぎメモ」と覚えておこう

ここまでの内容を短く振り返ります。

• CLAUDE.mdは、Claude Codeに「作業ルールや前提条件」を伝えるためのテキストファイル。
• 書く内容は「プロジェクト概要」「コーディングルール」「やってほしくないこと」の3つから始めれば十分。
• 置き場所は、プロジェクト固有ならフォルダ直下、全プロジェクト共通ならホームディレクトリ。迷ったらフォルダ直下から。

「まず何をすればいいか」を一つだけ挙げるなら、今使っているプロジェクトフォルダにCLAUDE.mdを作り、プロジェクトの目的を2〜3行で書いてみることです。それだけでも、Claude Codeの応答が自分の意図に近づく感覚をつかめるはずです。完璧な内容を最初から目指す必要はありません。使いながら「これも書いておけばよかった」と気づいた項目を足していけば、自然と自分専用のマニュアルが育っていきます。