Cmd. /doctor
설치와 설정을 진단·검증하고, 발견된 문제를 Claude가 직접 고치도록 하는 명령
핵심 요약
/doctor는 Claude Code 설치 상태와 설정을 진단·검증하고, 항목별로 상태 아이콘과 함께 결과를 보여줍니다.- 문제가 보고되면
f키를 눌러 Claude가 직접 수정하도록 맡길 수 있습니다. - 최소
v2.1.3이상이며,v2.1.116부터는 Claude가 응답 중일 때도 열 수 있습니다. - 설정 정합성 점검 도구로, 실행 중 문제 추적용인
/debug와 함께 묶여 소개됩니다. - plugin dependency skip·MCP override warning 등 확장 문제는
/doctor와/pluginErrors 탭을 함께 확인하세요.
명령어 원본 선언
/doctor공식 설명 요약
공식 문서의 설명은 다음과 같습니다.
Diagnose and verify your Claude Code installation and settings. Results show with status icons. Press
fto have Claude fix any reported issues.
/doctor는 Claude Code의 설치 상태와 설정을 진단하고 검증하는 명령입니다.
- 진단 결과는 상태 아이콘과 함께 항목별로 표시됩니다.
- 문제가 보고되면
f키를 눌러 Claude가 직접 수정하도록 맡길 수 있습니다.
공식 문서는 "무언가 잘못되었을 때"의 도구로 /doctor와 /debug를 함께 묶어 소개합니다. /doctor는 설치·설정의 정합성을 점검하는 쪽이고, /debug는 세션 로그를 읽어 실행 중 문제를 추적하는 쪽입니다.
최소 지원 버전
v2.1.3이상
사용법
인자나 별칭(alias)은 공식 문서에 나와 있지 않고, 단독 명령으로 실행합니다.
/doctor실행하면 진단 항목이 상태 아이콘과 함께 나열되고, 자동 수정이 가능한 문제가 있으면 f를 눌러 Claude에게 수정을 맡길 수 있습니다.
좋은 사용 예
- 명령어가 예상대로 동작하지 않을 때
- MCP/권한 관련 오류 발생 시
- 팀원 환경 차이 분석
- 설치·설정 검증 후
f로 자동 수정까지 한 번에 처리할 때
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/doctor | 설치·설정 진단/검증 + f 자동 수정 | 환경 정합성 점검과 수정이 목적일 때 |
/debug [설명] | 세션 디버그 로그 분석(번들 Skill) | 실행 중 발생한 문제를 추적할 때 |
/status | 설정 화면(Status 탭) 상태 조회 | 버전·모델·계정·연결 상태 확인 목적 |
/feedback | 세션 컨텍스트를 첨부한 버그 신고 | 문제를 Anthropic에 보고할 때 |
활용 사례
- 온보딩 문제 해결 플레이북
- 배포 파이프라인 에이전트 환경 점검
- 설치/설정 깨짐을
f한 번으로 복구
주의사항
- 진단 결과를 팀 공통 문서로 남겨 재발 방지
- 오류 재현 절차와 함께 기록
f로 자동 수정을 실행하면 Claude가 설정을 변경할 수 있으므로, 변경 내용을 확인한 뒤 진행하세요.- 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