Cmd. /debug
현재 세션의 디버그 로깅을 켜고 세션 디버그 로그를 읽어 문제를 진단하는 번들 스킬
핵심 요약
- debug log를 켜고 현재 session 문제 분석 (skill)
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
debug log를 켜고 현재 session 문제 분석 (skill)
/debug [description]사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 번들 스킬 |
| 상태 | 현재 공식 표 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
설치본의 명령 메뉴와 계정·조직 설정에 따라 사용할 수 있는 항목이 달라집니다.
사용 예
/debug Investigate the MCP connection failure# 디버그 로깅을 켜고 곧바로 진단 시작
/debug
# 진단 초점을 좁히도록 증상을 함께 설명
/debug MCP 서버 연결이 30초 후 끊깁니다선택 시점
- 세션 중간에 디버그 로깅을 켜고 이상 동작을 재현해 원인 추적
- 권한/연결 문제 발생 시, 로그를 켠 뒤 재현하여 초기 진단
- 버그 리포트(
/feedback) 전 증상과 로그를 함께 정리 [description]에 증상을 적어 분석 초점을 좁히기
관련 명령 선택
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/debug | 세션 디버그 로깅 토글 + 로그 기반 진단 | 런타임 이상 동작 추적 |
/doctor | 설치/설정 환경 진단(상태 아이콘 표시) | 설치/환경 문제 분석 |
/feedback | 세션 컨텍스트 첨부해 버그 리포트 제출 | 진단 후 이슈 보고 |
실행 결과와 유지 범위
진단 로그를 켜고 현재 세션의 문제를 조사합니다. 생성된 로그를 공유하기 전에 내용을 확인합니다.
/debug는 번들 스킬(bundled skill) 로, 현재 세션의 디버그 로깅을 켜고 그
세션 디버그 로그를 읽어 문제를 진단합니다.
핵심 동작은 다음과 같습니다.
- 디버그 로깅은 기본적으로 꺼져 있습니다.
claude --debug로 세션을 시작한 경우에만 처음부터 켜져 있습니다. - 세션 중간에
/debug를 실행하면 그 시점부터 로그 캡처가 시작됩니다. (이미 발생한 과거 동작은 로그에 남지 않으니, 재현할 수 있는 증상이라면/debug실행 후 다시 재현해야 합니다.) - 인자로 이슈를 설명하면 그 내용에 맞춰 분석 초점을 잡아 줍니다.
번들 스킬은 사용자가 직접 작성하는 스킬과 동일하게 동작합니다. Claude에게 전달되는 프롬프트이며, 관련 상황이면 Claude가 자동으로 호출할 수도 있습니다.
주의사항
- 디버그 로깅은 기본 OFF입니다.
/debug는 실행 시점 이후의 동작만 잡아내므로, 문제가 이미 지나갔다면 로깅을 켠 뒤 다시 재현하세요. - 진단 결과는 재현 절차와 함께 기록하세요.
- 디버그 로그에는 민감한 경로/환경 변수가 포함될 수 있으니 공유 시 주의하세요.
- 항상 처음부터 디버그 정보를 남기려면
claude --debug로 세션을 시작하세요.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록