02-구조

02. 구조 — 6 카테고리 결정 트리

증상 발생
   │
   ▼
[Q1] 도구 호출이 거부되거나 무한 대기?
   ├─ 예 → 권한 (settings.json, allowedTools, defaultMode)
   └─ 아니오 ▼
[Q2] 모델이 직전 결정을 잊거나 같은 실수 반복?
   ├─ 예 → 컨텍스트 (/context, /clear, 핸드오프)
   └─ 아니오 ▼
[Q3] 모델 동작이 어제와 모순?
   ├─ CLAUDE.md 변경됨 → CLAUDE.md (모순 항목 점검)
   └─ 새 버전 → 모델/버전 (changelog 확인)
[Q4] PreToolUse / PostToolUse에서 갑자기 죽음?
   ├─ 예 → hook (.claude/hooks/*, exit code, stderr 로그)
   └─ 아니오 ▼
[Q5] MCP 서버 호출 후 침묵 / 큰 응답 드롭?
   ├─ 예 → MCP (서버 로그, _meta/maxResultSizeChars)
   └─ 아니오 ▼
[Q6] 위 모두 아니다 → 모델/버전 (changelog, 모델 다운그레이드 시도)

카테고리별 1차 도구

권한

• settings.json 머지 결과 확인: 글로벌·프로젝트·로컬을 한 화면에 띄워라.
• allowedTools 와일드카드 충돌.
• 헤드리스 vs 인터랙티브 권한 모드 차이.

컨텍스트

• /context 확인.
• 70% 이상이면 핸드오프 + /clear.
• 자동 메모리 잘못된 학습 여부.

CLAUDE.md

• 최근 변경 diff: git log -p -- CLAUDE.md.
• 모순 항목 검색: 같은 키워드가 반대 지시로 두 번 나오나.

hook

• .claude/logs/ 확인.
• hook 스크립트를 stdin 시뮬레이션으로 직접 실행:

  echo '{"tool":"Bash","input":{"command":"git status"}}' | .claude/hooks/block-dangerous.sh

MCP

• 서버 stderr/로그.
• 응답 크기: 2026-04에 _meta["anthropic/maxResultSizeChars"] 오버라이드 추가됨 — 큰 응답이 잘리는 문제는 이걸로.

모델/버전

• claude --version 확인.
• 최근 changelog 비교: gh release list --repo anthropics/claude-code --limit 5.
• 모델 다운그레이드 임시 시도: --model claude-sonnet-4-5.