Claude Code 설치
목표 자기 머신(Windows·macOS)에 Claude Code 를 네이티브 방식으로 설치한다.
Claude Code 를 로컬 머신에 설치한다. 설치 방식은 네이티브로 한다.
1. 네이티브 vs npm
설치 경로는 네이티브 설치 스크립트와 npm 두 가지다. 네이티브를 쓴다.
| 네이티브 | npm | |
|---|---|---|
| 방식 | 공식 설치 스크립트 | npm i -g @anthropic-ai/claude-code |
| 자동 업데이트 | 지원(시작 시 확인 → 백그라운드 갱신) | 수동(npm update) |
| Node.js | 불필요 | Node 22+ 필요 |
자동 업데이트 때문에 네이티브가 기본이다.
2. 설치
macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex
3. 확인
새 터미널을 열고:
claude --version # 예: 2.1.211 (Claude Code)
claude doctor # 설치·설정·업데이트 상태 진단
command not found 면 PATH 가 새 셸부터 잡히므로 터미널을 새로 연다.
4. 자동 업데이트
시작 시 새 버전을 확인해 백그라운드로 받고 다음 실행 때 적용한다. 즉시 갱신은 claude update. 채널은 세션 내 /config 에서 latest(기본)·stable 로 고른다.
마무리
- 핵심 정리: 네이티브 설치 스크립트(
install.sh/install.ps1)로 로컬에 설치. Node 불필요, 자동 업데이트 지원. - 주의 사항: 설치 직후
claude --version이 안 잡히면 셸을 새로 연다(PATH). - 다음 시간: 설치한 Claude Code 에 로그인해 사용을 시작한다.