結論
最初にやること:OSのターミナルでfind .. -name 'CLAUDE.md' -o -name 'CLAUDE.local.md'を実行します。
CLAUDE.mdは必ずルートだけに置くものではなく、Claude Codeは起動ディレクトリから上位階層を探索し、関連サブディレクトリのファイルはその配下を読むときに追加します。
個人共通の指示は~/.claude/CLAUDE.md、チーム共通はリポジトリのCLAUDE.md、個人のプロジェクトメモはCLAUDE.local.mdへ分けられます。
挙動設定は別途settings.jsonの各スコープへ配置します。
実行場所:コメントに従い、ターミナルとClaude Codeの対話画面を使い分けます。
# ターミナルで実行:対象ファイルを検索
find .. -name 'CLAUDE.md' -o -name 'CLAUDE.local.md'
# ターミナルで実行:Claude Codeを起動
claude
# Claude Code起動後の対話画面で実行:コンテキスト使用量を確認
/context
具体的な手順
リポジトリ全体に適用する最小ルールをルートの
CLAUDE.mdへ置きます。パッケージ固有のコマンドや規約はモノレポ内の各ディレクトリへ置きます。
端末固有または個人用の指示は
CLAUDE.local.mdへ分離し、共有対象から外します。
複数のメモリファイルは単純な上書きではなく連結され、起動位置に近い指示ほど後から読み込まれます。
/contextでMemory filesを確認し、不要な階層のファイルはclaudeMdExcludesで除外できます。
実践プロンプト
現在読み込まれているルールの出所を確認させます。
入力場所:Claude Codeの対話画面へ貼り付けます。
現在のコンテキストに読み込まれたメモリファイルを列挙
各ファイルについて:
- 適用範囲
- 競合する指示
- 重複する指示
- ルート、サブディレクトリ、Skillのどこへ置くべきか
まだファイルは変更しない
注意点
サブディレクトリのCLAUDE.mdが常に無視されるという説明は現行仕様と異なります。
同じルールを複数階層へ複製すると矛盾しやすいため、最も狭い適切な範囲へ一度だけ記述します。
外部ファイルのimportは初回承認が必要になる場合があるため、共有リポジトリの参照先を確認します。