CLAUDE.md｜Claude Codeで最も重要な1つのファイル
Claude Codeを使い始めた人の多くが、数日で同じ壁に当たる。
「毎回同じ説明をしないと、自分の仕事に合った動き方をしてくれない。」この問題の答えが、CLAUDE.mdという1つのテキストファイルだ。適切に書かれたCLAUDE.mdがあれば、Claude Codeは毎朝「今日もよろしく」の一言で、昨日の続きから仕事を始められるようになる。
本稿では、CLAUDE.mdの役割、書き方の原則、そして実務で効果を出すための運用方法を整理する。
CLAUDE.mdとは何か——「毎回の前置き」を1ファイルに固める仕組み
CLAUDE.mdは、Claude Codeがフォルダを開いたときに自動で読み込むテキストファイルだ。このファイルに書いた内容は、そのフォルダで作業するあらゆる会話の前提として、常に参照される。
たとえば、毎回「私は中小企業向けのコンサル会社で営業を担当している。顧客名は伏せて、丁寧語で、箇条書き中心で返してほしい」と説明するのは、3回目には煩わしくなる。この前置きをCLAUDE.mdに1度書いてしまえば、以降は一切説明せずとも、Claude Codeは自動でその前提で動く。
エンジニア向けの機能という印象を持たれがちだが、本質は「自分専属のAIに、自分の仕事のやり方を引き継ぐ書類」だ。プログラミングの知識は一切不要で、日本語の文章で書けばいい。
CLAUDE.mdが決める3つのこと
優れたCLAUDE.mdは、次の3種類の情報を明確に区別して書き込む。
1. 自分と仕事の前提（WHO / WHAT）
Claude Codeがあなたの立場を理解するための情報だ。
- 自分の役割（例：大阪の映像制作会社の代表、営業兼ディレクター）
- 対象のフォルダの用途（例：顧客別の提案書や請求書を格納）
- 主要な関係者（例：岩崎＝代表、MANTA＝Claude Codeでの名前）
この情報があると、Claude Codeは「誰のために、何をしているか」を前提に判断できるようになる。
2. やってほしいこと（HOW）
作業のトーン、手順、優先順位を明示する。
- 返答のスタイル（例：丁寧語で統一、結論先行、箇条書き優先）
- 作業の優先順位（例：収益 > 広報 > 教育の順で判断する）
- 品質の基準（例：法人クライアントに提出できる水準を常に維持する）
ここで重要なのは「具体的に書く」ことだ。「丁寧に」ではなく「丁寧語で統一、です・ます調」と書く。「きれいに整える」ではなく「箇条書きは3〜5項目、1項目1行」と書く。抽象的な指示は、AIにとって解釈が難しく、毎回ぶれる原因になる。
3. やってほしくないこと（禁止事項）
3つのうち、実は最も重要なのがこれだ。
- やってはいけない操作（例：ファイルの削除は必ず確認を取る）
- 使ってはいけない表現（例：「格安」「今だけ」「やばい」などの俗語）
- 触れてはいけない情報（例：顧客の個人情報を他のファイルにコピーしない）
Claude Codeは指示に忠実に動くが、逆に言えば「止めてほしい行動」を書いておかないと、善意で実行してしまう場面が出てくる。禁止事項を先に固めておくことは、AIに業務を任せる上での安全弁になる。
良いCLAUDE.mdと悪いCLAUDE.md——具体性がすべてを決める
同じ内容でも、書き方によって効果は大きく変わる。
悪い例：
「丁寧な文章を心がけること。クライアントに失礼のないように。ビジネス的に適切な表現を使うこと。」
良い例：
「文体は断言する・です／ます調で統一。数字と事例で裏付ける。禁止表現：お手頃／格安／今だけ／やばい／とりあえず。」
悪い例の問題は「丁寧」「失礼のない」「ビジネス的に適切」がすべて解釈の余地を残している点だ。AIは具体的に書かれていない部分を自分の判断で埋めるため、結果が毎回ぶれる。
良い例は、判断の余地をなくしている。「何がダメで、何が正解か」が1行ずつ明示されており、AIは迷わず実行できる。
分量の目安——60行から、長くても300行以内
CLAUDE.mdには「短すぎると効かない、長すぎると読み飛ばされる」という特性がある。実用的な目安は60〜300行だ。
短すぎるCLAUDE.md（10行程度）は、結局毎回説明を追加する羽目になる。長すぎるCLAUDE.md（500行超）は、AIが重要な指示を見落とす頻度が上がる。指示の総数が増えすぎると、個々の優先度が曖昧になり、全体の従い方が逆に悪くなるという現象が観察されている。
書き出しのコツは「最小構成から始めて、ぶれたところを1行追記していく」ことだ。最初から完璧を目指す必要はない。
CLAUDE.mdは「育てるファイル」だ
CLAUDE.mdの真価は、運用しながら継続的に更新していく過程で発揮される。
使っていると必ず「今のは違う」と感じる瞬間が来る。表現がぶれた、勝手に削除された、専門用語が噛み合わない——こうした瞬間こそCLAUDE.mdに追記するタイミングだ。
たとえば、AIが「ぜひぜひ」という軽い表現を使ってしまったら、禁止表現リストに「ぜひぜひ」を追加する。Excelファイルを勝手に上書きされたら、「Excelの編集は必ずコピーを作ってから行う」を追加する。
この積み重ねが、数週間後には「自分の業務文脈を完全に理解したAI」を作り上げる。最初から完成版を書こうとせず、現場で起きた失敗を1行ずつ反映していく運用が、最も効果的だ。
書いてはいけないこと——CLAUDE.mdのNG
効果を下げる書き方も整理しておく。
曖昧な精神論を書かない。「品質を大切に」「ユーザー目線で」といった抽象指示は、AIにとって判断基準として機能しない。具体的なルールに落とす。
`/init`の自動生成をそのまま使わない。Claude Codeには、フォルダの中身を分析してCLAUDE.mdを自動生成する`/init`コマンドがある。便利な起点だが、生成結果は汎用的で冗長になりがちで、そのまま使うと内容が頭に入りにくい。自動生成はたたき台として使い、自分の言葉で書き直すことを前提にする。
機密情報をそのまま書かない。顧客名、パスワード、個人情報などをCLAUDE.mdに直接書くのは避ける。このファイルはClaude Codeに渡す文脈であり、会話ログに含まれる可能性もある。「顧客Aは〜」のように抽象化して書く。
変更が続くものは書かない。今期の売上目標、進行中の案件リストなど、頻繁に変わる情報はCLAUDE.mdに書かない。別のファイルに分け、必要な時にClaude Codeに参照させるほうが管理しやすい。
階層構造——個人と組織で使い分ける
CLAUDE.mdには階層がある。適用範囲の狭い順に、次の4つが読み込まれる。
- ローカル：そのフォルダ専用の一時的な設定
- プロジェクト：フォルダ全体に適用される設定（最も一般的）
- ユーザー：自分のすべての作業に共通する設定
- エンタープライズ：組織全体で強制される設定
個人利用であれば、プロジェクト階層とユーザー階層の2つで十分だ。「自分の基本ポリシー」はユーザー階層に、「このプロジェクト固有のルール」はプロジェクト階層に書き分ける。この2層構造が、複数案件を同時進行するときに威力を発揮する。
実践例——営業担当のCLAUDE.md（抜粋）
理論だけでは伝わらないので、実際に機能する最小構成を示す。
# 自分について
- 大阪の中小企業向けコンサル会社、営業担当
- 主な顧客：製造業の経営者（50〜70代、IT苦手）
# 文体
- 断言調、です／ます調で統一
- 結論先行、箇条書きは3〜5項目
- 数字と事例で裏付ける
# 禁止表現
- お手頃／格安／今だけ／やばい／とりあえず
- 「頑張ります」「善処します」などの曖昧表現
# やってほしくないこと
- ファイルの削除は必ず確認を取る
- 顧客名を別ファイルに転記しない
- 外部URLを勝手に開かない
# このフォルダについて
- 顧客別の提案書・議事録を格納
- 顧客Aは製造業、顧客Bは物流業と認識してよいこの程度の分量で、Claude Codeの動きは劇的に安定する。
まとめ——CLAUDE.mdを書くことは「AIへの教育」だ
CLAUDE.mdはClaude Codeを使う上で最も費用対効果の高い作業だ。
30分かけて60行のCLAUDE.mdを書くことで、以降の数ヶ月間、毎回の前置き説明が不要になり、アウトプットの品質も安定する。書き込む内容は、自分の仕事のやり方を言語化する作業そのものでもあり、書いているうちに「自分は普段どう判断しているか」が明確になる副産物もついてくる。
最初は完璧を目指さない。最小構成から始め、使いながら違和感を感じた部分を1行ずつ追記していく。数週間後には、このファイルがAIエージェントの性格そのものを形作っていることに気づくはずだ。
Claude Codeを導入したら、最初の30分をCLAUDE.mdに投資する。これが、AIを「便利な道具」から「自分の業務を理解している相棒」に変える唯一の工程だ。
