💾 O que e Auto-Memory
Auto-memory e a capacidade do Claude Code de salvar informacoes automaticamente entre sessoes. Quando ativada, o Claude detecta padroes, decisoes e preferencias durante a sessao e persiste essas informacoes para sessoes futuras.
🎯 Conceito Principal
- •Salvamento automatico: O Claude identifica e salva informacoes uteis sem que voce precise pedir
- •Persistencia entre sessoes: Informacoes salvas ficam disponiveis na proxima vez que voce abrir o Claude Code
- •Complementa CLAUDE.md: Auto-memory captura o que voce esqueceu de colocar no CLAUDE.md
- •Aprendizado continuo: A cada sessao, o Claude aprende mais sobre seu projeto e suas preferencias
💡 Dica Pratica
Auto-memory e como ter um assistente que toma notas durante a reuniao. Voce nao precisa anotar tudo porque ele esta fazendo isso por voce. Mas e importante revisar as notas de vez em quando para garantir que estao corretas.
⚙️ Como Configurar Auto-Memory
A configuracao de auto-memory e feita atraves das settings do Claude Code. Voce pode ativar, desativar e configurar o que deve ser salvo.
🎯 Conceito Principal
- •Ativacao: Use /config ou settings.json para ativar auto-memory
- •Diretorio de salvamento: As memorias sao salvas em .claude/memory/ por padrao
- •Granularidade: Voce pode configurar o nivel de detalhe: tudo, apenas decisoes importantes, ou manual
- •Escopo: Configuravel por projeto ou globalmente
💡 Dica Pratica
Ative auto-memory e use o Claude Code normalmente por uma semana. Depois revise o que foi salvo em .claude/memory/. Voce vai se surpreender com a quantidade de contexto util que ele captura automaticamente.
📋 O que o Claude Salva Automaticamente
Quando auto-memory esta ativa, o Claude salva diversos tipos de informacao que considera uteis para sessoes futuras. Entender o que e salvo te ajuda a confiar (ou nao) no que foi persistido.
🎯 Conceito Principal
- •Decisoes arquiteturais: Quando voce decide por um pattern, o Claude registra a decisao e o motivo
- •Preferencias de codigo: Estilo de nomeacao, patterns preferidos, imports habituais
- •Bugs encontrados: Problemas que foram diagnosticados e como foram resolvidos
- •Contexto de negocio: Informacoes sobre o dominio que surgiram durante conversas
💡 Dica Pratica
Nem tudo que o Claude salva e util ou correto. Faca revisoes periodicas em .claude/memory/ e delete o que nao faz sentido. E melhor ter menos memorias corretas do que muitas memorias com informacoes erradas.
📁 Diretorio .claude/memory/
O diretorio .claude/memory/ e onde as memorias automaticas sao armazenadas. Entender sua estrutura e organizacao te permite gerenciar eficientemente o que foi salvo.
🎯 Conceito Principal
- •Estrutura de arquivos: Cada memoria e um arquivo .md com data, contexto e conteudo
- •Organizacao cronologica: Memorias sao salvas com timestamp para facil rastreamento
- •Editavel: Voce pode editar, mover ou deletar qualquer arquivo de memoria
- •Git: Decida se quer versionar .claude/memory/ ou adicionar ao .gitignore
💡 Dica Pratica
Adicione .claude/memory/ ao .gitignore se as memorias contem informacoes sensiveis ou especificas da sua maquina. Versione se o time todo se beneficia das memorias compartilhadas.
🔎 Quando Confiar e Quando Editar
Auto-memory nao e infalivel. O Claude pode salvar informacoes imprecisas ou desatualizadas. Saber quando confiar e quando intervir e essencial.
🎯 Conceito Principal
- •Confie em: Decisoes explicitas que voce confirmou durante a sessao, comandos que funcionaram
- •Verifique: Inferencias sobre arquitetura, suposicoes sobre intencoes, generalizacoes
- •Edite: Memorias com informacoes desatualizadas apos refactoring ou mudancas de stack
- •Delete: Memorias de sessoes experimentais que nao refletem o estado atual do projeto
💡 Dica Pratica
Reserve 5 minutos no final de cada semana para revisar .claude/memory/. Pense nisso como 'code review das memorias'. Delete o lixo, corrija imprecisoes e mantenha so o que e util.
🔗 Integracao com CLAUDE.md
Auto-memory e CLAUDE.md sao complementares, nao concorrentes. CLAUDE.md sao instrucoes que voce define deliberadamente. Auto-memory sao informacoes que o Claude captura organicamente.
🎯 Conceito Principal
- •CLAUDE.md = intencional: Voce escreve as regras que quer que o Claude siga sempre
- •Auto-memory = organica: O Claude salva o que aprende durante as sessoes de trabalho
- •Promocao: Se uma memoria automatica e muito util, promova-a para o CLAUDE.md
- •Ciclo virtuoso: Auto-memory te mostra o que esta faltando no CLAUDE.md
💡 Dica Pratica
Use auto-memory como 'rascunho' para o CLAUDE.md. Se voce nota que o Claude salvou uma regra importante automaticamente, copie-a para o CLAUDE.md. Isso transforma uma memoria fragil em uma instrucao permanente.
Exercicio Pratico
Exercicio: Configurar Auto-Memory e Verificar Resultados
Tempo estimado: 15-20 minutos
Ativar auto-memory
Configure auto-memory no seu Claude Code usando /config ou settings.json.
Usar o Claude Code normalmente
Trabalhe no seu projeto por 3-5 sessoes fazendo tarefas variadas: criar codigo, corrigir bugs, refatorar.
Verificar memorias salvas
Abra .claude/memory/ e leia todas as memorias que foram salvas automaticamente.
Auditar e limpar
Delete memorias incorretas ou irrelevantes. Edite as que precisam de ajuste.
Promover para CLAUDE.md
Identifique 2-3 memorias que sao tao uteis que merecem ir para o CLAUDE.md e mova-as.
📋 Resumo do Modulo
Proximo Modulo:
2.6 - /init - Geracao Automatica