Claude Code 업데이트 오류 - 원인은 중복 설치

증상

Claude Code를 실행하려는데 갑자기 에러가 나기 시작했다. 요청하는 대로 claude update 를 실행해도 문제는 지속되었다.

$ claude
It looks like your version of Claude Code (0.2.9) needs an update.
A newer version (1.0.24 or higher) is required to continue.

To update, please run:
    claude update

This will ensure you have access to the latest features and improvements.

원인

claude 바이너리가 두 개 였다. 챗GPT는 원인을 다음으로 추측하는데 솔직히 나는 왜 이렇게 되었는지 모르겠다. 하하

• npm 글로벌 설치와 다른 패키지 매니저 설치가 충돌
  • npm으로 처음 설치한 후, 다른 방법으로 재설치했을 때
  • 시스템에 여러 Node.js 버전 관리 도구(nvm, n 등)를 사용하는 경우
• PATH 우선순위 문제
  • 구버전 바이너리가 PATH에서 우선순위가 높은 위치에 있어서 새버전보다 먼저 실행됨

문제 해결

1. 낡은 바이너리 확인·제거

❯ which claude
/Users/username/.npm-global/bin/claude

❯ claude --version
0.2.9

❯ rm -f /Users/username/.npm-global/bin/claude

1. 정상 바이너리 확인

❯ which claude
/Users/username/.nvm/versions/node/v22.15.1/bin/claude

❯ claude --version
1.0.59 (Claude Code)

1. 공식 업그레이드 및 버전 확인

❯ claude update
Current version: 1.0.59
Checking for updates...
New version available: 1.0.61 (current: 1.0.59)
Installing update...
Using global installation update method...
Successfully updated from 1.0.59 to version 1.0.61

❯ claude --version
1.0.61 (Claude Code)