AIニュース

CLAUDE.mdの書き方と置き場所 Claude Codeに覚えさせる基本

Claude Code を使っていると、プロジェクトの前提や決まりごとを毎回チャットで説明し直すことになりがちです。それを一度書いて引き継がせる仕組みが CLAUDE.md で、CLAUDE.md の書き方と置き場所を押さえると、セッションをまたいで同じ前提を共有できます。この記事では Claude Code の公式ドキュメントをもとに、ファイルの種類・置き場所・書く内容を順に整理します。

この記事で分かること

  • CLAUDE.md とは何か。Claude が自分で書く自動メモリとの役割の違い
  • 管理ポリシー・ユーザー・プロジェクト・ローカルという置き場所の違い
  • /init から始める作成手順と読み込みの確認方法
  • 1ファイル200行以下という目安とよくある失敗への対策

要点

  • CLAUDE.md は、プロジェクト・個人のワークフロー・組織全体に対して Claude に永続的な指示を与えるマークダウンファイルで、Claude はすべてのセッションの開始時にそれらを読む
  • 置き場所は管理ポリシー、ユーザー指示(~/.claude/CLAUDE.md)、プロジェクト指示(./CLAUDE.md または ./.claude/CLAUDE.md)、ローカル指示(./CLAUDE.local.md)に分かれる
  • 作り方の基本は「/init で下書きを作る → 検証できる具体さに直す → /context all で読み込みを確認する」
  • 1ファイルあたり200行以下が目標。長くなったら .claude/rules/ に分けられる
  • CLAUDE.md はコンテキストとして扱われ、強制的な設定ではない。アクションをブロックしたい場合は PreToolUse hook を使う

CLAUDE.md とは Claude Code に覚えさせる指示ファイル

公式ドキュメントによると、Claude Code の各セッションは新しいコンテキストウィンドウ(AI が一度に読み込める文章の範囲)で始まり、2つのメカニズムがセッション間で知識を保持します。1つは自分で書く CLAUDE.md ファイル、もう1つは自分の修正と好みに基づいて Claude が自分自身で書く自動メモリです。

CLAUDE.md ファイルは、プロジェクト、個人のワークフロー、または組織全体に対して Claude に永続的な指示を与えるマークダウンファイルです。これらのファイルはプレーンテキストで記述し、Claude はすべてのセッションの開始時にそれらを読みます。

先に押さえておきたい前提があります。どちらのメモリも各会話の開始時に読み込まれますが、Claude はこれらをコンテキストとして扱い、強制的な設定ではありません。 アクションをブロックするには、Claude の判断に関わらず PreToolUse hook を使用するよう案内されています。CLAUDE.md のコンテンツはシステムプロンプト自体の一部ではなく、システムプロンプトの後のユーザーメッセージとして配信されます。ここから「より具体的で簡潔な指示ほど Claude はそれに従う可能性が高くなる」という書き方の原則につながります。

CLAUDE.md と自動メモリの違い

項目 CLAUDE.md ファイル 自動メモリ
誰が書くか あなた Claude
何が含まれるか 指示とルール 学習とパターン
スコープ プロジェクト、ユーザー、または組織 リポジトリごと、ワーキングツリー全体で共有
読み込まれる場所 すべてのセッション すべてのセッション(最初の 200 行または 25KB)
用途 コーディング標準、ワークフロー、プロジェクトアーキテクチャ あなたの好み、Claude に与える修正

自動メモリはローカルセッションではデフォルトで有効です。MEMORY.md の最初の 200 行、または最初の 25KB のいずれか先に来る方が、すべての会話の開始時に読み込まれます。また Claude はアーキテクチャ、ファイルパス、デバッグ修正など、コードベースから導き出せるものはすべてスキップします。Claude に何かを記憶するよう求めると自動メモリに保存されるため、指示として残したいときは「これを CLAUDE.md に追加する」と直接伝える使い方が案内されています。

何を CLAUDE.md に書くか

ドキュメントは、CLAUDE.md を「そうでなければ何度も説明し直すことになる内容を記述する場所」として扱うよう勧めています。追加するタイミングとして挙げられているのは次の4つです。

  1. Claude が同じ間違いを 2 回目に犯した場合
  2. コードレビューで Claude がこのコードベースについて知っておくべきだったことが指摘された場合
  3. 前回のセッションで入力した同じ修正または説明をチャットに再度入力する場合
  4. 新しいチームメンバーが生産性を高めるために同じコンテキストが必要な場合

