Debug 세션 분석

생산성입문

Claude Code의 공식 번들 스킬 /debug는 현재 또는 과거 세션의 디버그 로그를 분석하여 문제를 진단합니다. 에러 패턴, 실패한 도구 호출, 비정상적인 토큰 사용량 등을 자동으로 감지하고 원인과 해결 방법을 제시합니다.

트리거/debug

사용빈도문제 발생 시

Claude Code가 예상과 다르게 동작할 때라면? /debug로 세션 로그를 분석해 원인 파악

토큰 사용량이 비정상적으로 높을 때라면? /debug로 어떤 도구 호출이 토큰을 많이 소모했는지 확인

디버그트러블슈팅번들 스킬세션

작동 흐름

/debug 실행 → 세션 로그 수집

↓

Phase 1: 2개 분석 병렬

error-scan

에러 패턴 및 실패 감지

usage-analysis

토큰/도구 사용량 분석

↓

이슈 진단 + 해결 방법 제시

↓

✓ 진단 리포트 + 권장 조치

스킬 코드

# Debug Session — Built-in Bundled Skill
## Trigger: /debug

Claude Code's official bundled skill for session troubleshooting.

### What it analyzes:

1. Error patterns:
  - Failed tool calls and their causes
  - Permission denials and sandbox issues
  - Network/API errors

2. Performance issues:
  - Unusually high token consumption
  - Slow tool executions
  - Repeated retry patterns

3. Behavioral anomalies:
  - Unexpected model responses
  - Context window overflow signals
  - Tool selection mismatches

### Usage:
```bash
# Debug current session
/debug

# Debug a specific past session
/debug --session <session-id>

# Debug with verbose output
/debug --verbose
```

### Output:
- Issue summary with severity levels
- Root cause analysis
- Recommended fixes or workarounds
- Links to relevant documentation

복사해서 CLAUDE.md에 붙여넣으면 바로 사용할 수 있습니다.