Auto memory
Memories
~/.claude/projects/<project>/memory/
Vendor docs
config
| name | type | required | meaning | concept | |
|---|---|---|---|---|---|
| CLAUDE_CODE_DISABLE_AUTO_MEMORY | boolean |
To disable auto memory via environment variable, set `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1`.
|
docs ↗ | ||
| MEMORY.md | path |
The first 200 lines of `MEMORY.md`, or the first 25KB, whichever comes first, are loaded at the start of every conversation.
|
docs ↗ | ||
| autoMemoryDirectory | path |
To store auto memory in a different location, set `autoMemoryDirectory` in your `settings.json`. It is read from any settings scope: user, project, local, policy, or `--settings`.
|
docs ↗ | ||
| autoMemoryEnabled | boolean |
Auto memory is on by default. To toggle it, open `/memory` in a session and use the auto memory toggle, which saves `autoMemoryEnabled` to your user settings at `~/.claude/settings.json`. To turn it off for a single project, set `autoMemoryEnabled` in that project's settings:
|
docs ↗ | ||
| ~/.claude/projects/<project>/memory/ | path |
Each project gets its own memory directory at `~/.claude/projects/<project>/memory/`. The `<project>` path is derived from the git repository, so all worktrees and subdirectories within the same repo share one auto memory directory. Outside a git repo, the project root is used instead.
|
docs ↗ |