書く対象は、すべてのセッションで Claude が保持すべき事実に限定します。ビルドコマンド、規約、プロジェクトレイアウト、「常に X を実行する」ルールなどです。エントリが複数ステップの手順である場合、またはコードベースの1つの部分にのみ関連する場合は、代わりにスキルまたはパススコープ付きルールに移すよう案内されています。

CLAUDE.md の置き場所を選ぶ

CLAUDE.md ファイルはいくつかの場所に配置でき、それぞれ異なるスコープを持ちます。公式ドキュメントの一覧は、ロード順に最も広いスコープから最も具体的なスコープまで並んでいます。

スコープ 場所 目的 共有対象
管理ポリシー macOS: /Library/Application Support/ClaudeCode/CLAUDE.md、Linux と WSL: /etc/claude-code/CLAUDE.md、Windows: C:\Program Files\ClaudeCode\CLAUDE.md IT/DevOps が管理する組織全体の指示 組織内のすべてのユーザー
ユーザー指示 ~/.claude/CLAUDE.md すべてのプロジェクトの個人的な設定 自分のみ(すべてのプロジェクト)
プロジェクト指示 ./CLAUDE.md または ./.claude/CLAUDE.md プロジェクトのチーム共有指示 ソース管理を通じたチームメンバー
ローカル指示 ./CLAUDE.local.md 個人的なプロジェクト固有の設定 自分のみ(現在のプロジェクト)

個人で使い始めるなら、作業するプロジェクトの ./CLAUDE.md から始めると分かりやすいでしょう。プロジェクトの指示はバージョン管理を通じてチームと共有されるため、個人的な設定ではなくプロジェクトレベルの標準に焦点を当てるよう案内されています。バージョン管理にチェックインすべきではない個人的なプロジェクト固有の設定については、プロジェクトルートに CLAUDE.local.md を作成します。これは CLAUDE.md と一緒にロードされ、同じ方法で扱われます。コミットされないよう .gitignore に追加しておきます。

読み込まれる順番と合わさり方

作業ディレクトリより上のディレクトリ階層内の CLAUDE.md および CLAUDE.local.md ファイルは起動時にロードされます。サブディレクトリ内のファイルはオンデマンドでロードされます。発見されたすべてのファイルは、互いに上書きするのではなく、コンテキストに連結されます。foo/bar/ の例では、foo/CLAUDE.md は foo/bar/CLAUDE.md の前にコンテキストに表示されるため、Claude を起動した場所に近い指示が最後に読まれます。大規模なモノレポで関係のない祖先の指示が入ってくる場合は、claudeMdExcludes 設定を使用すると、パスまたはグロブパターンで特定のファイルをスキップできます。

既定では、Claude はワーキングディレクトリまたはその上位ディレクトリに CLAUDE.md がない場合にのみ AGENTS.md を読み込みます。AGENTS.md を直接読み込むには Claude Code v2.1.277 以降が必要です。読み込むファイルを変えたい場合は、/config と入力して設定パネルを開き、Project instructions の値を設定します。

CLAUDE.md を作る手順

  1. 置き場所を決める。チームで共有するなら ./CLAUDE.md または ./.claude/CLAUDE.md に保存する
  2. /init を実行して、開始用の CLAUDE.md を自動的に生成する。Claude はコードベースを分析し、発見したビルドコマンド、テスト指示、プロジェクト規約を含むファイルを作成する
  3. CLAUDE.md が既に存在する場合、/init は上書きするのではなく改善を提案するので、その提案を確認する
  4. インタラクティブなマルチフェーズフローを使う場合は、/init を実行する前に CLAUDE_CODE_NEW_INIT 環境変数を 1 に設定する
  5. 生成されたファイルを、Claude が自分で発見しない指示で洗練させる
  6. 個人用のメモは、プロジェクトルートに CLAUDE.local.md を作成して分け、.gitignore に追加する
  7. セッションで /context all を実行し、Memory files の下のリストを確認して、ファイルがロードされたことを確かめる
  8. 編集したいときは /memory を実行する。ユーザーおよびプロジェクトスコープ全体にわたる CLAUDE.md、CLAUDE.local.md、およびその他のメモリファイルの場所がリストされ、任意のファイルを選択してエディタで開ける
  9. 運用を続けたら /doctor prompt-audit を実行して、指示ファイルの古い内容や矛盾する内容をチェックする。これには Claude Code v2.1.283 以降が必要

