CLAUDE.md: Global vs Project — What Goes Where

CLAUDE.md: Global vs Project — What Goes Where Claude Code reads CLAUDE.md at two levels. The user-global file at ~/CLAUDE.md (or ~/.claude/CLAUDE.md ) loads in every session, on every project. The project-local CLAUDE.md at the repo root loads only when you are working in that repo. Both files are read; their contents stack. The decision of which content goes where is one of the most consequential choices in the harness, and one of the easiest to get wrong. Why the split exists The split is not