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

  1. Run /init in a project to have Claude write a starter CLAUDE.md, then edit it.
  2. Put instructions for all your projects in ~/.claude/CLAUDE.md and project ones in ./CLAUDE.md or ./.claude/CLAUDE.md.
  3. 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.
  4. Pull in other files with @path/to/file lines, and open the files for editing with /memory.
  5. 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

  1. Version 0.2.107 · May 9, 2025

    Updated CLAUDE.md files can import other files with @path lines.

  2. Version 0.2.21 · by Mar 4, 2025

    Introduced Already part of Claude Code when the changelog began with this version.

Official documentation