Claude Code 업데이트 삽질기
yoga.wasm 에러부터 중복 설치 문제까지
바이브 코딩으로 개발하던 평범한 어느 날, Claude Code가 친절하게 업데이트 알림을 띄워줬다. 그런데 이 '친절한' 업데이트가 시작한 삽질의 여정을 정리해보고자 한다.
1차 삽질: 친절한 업데이트의 배신
Claude Code를 사용하다 보면 가끔 이런 메시지가 뜬다.
cd ~/.claude/local && npm update @anthropic-ai/claude-code
"아, 업데이트가 있구나. 뭐 새로운 기능이라도 추가됐나?" 하면서 말 그대로 따라했다. 각설하고, 명령어 실행하니까 이게 웬걸?
Error: Cannot find module './yoga.wasm'
아니, 뭔 yoga.wasm이 없다는 거야? -_-
GitHub 이슈 트래커의 간결한 답변
이런 경우엔 바로 GitHub 이슈 트래커부터 확인해야 한다. 개발자의 본능이지.
https://github.com/anthropics/claude-code/issues/1103
들어가 보니까... 아, 역시나 똑같은 에러로 고생하는 사람들이 있더라. 그리고 Anthropic의 답변이 정말 간결명료했다.
"재설치 하세요"
아... 이렇게 간단한 답변이라니. 무튼 IT 세계에서는 "재설치" 만큼 확실한 해결책도 없긴 하다.
맥북 사용자의 특별한 고민
문제는 난 맥북에서 사용 중이라, 권한 문제 때문에 특별한 방법으로 설치해서 사용하고 있었다는 거다.
아래처럼 npm 권한 설정을 변경해서 사용했거든.
# npm 글로벌 디렉토리 설정
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH
source ~/.zshrc
npm install -g @anthropic-ai/claude-code
첫 번째 해결: 수동 제거의 고행
그냥 npm uninstall 하니까 안 되더라. 그래서 결국 일일히 다 지우고 다시 설치하는 방향으로 했다.
1. 수동으로 Claude Code 제거
# Claude Code 디렉토리 강제 삭제
sudo rm -rf /Users/pink/.npm-global/lib/node_modules/@anthropic-ai/claude-code
# @anthropic-ai 디렉토리 전체 확인 및 제거
sudo rm -rf /Users/pink/.npm-global/lib/node_modules/@anthropic-ai
# bin 디렉토리에서 claude 실행 파일 제거
rm -f ~/.npm-global/bin/claude
2. npm 캐시 정리
npm cache clean --force
3. 잔여 파일 확인
# Claude Code 관련 파일이 남아있는지 확인
ls -la ~/.npm-global/lib/node_modules/ | grep anthropic
ls -la ~/.npm-global/bin/ | grep claude
4. Claude Code 재설치
npm install -g @anthropic-ai/claude-code
5. 설치 확인
# 설치 위치 확인
which claude
# 실행 테스트
claude --version
이렇게 해서 문제가 해결됐다.
2차 삽질: 데자뷰의 공포
그런데... 또 Claude Code 업데이트 하다가 같은 문제가 발생했다.(아직은 베타라 좀 불안정한듯)
"아, 또?"
그래서 같은 방법으로 해결하려고 해보니... 어? 뭔가 다르다.
클로드 코드가 업데이트 되면서 이제 글로벌 설치가 가능해졌더라!
Claude Code 설치 방식의 진화
앞서 말한대로 맥에서 예전 Claude Code 설치는 까다로웠다.
보안 위험: sudo 사용으로 인한 잠재적 보안 문제
설치 실패: 권한 문제로 인한 설치 실패 빈발
그래서 npm 글로벌 디렉토리를 따로 설정해서 쓸 수밖에 없었는데, Anthropic이 사용자 피드백을 반영하여 설치 방식을 대폭 개선했다.
sudo 불필요: 사용자 레벨 설치 지원으로 관리자 권한 불필요
사용자 디렉토리: ~/.npm-global 디렉토리에 설치
향상된 보안: 시스템 파일 수정 없이 안전한 설치
격리된 환경: 사용자별 독립적인 설치 환경 제공
안정성 향상: 권한 충돌로 인한 설치 실패 방지
중복 설치 문제 진단
claude doctor 명령어로 중복 설치 여부를 확인할 수 있다.
claude doctor
# 혹은 클로드에서
/doctor
중복 설치가 있으면 이런 경고가 뜬다.
Warning: Multiple installations found
- npm-local at /Users/username/.claude/local
- npm-global at /Users/username/.npm-global/bin/claude
완전한 해결 방법
1단계: 기존 설치본 완전 제거
방법 1: npm을 통한 제거 (권장)
# 전역 설치본 제거
npm uninstall -g @anthropic-ai/claude-code
# 로컬 설치본 제거
rm -rf ~/.claude/local
방법 2: 수동 제거 (npm으로 제거가 안 될 경우)
# Anthropic 관련 디렉토리 수동 삭제
sudo rm -rf ~/.npm-global/lib/node_modules/@anthropic-ai
# 숨겨진 임시 파일 정리
sudo rm -rf ~/.npm-global/lib/node_modules/.claude-code*
# npm 캐시 정리
npm cache clean --force
rm -f ~/.npm-global/package-lock.json
2단계: 최신 버전 설치
방법: npm 설치
npm install -g @anthropic-ai/claude-code
3단계: 설치 확인
# 버전 확인
claude-code --version
# 진단 실행
claude doctor
# 기본 테스트
claude --help
문제 해결 팁
npm 권한 에러 발생 시
# npm 전역 디렉토리 재설정
rm -rf ~/.npm-global
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
npm install -g @anthropic-ai/claude-code
마무리
Claude Code의 설치 방식 개선으로 이제는 맥에서도 sudo 없이 안전하게 설치가 가능해졌다. 사용자별 독립적인 환경을 제공하고, 설치 실패 위험도 대폭 감소했다.
기존 사용자들은 위의 해결 방법을 통해 중복 설치 문제를 깔끔하게 정리하고 최신 버전의 안정적인 Claude Code를 사용할 수 있다.
바이브 코딩 도구가 점점 성숙하고 있다는 걸 체감한다. yoga.wasm 에러로 시작된 삽질이지만, 결국 더 나은 설치 환경을 경험할 수 있게 됐으니 뭐... 그런 하루였다 ㅎㅎ
