CLAUDE.md

エージェントが指示されなくても知っておくべきこと、例えばビルド・テストコマンド、規約、アーキテクチャ上の決定、手を付けない項目などが記載されています。Claude Code はプロジェクトルートの ./CLAUDE.md または ./.claude/CLAUDE.md、個人用デフォルトの ~/.claude/CLAUDE.md、組織全体で管理されたファイルを読み込み、上書きせずにすべて結合します。サブディレクトリのファイルは、そのディレクトリ内で Claude が何かを読み取るときに後からロードされます。

コストは見積もりが甘くなりがちで、ファイルはシステムプロンプトの後にメッセージとしてセッションに組み込まれ、すべてのリクエストがコンテキスト全体を再送するため、各行は毎ターン課金され、キャッシュが有効な間は安価ですが再構築時は全額またはそれ以上になり、月に一度だけ重要なセクションでもすべてのセッションのリクエストで課金されます。

Anthropic のドキュメント（2026年9月時点）は CLAUDE.md を 200 行未満に保つことを推奨しており、長いファイルはコンテキストを多く消費し遵守度が低下すると指摘しています。@path インポートでファイルを分割すると整理はできてもサイズは減らず、インポートされたファイルも起動時にロードされます。サイズを縮小するには、ワークフロー固有の指示をスキルやパススコープのルールに移し、必要なときだけロードさせ、保守者向けメモをブロックレベルの HTML コメントに入れて Claude Code がモデルに渡す前に除去させる方法があります。

知っておくべき挙動が二つあります。プロジェクトルートのファイルは /compact 後も残りますが、Claude Code がディスクから再読み込みするためです。また、セッション中に編集した場合は、セッション開始時に一度だけ読み込まれるため、次の /clear、/compact、または再起動まで反映されません。/context は実際にロードされたメモリファイルを一覧表示します。