claude-md-doctor 설치형
조건부
Claude Code의 설정 파일(CLAUDE.md)이 실제로 잘 지켜지고 있는지 대화 기록을 근거로 진단해주는 도구
- ⚠️ 한글 윈도우에 그대로 설치하면 오류가 남 — 코드를 직접 고쳐야 작동함(고쳐서 확인 완료)
- ✅ 무료, 추가 프로그램 설치 없음(파이썬만 있으면 됨)
- ✅ 실제 대화 기록을 근거로 규칙이 지켜졌는지까지 확인해줌

무엇인가
Claude Code에게 "이렇게 일해라"라고 정해둔 설정 파일(CLAUDE.md)을 진찰하는 도구입니다. 파일이 너무 길지는 않은지, 깨진 링크는 없는지 점검하는 것에 더해, 과거 대화 기록을 실제로 뒤져서 그 규칙이 지켜졌는지 안 지켜졌는지까지 알려주는 게 다른 점검 도구와 다릅니다.
왜 볼만한가
Claude Code용 설정 파일을 여러 개 관리하고 있다면(예: 프로젝트별로), 그 규칙들이 실제로 작동하는지 감으로만 판단하고 있었을 겁니다. 이 도구는 "규칙 A는 20번 중 20번 다 지켜졌다", "규칙 B는 한 번 어겨졌다"처럼 숫자 근거를 내놓습니다. 이 볼트에서 직접 검진을 돌려본 결과, 등급 A와 함께 실제로 규칙 하나가 한 번 어겨졌던 사례를 정확히 찾아냈습니다.
주의할 점
- 원본 그대로 받아 쓰면 한글 윈도우 환경(코드페이지 cp949)에서 오류가 나며 멈춥니다. 화면에 특수 기호(—)를 출력하려다 생기는 문제인데, 코드를 세 군데 고쳐야 정상 작동합니다. 코딩을 모르면 직접 고치기 어려운 부분이라 배지를 "조건부"로 표시합니다.
- 명령어를 실행할 때 python이 아니라 py로 불러야 합니다(이 PC의 python 명령이 다른 프로그램으로 연결돼 있어서).
- 생긴 지 2주 안쪽인 신생 도구라, 다른 사람들의 사용 후기가 아직 없습니다.