네 줄로 보는 프롬프트 감사
- 프롬프트 감사는 /doctor 설정 점검에 포함된 하위 명령입니다. Claude Code 세션에서 /doctor prompt-audit(또는 /checkup prompt-audit)을 실행하세요.
- CLAUDE.md, 스킬, 에이전트, 명령에 남은 예전 모델용 프롬프트 패턴을 스캔하고, 오래된 경로·오래된 명령·서로 모순되는 지침 파일을 리포트 맨 앞에 올려 줍니다.
- Claude Code 2.1.283에 들어온 기능이므로 먼저 업데이트하세요. 예전 빌드에서는 /doctor가 리포트 대신 알 수 없는 하위 명령 오류를 반환합니다.
- 점검은 먼저 리포트를 보여 주고 변경 전에 확인을 요청합니다. 읽기 전용 확인만 원한다면 터미널에서 claude doctor를 실행하세요.
Anthropic just dropped the new Checkup command (/doctor)
채널:Software Engineer Meets AI2:18
Claude Code 2.1.283 — Prompt Audits & Windows Fix
채널:Claude Code Updates1:02
Claude Code v2.1.283 — Advanced Model Control and Auditing
채널:Claude Code Changelog2:10
Claude Code changelog — 2.1.283 adds /doctor prompt-audit
문서:github.com/anthropics/claude-codeChangelog
Claude Code commands reference — /doctor, /checkup and /claude-api
문서:code.claude.comDocs
스틸컷은 세 개의 녹화에서 가져왔습니다. Software Engineer Meets AI는 v2.1.205에서 /doctor 점검 전체를 녹화했고, prompt-audit 하위 명령과 그 범위는 v2.1.283에서 발표되었으며 같은 점검 UI를 씁니다. v2.1.283 릴리스 화면은 Claude Code Updates와 Claude Code Changelog에서 가져왔습니다. 모든 프레임은 직접 확인했고, 슬라이드 두 장은 채널의 화면 내 워터마크를 없애기 위해 잘라냈습니다.
스크린샷의 권리는 위 채널에 있으며, 자체 작성한 설명을 그림으로 보완하는 용도로만 사용합니다. 각 단계는 해당 타임스탬프로 연결됩니다.
Claude Code 프롬프트 감사, 단계별로 따라 하기
실행 전 준비
- 1
Claude Code를 2.1.283 이상으로 업데이트하기
이 기능이 들어간 빌드에서만 /doctor prompt-audit을 실행할 수 있습니다. 터미널에서 claude --version으로 버전을 확인하고, 감사가 추가된 2.1.283보다 낮으면 claude update로 업데이트하세요. 세션 안에서는 /doctor의 6번 점검이 설치된 버전과 릴리스 채널을 비교해 알려 줍니다.
2.1.283 릴리스 카드의 첫 항목이 Prompt Audit입니다. 이 버전이 아니면 명령이 응답하지 않습니다.영상 0:08 보기 - 2
예전 프롬프트 패턴에 감사가 필요한 이유 이해하기
예전 모델을 위해 쓴 지침은 메모리 파일, 스킬, 에이전트, 명령에 쌓여 있고, 그 모델이 사라진 뒤에도 모든 세션에 계속 영향을 줍니다. 감사는 이런 낡은 패턴을 드러내 추측 대신 무엇을 고쳐야 하는지 정확히 알려 주는 기능입니다.
낡은 지침은 일상 작업에서는 보이지 않습니다. 그래서 경고가 아니라 감사로 제공됩니다.영상 0:12 보기 - 3
정확한 명령과 스캔 범위 익히기
명령은 /doctor prompt-audit이고, /checkup은 /doctor의 별칭이라 /checkup prompt-audit도 같습니다. 범위는 Claude Code 설정, 즉 CLAUDE.md, 스킬, 에이전트, 명령입니다. 설정 점검의 하위 명령이며 별도 플러그인이나 마켓 설치가 필요 없습니다.
기존 명령에 인자 하나를 붙이는 것뿐입니다. 설치할 것은 없습니다.영상 1:02 보기
실제 세션에서 감사 실행하기
- 4
감사할 프로젝트에서 Claude Code 열기
세션은 프로젝트 루트에서 시작하세요. 감사는 그 프로젝트가 실제로 불러오는 설정을 읽기 때문에 상위 폴더에서 열면 다른 CLAUDE.md를 검사하게 됩니다. 입력하기 전에 헤더 줄에서 디렉터리와 모델을 확인하세요.
세션 헤더의 작업 디렉터리가 곧 감사 범위입니다.영상 1:00 보기 - 5
명령을 입력하고 읽기 전용으로 실행시키기
프롬프트에 /doctor prompt-audit을 입력하세요. 점검은 시작 전에 방식을 밝힙니다. 먼저 읽기 전용으로 상태 점검을 실행하고, 무언가를 바꾸기 전에 리포트를 보여 준다는 것입니다. 근거를 모으는 동안 파일 읽기와 셸 명령이 여러 턴 이어지는데, 멈춘 것이 아니라 정상입니다.
읽기 전용 약속이 제안보다 먼저 나오므로, 조사하는 동안에는 아무것도 기록되지 않습니다.영상 0:30 보기 - 6
각 점검의 근거 수집 과정 지켜보기
트랜스크립트에는 각 명령이 어느 점검에 쓰이는지 드러납니다. 6번은 최신 버전, 확장 관련 점검은 스킬 디렉터리와 hook 설정, 2·3번은 용량이 작은 CLAUDE.md, 1·4·8번은 최근 세션 트랜스크립트를 봅니다. hook이 명령을 막아도 점검은 필요한 사실을 다시 정리해 재시도하며, 실패로 끝내지 않습니다.
실행하는 모든 명령은 번호가 붙은 점검에 대응됩니다.영상 0:36 보기
리포트 읽기
- 7
리포트가 다루는 9개 점검 파악하기
0번은 설정 상태, 1번은 사용하지 않는 확장, 2번은 LOCAL 메모리 중복 정리, 3번은 항상 로드되는 콘텐츠 이동, 4번은 느린 hook, 5번은 컨텍스트를 많이 먹는 확장, 6번은 버전, 7번은 기본 권한 모드로서의 auto 모드, 8번은 자주 거부되는 읽기 전용 명령입니다. 프롬프트 감사에서 가장 중요한 것은 지침 파일 관련 점검입니다. 2번은 팀이 저장소에 커밋한 규칙과 중복되거나 충돌하는 개인 메모를 찾아내고, 3번은 거의 쓰지 않는 지침을 항상 켜진 컨텍스트 밖으로 옮깁니다.
CLAUDE.md와 다른 지침 파일을 건드리는 것은 2·3·5번 점검입니다.영상 1:16 보기 - 8
Proposed actions 섹션부터 읽기
Proposed actions는 리포트에서 실제로 파일을 바꾸는 부분이고, 각 항목에 편집 대상 파일과 되돌릴 수 있는지 여부가 적혀 있습니다. 문제가 없는 점검은 Healthy로 표시되고 No action으로 마무리되므로, 9개 점검 중 어디서 발견됐고 어디서 아무것도 없었는지 한눈에 보입니다.
결정하기 전에 각 제안의 파일 경로를 확인하세요. 수정은 그곳에 적용됩니다.영상 0:40 보기 - 9
경고와 두 개의 확인 질문 읽기
제안 아래에는 Warnings (no action) 블록이 있어 감사가 측정만 하고 바꾸지 않는 항목 — 느린 hook, 컨텍스트를 많이 먹는 확장 — 을 실측 수치와 함께 보여 주므로 직접 판단할 수 있습니다. 리포트는 마지막에 답을 단정하지 않고 확인 질문을 던집니다.
경고는 수정이 아니라 측정값입니다. 숫자만 붙고 제안은 없습니다.영상 0:56 보기
승인하고 반복하기
- 10
기록되기 전에 승인·선택·거절 정하기
점검은 메뉴로 끝납니다. Clean up everything, Let me pick, No, keep everything, Type something, Chat about this 다섯 가지입니다. 권장 항목인 Clean up everything을 고르면 모든 제안이 적용되고, Let me pick은 항목을 하나씩 확인하며, No, keep everything은 어떤 파일도 건드리지 않습니다. 리포트만 봐서는 아무것도 적용되지 않습니다.
기본 동작은 수정이 아니라 질문입니다. 안전 설계의 핵심이 바로 여기에 있습니다.영상 0:52 보기 - 11
감사를 월간 알림에 올려 두기
감사는 반복해도 부담이 없지만, Claude Code가 일정에 맞춰 대신 실행해 주지는 않습니다. /schedule은 클라우드 작업을 만들고 /loop은 세션이 살아 있는 동안만 돕니다. 현실적인 방법은 반복 캘린더 일정으로 다시 실행을 알림 받는 것입니다. 매달 한 번, 또는 모델 업그레이드로 예전 패턴이 무효가 된 직후에 하세요.
세션은 다시 시작해도 캘린더 알림은 남습니다. 사실상 이것이 유일한 스케줄러입니다.영상 2:08 보기
실제로 자주 겪는 다섯 가지 실패
프롬프트 감사가 안 된다는 이야기는 대부분 이 다섯 가지 중 하나입니다. 명령이 없다고 단정하기 전에 순서대로 확인하세요.
- 1알 수 없는 명령이거나 prompt-audit 항목이 없음 — 빌드가 2.1.283보다 이전입니다. claude --version으로 확인하고 claude update로 업데이트한 뒤, 새 빌드가 로드되도록 세션을 새로 여세요.
- 2/checkup prompt-audit와 /doctor prompt-audit의 차이 — 같은 명령입니다. 공식 문서에 /checkup이 /doctor의 별칭이라고 적혀 있어 어느 접두사든 같은 점검 스킬에 도달합니다.
- 3/claude-api prompt-audit은 대상이 다른 별개 하위 명령입니다. 직접 만든 Claude API 애플리케이션 코드의 프롬프트, 스킬, 도구 설명을 감사하고 수정안을 diff로 제시합니다. 2.1.283이 아니라 Claude Code 2.1.221 이상이 필요하고, CLAUDE.md는 보지 않습니다.
- 4지침 파일에 대해 아무 보고가 없음 — 정말 군더더기가 없거나, 아예 로드되지 않은 것입니다. /context를 실행해 어떤 메모리 파일과 스킬이 실제 컨텍스트에 있는지 확인하고, 세션을 프로젝트 루트에서 시작했는지도 점검하세요.
- 5세션 없이 읽기 전용 점검만 원함 — 터미널에서 claude doctor를 실행하세요. 세션을 열지 않고 설치와 설정 진단을 출력합니다. 수정 제안과 적용까지 가능한 것은 세션 안의 /doctor입니다.