他のツールから移ってきた場合も /init が役に立ちます。/init を実行すると他のツールの指示ファイルが読み込まれ、関連する部分が生成された CLAUDE.md に組み込まれます。対象として .cursor/rules/ または .cursorrules の Cursor ルール、.github/copilot-instructions.md の Copilot ルールが挙げられています。

何をどう書くか 効果的な指示の型

Claude は CLAUDE.md ファイルをコンテキストとして扱うため、指示の書き方が従う信頼性に影響します。ドキュメントは、検証可能なほど具体的な指示を書くよう勧め、次の言い換えを例に挙げています。

  • 「コードを適切にフォーマットする」ではなく「2 スペースのインデントを使用する」
  • 「変更をテストする」ではなく「コミット前に npm test を実行する」
  • 「ファイルを整理しておく」ではなく「API ハンドラーは src/api/handlers/ に存在する」

共通点は、守れたかどうかを後から確かめられる形になっていることです。判断の余地が残る表現を具体的な条件やコマンド名に置き換えると、ルールとして機能しやすくなります。

200行以下に保ち構造と一貫性を守る

ドキュメントが挙げる観点はサイズ・構造・一貫性です。サイズは、CLAUDE.md ファイルあたり 200 行以下を目標にします。より長いファイルはより多くのコンテキストを消費し、遵守を減らします。構造は、関連する指示をマークダウンヘッダーと箇条書きの下にグループ化します。整理されたセクションは、密集した段落よりも Claude が従いやすくなります。一貫性も見落としやすい点で、2 つの指示が矛盾している場合、Claude は 1 つを任意に選択する可能性があります。

容量の上限も押さえておきましょう。起動時に読み込まれる各 CLAUDE.md ファイルは、ファイルサイズが 4 MiB 以下であれば、その全体が Claude に渡されます。4 MiB を超えるファイルは Claude Code がスキップし、一切読み込みません。オンデマンドで読み込まれるファイルには独自のより小さい制限があり、200K コンテキストウィンドウでは 40,000 文字が上限です。

@ とルールで分ける

CLAUDE.md ファイルは @path/to/import 構文を使用して追加ファイルをインポートできます。インポートされたファイルは他のファイルを再帰的にインポートでき、最大深度は 4 ホップです。ただし軽量化にはなりません。インポートは長いファイルを整理するのに役立ちますが、インポートされたファイルはそれをインポートする CLAUDE.md と一緒にロードされるため、コンテキストコストは削減されません。

大規模なプロジェクトの場合、.claude/rules/ ディレクトリを使用して指示を複数のファイルに整理できます。各ファイルは1つのトピックをカバーし、testing.md や api-design.md のような説明的なファイル名を持たせます。ルールは YAML フロントマターと paths フィールドを使用して特定のファイルにスコープできます。~/.claude/rules/ の個人的なルールはマシン上のすべてのプロジェクトに適用されます。

使い分けの考え方(目安)

書きたい内容 置き場所の候補 出典にある理由
チーム全員に効かせたいビルドやテストのコマンド ./CLAUDE.md または ./.claude/CLAUDE.md 指示はバージョン管理を通じてチームと共有される
全プロジェクトで通したい自分のコードスタイル ~/.claude/CLAUDE.md すべてのプロジェクトの個人的な設定が用途
コミットしたくないサンドボックス URL や推奨テストデータ ./CLAUDE.local.md 個人的なプロジェクト固有の設定。.gitignore に追加する
特定のファイルだけに効かせたい決まり .claude/rules/ の paths 付きルール 一致するファイルで作業するときのみロードされる
複数ステップの手順やコードベースの一部だけの内容 スキル 呼び出すときまたは関連していると判断されたときにのみロードされる

そのまま使えるプロンプト例

