클로드 코드의 파일 기반 메모리 시스템: 벡터 DB에 대한 실용적인 대안

Claude Code는 에이전트 메모리를 위한 파일 기반 접근 방식을 사용하여 일반적인 벡터 데이터베이스와 임베딩 설정을 대체합니다. 완전한 RAG 대신, 이름, 설명, 유형 정보를 포함하는 작은 프론트매터 섹션이 있는 .md 파일로 메모리를 저장하며, 인덱스 역할을 하는 MEMORY.md 파일도 함께 사용합니다.

시스템 작동 방식

실행 시 시스템은 모든 것을 임베딩하거나 검색하지 않습니다. 다음과 같은 프로세스를 따릅니다:

• 메모리 파일을 스캔합니다 (약 200개로 제한, 최신 순)
• 처음 약 30줄만 읽습니다 (주로 메타데이터)
• 경량 매니페스트를 구축합니다
• 작은 모델을 사용하여 상위 약 5개의 관련 메모리를 선택합니다
• 선택된 메모리만 컨텍스트에 로드합니다 (크기 제한 있음)

주요 장점

이 설계는 몇 가지 실용적인 이점을 제공합니다:

• 비용 효율적: 제한된 파일, 제한된 토큰, 예측 가능한 비용
• 빠름: 임베딩 또는 유사성 검색 작업 없음
• 통제 가능: 몇 개의 메모리만 주입하며 모든 곳에 엄격한 제한 적용
• 인간이 읽기 쉬움: 모든 것이 마크다운 파일로 저장됨
• 쓰레기 데이터 감소: 저장소에서 이미 파생될 수 있는 정보를 명시적으로 저장하지 않음

이 시스템은 메모리를 '절대적 진실'이 아닌 '아마도 오래된 정보'로 취급하여 에이전트 메모리 관리에 신선한 접근 방식을 제공합니다. 이 설계는 대부분의 '메모리'가 대규모 지식 베이스보다는 선호도, 컨텍스트 또는 외부 참조로 구성되는 코딩 및 디버깅 에이전트에 특히 실용적입니다.

이 접근 방식이 모든 사용 사례에서 RAG를 대체하지는 않지만, 포괄적인 지식 검색보다 단순성과 예측 가능성이 더 중요한 개발 에이전트를 위한 확실한 절충안을 나타냅니다.