platinumG.

platinumGRepo 큐레이션 › claude-md-doctor

claude-md-doctor 설치형

조건부

Claude Code의 설정 파일(CLAUDE.md)이 실제로 잘 지켜지고 있는지 대화 기록을 근거로 진단해주는 도구

2026-09-05 확인 · 실제로 돌려봄 · 검증 환경 Windows 11 확인 · Python 3.9+ stdlib만(의존성 0) · 무료 · PATH의 python/python3는 Store 스텁이라 SKILL.md를 `py -3`로 패치해 설치함

무엇인가

Claude Code에게 "이렇게 일해라"라고 정해둔 설정 파일(CLAUDE.md)을 진찰하는 도구입니다. 파일이 너무 길지는 않은지, 깨진 링크는 없는지 점검하는 것에 더해, 과거 대화 기록을 실제로 뒤져서 그 규칙이 지켜졌는지 안 지켜졌는지까지 알려주는 게 다른 점검 도구와 다릅니다.

왜 볼만한가

Claude Code용 설정 파일을 여러 개 관리하고 있다면(예: 프로젝트별로), 그 규칙들이 실제로 작동하는지 감으로만 판단하고 있었을 겁니다. 이 도구는 "규칙 A는 20번 중 20번 다 지켜졌다", "규칙 B는 한 번 어겨졌다"처럼 숫자 근거를 내놓습니다. 이 볼트에서 직접 검진을 돌려본 결과, 등급 A와 함께 실제로 규칙 하나가 한 번 어겨졌던 사례를 정확히 찾아냈습니다.

주의할 점

  • 원본 그대로 받아 쓰면 한글 윈도우 환경(코드페이지 cp949)에서 오류가 나며 멈춥니다. 화면에 특수 기호(—)를 출력하려다 생기는 문제인데, 코드를 세 군데 고쳐야 정상 작동합니다. 코딩을 모르면 직접 고치기 어려운 부분이라 배지를 "조건부"로 표시합니다.
  • 명령어를 실행할 때 python이 아니라 py로 불러야 합니다(이 PC의 python 명령이 다른 프로그램으로 연결돼 있어서).
  • 생긴 지 2주 안쪽인 신생 도구라, 다른 사람들의 사용 후기가 아직 없습니다.