Claude Codeを使い始めると「毎回同じ説明をしている」「AIが会社のルールを知らない」という壁に当たります。解決策がCLAUDE.mdです。会社の基本情報、文体のルール、禁止事項を書いておくと、Claude Codeは起動のたびにそれを読み込んだうえで作業します。プログラミングの知識は不要で、テキストが書ければ始められます。
本記事は、Anthropicが公開しているClaude Codeの公式ドキュメント(メモリのページ)を2026年11月13日に確認し、その内容に沿って書いています。ツールの更新で仕様が変わることがあるため、最新の挙動は公式ドキュメントでご確認ください。なお、claudecode道場はAnthropic公式のサービスではなく、malna株式会社が提供する教材です。
目次
- CLAUDE.mdとは何か
- 置き場所と読み込まれる順序
- まず作る:/initと最小の書き方
- 何を書くか
- 効く書き方と、効かない書き方
- テンプレート(業種別)
- 他のファイルを取り込む(@構文)
- rules・skills・hooksとの使い分け
- auto memoryとの違い
- チームで共有する方法
- 効かないときの確認手順
- よくある質問
- まとめ
この記事の結論: CLAUDE.mdは、Claude Codeに毎回覚えていてほしいことを渡すためのテキストファイルで、会社の基本情報・文体・禁止事項から書き始めます。具体的に、1ファイル200行未満を目安に短く、矛盾なく書くのが基本です。ただしCLAUDE.mdは強制ではなく文脈として扱われるため、厳密に守らせたい処理はhooksで実装します。
1. CLAUDE.mdとは何か
CLAUDE.mdは、Claude Codeに「毎回覚えていてほしいこと」を渡すためのMarkdown形式のテキストファイルです。公式ドキュメントには、Claude Codeのセッションは毎回まっさらなコンテキストウィンドウから始まり、セッションをまたいで知識を持ち越す仕組みは2つあると書かれています。1つが自分で書くCLAUDE.md、もう1つがClaudeが自分でメモを残すauto memoryです。
大事な前提が1つあります。公式は、CLAUDE.mdを「強制される設定」ではなく「コンテキスト(文脈)」として扱うと説明しています。AIはこれを読んで従おうとしますが、厳密な遵守は保証されません。必ず守らせたい処理は、後述するhooksで実装します。
CLAUDE.mdの内容は、システムプロンプトの一部ではなく、その後に届くユーザーメッセージとして渡される、とも公式に書かれています。つまり「指示書として渡される参考資料」と捉えると、書き方の判断がしやすくなります。
claude.aiのProjectsも似た目的の機能ですが、別の機能です。CLAUDE.mdはClaude Codeが読むファイルなので、ターミナルやフォルダ単位で作業するならCLAUDE.md、ブラウザ中心ならProjectsが入口になります。ProjectsはClaude Code Projectsの完全活用法で扱っています。
2. 置き場所と読み込まれる順序
公式ドキュメントでは、CLAUDE.mdの置き場所は4種類あります。
| 範囲 | 場所 | 用途 |
|---|---|---|
| 組織の管理ポリシー | macOS: /Library/Application Support/ClaudeCode/CLAUDE.md、Linux・WSL: /etc/claude-code/CLAUDE.md、Windows: C:\Program Files\ClaudeCode\CLAUDE.md | 組織全体の方針(IT部門などが管理) |
| ユーザー | ~/.claude/CLAUDE.md | 自分の好み。全プロジェクトに適用 |
| プロジェクト | ./CLAUDE.md または ./.claude/CLAUDE.md | チームで共有する指示 |
| ローカル | ./CLAUDE.local.md | 自分だけのプロジェクト固有メモ。.gitignoreに追加する |
読み込みのルールは次のとおりです。
- 作業ディレクトリと、その上位のディレクトリにあるCLAUDE.mdとCLAUDE.local.mdが起動時に読み込まれます
- 見つかったファイルは上書きではなく連結されます。順序は「ファイルシステムの根に近い方から、作業ディレクトリに近い方へ」で、近いものほど後に読まれます
- 同じディレクトリでは、CLAUDE.local.mdがCLAUDE.mdの後に追加されます
- 作業ディレクトリより下のサブフォルダにあるCLAUDE.mdは、起動時ではなく、Claudeがそのフォルダのファイルを読んだり編集したりしたときに読み込まれます
実際に読み込まれたかは、セッション内で/context allを実行し、「Memory files」の一覧で確認できます。/memoryでも一覧の表示と編集ができます。
3. まず作る:/initと最小の書き方
最初の一枚は/initで作れます。公式ドキュメントによると、/initはコードベースを解析し、ビルドコマンドやテスト手順など、見つけた規約を含む初期のCLAUDE.mdを自動生成します。すでにCLAUDE.mdがある場合は、上書きせず改善案を出します。生成後に、Claudeが自力では発見できない情報を足して磨いていく流れです。
コードを扱わない業務の方は、/initを使わず手で書き始めても構いません。メモ帳を開き、会社名・業種・文体のルールを3行書き、CLAUDE.mdという名前でプロジェクトのフォルダに保存すれば、次の起動から読み込まれます。
4. 何を書くか
公式ドキュメントには、CLAUDE.mdに追記するタイミングの目安が載っています。
- Claudeが同じ間違いを2回したとき
- コードレビューなどで「このプロジェクトなら知っているべきこと」を指摘されたとき
- 前回のセッションと同じ訂正をまた入力しているとき
- 新しく入ったメンバーにも同じ説明が必要なとき
つまり「毎回説明し直していること」が書く候補です。業務での優先度は次のように整理できます。
必ず書く
- 会社・組織の基本情報(会社名、業種、主要サービス、ターゲット顧客)。ないとAIは毎回「どんな会社か」を推測します
- 文体・スタイル(です・ます体、結論先出し、箇条書きの使い方)
- 禁止事項(競合名を書かない、効果を断定しない、価格は「〜円程度」とする)
できれば書く
- 専門用語・社内用語と正式表記
- よく作る文書のフォーマット(議事録の項目など)
- 判断基準(迷ったときはどちらを優先するか)
余裕があれば
- セキュリティ上の注意(個人情報を外部サービスに送らない)
- よく参照する資料の場所
逆に、一部の業務にしか関係しない手順や、複数ステップの手続きは、skillsやrulesに移すのが公式の推奨です(第8章)。
5. 効く書き方と、効かない書き方
公式ドキュメントの「効果的な指示の書き方」は、次の3点に集約できます。
具体的で、確認できる形で書く。 公式の例は「2スペースでインデントする」が「コードを整形する」より効く、というものです。業務なら次のようになります。
| 弱い書き方 | 強い書き方 |
|---|---|
| 丁寧な文章を書く | 社外向けメールは「お世話になっております」で始める |
| 数字を正確に | 数値には必ず単位(円、%、名)を付ける |
| 整理して書く | 議事録は「日時・参加者・決定事項・宿題」の順で書く |
短く、構造化する。 公式の目安は、1ファイル200行未満です。長いと消費するコンテキストが増え、指示が守られにくくなると書かれています。見出しと箇条書きでグループ化した方が、密な文章よりClaudeに伝わります。
矛盾を残さない。 2つの指示が食い違うと、Claudeはどちらかを任意に選ぶ可能性があります。複数のCLAUDE.mdやrulesを使っている場合は、定期的に古い指示と矛盾を点検してください。公式には、/doctor prompt-audit(v2.1.283以降)で、古い指示・存在しないファイルへの参照・ファイル間の矛盾を検査し、修正案を出させる方法も紹介されています。修正はClaudeに依頼するまで適用されません。
6. テンプレート(業種別)
自社の状況に合わせて書き換えてください。最初は短くて構いません。
営業・コンサルティング向け
# 会社基本情報
- 会社名: 〇〇コンサルティング株式会社
- 業種: 経営コンサルティング
- 主なサービス: 中小企業の事業再生・組織改革支援
# 私の役割
- 職種: コンサルタント
- 主な業務: 課題分析・提案書作成・議事録管理
# 文体ルール
- 社外文書: 丁寧・簡潔・結論先出し
- 社内文書: 簡潔・箇条書き優先
- 数値には必ず単位をつける(〇万円、〇%、〇名)
# フォーマット
- 提案書: 課題定義→現状分析→解決策→期待効果→スケジュール
- 議事録: 日時・参加者・決定事項・宿題(担当者と期限付き)
人事・採用向け
# 会社基本情報
- 会社名: 〇〇株式会社
- 業種: IT・SaaS
- 採用対象: エンジニア・営業・マーケティング
# 文体ルール
- 候補者へのメール: 親しみやすく、礼儀は保つ
- 社内レポート: 数値重視・箇条書き
- 求人票: 職務内容を具体的に。業界用語を使いすぎない
# 禁止事項
- 候補者に具体的な年収を確約する表現を使わない
- 個人情報(住所・生年月日など)をメール本文に含めない
マーケティング向け
# 会社基本情報
- 会社名: 〇〇株式会社
- 業種: 消費財メーカー
- ターゲット顧客: 30〜50代の健康意識が高い女性
# 文体ルール
- SNS投稿: 親しみやすく・短く・行動を促す
- メルマガ: 読者目線・1通1メッセージ
- 広告コピー: 顧客にとっての利点を前面に
# 禁止表現
- 「確実に痩せる」「必ず効果が出る」などの断定表現
- 薬機法・景品表示法に触れるおそれのある表現
7. 他のファイルを取り込む(@構文)
CLAUDE.mdの中に@path/to/fileと書くと、そのファイルが展開され、CLAUDE.mdと一緒にコンテキストへ読み込まれます。公式ドキュメントの記載は次のとおりです。
- 相対パスと絶対パスの両方が使えます。相対パスは、作業ディレクトリではなく、importを書いたファイルの位置が基準です
- 取り込んだファイルが、さらに別のファイルを取り込むこともできます。深さは最大4段までです
- コードスパン(バッククォート)やコードブロックの中の
@は取り込みとして扱われません。パスを文字のまま書きたいときはバッククォートで囲みます - 作業ディレクトリの外にあるファイルを初めて取り込むときは、承認ダイアログが表示されます
会社概要は @docs/company.md、用語集は @docs/glossary.md を参照。
# 個人設定
- @~/.claude/my-preferences.md
注意点として、公式は「importは長いファイルを整理する助けにはなるが、コンテキストの消費は減らさない」と明記しています。取り込んだファイルも一緒に読み込まれるためです。分量を減らしたいなら、rulesやskillsに分けます。
8. rules・skills・hooksとの使い分け
CLAUDE.mdに何でも書くのではなく、性質に応じて置き場所を分けます。公式ドキュメントの説明をもとに整理します。
| 仕組み | 読み込まれるタイミング | 向いているもの |
|---|---|---|
| CLAUDE.md | 毎セッションの開始時 | 常に守ってほしい事実とルール(会社情報、文体、禁止事項) |
.claude/rules/ | pathsの指定がなければ起動時。指定があれば該当ファイルを扱うとき | 話題別に分けたルール、特定の種類のファイルだけに効くルール |
| skills | 自分で呼び出したとき、またはClaudeが関連すると判断したとき | 複数ステップの手順、特定の業務だけの手順書 |
| hooks | 決まったタイミングでシェルコマンドとして実行 | 「コミットの前に必ず」のように、AIの判断に関係なく強制したい処理 |
.claude/rules/は、プロジェクトの.claude/rules/フォルダに、1テーマ1ファイルのMarkdownを置く方式です。フォルダ内は再帰的に探索されます。先頭にpathsを書くと、そのパターンに合うファイルをClaudeが扱うときだけ読み込まれます。
---
paths:
- "docs/contracts/**/*.md"
---
# 契約書ドラフトのルール
- 金額は税込・税抜を必ず併記する
公式によると、ルールで読み取られるフロントマターはpathsだけで、それ以外の項目は無視されます。
使い分けの目安は、公式の「CLAUDE.mdには、毎セッション保持してほしい事実を書く。複数ステップの手順や、一部にだけ関係する内容はskillsかpath指定のrulesへ移す」という考え方です。skillsはClaude Code Skillsガイド、hooksはClaude Code Hooksの使い方ガイドで詳しく扱っています。
9. auto memoryとの違い
公式ドキュメントは、CLAUDE.mdとauto memoryを「補完し合う2つの記憶の仕組み」として並べています。
| CLAUDE.md | auto memory | |
|---|---|---|
| 誰が書くか | 自分 | Claude |
| 中身 | 指示とルール | 学んだことやパターン |
| 範囲 | プロジェクト、ユーザー、組織 | リポジトリ単位(worktree間で共有) |
| 読み込み | 毎セッション | 毎セッション(MEMORY.mdの先頭200行または25KBまで) |
auto memoryはClaudeが「今後の会話で役に立つ」と判断した内容を保存します。公式では、保存先は~/.claude/projects/<project>/memory/で、MEMORY.mdが索引の役割を持ち、種類としてuser・feedback・project・referenceの4つがあると説明されています。保存内容は普通のMarkdownで、/memoryから確認・編集・削除できます。ローカル環境専用のため、別のPCとは共有されません。
使い分けはシンプルです。ルールとして必ず従わせたいことは自分でCLAUDE.mdに書き、「こう直された」という学びはauto memoryに任せます。「これをCLAUDE.mdに追加して」とClaudeに頼めば、CLAUDE.mdへの追記もできます。
なお、/compact(会話の圧縮)の後も、プロジェクト直下のCLAUDE.mdはディスクから再読み込みされて残ります。一方、会話の中でだけ伝えた指示は失われることがあります。残したい指示はCLAUDE.mdに書いてください。コンテキストの扱いはClaude Codeのコンテキストウィンドウ解説も参考になります。
10. チームで共有する方法
プロジェクトのCLAUDE.mdをGitで共有する。 公式ドキュメントでは、プロジェクトのCLAUDE.mdは「バージョン管理を通じてチームで共有する」ものと位置づけられています。リポジトリに含めれば、メンバー全員が同じ指示を読み込みます。Gitを使わない組織は、共有フォルダに置いてメンバーが同じ場所に配置する運用でも成り立ちます。
個人の好みはCLAUDE.local.mdに分ける。 チームで揃える内容はCLAUDE.md、個人の設定はCLAUDE.local.mdに置き、後者は.gitignoreに追加します。
複数のAIツールを使う場合は、正本を1つにする。 malnaでは、Claude CodeやCodexなど複数のAIツールで共通の判断基準を使うため、共通の指示を1つの正本ファイルに置き、ツールごとの差分と結合して各ツールの指示ファイルを自動生成して配布する運用にしています。生成物を直接編集しない、という設計にしているのは、ツールごとに内容がずれていくのを防ぐためです。
公式にも、複数のツールで1つのファイルを共有する方法があります。リポジトリにAGENTS.mdがある場合、CLAUDE.mdが存在しなければClaude CodeはAGENTS.mdを読みます(v2.1.277以降)。両方ある場合は、既定ではCLAUDE.mdだけが読まれるため、CLAUDE.mdの中で@AGENTS.mdと書いて取り込み、Claude専用の指示はその下に書く方法が紹介されています。
11. 効かないときの確認手順
公式の確認手順を、順番に整理します。
/context allを実行し、「Memory files」にそのCLAUDE.mdが出ているか確認する。出ていなければClaudeには見えていません- サブフォルダのCLAUDE.mdは起動時には一覧に出ません。そのフォルダのファイルを読ませたときに読み込まれます
- 指示を具体的にする(「きれいに書く」ではなく数値や形式で)
- 複数のCLAUDE.mdやrulesの間で矛盾がないか確認する
- 特定のタイミングで必ず実行したい処理は、hooksに移す
分量にも上限があります。公式によると、1つのCLAUDE.mdが200行を超えると警告が表示され、4MiBを超えるファイルは読み込まれません。サブフォルダのCLAUDE.mdなど、必要になったときに読み込まれるファイルには1ファイルあたりの文字数の上限があり、200Kのコンテキストウィンドウでは40,000文字です。
12. よくある質問
Q. CLAUDE.mdは何文字くらいが適切ですか。 公式の目安は1ファイル200行未満です。文字数の推奨は公式には見当たりません。最初は数行から始め、同じ訂正を繰り返したときに1行ずつ足す方法が現実的です。
Q. AGENTS.mdとCLAUDE.mdは何が違いますか。
AGENTS.mdは複数のコーディングツールが共通で読む指示ファイルとして使われています。Claude Codeは、CLAUDE.mdがなければAGENTS.mdを読み、両方ある場合は既定ではCLAUDE.mdだけを読みます。/configの「Project instructions」で挙動を変更できます。
Q. 書いたのに守られません。 CLAUDE.mdは強制ではなく文脈として扱われるため、曖昧な指示や矛盾する指示は守られにくくなります。第11章の手順で確認し、必ず守らせたい処理はhooksにします。
13. まとめ
CLAUDE.mdは、毎回の説明をなくすための最初の一手です。要点は次の4つです。
- 置き場所は4種類あり、近いものほど後に読まれる。サブフォルダのものは必要になったときに読み込まれる
- 具体的に、短く(目安は200行未満)、矛盾なく書く
- 手順はskills、ファイル別のルールはrules、強制したい処理はhooksに分ける
- 学びの蓄積はauto memoryに任せ、ルールは自分でCLAUDE.mdに書く
本記事の仕様は、2026年11月13日時点で公式ドキュメントを確認した内容です。
claudecode道場では、CLAUDE.mdの書き方からProjectsの設定まで、Claude Codeを自社仕様にカスタマイズする方法を体系的に学べます。非エンジニアのビジネスパーソンが実務で使えるレベルになることを最優先に設計されています。




