Claude Code 세션 휘발성 해결을 위한 4계층 자동 Memory System 설계

I built KIOKU — an OSS memory system for Claude Code

megaphone2026년 4월 17일6분intermediate

AI 요약

Context

Claude Code 사용 시 세션마다 컨텍스트가 초기화되어 설계 결정 사항과 기술 스택 근거를 반복 설명해야 하는 비효율 발생. LLM Wiki 개념을 기반으로 한 지속적 메모리 저장소의 필요성 대두.

Technical Solution

L0 Auto-Capture: Claude Code Hook 시스템을 통한 UserPrompt, ToolUse 등 4가지 이벤트의 로컬 Markdown 로그 자동 기록
L1 Structuring: 정기적 스케줄러가 claude -p를 호출하여 원시 로그를 Concept, Project, Decision 단위의 구조화된 Wiki로 변환
L2 Integrity Checks: 월간 헬스체크를 통해 Broken Link 및 Frontmatter 누락을 탐지하고 정기적인 Secret Leak 검사 수행
L3 Sync: Git 기반의 Wiki 동기화를 통해 기기간 컨텍스트를 공유하되, .gitignore 검증 가드를 통해 로컬 세션 로그 유출 원천 차단
Recursive Loop Prevention: KIOKU_NO_LOG 환경 변수와 CWD 체크를 통한 로그 처리 세션의 무한 재귀 호출 방지
Permission Restriction: Wiki 생성 시 --allowedTools를 Write/Read/Edit로 제한하여 Bash 실행 권한을 제거함으로써 Prompt Injection 리스크 최소화

실천 포인트

- LLM 기반 자동화 툴 설계 시 처리 프로세스가 다시 트리거를 발생시키는 무한 재귀 루프 방지 로직 구현 - 보안 민감 데이터 처리를 위해 Regex 기반 마스킹과 주기적인 사후 스캔(Scan-secrets)의 2중 방어 체계 구축 - AI 생성 콘텐츠의 품질 향상을 위해 '전체 추출'보다 '다음 세션에 필요한 정보'로 한정한 Prompt Tuning 적용

태그

#Prompt Injection #Event-Driven #LLM Wiki #Secret Masking #Context Injection

원문 읽기