Claude Code 환각 줄이기: 사양 기반 접근법 공유

Reddit의 r/ClaudeAI 커뮤니티에서 한 개발자가 Claude Code를 장시간 개발 세션에 사용할 때 환각 현상을 줄이는 실용적인 방법을 공유했습니다. 이 접근법은 구조화된 문서화를 통해 컨텍스트를 유지하는 데 중점을 둡니다.

문제: 압축 과정에서의 컨텍스트 손실

해당 개발자는 Claude Code가 프로젝트를 시작할 때는 잘 진행되지만, 여러 번의 컨텍스트 압축 후에는 성능이 저하되는 패턴을 설명했습니다. "테스트를 생성하고 테스트가 통과할 때까지 완료했다고 말하지 마세요"와 같은 구체적인 지시사항들은 압축 후에 잊혀져서, 이전 버그들이 다시 나타나고 출력 품질이 악화되는 원인이 되었습니다.

해결책: 명세 주도 개발

Anthropic이 자신들의 Plugins 기능을 구축한 방식에서 영감을 얻어, 해당 개발자는 명세 우선 접근법을 채택했습니다:

먼저 Claude에게 앱에 대해 명확히 하는 질문을 하도록 요청한 후, 상세한 불릿 포인트 요구사항이 담긴 REQUIREMENTS.md를 생성합니다
요구사항 문서의 불릿 포인트를 참조하여 각 요구사항에 대한 작업이 담긴 IMPLEMENTATION_PLAN.md를 생성합니다
구현 계획과 100% 일치하는 테스트 계획을 생성하여 각 작업에 대한 테스트 케이스를 포함합니다
구현 계획을 참조하고 단계를 실행하라는 지시사항이 담긴 CLAUDE.md를 생성합니다

CLAUDE.md는 구체적으로 Claude에게 다음과 같이 지시합니다:

구현 계획을 참조하고 그 안의 단계들을 실행하세요. 각 작업의 개발이 완료된 후, 해당 작업에 대한 테스트 계획 항목을 반드시 실행해야 하며, 테스트가 통과한 후에만 "반드시" 완료로 표시해야 합니다. 제가 제공하는 각각의 새로운 지시사항에 대해 요구사항 문서, 구현 계획 및 테스트 계획을 업데이트해야 합니다.

결과

해당 개발자는 여러 번의 압축 후에도 훨씬 더 나은 실행 품질을 보고했습니다. Claude는 더 이상 압축 후에 진행 상황을 잃지 않으며, 어디서부터 실행해야 할지 알고 있습니다. 개발자는 "무엇이 남았나요?"라고 물어보면 유용한 답변을 얻을 수 있으며, 환각 현상이 크게 줄어들었습니다.

언급된 한 가지 제한사항: Claude는 여전히 매번 테스트를 실행하지 않는데, 이는 해당 개발자의 로컬 환경 제약(오래된 Mac, XCode 또는 시뮬레이터 실행 어려움) 때문이라고 설명했습니다.

Claude는 또한 이 과정에서 MEMORY.md 파일을 생성했지만, 해당 개발자는 이것이 어떻게 유용한지 모르겠다고 언급했습니다.

📖 전체 출처 읽기: r/ClaudeAI