Tired of Claude Code Ignoring Your CLAUDE.md? I Built claudemd-guard

개요

Claude Code에서 CLAUDE.md 파일에 정의된 규칙이 긴 세션 후 무시되는 문제를 해결하기 위해 claudemd-guard 도구가 개발되었습니다.

주요 내용

• Claude Code는 대화가 길어질수록 CLAUDE.md 파일의 내용이 컨텍스트 창에서 밀려나 모델이 규칙을 무시하는 현상이 발생합니다.
• claudemd-guard는 Claude Code의 PreToolUse 훅으로 작동하여 Edit, Write, Bash 등의 도구 실행 전에 CLAUDE.md 파일을 수집하고, AI 검증기에 규칙과 의도된 작업을 전달합니다.
• AI 검증기는 규칙 위반 시 작업을 차단하고, 위반이 없을 경우 작업을 허용합니다.
• 이 도구는 로컬 Claude CLI를 통해 실행되며 추가 API 키가 필요하지 않습니다.
• 오류 발생 시 작업을 허용하는 fail-open 디자인을 따릅니다.
• npm을 통해 설치 및 제거할 수 있으며, 설치 후 Claude Code를 재시작하여 활성화해야 합니다.

시사점

claudemd-guard는 Claude Code 사용 시 CLAUDE.md 파일에 명시된 규칙 준수를 강화하여 반복적인 롤백 및 검토 작업을 줄여주는 실질적인 해결책을 제공합니다.