Features · Built in · since version 0.2.21
Memory (CLAUDE.md)
Give Claude standing instructions about you and your project that it reads at the start of every session.
What it is
CLAUDE.md is a plain Markdown file of notes for Claude: build commands, code style, project conventions. Claude Code loads it when a session starts, so you don't repeat yourself each time. Files can live in your home folder (for all projects), in the project (shared with the team) or in a personal CLAUDE.local.md. Claude can also keep its own notes, called auto memory, in a folder per repository.
Why it matters
- No more repeating yourselfCommands, naming rules and gotchas written once are known in every new session.
- Shared team knowledgeA project CLAUDE.md committed to the repository gives everyone's sessions the same context.
- Personal and project layersYour own preferences in ~/.claude/CLAUDE.md sit alongside the project's file instead of replacing it.
How it works
- Run /init in a project to have Claude write a starter CLAUDE.md, then edit it.
- Put instructions for all your projects in ~/.claude/CLAUDE.md and project ones in ./CLAUDE.md or ./.claude/CLAUDE.md.
- At launch, Claude Code loads the files from the working folder and every folder above it and combines them; files in subfolders load when Claude works there.
- Pull in other files with @path/to/file lines, and open the files for editing with /memory.
- Keep each file short: Claude treats it as guidance, so use permission rules or hooks for anything that must always be enforced.
Hands-on example coming
This feature has no reviewed example yet. The official documentation below has the details.
Update history
Version 0.2.107 · May 9, 2025
Updated CLAUDE.md files can import other files with @path lines.
Version 0.2.21 · by Mar 4, 2025
Introduced Already part of Claude Code when the changelog began with this version.