Você abre uma nova sessão do Claude Code. Cinco minutos depois, percebe que ele não faz a menor ideia do que você construiu ontem. Você está explicando seu sistema de autenticação novamente, redescrevendo as decisões de arquitetura da semana passada, vendo-o sugerir exatamente o refactor que você já disse que era uma má ideia. De novo.
Este é o problema fundamental do Claude Code como ferramenta standalone: cada sessão começa do zero. Para um script rápido ou uma tarefa pontual, não importa. Mas para qualquer um que trabalha em um sistema real durante dias ou semanas, essa página em branco é um assassino de produtividade.
claude-mem resolve isso. E a comunidade concorda — acabou de ultrapassar 51.600 estrelas no GitHub trending.
O que o claude-mem faz, especificamente
Criado por Alex Newman (@thedotmack), claude-mem é um plugin do Claude Code que transforma suas sessões em um sistema de memória persistente e pesquisável. Observa tudo que Claude faz, comprime de forma inteligente e injeta o contexto relevante de volta em sessões futuras — automaticamente.
A ideia central: sempre que Claude edita um arquivo, executa um comando ou toma uma decisão de arquitetura, claude-mem captura isso como uma observação — comprimida para cerca de 500 tokens usando Claude Haiku rodando de forma assincronizada em um worker em background. Essas observações são armazenadas localmente em SQLite em ~/.claude-mem/claude-mem.db. Na próxima vez que você abre uma sessão no mesmo projeto, as observações relevantes aparecem automaticamente.
Sem notas manuais. Sem manutenção de CLAUDE.md. Sem contexto que você precisa lembrar de colar.
A arquitetura: cinco hooks
claude-mem se conecta ao ciclo de vida do Claude Code em cinco pontos:
SessionStart → Carrega contexto relevante de sessões anteriores
UserPromptSubmit → Opcionalmente aumenta o prompt com histórico
PostToolUse → Captura observação após cada ação de tool
Summary → Gera resumo da sessão
SessionEnd → Comprime e persiste o estado final
O trabalho pesado ocorre em um serviço worker em background rodando na porta 37777. Isso é importante: a compressão é assincronizada, então não bloqueia sua sessão. Você trabalha normalmente; o pipeline de memória roda em paralelo.
O modelo padrão para compressão é claude-haiku-4-5 — rápido e barato, sem queimar seu orçamento de contexto principal em bookkeeping.
Instalação: dois comandos
# Em uma sessão do Claude Code:
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem
Reinicie Claude Code. Pronto. O contexto de sessões anteriores vai começar a aparecer automaticamente.
Um detalhe importante: há também um pacote npm, mas npm install -g claude-mem apenas instala a biblioteca — não registra os hooks nem inicia o serviço worker. Sempre use os comandos de plugin acima.
O que você obtém
Skill mem-search: Consulte o histórico do seu projeto diretamente no chat. Pergunte “qual decisão tomamos sobre o schema do banco de dados?” ou “trabalhamos antes no fluxo de pagamentos?” e você obtém respostas sintetizadas de observações passadas em vez de logs crus.
Web viewer: Acesse http://localhost:37777 para um stream de memória em tempo real. Cada observação listada, pesquisável, com contexto antes/depois e indicadores visuais de prioridade (
decisões críticas,
informacional,
arquitetural).
File-read gating: Quando claude-mem tem observações anteriores sobre um arquivo, bloqueia leituras redundantes e injeta o histórico de observações em seu lugar. Menos tokens desperdiçados relendo arquivos que Claude já entende.
Controle de privacidade: Envolva qualquer conteúdo em tags <private> e claude-mem não o armazena.
Sincronização entre máquinas: claude-mem-sync permite fazer push/pull de observações entre máquinas via SSH. O time testou sincronizar mais de 3.400 observações entre dois servidores — e uma sessão fresca na máquina remota usou essa memória transferida para entregar um PR real com novos recursos.
Ressalvas honestas
Duas coisas que vale a pena saber antes de instalar:
Latência. A geração de observações adiciona 60–90 segundos por uso de tool quando roda em modo background. Na maioria das sessões você não vai notar porque é assincronizado — mas em hardware lento ou com um worker ocupado, pode ser notável.
Evolui rapidamente. O changelog mostra releases semanais com mudanças breaking e correções de bugs. A v12.0.1 corrigiu problemas de confiabilidade de MCP tools que entraram na v12.0.0. É desenvolvimento ativo e saudável, mas espere ter que atualizá-lo com frequência. Verifique a página de releases antes de reportar issues.
Licença AGPL-3.0. Gratuito para usar, mas se você construir algo sobre ele, os termos AGPL se aplicam. Vale a pena ler se você o usar em um contexto comercial.
O quadro maior
Os criadores do claude-mem chamam sua abordagem de RAD — Retrieval Augmented Development. A analogia: RAG padronizou como os agentes recuperam conhecimento externo; RAD quer padronizar como os agentes recuperam sua própria memória de trabalho. Se esse enquadramento for adotado ainda está por ver, mas o problema que resolve é real e pouco atendido.
As 51K estrelas não são hype. São desenvolvedores cansados de re-explicar sua arquitetura todas as manhãs.
Instale hoje
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem
GitHub: GitHub - thedotmack/claude-mem: A Claude Code plugin that automatically captures everything Claude does during your coding sessions, compresses it with AI (using Claude's agent-sdk), and injects relevant context back into future sessions. · GitHub
Docs: https://docs.claude-mem.ai
Quantas vezes você se encontrou re-explicando para Claude Code algo que já tinha contado a semana passada? Você testou claude-mem ou alguma solução alternativa para o problema de memória entre sessões? Comente abaixo ![]()
