Sistema de memória persistente de código aberto para Claude Code resolve a perda de contexto entre sessões

Um desenvolvedor criou um sistema de memória persistente para o Claude Code que resolve o problema comum de perder o contexto entre conversas. O sistema funciona junto com o Claude Code sem exigir plugins ou chaves de API.

Como funciona

O sistema opera através de três componentes principais:

• Durante as conversas, o Claude escreve notas de uma linha em memory/inbox.md para capturar decisões importantes, credenciais e lições aprendidas
• Uma tarefa cron noturna extrai transcrições de conversas (salvas como arquivos JSONL em ~/.claude/projects/) e combina com as entradas da caixa de entrada em um registro diário
• No início de cada nova conversa, o Claude lê os últimos 2 dias de registros através das regras do CLAUDE.md

Processo de configuração

A configuração requer etapas mínimas:

git clone https://github.com/Sunnyztj/claude-code-memory.git
cd claude-code-memory
./setup.sh ~/projects/memory
# Adicione as regras de memória ao seu CLAUDE.md
# Configure uma tarefa cron noturna

O que é lembrado automaticamente

• Decisões de arquitetura (ex: "mudou do MongoDB para PostgreSQL")
• Detalhes de implantação (ex: "IP do VPS alterado, nova configuração do Nginx")
• Lições aprendidas (ex: "Docker COPY usa root:600 por padrão, precisa de chmod")
• Informações de conta, chaves de API, marcos do projeto

Decisões de design principais

• Abordagem baseada em arquivos (não banco de dados) — permite que o Claude leia/escreva diretamente, é compatível com git e funciona offline
• Padrão de caixa de entrada — uma linha por entrada com zero atrito para captura
• Extração incremental de JSONL — rastreia deslocamentos de bytes e nunca reprocessa conversas antigas
• Baseado em cron (não em processo) — funciona com o Claude Code padrão sem plugins

O sistema funciona com qualquer configuração do Claude Code e inclui modelos opcionais de tarefas cron para usuários do ClaudeClaw (modo daemon). O desenvolvedor relata usá-lo diariamente no fluxo de trabalho de produção com melhorias significativas na retenção de contexto.