Claude CodeIntermediateClaude Code
CLAUDE.local.md and @imports: context without cluttering the repo
Personal notes go in CLAUDE.local.md and long documents are referenced with @path, instead of pasting them into the project's CLAUDE.md.
CLAUDE.md files do not override each other: they are concatenated from the broadest scope to the most specific. Your sandbox URLs or test data go in CLAUDE.local.md, added to .gitignore. For extensive documentation use @path/to/doc: it is loaded at startup together with the CLAUDE.md that references it. In a monorepo, the CLAUDE.md files in subfolders are only loaded when Claude works in that folder.
Example
# CLAUDE.md ## Build & Test - npm run build - npm test ## Architecture Three-line summary. Full detail: @docs/architecture.md # .gitignore CLAUDE.local.md