Skip to content

Definition

A Claude Code feature that persists per-project memory across sessions in a managed directory, auto-loading an entrypoint file at the start of each session.

Key points

  • ⚠ verify (2026-07-08): introduced in v2.1.59+.
  • Stored at ~/.claude/projects/<project>/memory/, with entrypoint MEMORY.md — the first 200 lines / 25 KB of each file are loaded each session.
  • Toggle: autoMemoryEnabled (default true) in settings.json, or env var CLAUDE_CODE_DISABLE_AUTO_MEMORY=1. Directory configurable via autoMemoryDirectory.
  • Complements the CLAUDE.md Hierarchy (project instructions) and Session Resume And Fork (transcript continuation) as a third persistence mechanism.

Why it matters for the exam

  • D3 (20% of scored content) can test that auto memory exists, is on by default (autoMemoryEnabled default true), and how to disable it (setting or CLAUDE_CODE_DISABLE_AUTO_MEMORY=1).

Common gotchas

  • Only the first 200 lines / 25 KB of each memory file is loaded — long memory files are truncated.
  • Auto memory is separate from CLAUDE.md and from session resume; don't conflate the three persistence layers.
  • Version-gated (v2.1.59+) — ⚠ verify (2026-07-08).

See also

Sources