Cmd. /doctor
Claude Code 전체 setup을 진단하고 발견된 문제를 고치는 checkup 명령
핵심 요약
- 설치·설정·성능·CLAUDE.md 종합 점검·수정 (skill)
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
설치·설정·성능·CLAUDE.md 종합 점검·수정 (skill). prompt-audit 하위 명령은 v2.1.283+
/doctor [prompt-audit [path]]사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 번들 스킬 |
| 상태 | 현재 공식 표 |
| 별칭 | /checkup |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-10-23 · Claude Code 2.1.308 |
설치본의 명령 메뉴와 계정·조직 설정에 따라 사용할 수 있는 항목이 달라집니다.
사용 예
/doctor
/doctor prompt-audit단독 명령 또는 별칭으로 실행합니다.
/doctor
/checkup
/doctor prompt-audit실행하면 먼저 발견 사항을 보고하고, 무언가를 바꾸기 전에 확인을 요청합니다.
prompt-audit (v2.1.283+)
/doctor prompt-audit(또는 /checkup prompt-audit)는 CLAUDE.md, skill, agent, custom command에서
이전 모델용으로 쓰인 프롬프트 패턴을 찾아 보고합니다. 오래된 경로·명령, 서로 모순되는 지시 파일이
보고서 맨 앞에 오고, Claude Code가 문서화한 thinking 키워드는 지우라고 권하지 않습니다. Opus 5.5·Fable
5.1로 옮긴 뒤 과한 강조나 낡은 우회 지시를 정리할 때 씁니다. 2026-10-07 기준 공식 Commands 표에
/doctor [prompt-audit [path]]로 등재되어 있습니다. Claude API 코드의 프롬프트를 점검하는
/claude-api prompt-audit과는 대상이 다릅니다.
선택 시점
- 명령어가 예상대로 동작하지 않을 때
- MCP/권한 관련 오류 발생 시
- 팀원 환경 차이 분석
- 설치·설정 검증 후 수정까지 한 번에 처리할 때
- 모델을 올린 뒤 CLAUDE.md·skill의 낡은 프롬프트 패턴을 점검할 때(
prompt-audit)
관련 명령 선택
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/doctor | setup checkup 진단 + 확인 후 수정 | 환경 정합성 점검과 수정이 목적일 때 |
/debug [설명] | 세션 디버그 로그 분석(번들 Skill) | 실행 중 발생한 문제를 추적할 때 |
/status | 설정 화면(Status 탭) 상태 조회 | 버전·모델·계정·연결 상태 확인 목적 |
/feedback | 세션 컨텍스트를 첨부한 버그 신고 | 문제를 Anthropic에 보고할 때 |
실행 결과와 유지 범위
설치·설정 문제를 진단하고 요청에 따라 수정할 수 있습니다. prompt-audit(/checkup prompt-audit)은 CLAUDE.md·skill·agent·command에서 이전 모델용 프롬프트 패턴을 찾아 보고합니다. 제안된 수정을 검토한 뒤 적용합니다.
v2.1.205부터 /doctor는 단순 설치·설정 검증을 넘어 문제를 진단하고 고칠 수 있는 전체 setup checkup으로 확장됐고 /checkup 별칭이 추가됐습니다. 현재 공식 표는 이를 skill로 분류합니다.
현재 checkup이 보는 항목은 다음과 같습니다.
- 설치 상태: 중복·잔여 설치, PATH 문제, 파싱되지 않는 settings 파일, 릴리스 채널의 새 버전
- 컨텍스트 비용: 쓰지 않는 skill·MCP 서버·plugin, 느린 hook
- CLAUDE.md: 로컬과 체크인 파일의 중복 제거, 코드베이스에서 알 수 있는 내용 정리(v2.1.206+), 항상 로드되는 지침을 필요할 때 로드되는 skill·중첩 CLAUDE.md로 이동
- 권한: auto mode를 기본으로 만들지, 자주 거부된 읽기 전용 명령을 미리 허용할지 제안
v2.1.205 이전의 /doctor는 읽기 전용 진단 화면을 열고 f를 누르면 보고서를 Claude에게 보냈습니다.
터미널에서 세션 없이 읽기 전용 진단만 보려면 claude doctor를 씁니다.
공식 문서는 "무언가 잘못되었을 때"의 도구로 /doctor와 /debug를 함께 묶어 소개합니다. /doctor는 설치·설정의 정합성을 점검하는 쪽이고, /debug는 세션 로그를 읽어 실행 중 문제를 추적하는 쪽입니다.
주의사항
- 진단 결과를 팀 공통 문서로 남겨 재발 방지
- 오류 재현 절차와 함께 기록
- 수정을 승인하면 Claude가 설정·CLAUDE.md를 변경할 수 있으므로, 변경 내용을 확인한 뒤 진행하세요.
- v2.1.116부터
/doctor는 Claude가 응답 중일 때도 열 수 있습니다. - plugin dependency skip이나 MCP override warning처럼 최근 릴리스에서
/doctor에 노출되는 항목이 늘어났으므로, 확장/연동 문제는/doctor와/pluginErrors tab을 함께 확인하세요. - v2.1.290부터 managed settings가 사용자 sandbox
allowRead경로나 허용 도메인을 무시하고 있으면/status와 doctor가 경고를 표시합니다.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록