Sistema de Memória Baseado em Arquivos do Claude Code: Uma Alternativa Pragmática aos Bancos de Dados Vetoriais

O Claude Code usa uma abordagem baseada em arquivos para a memória do agente que substitui a configuração típica de banco de dados vetorial e embeddings. Em vez de RAG completo, ele armazena memórias como arquivos .md com pequenas seções frontmatter contendo nome, descrição e informações de tipo, além de um arquivo MEMORY.md que funciona como índice.

Como o Sistema Funciona

Em tempo de execução, o sistema não incorpora nem pesquisa tudo. Ele segue este processo:

• Escaneia arquivos de memória (limitado a aproximadamente 200, os mais recentes primeiro)
• Lê apenas as primeiras ~30 linhas (principalmente metadados)
• Constrói um manifesto leve
• Usa um modelo pequeno para escolher as ~5 memórias mais relevantes
• Carrega apenas essas memórias selecionadas no contexto (com limites de tamanho)

Vantagens Principais

O design oferece vários benefícios práticos:

• Custo-efetivo: Arquivos limitados, tokens limitados, custos previsíveis
• Rápido: Sem operações de embedding ou busca por similaridade
• Controlado: Apenas injeta algumas memórias com limites rígidos em todos os lugares
• Legível por humanos: Tudo é armazenado como arquivos markdown
• Menos lixo: Evita explicitamente armazenar informações que já podem ser derivadas do repositório

O sistema trata a memória como "possivelmente desatualizada" em vez de verdade absoluta, o que fornece uma abordagem refrescante para o gerenciamento de memória do agente. Este design é particularmente pragmático para agentes de codificação e depuração onde a maior parte da "memória" consiste em preferências, contexto ou referências externas, em vez de grandes bases de conhecimento.

Embora esta abordagem não substitua o RAG para todos os casos de uso, ela representa uma troca sólida para agentes de desenvolvimento onde simplicidade e previsibilidade importam mais do que recuperação abrangente de conhecimento.