Cmd. /debug
현재 세션의 디버그 로깅을 켜고 세션 디버그 로그를 읽어 문제를 진단하는 번들 스킬
핵심 요약
/debug [description]은 현재 세션의 디버그 로깅을 켜고 그 로그를 읽어 문제를 진단하는 번들 스킬입니다.- 디버그 로깅은 기본 OFF라서
/debug는 실행 시점 이후의 동작만 잡아냅니다. 이미 지나간 증상은 로깅을 켠 뒤 다시 재현해야 합니다. - 처음부터 디버그 정보를 남기려면
claude --debug로 세션을 시작합니다(자동 기록 비활성화는 v2.1.71 부근 반영). - 디버그 로그에는 민감한 경로·환경 변수가 포함될 수 있어 공유 시 주의해야 합니다.
명령어 원본 선언
/debug [description][description]: (선택) 분석을 집중시키고 싶은 이슈를 자유 텍스트로 설명. 생략 가능.
공식 설명 요약
/debug는 번들 스킬(bundled skill) 로, 현재 세션의 디버그 로깅을 켜고 그
세션 디버그 로그를 읽어 문제를 진단합니다.
핵심 동작은 다음과 같습니다.
- 디버그 로깅은 기본적으로 꺼져 있습니다.
claude --debug로 세션을 시작한 경우에만 처음부터 켜져 있습니다. - 세션 중간에
/debug를 실행하면 그 시점부터 로그 캡처가 시작됩니다. (이미 발생한 과거 동작은 로그에 남지 않으니, 재현할 수 있는 증상이라면/debug실행 후 다시 재현해야 합니다.) - 인자로 이슈를 설명하면 그 내용에 맞춰 분석 초점을 잡아 줍니다.
번들 스킬은 사용자가 직접 작성하는 스킬과 동일하게 동작합니다. Claude에게 전달되는 프롬프트이며, 관련 상황이면 Claude가 자동으로 호출할 수도 있습니다.
최소 지원 버전
- 공식 명령어 레퍼런스 표에는
/debug에 대한 별도 최소 버전 표기가 없습니다. - 디버그 로깅이 기본 비활성화로 전환된 변경(
claude --debug미사용 시 자동 기록하지 않음)은 Changelog 기준v2.1.71부근에서 반영되었습니다.
사용법
# 디버그 로깅을 켜고 곧바로 진단 시작
/debug
# 진단 초점을 좁히도록 증상을 함께 설명
/debug MCP 서버 연결이 30초 후 끊깁니다좋은 사용 예
- 세션 중간에 디버그 로깅을 켜고 이상 동작을 재현해 원인 추적
- 권한/연결 문제 발생 시, 로그를 켠 뒤 재현하여 초기 진단
- 버그 리포트(
/feedback) 전 증상과 로그를 함께 정리 [description]에 증상을 적어 분석 초점을 좁히기
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/debug | 세션 디버그 로깅 토글 + 로그 기반 진단 | 런타임 이상 동작 추적 |
/doctor | 설치/설정 환경 진단(상태 아이콘 표시) | 설치/환경 문제 분석 |
/feedback | 세션 컨텍스트 첨부해 버그 리포트 제출 | 진단 후 이슈 보고 |
활용 사례
- 온보딩 이슈 자가진단: 로깅을 켜고 문제를 재현해 로그 확보
- 팀 운영 장애 대응 초기 체크: 재현 절차 + 디버그 로그로 원인 좁히기
주의사항
- 디버그 로깅은 기본 OFF입니다.
/debug는 실행 시점 이후의 동작만 잡아내므로, 문제가 이미 지나갔다면 로깅을 켠 뒤 다시 재현하세요. - 진단 결과는 재현 절차와 함께 기록하세요.
- 디버그 로그에는 민감한 경로/환경 변수가 포함될 수 있으니 공유 시 주의하세요.
- 항상 처음부터 디버그 정보를 남기려면
claude --debug로 세션을 시작하세요.
출처
- Commands(공식 명령어 레퍼런스): https://code.claude.com/docs/en/commands
- Bundled skills: https://code.claude.com/docs/en/skills#bundled-skills
- Changelog: https://raw.githubusercontent.com/anthropics/claude-code/refs/heads/main/CHANGELOG.md