Tips // Claude in practice

Tips for working better with Claude

One short tip at a time, with an example you can copy. Move through them at random or search for what you need.

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
#claude-md#memory#monorepo#imports