설치 및 업데이트

시스템 요구사항

항목	요구사항
Node.js	18.x 이상 (20.x LTS 권장)
npm	8.x 이상
OS	macOS 12+, Ubuntu 20.04+, Windows 10+ (WSL2)
RAM	최소 4GB (8GB 권장)
디스크	500MB 이상 여유 공간

---

설치

글로벌 설치 (권장)

npm install -g @anthropic-ai/claude-code

설치 확인

claude --version
which claude

npx로 설치 없이 실행

npx @anthropic-ai/claude-code

---

버전 관리

현재 버전 확인

claude --version

최신 버전으로 업데이트

npm update -g @anthropic-ai/claude-code

특정 버전 설치

npm install -g @anthropic-ai/claude-code@1.2.3

자동 업데이트 설정

Claude Code는 실행 시 새 버전이 있으면 알림을 표시합니다. 자동 업데이트 비활성화:

export CLAUDE_CODE_DISABLE_AUTOUPDATE=1

---

팀 환경 표준화

팀 전체가 동일한 버전을 사용하도록 관리합니다.

.nvmrc 활용

# 프로젝트 루트에 Node.js 버전 고정
echo "20" > .nvmrc

온보딩 스크립트 예시

#!/bin/bash
# setup-claude.sh

# Node.js 버전 확인
required_node="18"
current_node=$(node -v | cut -d'v' -f2 | cut -d'.' -f1)

if [ "$current_node" -lt "$required_node" ]; then
  echo "Node.js $required_node 이상이 필요합니다. 현재: v$current_node"
  exit 1
fi

# Claude Code 설치 또는 업데이트
if command -v claude &> /dev/null; then
  echo "Claude Code 업데이트 중..."
  npm update -g @anthropic-ai/claude-code
else
  echo "Claude Code 설치 중..."
  npm install -g @anthropic-ai/claude-code
fi

echo "Claude Code $(claude --version) 준비 완료"

---

프록시 환경 설정

회사 네트워크에서 프록시를 사용하는 경우:

export HTTPS_PROXY=http://proxy.company.com:8080
export HTTP_PROXY=http://proxy.company.com:8080
export NO_PROXY=localhost,127.0.0.1,.internal.company.com

---

제거

npm uninstall -g @anthropic-ai/claude-code

# 설정 파일 삭제 (선택)
rm -rf ~/.claude