Claude Code 시작하기
2. 설치 경로와 업데이트 채널3 / 9

설치는 취향이 아니라 버전 정책이다

네이티브·패키지 매니저·npm 경로와 latest/stable 채널 선택

개념 학습 45 XP 9분

권장 설치는 네이티브 인스톨러이고, 이 경로만 기본적으로 백그라운드 자동 업데이트됩니다. Homebrew·WinGet·리눅스 패키지 매니저 설치는 자동으로 올라가지 않아 누군가 brew upgrade나 winget upgrade를 실행해야 합니다. 문제는 버전이 곧 기능이라는 점입니다. Sonnet 5는 v2.1.197 이상, Fable 5는 v2.1.170 이상, Opus 4.8은 v2.1.154 이상이 필요하므로 뒤처진 설치는 모델 목록부터 다르게 보입니다. 그래서 설치 경로 결정은 항상 "무엇을 쓸 것인가"에서 역산합니다.

설치 경로업데이트 방식이 경로를 고르는 이유
네이티브 인스톨러백그라운드 자동 업데이트기본 권장, 팀 표준 환경
Homebrew claude-codebrew upgrade 수동stable 채널로 회귀 위험 회피
Homebrew claude-code@latestbrew upgrade 수동릴리스 즉시 신기능 검증
WinGetwinget upgrade 수동Windows 사내 배포 도구와 정합
npm 글로벌@latest 재설치기존 npm 파이프라인 호환 목적
npm으로 깔아도 설치되는 것은 동일한 네이티브 바이너리이며, 신규 표준에는 비권장입니다.
  1. 최소 버전 확정팀이 써야 할 모델·명령의 최소 버전을 먼저 적어 둡니다.
  2. 경로 선택자동 업데이트가 필요하면 네이티브, 사내 배포가 있으면 패키지 매니저를 씁니다.
  3. 채널 고정autoUpdatesChannel로 채널을, minimumVersion으로 하한선을 명시합니다.
  4. 검증 루틴claude --version과 claude doctor로 버전과 최근 업데이트 결과를 확인합니다.
이전