Claude Code uses a dual-memory system to balance your explicit instructions with its own learned observations.
| Feature | CLAUDE.md (Static Memory) | MEMORY.md (Auto Memory) |
|---|---|---|
| Who Writes It? | You (Manual) | Claude (Automated) |
| Content | "Project rules, architecture, tech stack." | "Patterns, ""gotchas,"" and user preferences." |
| Location | Your Project Root (git-tracked). | ~/.claude/projects/ (system-local). |
| Persistence | Permanent and shared with your team. | Local to your machine; session-dependent. |