「Claude Codeを使い始めたけど、CLAUDE.mdって何のために必要なの？」「どう書けばいいかわからなくて、とりあえず放置している」――そんな方は意外と多いです。実は、CLAUDE.mdの書き方ひとつで、Claude Codeの作業効率が大きく変わります。この記事では、初めてClaude Codeに触れる方でもすぐに実践できるよう、CLAUDE.mdの役割から具体的な書き方まで丁寧に解説します。
CLAUDE.mdとは何か？Claude Codeを使いこなす鍵
CLAUDE.mdとは、Claude Codeに対してプロジェクトのルールや背景情報を事前に伝えておくための設定ファイルです。Markdownで書かれたテキストファイルで、Claude Codeはこのファイルを自動的に読み込んで作業を始めます。簡単に言えば、「新しいスタッフへの引き継ぎ書」のようなものです。毎回「このサイトはこういう目的で、こういうルールで運営しています」と説明しなくても、CLAUDE.mdを読めばAIが文脈を把握した状態で作業してくれます。
なぜCLAUDE.mdがないと作業効率が下がるのか
CLAUDE.mdがないと、Claude Codeはプロジェクトの背景を何も知らないまま作業を始めます。たとえばブログの記事を書いてもらう場合、サイトのターゲット読者、文字数のルール、使用するHTMLの形式、内部リンクの注意点――こういった情報を毎回会話の中で伝える必要があります。これは時間の無駄なだけでなく、伝え忘れがあるとミスにもつながります。CLAUDE.mdがあれば、こうした基本情報を一度書いておくだけで、以後の会話には毎回自動で反映されます。
CLAUDE.mdとシステムプロンプトの違い
Claude APIを直接使う場合は「システムプロンプト」という概念がありますが、CLAUDE.mdはそれをファイルとして管理できるようにしたものと考えるとわかりやすいです。システムプロンプトはAPIを叩くたびにコードに書く必要があるのに対し、CLAUDE.mdはファイルを置くだけで常に有効になります。プログラミングの知識がなくても扱えるのが大きなメリットです。Claudeの機能や料金プランの詳細は以下の記事でまとめています。
CLAUDE.mdはどこに置けばいいのか
CLAUDE.mdの置き場所にはルールがあります。基本は「プロジェクトのルートディレクトリ（一番上の階層）」に置くことです。Claude Codeは作業を開始するとき、このルートのCLAUDE.mdを自動的に探して読み込みます。ファイル名は必ず「CLAUDE.md」（すべて大文字）にする必要があります。「claude.md」や「Claude.md」では読み込まれないので注意してください。
複数のCLAUDE.mdを使い分ける方法
実は、CLAUDE.mdはルートだけでなく、サブフォルダにも置くことができます。たとえば「articles」フォルダの中に別のCLAUDE.mdを置けば、そのフォルダ内での作業にだけ追加のルールを適用できます。ブログの記事フォルダ専用のCLAUDE.mdに記事執筆のフォーマットを細かく記載しておき、ルートのCLAUDE.mdにはサイト全体の方針を書く、という使い分けが便利です。
グローバル設定との使い分け
Claude Codeには、すべてのプロジェクトに共通して適用される「グローバルCLAUDE.md」も設定できます。こちらは ~/.claude/CLAUDE.md（Windowsの場合は C:\Users\ユーザー名\.claude\CLAUDE.md）に置きます。「いつでも日本語で返答してほしい」「コメントは書かないでほしい」といった、どのプロジェクトでも共通するルールはグローバルに書いておくと効率的です。
CLAUDE.mdに書くべき内容と優先順位
何でも書けばいい、というわけではありません。CLAUDE.mdに詰め込みすぎると、かえって重要な情報が埋もれてしまいます。大切なのは「AIが知らないと作業の質が落ちること」に絞って書くことです。以下の4つを基本の柱として考えると整理しやすいです。
| 記載カテゴリ | 書く内容の例 | 優先度 |
|---|---|---|
| プロジェクト概要 | サイトの目的・ターゲット読者・運営方針 | 高 |
| 作業ルール | 文字数・フォーマット・禁止事項・出力形式 | 高 |
| よく使う参照情報 | サイトURL・内部リンクのルール・画像命名規則 | 中 |
| 注意・禁止事項 | 過去のミスを防ぐための具体的な制約 | 高 |
プロジェクト概要・目的を書く
まず冒頭に「このプロジェクト（サイト）は何のためのものか」を簡潔に書きます。たとえばブログ運営であれば、「このサイトはAI活用・SEO・副業をテーマにしたブログです。広告収入を最大化するため、SEOに強い記事を継続的に公開しています」といった一段落で十分です。AIはこの情報を元に、作業の優先度や判断基準を自動的に調整してくれます。
作業ルールと制約事項を具体的に書く
「丁寧な文章で書いてください」のような抽象的な指示は、AIには伝わりにくいです。「文字数：3000〜5000文字」「H2見出しの直後には必ず本文段落を入れること（H2→H3の連続は禁止）」「WordPress投稿用HTML形式で出力すること」のように、具体的な数値や条件を使って書くことが重要です。ルールが曖昧だと、AIは都合よく解釈してしまいます。
ブログ記事で使うプロンプトの作り方についても、具体的な書き方と実例を以下の記事でまとめています。CLAUDE.mdの記述と合わせて参考にしてください。
実際のCLAUDE.md記述例：ブログ運営の場合
理屈より実例を見た方が一番わかりやすいので、ブログ運営向けのCLAUDE.mdの書き方を具体的に示します。以下は実際に使えるテンプレートです。自分のサイトに合わせてカスタマイズして使ってください。
ブログ運営向けCLAUDE.md テンプレート
# サイト概要
このサイトは〇〇をテーマにしたブログです。
ターゲット読者：30〜40代の副業初心者
目的：広告収入（アドセンス・アフィリエイト）の最大化
---
## 記事作成ルール
- 文字数：3000〜5000文字
- H2見出しの直後には必ず本文段落を入れること（H2→H3の連続は禁止）
- WordPress投稿用HTML形式で出力すること
- 文章はAIっぽさを感じさせない、人間味ある文体で書くこと
## 内部リンクのルール
- 仮のURLや推測URLは絶対に使用しないこと
- 記事作成前に必ずサイトマップ（https://〇〇.jp/post-sitemap.xml）を取得し、実在するURLを確認する
- 記事の文脈に合うURLのみ使用すること
## 出力形式
- アイキャッチ画像のGeminiプロンプト・英文ファイル名・altテキストを毎回出力する
- SEOタイトル・メタディスクリプション・キーワードを毎回出力するテンプレートの各セクションの解説
冒頭の「サイト概要」は、Claude Codeが何のために作業しているのかを把握するための土台です。ここが曖昧だと、記事のトーンや内容がサイトの方針からずれてしまいます。「記事作成ルール」は箇条書きで書くのがベストです。長い文章よりも箇条書きの方がAIに確実に守ってもらいやすくなります。「内部リンクのルール」のように、過去に問題が起きた箇所を「禁止事項」として明示しておくのも非常に有効です。ミスの再発防止策として、気づいたタイミングでどんどん追記していきましょう。
初心者が陥りやすいミスと改善ポイント
CLAUDE.mdを書き始めたばかりの頃は、誰でも同じようなミスをします。書き方の方向性さえ押さえておけば、試行錯誤の時間を大幅に省けます。ここでは特によくある3つの失敗パターンを紹介します。
ミス①：抽象的な指示を書いてしまう
「わかりやすく書いてください」「SEOを意識してください」といった指示は、人間には伝わる気がしますが、AIには解釈の余地が広すぎます。「読者は副業初心者の会社員を想定し、専門用語には必ず括弧で補足説明を加えること」「H2見出しごとに最低2段落の本文を入れること」のように、具体的な条件や数値で書くことを意識してください。曖昧な言葉を使うたびに、AIの出力がブレやすくなります。
ミス②：情報を詰め込みすぎる
最初から完璧なCLAUDE.mdを作ろうとして、あれこれ書きすぎてしまうケースも多いです。情報量が多すぎると、AIが本当に重要なルールを見落とす原因になります。最初は「絶対に守ってほしいこと」だけを5〜10項目に絞って書き、実際に使いながら気になった点を少しずつ追記していくのが現実的です。CLAUDE.mdは完成させるものではなく、育てていくものと考えてください。
ミス③：一度書いたら更新しない
「AIが間違えた」「期待通りの出力にならなかった」というケースのほとんどは、CLAUDE.mdに必要な情報が書かれていないことが原因です。作業中に「このルールを書いておけばよかった」と気づいたら、その場ですぐCLAUDE.mdに追記する習慣をつけましょう。特に「やってはいけないこと（禁止事項）」は、実際のミスが起きたあとに書くのが一番具体的で効果的です。
CLAUDE.mdを副業・ビジネスに活かす発展的な使い方
CLAUDE.mdはブログ運営だけでなく、副業全般に応用できます。ウェブサイト制作の案件なら、クライアントの要件や禁止事項をCLAUDE.mdに書いておけば、毎回のやり取りが効率化されます。データ処理や資料作成の副業なら、入出力のフォーマットや命名規則を記載しておくと、作業のブレが減ります。Claude Codeを副業に活かす具体的な方法については、以下の記事で7つのジャンルに分けて解説しています。
まとめ：CLAUDE.mdは「育てる」ものと考えよう
CLAUDE.mdは、一度書いて終わりのファイルではありません。Claude Codeと一緒に作業を続けながら、気づいたことを少しずつ追記・修正していくことで、どんどん精度が上がっていきます。最初から完璧を目指さず、まずは「サイト概要」と「最低限守ってほしいルール」だけを書いて始めてみましょう。
今回の内容をまとめると、以下のポイントが特に重要です。
- CLAUDE.mdはプロジェクトのルートに「CLAUDE.md」という名前で置く
- 書く内容は「プロジェクト概要」「作業ルール」「禁止事項」の3本柱で整理する
- 抽象的な指示より、具体的な数値・条件・フォーマットで書く
- 詰め込みすぎず、重要なルールを絞って書く
- ミスが起きたら「禁止事項」として追記し、再発を防ぐ
- グローバル設定とプロジェクト設定を使い分けて効率化する
CLAUDE.mdを適切に整備すれば、毎回同じ説明をする手間がなくなり、AIとの作業がスムーズになります。副業やサイト運営の効率を底上げするための、地味だけど確実に効果のある一歩です。ぜひ今日から試してみてください。
コメント