場面:初めてのプロジェクトで CLAUDE.md を整えたい
前提:このリポジトリのルートで /init を実行し、CLAUDE.md が生成済みです。
依頼:生成された CLAUDE.md を次の方針で書き直す案を出してください。
- 見出しと箇条書きでグループ化する(ビルド / テスト / 命名規約)
- 曖昧な表現は、検証できる具体的な指示に言い換える
- 全体で 200 行以下に収める
出力の形:修正後の CLAUDE.md 全文と、削った項目の一覧。提案だけ見せてください。
場面:同じ修正を 2 回目に指示したので覚えさせたい
今回の指摘:コミットの前にテストを実行してほしい。
依頼:この指摘を CLAUDE.md に追加してください。
条件:実行するコマンド名まで書いた 1 行にし、関係する見出しの下に入れる。
既にある項目と矛盾していないか確認し、矛盾があれば先に教えてください。
出力の形:追加する箇所の差分と、追加先の見出し名。
場面:メモが増えてきたので置き場所を振り分けたい
前提:チームで共有するリポジトリで、自分用のメモも混ざっています。
依頼:次のメモを CLAUDE.md、CLAUDE.local.md、.claude/rules/ の
どこに置くべきか振り分けてください。
1. テストは npm test で実行する
2. 自分の検証用サンドボックスの URL
3. API を書くときの入力チェックの決まり
出力の形:メモ番号 / 置き場所 / 理由を 1 行ずつの表で。

よくある失敗と対策

置き場所が違って読まれていない

意図したファイルがロードされていないと、書いた内容は反映されません。デバッグの第一歩として /context all を実行し、Memory files の下のリストを確認します。そこにないファイルがある場合、Claude はそれを見ることができません。作業ディレクトリのサブディレクトリにある CLAUDE.md は起動時ではなくオンデマンドで読み込まれるため、Memory files の下には表示されず、読み込まれるとそのパスを含む Loaded 行がターミナルに表示されます。

書き方が曖昧で守られない

Claude は CLAUDE.md を読んで従おうとしますが、特に曖昧または矛盾した指示の場合、厳密な準拠を保証することはできません。 対策は指示をより具体的にすることです。各コミットの前やファイル編集後など特定の時点で実行する必要があるものは、代わりにフックとして記述します。フックはシェルコマンドとして固定されたライフサイクルイベントで実行され、Claude が何をすることに決めたかに関係なく適用されます。

ファイルが長くなりすぎる

200 行を超えるファイルはより多くのコンテキストを消費し、準拠を減らす可能性があります。指示ファイルのいずれかが推奨される長さを超えている場合、起動時と /status の実行時に警告が表示されます。対策は、パススコープルールで一致するファイルのときだけ読み込ませるか、すべてのセッションで必要でないコンテンツをトリミングすることです。/doctor チェックアップは、ディレクトリレイアウトや依存関係リストのようにコードベースから派生できるコンテンツを削除し、落とし穴や根拠を残すよう提案します。

指示どうしが矛盾している

複数のファイルに書き足していくと、同じ動作に別の指示が出てくることがあります。2 つの指示が矛盾している場合、Claude は 1 つを任意に選択する可能性があります。Claude Code はプロジェクトルールの前にユーザーレベルルールをロードし、どちらのセットも他方を上書きしないため、2つを一貫性のあるものに保つ必要があります。定期的に /doctor prompt-audit を実行すると、古いモデル用に書かれた指示や、存在しないファイルまたはコマンドへの参照、互いに矛盾するファイルを探してレポートしてくれます。

職種別の使い方の例

ここからは出典にある機能の範囲で考えた使い方の例です。自分の仕事に合わせて読み替えてみてください。

営業の例

提案資料の文面や定型文の決まりを毎回説明し直しているなら、その決まりを CLAUDE.md に1行ずつ書いておく、という使い方が考えられます。「見出しは体言止めにする」のように、守れたか確認できる形にすると、検証可能なほど具体的に書くという原則に合います。自分だけの表現の好みは ~/.claude/CLAUDE.md に、チーム共通の表記ルールはプロジェクトの CLAUDE.md に分ける整理もできます。

事務の例

データ整理や月次の集計など、同じ前提を毎月説明するケースでは、ファイルの置き場所や命名の規約を CLAUDE.md に残しておくとよいでしょう。ただし複数ステップの手順はスキルに移すよう案内されているため、「毎回同じ前提」と「そのときだけの手順」を分けて考えるのが安全です。自分の検証用データの場所などは CLAUDE.local.md に置く形が合います。

