핑크곰: Claude Code 업데이트가 yoga.wasm을 못 찾는 macOS 삽질기

배경

2025년 7월 30일, macOS에서 cd ~/.claude/local && npm update @anthropic-ai/claude-code 후 “yoga.wasm module not found” 에러를 만난 핑크곰의 디버깅 일지.

접근

GitHub 이슈 트래커는 재설치를 권장. macOS는 sudo를 피하기 위해 npm 권한 특별 설정 필요. 업데이트가 두 npm 디렉터리(~/.claude/local, ~/.npm-global)에 중복 설치 생성. claude doctor 명령어로 진단. 해법: 완전 제거 → 캐시 정리 → npm 글로벌로 새로 설치.

결과

재설치로 복구. 그러나 “그냥 업데이트”가 평범한 사용자에게는 위험한 함정이라는 사실 노출.

교훈

npm 글로벌 패키지의 권한·경로 문제는 OS·설치 방식에 따라 미묘하게 깨진다. 평범한 업데이트 명령에도 claude doctor 같은 진단 도구 사용이 필요하다.

원문 인용

“yoga.wasm module not found” 의역: yoga.wasm 모듈을 찾지 못함 — 업데이트 후 가장 흔한 깨짐.