Faqs
Claude Code Memory Docs: CLAUDE.md, Rules, Auto Memory
Find the official Claude Code memory docs for CLAUDE.md, CLAUDE.local.md, rules, imports, and auto memory, with a practical setup map.
Claude Code Memory Official Docs
Use the official memory docs when you need source-of-truth behavior. Use this page when you need to decide which memory file to edit.
Last checked on July 7, 2026. Claude Code memory behavior can change, so verify official docs before standardizing team rules.
Quick Answer
- Official docs: Claude Code memory
- Shared project memory:
CLAUDE.md - Private local memory:
CLAUDE.local.md - Scoped rules:
.claude/rules/ - Reusable workflows with metadata: skills
- Temporary context: put it in the chat, not in memory
Memory Surfaces
| Need | Use |
|---|---|
| Team-wide project conventions | CLAUDE.md |
| Private local notes | CLAUDE.local.md |
| Directory or file scoped behavior | .claude/rules/ |
| Repeatable workflow with arguments and supporting files | Skill |
| One-off instruction for one task | Prompt text |
Common Mistakes
- Putting secrets, API keys, or private credentials in
CLAUDE.md. - Turning
CLAUDE.mdinto a long README clone. - Mixing local personal preferences into team memory.
- Using global memory for rules that should only apply to one repository.
- Forgetting to update memory after changing build, test, or deploy commands.