오픈소스 지속 메모리 시스템인 Claude Code는 세션 간 컨텍스트 손실 문제를 해결합니다.

한 개발자가 Claude Code를 위한 지속적인 메모리 시스템을 만들었습니다. 이 시스템은 대화 간 컨텍스트를 잃어버리는 일반적인 문제를 해결합니다. 플러그인이나 API 키 없이도 Claude Code와 함께 작동합니다.

작동 방식

이 시스템은 세 가지 주요 구성 요소를 통해 작동합니다:

• 대화 중에 Claude는 중요한 결정, 자격 증명, 배운 교훈을 캡처하기 위해 memory/inbox.md에 한 줄짜리 메모를 작성합니다
• 야간 크론 작업이 대화 기록(~/.claude/projects/에 JSONL 파일로 저장됨)을 추출하고 인박스 항목과 결합하여 일일 로그를 생성합니다
• 각 새 대화가 시작될 때, Claude는 CLAUDE.md 규칙을 통해 지난 2일간의 로그를 읽습니다

설정 과정

설정은 최소한의 단계만 필요합니다:

git clone https://github.com/Sunnyztj/claude-code-memory.git
cd claude-code-memory
./setup.sh ~/projects/memory
# 메모리 규칙을 CLAUDE.md에 추가하세요
# 야간 크론 작업을 설정하세요

자동으로 기억되는 내용

• 아키텍처 결정 (예: "MongoDB에서 PostgreSQL로 전환")
• 배포 세부사항 (예: "VPS IP 변경, 새로운 Nginx 설정")
• 배운 교훈 (예: "Docker COPY는 기본적으로 root:600으로 설정되므로 chmod가 필요함")
• 계정 정보, API 키, 프로젝트 마일스톤

주요 설계 결정

• 파일 기반 접근 방식 (데이터베이스 아님) — Claude가 직접 읽고 쓸 수 있으며, Git 친화적이고 오프라인에서 작동합니다
• 인박스 패턴 — 캡처에 마찰이 없는 한 줄짜리 항목
• 증분 JSONL 추출 — 바이트 오프셋을 추적하고 이전 대화를 다시 처리하지 않습니다
• 크론 기반 (프로세스 내부 아님) — 플러그인 없이 일반 Claude Code와 작동합니다

이 시스템은 모든 Claude Code 설정과 호환되며, ClaudeClaw(데몬 모드) 사용자를 위한 선택적 크론 작업 템플릿을 포함합니다. 개발자는 프로덕션 워크플로에서 매일 사용하며 컨텍스트 유지가 크게 개선되었다고 보고합니다.