Anthropic의 Lance Martin이 2026년 9월 23일 오전 10시 47분(KST) 공유한 팁은 간단합니다. Opus 5.5를 Claude Code에서 쓴다면 지금 /claude-api prompt-audit을 한 번 실행해 보세요. CLAUDE.md, AGENTS.md, 스킬과 프롬프트를 훑어 예전 모델에 맞춘 지시를 찾고, 무엇을 왜 고칠지 보고서와 수정안 diff로 돌려줍니다.
출처: X @RLanceMartin
실행 방법
최신 Claude Code에서 /claude-api prompt-audit을 입력하면 됩니다. Anthropic 공식 문서의 Bundled skills에 포함된 스킬이라 별도 플러그인 설치는 필요하지 않습니다. 업데이트가 필요하면 터미널에서 claude update를 실행하세요.
같은 점검은 Claude Code v2.1.283 이상에서 /doctor prompt-audit으로도 부를 수 있습니다. /checkup은 /doctor의 별칭이며, 검사할 폴더를 덧붙여 범위를 좁힐 수도 있습니다. 예를 들어 /doctor prompt-audit src/agents처럼 입력합니다.
Claude Code 팀의 Lydia Hallie는 명령 이름 때문에 API 작업 전용처럼 들릴 수 있지만, Claude Code 설정 파일에도 사용할 수 있다고 안내했습니다.
출처: X @lydiahallie
무엇을 돌려주나
결과는 두 가지입니다. 첫째, 파일과 줄 위치를 짚으며 어떤 패턴인지, 목표 모델에서 왜 낡았는지, 판단 확신도는 어느 정도인지 설명하는 감사 보고서입니다. 둘째, 적용할 수 있는 구체적인 수정안 diff입니다. 점검 도중 확인을 위해 멈추지 않고 보고서와 제안을 끝까지 만듭니다.
기본 동작은 제안까지입니다. 공식 가이드는 “Propose - never apply edits without the user's consent.”라고 작업 원칙을 명시합니다. 보고서를 읽고 동의하는 변경만 후속으로 “적용해 줘”라고 요청하면 됩니다.
걸러 내는 안티패턴 6가지
검증 의식. “작업을 두 번 확인해”, “답하기 전에 두 번 검증해”처럼 결과 기준 없이 같은 검증을 반복하게 하는 문장입니다. 중복 확인이 늘어 토큰을 더 쓰고 작업을 반복할 수 있습니다.
철저함·강조 부스터. “최대한 철저하게”, “CRITICAL: YOU MUST ALWAYS…” 같은 강한 표현을 여러 겹 붙이면 응답이 길어지고 불필요한 도구 호출이 늘 수 있습니다. 정말 필요한 요구사항을 평이하고 구체적으로 남기는 편이 낫습니다.
고정 절차와 스크래치패드 틀. “스크래치패드에서 단계별로 생각해”처럼 모든 문제에 같은 사고 절차를 강제하면 모델의 기본 추론 위에 추가 지시가 쌓입니다. 필요한 결과와 검증 기준을 직접 적으세요.
낡은 예시. 이전 모델이 실수하지 않도록 넣었던 긴 few-shot 예시는 이제 불필요할 수 있습니다. 모델이 예시의 추론 양식까지 따라 하면서 간단한 요청에도 장황하게 답할 수 있습니다.
서로 부딪히는 규칙. “정책 안에서는 항상 환불”과 “에스컬레이션 없이는 환불하지 마”처럼 동시에 따를 수 없는 규칙입니다. 최신 모델은 지시를 더 문자 그대로 따르므로 우선순위와 예외를 명확히 해야 합니다.
구식 설정. 수동 thinking budget처럼 이전 모델 세대에 맞춘 설정은 최신 API에서 거부되거나 의도와 다르게 동작할 수 있습니다. 목표 모델의 현재 문서에 맞춰 다시 확인하세요.
점검 범위는 프롬프트 문장에 그치지 않습니다. 스킬 파일의 일반 지식 설명, 한 번의 실수를 영구 규칙으로 만든 줄, 빠르게 낡는 경로·버전도 살펴봅니다. 도구 설명 안의 행동 지시와 가짜 대화 예시, 요청 설정도 대상입니다. 반대로 제품·환경·독자·품질 기준처럼 작성자만 아는 맥락과 제약의 이유는 남겨야 합니다. 길다는 이유만으로 지우지는 않습니다.
출처: X @RLanceMartin
점검 전후 차이
Lance Martin이 공개한 Anthropic 내부 고객지원 벤치마크에서는 Opus 4.8용 프롬프트를 Opus 5에 그대로 옮겼을 때 티켓당 비용이 2.52센트·정확도 89.4%에서 3.43센트·91.7%로 바뀌었습니다. prompt-audit 후에는 티켓당 2.93센트에 정확도 97.0%였습니다. 감사 전 Opus 5와 비교하면 정확도는 5.3%포인트 올랐고 비용은 0.49센트 줄었습니다. 내부 벤치마크 한 사례이므로 모든 프로젝트에서 같은 수치가 나오지는 않습니다.
팀은 중복 검증 지시가 같은 일을 반복하게 하고, 강조 부스터가 필요 없는 검색을 수십 차례 유발한 사례를 들었습니다. Opus 5.5의 비용과 effort 설정을 함께 살펴보려면 Claude Code effort 가이드도 참고할 수 있습니다.
함께 나온 /claude-api migrate
Opus 5.5 출시 안내에서 Lance Martin은 /claude-api migrate와 prompt-audit을 함께 소개했습니다. migrate는 먼저 대상 파일·폴더와 목표 모델을 확인하고 애플리케이션 코드를 새 모델에 맞게 옮깁니다. 이어 같은 범위의 프롬프트와 도구 설명도 prompt-audit 기준으로 점검합니다.
출처: X @RLanceMartin
공식 claude-api 스킬 문서에 설명된 명령은 다음과 같습니다.
| 명령 | 하는 일 |
|---|---|
prompt-audit | 프롬프트·스킬·도구 설명과 관련 설정을 감사하고 보고서 및 수정안을 제안 |
migrate | Claude API 코드를 목표 모델로 옮기고 같은 범위의 프롬프트도 점검 |
upgrade | Python anthropic SDK의 메이저 버전 업그레이드 절차 안내 |
managed-agents-onboard | Claude Managed Agents 도입을 위한 안내 |
cost-optimize | 품질을 유지하며 API 비용을 낮출 수 있는 지점을 분석 |
스킬의 이름과 하위 명령 목록은 업데이트될 수 있으므로 최신 설명은 Anthropic skills 저장소의 claude-api 문서에서 볼 수 있습니다.
