Cmd. /doctor
환경 문제를 진단하고 실행 실패 원인을 빠르게 파악하는 명령
명령어 원본 선언
/doctor공식 설명 요약
/doctor는 설치/설정/실행 환경에서 발생하는 문제를 진단하는 데 쓰입니다.
연결/권한/도구 인식 문제를 빠르게 좁혀갈 수 있습니다.
최소 지원 버전
v2.1.3이상 (Changelog 기준)
사용법
/doctor좋은 사용 예
- 명령어가 예상대로 동작하지 않을 때
- MCP/권한 관련 오류 발생 시
- 팀원 환경 차이 분석
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/doctor | 진단 중심 | 오류 원인 파악이 목적일 때 |
/status | 상태 조회 | 정상 운영 중 점검 목적 |
/debug 계열 | 상세 디버깅 | 심층 분석이 필요할 때 |
활용 사례
- 온보딩 문제 해결 플레이북
- 배포 파이프라인 에이전트 환경 점검
주의사항
- 진단 결과를 팀 공통 문서로 남겨 재발 방지
- 오류 재현 절차와 함께 기록
- v2.1.116부터
/doctor는 Claude가 응답 중일 때도 열 수 있습니다. - plugin dependency skip이나 MCP override warning처럼 최근 릴리스에서
/doctor에 노출되는 항목이 늘어났으므로, 확장/연동 문제는/doctor와/pluginErrors tab을 함께 확인하세요.
출처
- Commands: https://code.claude.com/docs/en/commands
- Changelog: https://code.claude.com/docs/en/changelog