企画の例

調査メモや議事録の書式を揃えたい場合は、箇条書きの粒度や見出しの付け方を CLAUDE.md に書いておく例が考えられます。ファイル種別ごとに書式が違うなら、.claude/rules/ に paths 付きのルールを作り、該当するファイルを扱うときだけ読み込ませる方法が用意されています。

よくある質問

CLAUDE.md はどこに置けばいいですか

プロジェクト用なら ./CLAUDE.md または ./.claude/CLAUDE.md に保存できます。すべてのプロジェクトに効かせたい個人設定は ~/.claude/CLAUDE.md、コミットしたくないプロジェクト固有の個人設定はプロジェクトルートの CLAUDE.local.md が用途として挙げられています。組織全体の指示は管理ポリシーの場所に置き、MDM やグループポリシーなどで配布する方法が案内されています。

CLAUDE.md は何行くらいが目安ですか

CLAUDE.md ファイルあたり 200 行以下を目標にするよう書かれています。より長いファイルはより多くのコンテキストを消費し、遵守を減らします。コードベースの一部にのみ関連する指示は、パススコープ付きルールに移すと、一致するファイルで作業するときだけロードされます。

/init を実行すると既存の CLAUDE.md は上書きされますか

CLAUDE.md が既に存在する場合、/init は上書きするのではなく改善を提案します。新規の場合はコードベースを分析し、発見したビルドコマンド、テスト指示、プロジェクト規約を含むファイルを作成します。そこから、Claude が自分で発見しない指示を足して洗練させる流れが示されています。

AGENTS.md がある場合はどちらが読まれますか

既定では、Claude はワーキングディレクトリまたはその上位ディレクトリに CLAUDE.md がない場合にのみ AGENTS.md を読み込みます。両方を一緒に読ませたい場合は、/config の設定パネルで Project instructions を claude-md-and-agents-md に設定します。この値では、CLAUDE.md と AGENTS.md を一緒に、各ディレクトリの CLAUDE.md ファイルを最初に読み込みます。

書いた指示が守られないときはどうすればいいですか

まず /context all を実行し、Memory files の下に対象ファイルがあるか確認します。次に指示をより具体的にし、ファイル全体で矛盾する指示を探します。特定の時点で実行させたい内容はフックとして記述する、ブロックしたいアクションは PreToolUse hook を使う、という案内も合わせて確認しておくとよいでしょう。

会社やチームで使うなら

CLAUDE.md の価値は、チームで同じ前提を共有できるところにあります。プロジェクト指示はソース管理を通じてチームメンバーと共有されるため、ビルドコマンドや命名規約を1か所にまとめておくと、新しく入った人の立ち上がりにも使えます。あわせて .claude/settings.json をコミットして、リポジトリをクローンするすべての人が同じ権限、フック、およびプラグインを取得するようにできます。法人での導入や研修を検討しているなら、法人向けAIリスキリングサービスで導入社数No.1(東京商工リサーチ・2026年3月末時点)の株式会社デジライズに相談できます(デジライズ)。

あわせて読みたい

まとめ

CLAUDE.md は、Claude に永続的な指示を与えるマークダウンファイルで、すべてのセッションの開始時に読まれます。置き場所は管理ポリシー、ユーザー、プロジェクト、ローカルに分かれ、発見されたすべてのファイルは上書きではなくコンテキストに連結されます。書き方の要点は、検証可能なほど具体的に書くこと、1ファイル200行以下に保つこと、矛盾を定期的に点検することの3つです。Claude Code のメモリ設計を体系的に学びたいときは、デジライズAIスクールのコース一覧や料金プランから「3.コンテキストと文脈設計 ~ Claude~」のような講座を確認してみてください。

出典


この記事は、各社の公式のヘルプ・ドキュメントや公的機関の資料をもとに AI で下書きし、出典の本文との照合とGoogle 検索による事実確認(ファクトチェック)を通ったものだけを公開しています。料金や機能は変わることがあるため、使う前に公式ページで最新の情報を確かめてください(2026年11月8日時点)。

CLAUDE.mdの書き方と置き場所|Claude Code | デジライズAIスクール