Claude Code의 3단계 메모리 설계와 자동 최적화 시스템 분석

Context

단순한 인덱스 용량 제한이 아닌 전체 토큰 예산 관리와 컨텍스트 효율화가 핵심 과제. 메모리 누적에 따른 정보 파편화 및 최신성 유지 문제 해결 필요.

Technical Solution

• 시스템 프롬프트 상주하는 인덱스(Layer 1), 온디맨드 로드 방식의 토픽 파일(Layer 2), grep 기반 접근의 세션 기록(Layer 3)으로 구성된 3계층 메모리 설계
• 코드베이스로 유추 가능한 정보는 제외하고 사용자 선호도와 피드백 등 고유 컨텍스트만 저장하는 데이터 필터링 전략
• 긍정 및 부정 피드백을 모두 기록하여 과거 실수 방지와 검증된 접근 방식 유지를 동시에 달성하는 피드백 캡처 구조
• 24시간 및 5세션 경과 후 작동하는 autoDream 프로세스를 통한 중복 제거 및 모순 해결 기반의 메모리 통합 체계
• PID 기반 락 파일(.consolidate-lock)과 1시간 타임아웃 설정을 통한 동시성 제어 및 프로세스 충돌 방지 설계
• 각 쿼리 종료 후 즉시 실행되는 extractMemories 에이전트와 주기적 최적화를 수행하는 autoDream의 이원화 구조

Impact

• Layer 1 인덱스 용량 최대 200라인 및 25KB 제한으로 토큰 비용 최적화

Key Takeaway

메모리 시스템은 단순한 데이터 축적이 아닌 지속적인 편집과 통합을 통한 정제 과정이 필수적이며, 데이터의 성격에 따라 접근 비용을 차등화하는 계층형 설계가 효율적임.