Système de mémoire basé sur les fichiers de Claude Code : une alternative pragmatique aux bases de données vectorielles

Claude Code utilise une approche basée sur des fichiers pour la mémoire des agents, remplaçant la configuration typique de base de données vectorielle et d'embeddings. Au lieu d'un RAG complet, il stocke les mémoires sous forme de fichiers .md avec de petites sections frontmatter contenant des informations de nom, description et type, plus un fichier MEMORY.md qui sert d'index.

Fonctionnement du système

Au moment de l'exécution, le système n'incorpore ni ne recherche tout. Il suit ce processus :

• Scanne les fichiers de mémoire (limités à environ 200, les plus récents en premier)
• Lit seulement les ~30 premières lignes (principalement des métadonnées)
• Construit un manifeste léger
• Utilise un petit modèle pour choisir les ~5 mémoires les plus pertinentes
• Charge uniquement ces mémoires sélectionnées dans le contexte (avec des limites de taille)

Avantages clés

La conception offre plusieurs avantages pratiques :

• Économique : Fichiers limités, tokens limités, coûts prévisibles
• Rapide : Aucune opération d'embedding ou de recherche de similarité
• Contrôlé : N'injecte que quelques mémoires avec des plafonds stricts partout
• Lisible par l'humain : Tout est stocké sous forme de fichiers markdown
• Moins de déchets : Évite explicitement de stocker des informations qui peuvent déjà être dérivées du dépôt

Le système traite la mémoire comme "potentiellement obsolète" plutôt que comme une vérité absolue, ce qui offre une approche rafraîchissante de la gestion de la mémoire des agents. Cette conception est particulièrement pragmatique pour les agents de codage et de débogage où la plupart des "mémoires" consistent en des préférences, du contexte ou des références externes plutôt que de grandes bases de connaissances.

Bien que cette approche ne remplace pas le RAG pour tous les cas d'utilisation, elle représente un bon compromis pour les agents de développement où la simplicité et la prévisibilité comptent plus qu'une récupération complète des connaissances.