CLAUDE.md の書き方:ユーザー・プロジェクト・ディレクトリの 3 階層と実例テンプレート

前提が公式ドキュメントと異なります。CLAUDE.md は システムプロンプトには入っていません。公式のメモリのドキュメントにこう書かれています。

CLAUDE.md content is delivered as a user message after the system prompt, not as part of the system prompt itself. Claude reads it and tries to follow it, but there's no guarantee of strict compliance, especially for vague or conflicting instructions.

(CLAUDE.md の内容は、システムプロンプトの一部ではなく、システムプロンプトの 後ろに置かれるユーザーメッセージ として渡されます。Claude はそれを読んで従おうとしますが、厳密な遵守は保証されません。曖昧な指示や矛盾する指示では特にそうです。)

つまり「システムプロンプトに入っているのだから必ず適用されるはず」という期待が、設計と合っていません。読み込まれていること自体は /context の Memory files で確認できます。そこに出ていれば、Claude は見えています。

遵守率を上げる方法として、ドキュメントは次を挙げています。

• 指示を具体的にする。「コードを整形する」ではなく「2 スペースのインデントを使う」のように検証できる書き方にする
• CLAUDE.md 同士、サブディレクトリの CLAUDE.md、.claude/rules/ の間で矛盾していないか見直す。矛盾があると Claude はどちらかを任意に選びます
• 1 ファイル 200 行未満に収める。長いファイルはコンテキストを多く消費し、遵守率を下げると明記されています

特定の時点で必ず実行されなければならない指示(コミット前、ファイル編集後など)は、文章ではなくフックとして書きます。フックはライフサイクルの決まった時点でシェルコマンドとして実行され、Claude の判断に関係なく適用されます。

本当にシステムプロンプトのレベルに置きたい場合は、起動時に --append-system-prompt を渡します。対話利用よりスクリプトや自動化に向いた方法です。

CLAUDE.md にできるのは「Claude が何をしようとするか」を変えることまでで、「何が許されるか」を決める仕組みではありません。公式の権限ドキュメントにこう明記されています。

Permission rules are enforced by Claude Code, not by the model. Instructions in your prompt or CLAUDE.md shape what Claude tries to do, but they don't change what Claude Code allows.

(権限ルールを強制するのは Claude Code であって、モデルではありません。プロンプトや CLAUDE.md の指示は Claude が何をしようとするかを左右しますが、Claude Code が何を許すかは変えません。)

つまり「明示的な合図がないかぎり実行しない」のようなルールは、CLAUDE.md に書いただけでは保証されません。読み込まれてはいるが、守るかどうかはモデルの判断に委ねられます。同じドキュメントは、実際に強制する手段として /permissions、権限ルール、権限モード、PreToolUse フックの 4 つを挙げています。

確実に止めたい操作があるなら、settings.json の permissions に書きます。評価の順序は deny → ask → allow で、最初に一致したルールが結果を決めます。ルールの具体性は順序を変えないので、広い deny は狭い allow より優先されます。

{
  "permissions": {
    "ask": [
      "Bash",
      "Edit"
    ],
    "deny": [
      "Bash(rm -rf *)"
    ]
  }
}

条件がもっと複雑な場合は PreToolUse フックを使います。公式ドキュメントによると、PreToolUse フックはツール呼び出しのたびに、権限の確認プロンプトより前に実行され、その出力で呼び出しを拒否する・確認を強制する・確認を飛ばすのいずれかを選べます。終了コード 2 で終わると、権限ルールの評価より前にツール呼び出しが止まります。

なお、フックの判断は権限ルールを飛び越えません。deny ルールと ask ルールはフックの戻り値に関係なく評価され、一致する deny があれば呼び出しは止まり、一致する ask はフックが "allow" を返しても確認を出します。

セッションをまたいで挙動が揺れる点についても、CLAUDE.md は毎回読み込まれますが、過去の文脈の要約をどう扱うかはモデル側の判断です。ここを固定したい場合も、文章ではなく permissions かフックで縛るのが確実です。

詳しい手順は Claude Code の settings.json で権限を設定する を参照してください。