Claude Code の CLAUDE.md に何を書くと効くのか（1年運用した実測）

Claude Codeの「CLAUDE.md」の書き方について、1年間の運用実績から考察。出力の安定には「禁止事項」の記述が「好み」よりも効果的であり、想像と逆の効果があったことを実測データと共に解説。具体的な運用方法を示す。

• Claude CodeのCLAUDE.mdファイルにおいて、「好み」より「禁止事項」を具体的に記述する方がAIの出力安定に効果的であることが判明した。
• 「絶対禁止」としてCSSの直書き禁止やstyle属性の使用禁止などを明記することで、AIの意図しない挙動や出力のブレが大幅に減少した。
• プロジェクト固有の表記揺れや命名規則、コンポーネントの粒度などの「決定事項」を明記することで、AIが迷うポイントを減らし、作業効率を向上させる。
• AIが判断に迷う可能性のある「分岐点」について、情報不足の場合は「要確認」とするなどの指示を事前に記述しておくことが有効である。
• CLAUDE.mdには案件固有の前提条件に絞り、一般的なことは書かない、または別ファイルに参照させることで、情報過多によるルールの埋没を防ぐ。