피드로 돌아가기
Dev.toBackend
원문 읽기
Your CLAUDE.md is probably broken — 5 silent failure patterns and how to fix them
Claude Code 사용자들이 CLAUDE.md 파일에서 60줄 이상 규칙을 작성하면 Claude가 중반부터 일부 규칙을 무시하는 silent failure 발생
AI 요약
Context
Claude Code는 약 100~150개의 instruction slot 예산을 가지고 있으나 시스템 프롬프트가 50개를 소비해 실제 사용 가능한 슬롯이 제한적이다. 대부분의 프로덕션 CLAUDE.md 파일은 규칙 수를 초과하면서도 개발자가 이를 인식하지 못하고 있다. Claude가 명시적으로 어떤 규칙을 무시하는지 알려주지 않아 디버깅이 불가능하다.
실천 포인트
Claude Code를 사용하는 개발팀은 CLAUDE.md를 60줄 이내로 제한하고 모든 '금지' 규칙에 대체 수행 방법을 명시한 후, 반드시 실행되어야 할 작업(linting, type checking)은 hooks로 설정함으로써 Claude가 매 세션마다 일관된 동작을 수행하도록 강제할 수 있다.