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

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

- Canonical: https://learning.reopt.ai/en/courses/claude-code-getting-started/lessons/ccgs-m2-concept
- Language: en
- HTML: https://learning.reopt.ai/en/courses/claude-code-getting-started/lessons/ccgs-m2-concept

---

[Getting started with Claude Code](/en/courses/claude-code-getting-started) 2. 설치 경로와 업데이트 채널 3 / 9

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

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

권장 설치는 네이티브 인스톨러 이고, 이 경로만 기본적으로 백그라운드 자동 업데이트됩니다. Homebrew·WinGet·리눅스 패키지 매니저 설치는 자동으로 올라가지 않아 누군가 brew upgrade 나 winget upgrade 를 실행해야 합니다. 문제는 버전이 곧 기능이라는 점입니다. Sonnet 5는 v2.1.197 이상, Fable 5는 v2.1.170 이상, Opus 4.8은 v2.1.154 이상이 필요하므로 뒤처진 설치는 모델 목록부터 다르게 보입니다. 그래서 설치 경로 결정은 항상 "무엇을 쓸 것인가"에서 역산합니다.
최소 버전을 먼저 적고 채널을 나중에 고른다 쓰려는 모델·명령의 최소 버전을 먼저 확정한 뒤 채널을 정합니다. stable 은 latest 보다 보통 약 1주 늦고 큰 회귀가 있는 릴리스를 건너뛰므로, 최신 기능이 필요하면 두 채널을 목적별로 분리합니다.

| 설치 경로 | 업데이트 방식 | 이 경로를 고르는 이유 |
| 네이티브 인스톨러 | 백그라운드 자동 업데이트 | 기본 권장, 팀 표준 환경 |
| Homebrew claude-code | brew upgrade 수동 | stable 채널로 회귀 위험 회피 |
| Homebrew claude-code@latest | brew upgrade 수동 | 릴리스 즉시 신기능 검증 |
| WinGet | winget upgrade 수동 | Windows 사내 배포 도구와 정합 |
| npm 글로벌 | @latest 재설치 | 기존 npm 파이프라인 호환 목적 |

npm으로 깔아도 설치되는 것은 동일한 네이티브 바이너리이며, 신규 표준에는 비권장입니다.

- 1 최소 버전 확정 팀이 써야 할 모델·명령의 최소 버전을 먼저 적어 둡니다.

- 2 경로 선택 자동 업데이트가 필요하면 네이티브, 사내 배포가 있으면 패키지 매니저를 씁니다.

- 3 채널 고정 autoUpdatesChannel 로 채널을, minimumVersion 으로 하한선을 명시합니다.

- 4 검증 루틴 claude --version 과 claude doctor 로 버전과 최근 업데이트 결과를 확인합니다.

실무에 남길 기준

- 패키지 매니저 설치는 자동 업데이트되지 않으므로 업그레이드 담당자가 필요하다
- npm update -g 는 최초 설치 시점의 semver 범위를 지켜 최신 릴리스로 넘어가지 못할 수 있다
- 백그라운드 확인만 끄려면 DISABLE_AUTOUPDATER=1 , 수동 경로까지 막으려면 DISABLE_UPDATES 를 쓴다

[Previous](/en/courses/claude-code-getting-started/lessons/ccgs-m1-quiz) Got it · Continue

---

Site guide for agents: https://learning.reopt.ai/llms.txt · Sitemap: https://learning.reopt.ai/sitemap.xml · Contact: https://learning.reopt.ai/contact