CLAUDE.mdの書き方：効果が出る3種類の指示

2026年5月16日更新 2026年10月12日

この記事で学べること

CLAUDE.mdは、Claude Codeにプロジェクトの前提や方針を伝える文書です。会話ごとに説明していた約束をここへ残しておくと、次の作業でも参照できるようになります。

何でも書き込む必要はありません。このサイトで残しているのは、承認が必要な操作、用語の意味、ファイルの置き場所など、繰り返し使う前提です。以下の例を読むと、CLAUDE.mdに残す指示と、その場の会話や実行環境の設定で扱う内容を区別できます。

ここでは、プロジェクトの一番上のフォルダにCLAUDE.mdを置く構成を扱います。Claude Codeのメモリや設定には複数の適用範囲があり、作業場所や設定によって参照する指示が異なる場合があります。[1][2]

CLAUDE.mdに書いた文章は、AIがどう作業するかを判断するための指示です。特定の操作を確実に止めたい場合は、指示を書くことに加えて、実行できる操作を制限する設定が必要になります。

このサイトを作っていたとき、本番環境へのデプロイ操作は私の明示的な承認後だけにしてほしい、と会話で伝えていました。しかし、プロジェクトの指示ファイルには書いておらず、別の作業中に本番向けビルドを実行しようとする場面が複数回ありました。

そこで、CLAUDE.mdへ次のルールを追加しました。

## Non-Negotiable Rules

- `npm run build` はユーザーの明示承認なしに実行しない。本番向け成果物が生成される。

記載してからは、実行前に確認を挟む可能性が高まりました。ただし、文章だけで操作を強制停止できるわけではありません。確実に止める必要がある操作では、権限設定やHooksも併用します。Hooksは、コマンド実行の前後など、決まったタイミングで自動処理を動かす仕組みです。

このサイトでは、繰り返し使う前提を次の3種類に分けています。

禁止ルール

「本番向けビルドは承認なしに実行しない」「既存のナビゲーションを変更しない」「機密情報をコミットしない」など、避ける操作や承認条件を書きます。コミットは、ファイルの変更を履歴に保存する操作です。権限設定やHooksを併用して操作を止める場合にも、何を禁止するかを指示に残します。[2]

用語の定義

「ブログはsrc/content/blog/配下、ドキュメントはsrc/content/docs/配下を指す」のように、このプロジェクトでの意味を書きます。「記事」という言葉だけでは配置先が決まらない場合に、判断の前提をそろえられます。

ディレクトリ構造の説明

ディレクトリはファイルをまとめるフォルダです。主要なフォルダについて、何を置く場所なのかを示します。用語の定義が「ブログとは何か」を決めるのに対し、こちらは必要なファイルを探したり、作成したファイルを置いたりするための案内になります。

すべての手順をCLAUDE.mdに集めると、今の作業に関係しない指示まで長くなり、優先するルールを見つけにくくなります。

このサイトでは、プロジェクトの全体像と最重要ルールをCLAUDE.mdに残しています。詳しいルールはshared/rules/、特定の作業の手順はshared/skills/へ分け、CLAUDE.mdから参照先を示しています。

CLAUDE.mdに残すかどうかは、その前提を次の作業でも使うかで判断できます。毎回説明している禁止事項、用語、配置先は記録する意味があります。一度限りの依頼は会話で伝え、詳しい手順は別の文書へ分けると、優先する約束を見つけやすくなります。

また、指示を記録することと、操作を止めることは別です。承認が必要な操作はCLAUDE.mdで明示し、確実な停止が必要な範囲は権限設定やHooksで制御します。過去の問題と対処を残す方法は、別の記事で扱うlessons.mdにつながります。

最新のリリースやアップデートの詳細は、公式サイト・公式ドキュメントを確認してください。