macOS에서 Claude Code 자동 업데이트 문제 해결하기

문제 상황

macOS에서 Claude Code를 사용하다 보면 자동 업데이트가 제대로 작동하지 않는 문제를 겪을 수 있습니다. 이 문제는 현재도 지속되고 있는 알려진 이슈입니다.

특히 주의할 점은 기본 제공되는 마이그레이션 명령어를 사용하면 조용히 실패(silent fail) 한다는 것입니다. 이 경우 Claude Code가 단순히 자체 제거만 수행하고 재설치는 진행되지 않아, 결과적으로 Claude Code가 완전히 사라지는 상황이 발생할 수 있습니다.

해결 방법

이 문제는 네이티브 설치(native installation) 방식으로 해결할 수 있습니다. 다음 단계를 순서대로 따라해 주세요.

1단계: 로컬 버전 제거

먼저 로컬에 설치된 @anthropic-ai/claude-code 패키지가 있다면 모두 제거합니다.

2단계: 전역 버전 제거

npm을 통해 전역으로 설치된 패키지를 제거합니다:

npm uninstall -g @anthropic-ai/claude-code

3단계: 네이티브 방식으로 재설치

기존 패키지를 모두 제거한 후, 공식 설치 스크립트를 사용하여 네이티브 방식으로 설치합니다:

curl -fsSL https://claude.ai/install.sh | bash

4단계: 설치 확인

새 터미널을 열고 다음 명령어로 설치가 정상적으로 완료되었는지 확인합니다:

claude doctor

마무리

위 과정을 통해 Claude Code의 자동 업데이트 문제를 해결하고 정상적으로 사용할 수 있게 됩니다. 핵심은 기존 설치를 완전히 제거한 후 네이티브 설치 방식으로 새롭게 설치하는 것입니다.

만약 claude doctor 명령어 실행 시 문제가 발견되면, 출력된 메시지를 확인하여 추가 조치를 취하시기 바랍니다.