Skip to content

SOP-006: Memory System

DOCUMENT CONTROL

FieldValue
SOP IDSOP-006
Version1.0
StatusActive

Purpose

Configure and use Claude Code memory system for persistent context across sessions.

Memory Architecture

Claude Code maintains memory at multiple levels:

  1. Project Memory - Stored in CLAUDE.md files
  2. User Memory - Stored in ~/.claude/memory/
  3. Session Memory - Current conversation context

Managing Memory

View Current Memory

Use the slash command:

  • /memory - Show current memory state

Memory Commands

CommandAction
/memoryView memory
/memory addAdd to memory
/memory clearClear memory
/memory editEdit memory entries

CLAUDE.md Files

Project-level memory stored in CLAUDE.md:

Location hierarchy:

  • Project root: CLAUDE.md
  • Subdirectories: CLAUDE.md (scoped context)
  • User level: ~/.claude/CLAUDE.md

Example CLAUDE.md

Memory Persistence

Memory persists across:

  • Session restarts
  • Project switches
  • Claude Code updates

Memory does NOT persist:

  • Between different machines (unless synced)
  • After explicit clear

Best Practices

Memory Tips

  1. Keep CLAUDE.md focused and updated
  2. Use for project patterns and conventions
  3. Include important architectural decisions
  4. Update when tech stack changes

Verification Checklist

  • [ ] Access memory via /memory command
  • [ ] Understand CLAUDE.md hierarchy
  • [ ] Know how to add/edit memory
  • [ ] Keep memory current and relevant

Next Steps

Based on Official Claude Code Documentation