Sistema de Memória
~25 min Intermediário Parte 3

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:

TipoDescrição
userPerfil, preferências, expertise do usuário
feedbackCorreções e confirmações de comportamento
projectContexto do projeto, decisões, prazos
referencePonteiros 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 responses

Quando 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:

ComandoDescrição
/memoryLista todas as memórias
/memory listLista com detalhes
/memory show user-profileMostra 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.

Recursos

0%