클로드 코드가 시간이 지나면서 당신의 프로젝트를 학습하는 시스템

r/ClaudeAI의 한 개발자가 Claude Code의 세션 간 지속적 컨텍스트 부족 문제를 해결하기 위한 시스템을 공유했습니다. 매번 처음부터 시작하는 대신, 이 설정은 Claude가 프로젝트의 규칙, 아키텍처, 과거 실수를 학습하도록 돕습니다.

문제와 해결책

Claude Code를 사용할 때, 각 새 세션은 이전의 모든 컨텍스트를 잃습니다. Claude는 이미 이해한 파일을 다시 읽고, 수정된 실수를 반복하며, 확립된 패턴을 무시하여 지속적인 재설명이 필요합니다.

해결책은 모든 저장소에 몇 가지 파일을 추가하는 것입니다:

• CLAUDE.md - Claude에게 행동 방식을 알려주는 짧은 규칙 모음. 예를 들어 "명확하지 않은 부분이 있으면 진행하기 전에 물어보기"와 "직접 테스트를 실행하지 말고, 대신 실행할 명령어를 알려주기"(이는 오류 추적에 토큰을 낭비하지 않아 비용을 절약합니다)가 포함됩니다.
• docs/ 폴더 - 프로젝트 규칙, 패턴, 아키텍처를 담은 짧은 파일들(각 5-10줄)을 하위 폴더로 구성하여 포함합니다. 인덱스 파일(docs/README.md)은 Claude가 추측하는 대신 적절한 문서를 빠르게 찾도록 돕습니다.

세 가지 핵심 프롬프트

• bootstrap - 기존 코드베이스를 채택할 때 한 번 붙여넣습니다. Claude가 코드를 읽고 초기 문서를 작성합니다.
• refine - 세션 끝에 붙여넣습니다. Claude가 발생한 일을 반성하고 새로운 학습 내용으로 문서를 업데이트합니다.
• factory - Claude가 반복하고 싶은 작업을 수행했을 때 붙여넣습니다. 패턴을 재사용 가능한 프롬프트로 캡처합니다.

워크플로우 루프

이 과정은 지속적인 학습 사이클을 만듭니다: Claude와 함께 코딩 → 세션 종료 → refine 프롬프트 붙여넣기 → Claude가 문서 업데이트 → 커밋 → 다음 세션이 더 똑똑하게 시작. 문서가 git에 저장되므로 팀원 모두가 혜택을 받으며, 어떤 기술 스택과도 작동합니다.

구현 시 실용적인 팁

• 오류 추적에 토큰을 소모하지 않도록 Claude에게 빌드/테스트 명령어를 실행하지 말라고 명시적으로 지시하세요. 대신 실행할 명령어를 알려주도록 합니다.
• 모호한 용어(예: "복잡한 작업 시 일시 정지")보다는 규칙에 구체적인 숫자(예: "3개 이상 파일 변경 시 일시 정지")를 사용하세요. Claude는 모호성을 해석하는 데 시간을 낭비합니다.
• docs 폴더의 인덱스 파일은 Claude가 관련 정보를 찾기 위해 무작위 파일을 열지 않도록 방지하여 즉시 효과를 냅니다.

이 시스템은 무료이며 오픈 소스로, saas-vibe에서 이용 가능합니다.