Claude Code, npm 설치 → 네이티브 설치로 완전 이전

왜 바뀌었나

npm 글로벌 설치는 Node 버전에 민감했고, 업데이트 자동화가 어려웠으며, VS Code·JetBrains·Desktop 등 서피스별로 다른 바이너리를 관리하기 복잡했다. 네이티브 단일 바이너리로 이 문제를 해결했다.

권장 설치 방법

macOS / Linux / WSL

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

Windows (PowerShell)

irm https://claude.ai/install.ps1 | iex

Windows (CMD)

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Homebrew (macOS)

brew install --cask claude-code

WinGet (Windows)

winget install Anthropic.ClaudeCode

확인

claude --version
claude  # 첫 실행 시 브라우저 로그인

기존 npm 설치자 정리

npm uninstall -g @anthropic-ai/claude-code
which claude    # 경로가 예전 npm 쪽이면 제거되지 않은 것
hash -r         # 쉘 캐시 리셋

달라진 실제 경험

• 자동 업데이트 내장: claude update
• CI에서도 curl ... | bash 한 줄로 설치 가능
• Node 미설치 환경에서도 동작 (Rust 도구 개발자들도 사용 가능)
• VS Code / JetBrains 확장이 같은 바이너리를 reuse

요구사항

• 유료 Claude 구독 (Pro / Max / Team / Enterprise) — Free로는 사용 불가
• 최초 실행 시 브라우저 OAuth 로그인

프로젝트 루트에 CLAUDE.md 두는 패턴

Claude Code가 작업 시 자동 참고하는 프로젝트 지시서. 여기에 프로젝트 규칙·코딩 컨벤션·금지 사항을 적어두면 매번 설명할 필요 없음.