Claude Code 사용자들은 `/doctor prompt-audit` 명령어를 실행하여 프롬프트의 최신 상태를 점검해야 합니다. 모델이 업그레이드되면서 구형 프롬프트가 오히려 문제를 일으킬 수 있기 때문입니다. 이 명령어는 CLAUDE.md와 스킬에 포함된 만료 경로, 명령어, 충돌 지시어 등을 확인합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 X @berryxia (자동 발견)의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기Claude Code 사용자라면 모두 /doctor prompt-audit을 실행해 보세요!
이는 Claude Code 팀의 @lydiahallie 님이 방금 올린 알림이며, 이미 24만 명이 넘는 사람이 확인했습니다.
많은 사람들이 CLAUDE.md를 한 번 잘 작성하면 계속 사용할 수 있다고 생각합니다. 하지만 프롬프트(prompt) 역시 만료될 수 있습니다.
이 명령어는 Claude Code 2.1.283 버전에서 추가되었습니다.
공식 업데이트 로그의 원문은 다음과 같습니다: '당신의 CLAUDE.md, skills, agents 및 사용자 정의 명령에 오래된 모델을 위해 작성된 프롬프트 방식이 있는지 확인하세요.'
모델이 세대를 거쳐 업그레이드되면서, 예전에 구형 모델(old model)의 성능을 유지하기 위해 작성했던 규칙들이 새로운 모델에게 적용될 경우 오히려 발목을 잡는 경우가 생길 수 있습니다.
후속 버전에서는 이 부분을 한 번 더 강화하여 보고서 맨 앞부분에 다음 세 가지 유형의 문제를 먼저 나열합니다:
① 만료된 경로: 파일이 이미 다른 곳으로 옮겨졌는데, CLAUDE.md에는 여전히 이전 위치가 적혀 있는 경우
② 만료된 명령어: 스크립트 이름이 변경되었는데, 설명은 아직 구형인 경우
③ 충돌하는 지시어: 전역 설정에 하나, 프로젝트별 설정에 또 하나 등 두 가지 설명이 서로 다른 경우
Claude Code 공식 문서에서 언급했던 사고 키워드(thinking keyword)는 문제로 간주하여 삭제하지 않습니다.
사용법은 매우 간단합니다. Claude Code 내에서 다음을 입력하세요:
/doctor prompt-audit
또는 /checkup prompt-audit으로 작성할 수도 있습니다. 이 명령어는 일반적인 설치 상태 점검(installation check)이 아니라 오직 지시어 파일만 확인합니다.
솔직히 말해서, 전제 조건이 하나 있습니다: 버전이 2.1.283 이상이어야 합니다.
저는 제 컴퓨터가 아직 2.1.220이라서 먼저 업데이트해야 실행할 수 있었습니다 😂
또한, API를 사용하여 Agent를 직접 작성하는 분들 중에는 내장된 claude-api skill에도 prompt-audit 기능이 있습니다. 이 기능은 API 프롬프트와 도구 설명을 점검하며, 접근 방식은 동일합니다.
CLAUDE.md와 skills를 많이 모아 놓으신 분일수록 한 번 실행해 보시는 것이 좋습니다~