Claude Code에 같은 수정을 계속 설명하고 계신가요? 프로젝트 지침끼리 충돌하거나, 이미 없어진 파일·명령이 지침에 남아 있는지도 살펴보세요. /doctor prompt-audit로 지침 파일을 점검하고 수정 제안을 받을 수 있어요. 11월 9일 공식 문서 기준의 활용 팁입니다.

1. 먼저 점검 결과부터 받아보세요

Claude Code 세션에서 아래 명령을 입력합니다.

/doctor prompt-audit

공식 문서에 따르면 예전 모델을 전제로 쓴 지침, 존재하지 않는 파일이나 명령을 가리키는 내용, 서로 충돌하는 지침 등을 찾아 결과와 수정안을 보여줍니다. 수정안을 적용해달라고 요청하기 전에는 파일을 변경하지 않아요.

이 기능은 Claude Code v2.1.283 이상이 필요합니다. 기본 제공 /claude-api 스킬을 통해 실행되므로, 설정의 skillOverrides 또는 disableBundledSkills로 해당 스킬을 꺼둔 경우에는 사용할 수 없어요. 회사에서 관리하는 환경이라면 임의로 제한을 바꾸기보다 관리자에게 확인해주세요.

2. 점검할 파일의 범위도 확인하세요

기본 점검 범위에는 CLAUDE.md, CLAUDE.local.md, AGENTS.md와 .claude/ 및 ~/.claude/ 아래의 규칙·스킬·명령·하위 에이전트·출력 스타일이 포함됩니다. 프로젝트 지침뿐 아니라 사용자 설정 쪽의 지침도 대상이 될 수 있어요.

특정 파일이나 폴더만 점검하려면 명령 뒤에 경로를 붙일 수 있습니다. 예를 들어 현재 프로젝트의 CLAUDE.md만 먼저 보고 싶을 때는 다음처럼 범위를 좁혀보세요. 실제로 존재하는 파일 경로를 사용해야 합니다.

/doctor prompt-audit CLAUDE.md

3. 제안은 현재 프로젝트와 대조한 뒤 반영하세요

도트의 제안은 결과를 읽을 때 다음 세 가지를 먼저 확인하는 거예요.
파일 위치와 검사 명령이 지금 프로젝트에도 맞는지
더 이상 쓰지 않는 예전 작업 방식이 남아 있는지
같은 작업을 서로 다르게 지시하는 문장이 함께 있는지

리빌더 사이트를 손보는 경우에도 현재 사용하는 버전과 실제 커스텀 파일을 기준으로 판단해주세요. 수정안을 한꺼번에 받아들이기보다 필요한 항목부터 검토하고, 반영한 뒤에는 변경 내용과 테스트 결과를 확인하는 편이 좋아요.

코드의 보안 검토와 실제 동작 테스트는 별도로 필요합니다. 공식 문서도 CLAUDE.md를 강제로 적용되는 설정이 아닌 참고 맥락으로 설명해요. 지침에 적었다는 이유만으로 위험한 동작이 반드시 차단된다고 생각하면 안 됩니다.

업무용 저장소는 조직의 AI 도구 이용 규칙을 따르고, API 키·비밀번호·회원 개인정보는 지침 파일이나 공개 질문에 넣지 마세요.

공식 출처 · 확인일 2026-11-09

Claude Code 문서: Audit your instruction files
지원 버전, 점검 범위, 수정 적용 조건과 CLAUDE.md의 역할을 확인할 수 있어요.