안 된다, 뭐가 문제인지 모르겠다

doctor → status → context 순으로 확인한다. 재현하지 못하면 원인을 모르는 것이다.

증상별로 고치기 전에 상태를 먼저 읽는다. 세 명령이 대부분의 원인을 짚어준다.

1. 설정·인증·경로를 한 번에 점검한다

claude doctor 또는 세션 안에서 /doctor. 버전과 인증 상태도 같이 본다.

claude --version && claude auth status && claude doctor

/context 로 사용량을 보고 찼으면 /clear 또는 /compact. "느려졌다"의 가장 흔한 원인이다.

--safe-mode 는 커스터마이제이션을 전부 끄고, --bare 는 훅·스킬·플러그인·MCP를 건너뛴다. 이걸로 정상 동작하면 원인은 내 설정에 있다. 이분법으로 범위를 반씩 줄이는 게 가장 빠르다.

claude install stable 로 네이티브 바이너리를 다시 깐다. npm으로 깔았던 흔적이 남아 충돌하는 경우가 있다.

--verbose 로 상세 로그를 켠다. 추측 대신 실제 호출을 본다.

고쳤다고 선언하기 전에 양방향으로 확인할 것 — 고친 상태에서 되는지, 일부러 되돌리면 다시 깨지는지. 되돌려도 잘 돌아가면 원인을 잘못 짚은 것이고 진짜 원인은 아직 남아 있다.

데이터 src/_data/tasks/it-broke.yaml 틀린 게 있으면 이 파일을 고치면 사이트·검색·치트시트가 같이 바뀐다.