Cmd. /doctor
Claude Code 전체 setup을 진단하고 발견된 문제를 고치는 checkup 명령
핵심 요약
- 설치·설정·성능·CLAUDE.md 종합 점검·수정 (skill)
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
설치·설정·성능·CLAUDE.md 종합 점검·수정 (skill)
/doctor사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 번들 스킬 |
| 상태 | 현재 공식 표 |
| 별칭 | /checkup |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
설치본의 명령 메뉴와 계정·조직 설정에 따라 사용할 수 있는 항목이 달라집니다.
사용 예
/doctor단독 명령 또는 별칭으로 실행합니다.
/doctor
/checkup실행하면 진단 항목이 상태 아이콘과 함께 나열되고, 자동 수정이 가능한 문제가 있으면 f를 눌러 Claude에게 수정을 맡길 수 있습니다.
선택 시점
- 명령어가 예상대로 동작하지 않을 때
- MCP/권한 관련 오류 발생 시
- 팀원 환경 차이 분석
- 설치·설정 검증 후
f로 자동 수정까지 한 번에 처리할 때
관련 명령 선택
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/doctor | 설치·설정 진단/검증 + f 자동 수정 | 환경 정합성 점검과 수정이 목적일 때 |
/debug [설명] | 세션 디버그 로그 분석(번들 Skill) | 실행 중 발생한 문제를 추적할 때 |
/status | 설정 화면(Status 탭) 상태 조회 | 버전·모델·계정·연결 상태 확인 목적 |
/feedback | 세션 컨텍스트를 첨부한 버그 신고 | 문제를 Anthropic에 보고할 때 |
실행 결과와 유지 범위
설치·설정 문제를 진단하고 요청에 따라 수정할 수 있습니다. 제안된 수정을 검토한 뒤 적용합니다.
v2.1.205부터 /doctor는 단순 설치·설정 검증을 넘어 문제를 진단하고 고칠 수 있는 전체 setup checkup으로 확장됐고 /checkup 별칭이 추가됐습니다. 이전 버전의 상태 아이콘과 f 자동 수정 흐름도 계속 유효합니다.
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는 세션 로그를 읽어 실행 중 문제를 추적하는 쪽입니다.
주의사항
- 진단 결과를 팀 공통 문서로 남겨 재발 방지
- 오류 재현 절차와 함께 기록
f로 자동 수정을 실행하면 Claude가 설정을 변경할 수 있으므로, 변경 내용을 확인한 뒤 진행하세요.- v2.1.116부터
/doctor는 Claude가 응답 중일 때도 열 수 있습니다. - plugin dependency skip이나 MCP override warning처럼 최근 릴리스에서
/doctor에 노출되는 항목이 늘어났으므로, 확장/연동 문제는/doctor와/pluginErrors tab을 함께 확인하세요.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록