피드로 돌아가기
What to Put in Your CLAUDE.md (and What to Leave Out)
Dev.toDev.to
AI/ML

Context Window 최적화를 통한 AI LLM 추론 정확도 극대화

What to Put in Your CLAUDE.md (and What to Leave Out)

PromptMaster2026년 6월 21일3intermediate

Context

AI 코딩 에이전트의 컨텍스트 윈도우 내 불필요한 정보 유입으로 인한 토큰 낭비 및 주의집중력 저하 발생. 방대한 지침 파일로 인해 핵심 규칙이 노이즈에 묻히며 LLM의 신뢰도가 하락하는 병목 지점 확인.

Technical Solution

  • Context Window 부하 감소를 위한 최소 필요 정보 중심의 CLAUDE.md 설계
  • Version number를 포함한 기술 스택 명시로 LLM의 프레임워크 버전 오인 방지
  • Top-level Layout 중심의 Directory Map 구성을 통한 프로젝트 구조 인지 효율화
  • Linter 및 Formatter가 강제하지 못하는 런타임 규칙 및 비즈니스 컨벤션 중심의 지침 정의
  • '제거 시 오류 발생 여부'라는 One-line Test 기반의 엄격한 정보 필터링 프로세스 적용
  • 성격 부여(Personality instructions) 및 중복 규칙 제거를 통한 Prompt Noise 최소화

- [ ] 각 라인에 대해 '이 내용을 삭제했을 때 AI가 실수할 가능성이 있는가' 검증 - [ ] Linter/Formatter로 자동화 가능한 규칙을 문서에서 제거하고 Tooling으로 대체 - [ ] 단순 요약이 아닌 버전 정보, 빌드 명령어, 수정 금지 경로 등 실행 가능한 정보 위주로 구성 - [ ] 페르소나 설정 등 추상적인 지시어를 제거하여 Context 효율성 확보

원문 읽기