목차
개요
Claude Code를 Homebrew(brew)로 설치한 경우, Homebrew cask 패키지는 기본적으로 자동 업데이트가 되지 않습니다. 새로운 기능이나 보안 업데이트를 적용하려면 직접 업데이트 명령어를 실행해야 합니다.
이번 포스트에서는 수동 업데이트 방법, 자동 업데이트 설정, 그리고 네이티브 설치로의 전환 방법까지 정리합니다.
Claude Code의 설치 방법과 기본 사용법은 Claude Code 기초 지식과 기본 사용법을 참고해 주세요.
현재 버전 확인
업데이트 전에 현재 설치된 버전을 확인합니다.
claude --version업데이트 가능한 패키지가 있는지 확인하려면 brew outdated를 사용합니다.
brew outdated --caskclaude-code가 목록에 나타나면 새 버전이 사용 가능하다는 의미입니다.
수동 업데이트
Homebrew의 formula 정보를 최신으로 갱신한 후, Claude Code를 업그레이드합니다.
brew update && brew upgrade --cask claude-codebrew update: Homebrew 자체와 formula/cask 정보를 최신으로 갱신합니다.brew upgrade --cask claude-code: Claude Code cask를 최신 버전으로 업그레이드합니다.
brew upgrade claude-code만 실행해도 최신 Homebrew에서는 cask를 자동으로 인식하지만,--cask플래그를 명시하는 것이 더 명확합니다.
자동 업데이트 설정
매번 수동으로 업데이트하는 것이 번거롭다면, homebrew-autoupdate를 사용하여 백그라운드에서 자동으로 업데이트되도록 설정할 수 있습니다.
homebrew-autoupdate 설치
brew tap homebrew/autoupdate자동 업데이트 시작
brew autoupdate start --upgrade --cleanupstart: macOS의launchd를 사용하여 주기적으로brew update를 실행하도록 스케줄링합니다.--upgrade:brew update후 자동으로brew upgrade도 실행하여 패키지를 최신 버전으로 업그레이드합니다.--cleanup: 업그레이드 후 오래된 버전의 캐시를 자동으로 정리합니다.
기본 주기는 **24시간(86400초)**입니다. 주기를 변경하고 싶다면 초 단위로 지정합니다.
# 12시간마다 자동 업데이트
brew autoupdate start 43200 --upgrade --cleanup설정 확인 및 관리
# 현재 자동 업데이트 상태 확인
brew autoupdate status
# 자동 업데이트 중지
brew autoupdate stop
# 자동 업데이트 삭제 (스케줄 제거)
brew autoupdate delete이 설정은 Claude Code뿐만 아니라 Homebrew로 설치한 모든 패키지에 적용됩니다. 특정 패키지만 업데이트에서 제외하고 싶다면
brew pin <package>를 사용합니다.
네이티브 설치로 전환하기
Homebrew 대신 네이티브 설치 스크립트를 사용하면, Claude Code가 실행 시마다 자동으로 업데이트를 확인합니다. 자동 업데이트의 안정성이 더 높으므로, 업데이트 관리가 번거롭다면 네이티브 설치로 전환하는 것을 권장합니다.
1. Homebrew 버전 제거
brew uninstall --cask claude-code2. 네이티브 설치 스크립트 실행
curl -fsSL https://claude.ai/install.sh | bash3. 설치 확인
claude --version기존 Homebrew 설치에서 네이티브 설치로 전환할 때, Claude Code 내에서 /migrate-installer 명령어를 사용하면 기존 설정을 유지하면서 설치 방식을 전환할 수 있습니다.
claude
# Claude Code 내에서
> /migrate-installer업데이트 문제 해결
Auto-update failed 메시지
Claude Code 실행 시 Auto-update failed 메시지가 나타나는 경우, 대부분 파일 시스템 권한 문제입니다.
# Homebrew 디렉토리 권한 수정
sudo chown -R $(whoami) $(brew --prefix)/*
# 또는 Homebrew 재설치 후 Claude Code 재설치
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install --cask claude-code그래도 해결되지 않으면 네이티브 설치로 전환하는 것을 권장합니다.
Homebrew 캐시 문제
업그레이드가 실패하는 경우, 캐시를 정리한 후 다시 시도합니다.
brew cleanup
brew update
brew upgrade --cask claude-code완료
이것으로 Homebrew로 설치한 Claude Code의 업데이트 방법에 대해 알아보았습니다. 수동 업데이트, 자동 업데이트 설정, 네이티브 설치 전환까지 다뤘으니, 자신의 환경에 맞는 방법을 선택하여 항상 최신 버전의 Claude Code를 사용하시기 바랍니다.
제 블로그가 도움이 되셨나요? 하단의 댓글을 달아주시면 저에게 큰 힘이 됩니다!
앱 홍보
Deku가 개발한 앱을 한번 사용해보세요.Deku가 개발한 앱은 Flutter로 개발되었습니다.관심있으신 분들은 앱을 다운로드하여 사용해 주시면 정말 감사하겠습니다.
