CLAUDE.mdとは、Claude Codeがセッション開始時に自動で読み込むプロジェクトの指示書ファイル。プロジェクトの規約や前提をあらかじめ書いておけば、毎回説明しなくてもAIがそれに従って作業する。
解説
実務での役割は、システムプロンプトに近い。ファイル操作の範囲、命名のルール、公開前に必ず確認すべき事項など、プロジェクトごとに繰り返し伝える必要がある前提を1つのファイルにまとめておく。担当者や日をまたいでも同じ前提でAIが動くようになる。
初心者が誤解しやすいのは、CLAUDE.mdを一度書けば完成だと考えてしまう点である。実際には運用の中でルール違反や誤解が見つかるたびに追記していく性質のファイルであり、完成形を最初から目指す必要はない。育てていくドキュメントだと捉えたほうが実態に合う。
もう1つ誤解されやすいのは、CLAUDE.mdに書いたことがすべての場面で絶対に守られると考えることである。指示が長く複雑になるほど、AIが一部を見落とす可能性は残る。重要な禁止事項ほど短く明確に書き、実際の作業結果で守られているかを確認する運用が欠かせない。
実務では、プロジェクト直下に置く版とユーザー全体に効く版を使い分けることがある。プロジェクト固有のルールは前者に、どのプロジェクトでも共通して守りたい習慣は後者に書くと、重複や矛盾が減る。