Sistema de Memória
Claude Code tem um sistema de memória persistente baseado em arquivos. Salva informações entre sessões em ~/.claude/projects/<hash>/memory/.
Tipos de memória
O sistema de memória organiza informações em quatro categorias distintas:
| Tipo | Descrição |
|---|---|
user | Perfil, preferências, expertise do usuário |
feedback | Correções e confirmações de comportamento |
project | Contexto do projeto, decisões, prazos |
reference | Ponteiros para recursos externos (Jira, Slack, docs) |
Estrutura de arquivo de memória
Cada memória é um arquivo Markdown com frontmatter YAML que define tipo e nome:
---
name: user-profile
description: Developer profile and preferences
type: user
---
User is a senior full-stack developer with 10 years experience.
Expert in TypeScript and React. New to DevOps.
Prefers concise responses without trailing summaries.MEMORY.md — índice
O arquivo MEMORY.md funciona como índice central de todas as memórias do projeto:
# Memory Index
- [User Profile](user-profile.md) — senior dev, TypeScript expert
- [Project Context](project-context.md) — e-commerce app, deadline Mar 15
- [Feedback](feedback-style.md) — prefers terse responsesQuando o Claude salva memória
O Claude salva memória automaticamente em situações específicas:
- Ao aprender sobre o usuário: salva user memory
- Ao receber correção: salva feedback memory
- Ao conhecer contexto do projeto: salva project memory
- Ao descobrir recursos externos: salva reference memory
Como acessar memória — comandos /memory
Use os seguintes comandos para gerenciar suas memórias diretamente na sessão:
| Comando | Descrição |
|---|---|
/memory | Lista todas as memórias |
/memory list | Lista com detalhes |
/memory show user-profile | Mostra memória específica |
/memory forget feedback-* | Remove memórias por padrão |
# Listar todas as memórias
/memory
# Exibir detalhes de uma memória específica
/memory show user-profile
# Remover memórias por padrão glob
/memory forget feedback-*Boas práticas
- Salvar explicitamente: "Lembre-se que prefiro pnpm" → Claude salva
- Corrigir: "Não, use tabs não spaces" → Claude atualiza
- Revisar periodicamente: memórias velhas podem ficar desatualizadas
- Não salvar: código, git history, estado temporário
Exercício
Inicie uma sessão do Claude Code e diga suas preferências pessoais: linguagem favorita, estilo de código, ferramentas preferidas. Em seguida, verifique em ~/.claude/projects/*/memory/ que as memórias foram salvas corretamente como arquivos Markdown.