- Claude Codeを使い始めたけれど、毎回同じ前提や指示を説明し直している
- CLAUDE.mdという言葉は聞くけれど、何をどう書けばいいのかわからない
- チームで使うルールをどう蓄積していけばいいのか、運用イメージが湧かない
このような疑問や期待をお持ちではありませんか？
CLAUDE.mdとは、Claude Codeが会話の開始時に毎回読み込む、業務ルールを書いておくための指示書ファイルです。ここに一度書いておけば、同じ説明を繰り返す必要がなくなります。
読み終えるころには、何を書けばよいか、どこに置けばよいか、どこまでをCLAUDE.mdに任せるべきかを、自分で判断できるようになります。
1. CLAUDE.mdとは？毎回の指示を省略できる仕組み
CLAUDE.mdとは、Claude Codeが会話を始めるたびに自動で読み込む、Markdownというテキスト形式の指示書ファイルです。
CLAUDE.mdが自動で読み込まれるイメージ
CLAUDE.mdが無ければ、Claude Codeは、会話を始めるたびに白紙の状態からスタートし、前回のやり取りは持ち越されません。
例えば、CLAUDE.mdに以下のようなことを記載しておけば、依頼のたびに打ち直す必要がなく、仕事を始めてもらえます。
- 提案書は「ですます調」で書いてほしい - 経理レポートは「表形式」で出してほしい
毎回言い直していたことをCLAUDE.mdファイルとして特定のファイルの置き場所に置くことで、Claude Codeは会話を始めるたびに自動で読み込むようになります。
CLAUDE.mdの置き場所による適用範囲の違い
CLAUDE.mdは1種類ではありません。
誰に効かせたいかによって置き場所が分かれており、個人のこだわりとチーム全員に守ってほしいルールを、同じファイルに混ぜずに済みます。
CLAUDE.mdを適切な場所に格納するイメージ
| 読み込み順序 | スコープ | ファイルの置き場所 | 向いている用途 |
|---|---|---|---|
| 1 | 管理ポリシー | 組織のIT部門が定める所定のパス | 会社全体に適用したい方針 IT部門が各PCへ配布する |
| 2 | ユーザー | ~/.claude/CLAUDE.md |
自分が関わる全案件に共通する、個人の書き方の好み |
| 3 | プロジェクト | ./CLAUDE.md または ./.claude/CLAUDE.md |
同じ案件を扱う人が同じ内容を持つための業務ルール・用語・出力形式 |
| 4 | ローカル | ./CLAUDE.local.md |
共有せず自分の手元だけに置いておきたいメモ |
ファイルは1→4の順に読み込み、あとから読まれた内容ほど近い指示として扱われます。
そして、すべて連結されたコンテキストとして読み込まれます。
チームで運用するなら、まずプロジェクトのCLAUDE.mdを1本つくるのが出発点です。
フォルダの中にさらにフォルダを分けている場合は、その中にもCLAUDE.mdを置けます。
こちらは起動時ではなく、Claude Codeがそのフォルダのファイルを読んだときに追加で読み込まれます。
使えるようになるまでの流れ
実際に使い始めるまでは、4つの手順で足ります。
/initコマンドを実行する
Claude Codeが対象のフォルダを分析し、出発点となるCLAUDE.mdを自動生成します- 毎回言い直していた前提・ルール・出力形式を、自分の言葉で書き足す
- チームで共有するのか自分だけで使うのかを決め、上の表のスコープに沿って配置する
/memoryコマンドで、どのメモリファイルがどこにあるかを一覧表示し、選んでそのまま開いて確認する
最初から完成品を目指す必要はありません。
/init で骨組みを出させて、そこに「毎回言っていたこと」を足していくだけで、実用に足るCLAUDE.mdになります。
長いファイルはコンテキストを消費し、指示の遵守度を下げるためです。
200行を超えそうなら、
.claude/rules/ というフォルダに用途別のファイルとして分割できます。このフォルダに置いたルールは、特定のファイルを扱うときだけ読み込ませる設定もできるため、必要な場面でだけ効かせられます。2. CLAUDE.mdの書き方｜業務ルール・トーン・出力形式を蓄積する具体例
CLAUDE.mdに書くべきことは、ひと言でいえば「あなたが2回以上言ったこと」です。
2回言ったなら3回目もある、と考えて、その場でCLAUDE.mdに移します。
一度きりの依頼を書く必要はありません。その場のチャットで伝えれば済みます。
効いてくるのは、毎回同じ前提を伝えないと成果物がぶれるタイプの業務です。
CLAUDE.mdに追記が必要な業務イメージの例
| やりたいこと（部署・業務） | CLAUDE.mdに書いておく指示の例 | 書かなかった場合に毎回起きること |
|---|---|---|
| 営業 提案書のたたき台をつくる |
– 構成は「課題整理→提案内容→見積もりの骨格」の順にする – 文体はですます調 – 競合を名指しで批判しない |
章立てが毎回変わり、社内レビューで構成の直しが発生する |
| 経理 月次レポートをまとめる |
– 数値は必ず表形式にする – 前月比と前年同月比を併記する – 金額は千円単位に統一する |
単位や比較軸が回ごとに変わり、過去分と並べて読めない |
| 人事 候補者情報を要約する |
– 個人が特定される表現は避ける – 評価コメントは断定せず「〜と考えられます」で締める |
社内共有できない表現が混ざり、都度書き換えが必要になる |
| マーケティング 記事の下書きをつくる |
– 見出しは検索意図を意識した疑問形にする – 自社サービス名は正式名称で統一する |
表記ゆれの修正と見出しの作り直しが毎回発生する |
書き込むときは、見出しと箇条書きの形にまとめます。文章で長々と説明するより、以下のように短い命令形の箇条書きのほうが解釈がぶれません。
## 提案書作成のルール
- 構成は「課題整理→提案内容→見積もりの骨格」の順にする
- 文体はですます調に統一する
- 競合他社を名指しで批判する表現は使わない
- 金額の単位は千円単位に統一する「わかりやすく書いて」「いい感じにまとめて」といった抽象的な指示だけでは、毎回違う解釈になります。
避けてほしい表現と望ましい出力形式まで具体的に書き切ると、同じ品質を再現しやすくなるでしょう。判断に迷ったときの基準、たとえば迷ったら箇条書きにする、まで書いておくとさらに安定します。
毎回チャットで言えば済むのでは？という疑問がある方。
一人で、一回きりの作業なら、そのとおりです。
CLAUDE.mdが効いてくるのは、同じ作業を繰り返すとき、そして担当者が複数いるときです。
あなたの頭の中にある判断基準がファイルとして残るため、隣の人が同じ指示で同じ品質の成果物を出せるようになります。
ただし、AGENTS.mdの内容が使えないわけではありません。他のAIコーディングツール向けにAGENTS.mdをすでに運用しているなら、CLAUDE.mdを1本用意して、そこからAGENTS.mdを読み込ませる書き方が公式に案内されています。
指示を書いたファイルをAGENTS.mdだけにしておくと読まれないので、その点だけ注意しましょう。
3. 自分の業務を再現するためのワークスペース設計の例
CLAUDE.mdは1ファイルに詰め込みすぎないほうがよいため、ファイル単体ではなくフォルダ構成とセットで設計すると、運用が安定します。
プロジェクト運用におけるワークスペース設計の例をご紹介します。
以下は公式が定めた構成ではなく、FLINTERSで運用している一例です。
ホームディレクトリの .claude/ フォルダには、どのフォルダでClaude Codeを起動しても必ず読み込まれる共通ルールのCLAUDE.mdと、スキルをまとめる skills/ を置きます。
作業フォルダは work/ を最上位にして、その下に案件ごとの project_A/、project_B/ を作る形です。
案件フォルダの中は、共通ルールのCLAUDE.md、参照情報を入れる references/、成果物を書き出す output/ の3つに分けます。
- CLAUDE.mdは案件フォルダ単位で置きます。
work/はローカルのどこに置いても動作は変わりません。管理しやすい場所を選んで構いません。
ワークスペースの基本構成の一例
構成そのものは一例です。このようにすることで
- どのフォルダでClaude Codeを起動しても必ず読み込まれる共通ルール
- 案件ごとに適用したい共通ルール
2つのルールを分けて管理運用しやすい作業環境を構築します。
CLAUDE.mdだけを整えて参照情報の置き場所を決めないままだと、結局は毎回ファイルの場所を指示することになります。
指示書と参照先をセットで設計する、という考え方を持つことが運用がしやすい環境への近道になると思います。
4. CLAUDE.mdに適さないルールとは？
先ほど、2回以上言ったことがあった場合にCLAUDE.mdに移すことをご案内しました。
ですが、Claude Codeには振る舞いを制御する仕組みが複数あります。
役割で使い分けがされているため CLAUDE.md には適さないルールについてご紹介します。
- CLAUDE.mdに適しているのは、前提知識、業務ルール、文体、出力形式です。
- Skillsに登録するのは、特定の作業のやり方、使うツールや台本、作業手順書にあたる指示です。
- Hooksに登録するのは、決められたタイミングで自動的にコマンドを実行する仕組みです。
決定的な違いは、CLAUDE.mdが「伝える」ものであって「実行する」ものではないという点にあります。
公式ドキュメントも、CLAUDE.mdの内容は強制される設定ではなく、あくまで文脈であると説明しています。
| 要素 | 役割 | 何を定義するか |
|---|---|---|
| CLAUDE.md（Rules） | 行動規範を伝える | 前提知識・業務ルール・文体・出力形式 |
| Skills | 作業手順を渡す | 特定の作業のやり方、使うツールや台本。使うときにだけ読み込まれる |
| Hooks | 決まった場面で実行する | どのタイミングで、どんな処理を自動的に走らせるか |
CLAUDE.mdとHooksの線引きについて
最も迷いやすいのが、CLAUDE.mdとHooksの境目です。
判断は「守られなかったら困る度合い」で決めます。
| やりたいこと | どこに書くべきか |
|---|---|
| 文体・構成・用語を揃えたい | CLAUDE.md（多少ぶれても手直しで済む） |
| この操作は必ず実行前に止めてほしい | Hooks（判断に委ねず確実に止める） |
| 会話の開始時に必ず決まった処理を走らせたい | Hooks（開始時のイベントで実行する） |
また、Hooksには、会話の開始時やツールの実行前後など、10種類ほどのタイミングが用意されています。代表的なものは4つです。
| イベント名 | いつ発火するか |
|---|---|
SessionStart |
会話を開始・再開したとき |
UserPromptSubmit |
ユーザーが指示を送信した直後 |
PreToolUse |
ファイル編集やコマンド実行などのツールを使う直前。ここで操作をブロックできる |
PostToolUse |
ツールの実行が成功したあと |
絶対に守らせたいことは、CLAUDE.mdに書くのではなくPreToolUse hookを使いましょう。
5. CLAUDE.mdを自分の業務に最適化する進め方
CLAUDE.mdは、一度書いて終わりではありません。
使いながら思ったように伝わらなかった指示に気づき、そのたびに書き直していくことで、自分やチームの業務に合った状態へ近づいていきます。
どの業務からCLAUDE.mdを書き始めるのが学習として良いか？
すべての業務を一度に書き起こそうとすると挫折しやすいです。
FLINTERSでは自動化の難易度を3段階に分け、上から順に手をつけることを推奨しています。
公式の分類ではなく、社内で運用してきた整理の一例です。
| 難易度 | 業務の性質 | 業務の例 |
|---|---|---|
| 1 | コンテキストが固定された定型業務 | 社内Slackに来た質問と回答を、決まった集計ファイルへ追記更新する |
| 2 | コンテキストがブラッシュアップされていく定型業務 | 提案に使う競合情報を調査し、観点を更新しながら結果を資料化する |
| 3 | 経験値による判断や、言語化できていない過程がある業務 | 提案骨子の作成 |
難易度1：参照先が固定されているため、書けばすぐ効きます。
難易度2：使うたびに参照する観点が増えるので、参照用のmdファイルをClaudeに更新させながら育てます。
難易度3：担当者の勘がまだ言葉になっていない領域です。壁打ちのなかで「なぜその判断をしたのか？」を言語化し、少しずつルールへ反映していきます。
FLINTERS式、挫折しないための段階を分けたCLAUDE.mdの設計
まずは難易度1から、小さく始めるのが現実的でしょう。
CLAUDE.mdを育てるサイクル
- 指示を出す
- 出てきた成果物と、自分が期待していたものの差分を見る
- その差分が毎回起きそうなことなら、CLAUDE.mdに1行追記する
- 追記が増えて読みづらくなったら、見出しで整理するか
.claude/rules/に分割する
このサイクルを回すほど、毎回説明していたことは減っていきます。
最初の1週間で完成させるものではなく、3か月かけて厚くなっていくもの。
書き足すときは、迷ったら命令形の1行にしてください。
個人の工夫を、組織の資産にするために
担当者一人であれば、CLAUDE.mdの運用は試行錯誤で進められます。
一方、部署をまたいで広げようとすると論点が変わります。
どの業務ルールを共有スコープに置くか、外部接続や自動実行をどこまで許可するか、誰がレビューするか。業務設計とガバナンスの話になるからです。
この段階の主な進め方を3つご紹介します。
- 担当者が自走して社内に広める
- ルールとガイドラインを整備してから展開する
- 外部の支援を受けて設計と教育を同時に進める
どれが適切かは、社内にAI活用の知見がどれだけ蓄積されているかで変わります。
FLINTERSでは、Claude製品・Dify・Google Workspaceなど幅広い製品環境に対応したAI研修を提供しています。組織導入におけるガバナンスやセキュリティのリスクを踏まえた設計と、お客様の環境に合わせたカスタマイズを行っています。
「個人の工夫で止まっているAI活用を部署の標準にしたい」という段階でこそ、外部の設計知見が効いてきますのでお気軽にご相談ください。
6. よくある質問（FAQ）
Q. CLAUDE.mdとは何ですか？
A. Claude Codeが会話の開始時に毎回読み込む指示書ファイルです。プロジェクトやチームのルール・前提知識を書いておくことで、毎回同じ説明をしなくて済むようになります。
Q. CLAUDE.mdを書くと、なぜ毎回同じ指示をしなくてよくなるのですか？
A. Claude Codeは会話ごとに白紙の状態から始まりますが、CLAUDE.mdの内容は開始時に自動で読み込まれるためです。一度書いておけば、以降はその前提を踏まえた状態でやり取りが始まります。
Q. CLAUDE.mdにはどんな業務ルール・トーン・出力形式を書けばいいですか？
A. 「2回以上言ったこと」を書きます。望ましい出力形式、文体・トーン、避けてほしい表現、判断に迷ったときの基準の4点を、部署でよく発生する業務ごとに書き溜めるのがおすすめです。
Q. CLAUDE.mdはどこに置けばいいですか？
A. チームで同じルールを共有したいならプロジェクトの ./CLAUDE.md、自分が関わる全案件で効かせたい個人の好みならユーザーの ~/.claude/CLAUDE.md、共有せず手元だけに置きたいメモなら ./CLAUDE.local.md です。会社全体の方針はIT部門が管理ポリシーとして配布します。
Q. CLAUDE.mdとHooksはどう違いますか？
A. CLAUDE.mdはルールを伝える仕組みで、最終的な判断はモデルに委ねられます。Hooksは決まったタイミングで処理を実行する仕組みで、確実に守らせたいことに向いています。絶対にブロックしたい操作があるなら、CLAUDE.mdではなくPreToolUse hookを使います。
Q. CLAUDE.mdはどれくらいの行数が適切ですか？
A. 公式ドキュメントでは1ファイルあたり200行未満が目安とされています。長すぎると重要なルールが埋もれ、指示の遵守度が下がるためです。超えそうな場合は .claude/rules/ に用途別に分割します。
Q. エンジニアでなくてもCLAUDE.mdは書けますか？
A. 書けます。中身はプログラムではなく、見出しと箇条書きで書かれた文章です。/init コマンドでたたき台を自動生成できるため、白紙から書き起こす必要もありません。
Q. うちは小さな部署ですが、それでも効果はありますか？
A. 一人で使う場合でも、毎回の前提説明が不要になる分の時短効果があります。人数が少ない組織のほうが、担当者の頭の中にあるルールが言語化されずに属人化しやすいため、書き出す価値は大きいといえます。
Q. セキュリティ面で気をつけることはありますか？
A. CLAUDE.md自体は文章ファイルなので、置いただけで外部に情報が送られるものではありません。ただしプロジェクトのCLAUDE.mdはチームで共有するファイルなので、共有してよい範囲の内容だけを書き、認証情報や機密情報は書き込まないでください。手元だけに置きたいメモは ./CLAUDE.local.md に分けます。組織で使うなら、どのルールを共有スコープに置くか、誰がレビューして承認するかを先に決めておきましょう。
Q. CLAUDE.mdは一度作ったら終わりですか？
A. いいえ。意図通りに伝わらなかった指示を見直し、少しずつ業務に合わせて育てていくものです。差分に気づいたら1行足す、という運用が現実的です。
まとめ
CLAUDE.mdは、Claude Codeに毎回同じ説明をし直す手間を省くための指示書です。
指示書だけを整えるのではなく、参照情報の置き場所とセットで設計し、難易度の低い定型業務から小さく始めるところに勘所があります。
まずは、あなたの部署でよく発生する業務をひとつ選び、毎回言い直している前提を3行だけ書き出してみてください。それがあなたのCLAUDE.mdの1行目になります。
個人の工夫を部署や全社の標準へ広げる段階では、業務設計とガバナンスをセットで考える必要が出てきます。
自社の業務に合わせたAI活用の進め方に迷ったら、お気軽にご相談ください。
