클로드코드 02-installation

2. 설치 가이드

Claude Code의 시스템 요구사항, 플랫폼별 설치, 업데이트 및 제거 방법

2.1. 시스템 요구사항

- OS: macOS 13.0+, Windows 10 1809+, Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+
- 하드웨어: 4 GB+ RAM, x64 또는 ARM64 프로세서
- 네트워크: 인터넷 연결 필수
- 셸: Bash, Zsh, PowerShell, CMD

참고: Windows에서는 Git for Windows 설치를 권장한다. 설치되지 않은 경우 PowerShell을 대신 사용한다. WSL 환경에서는 Git for Windows가 필요 없다.

2.2. 설치 방법

2.2.1. Native Install (권장)

자동 업데이트가 지원되는 가장 간단한 방법이다.

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

팁: The token '&&' is not a valid statement separator라는 에러가 나면 PowerShell이 아닌 CMD에 있다. 'irm' is not recognized라는 에러는 CMD가 아닌 PowerShell에 있다.

2.2.2. Homebrew

brew install --cask claude-code

- claude-code: stable 채널 (약 1주일 지연, 주요 버그 스킵)
- claude-code@latest: latest 채널 (즉시 업데이트)

참고: Homebrew는 자동 업데이트를 지원하지 않는다. brew upgrade claude-code로 수동 업데이트해야 한다.

2.2.3. WinGet

winget install Anthropic.ClaudeCode

참고: WinGet도 자동 업데이트를 지원하지 않는다. winget upgrade Anthropic.ClaudeCode로 수동 업데이트한다.

2.2.4. Linux 패키지 매니저

apt (Debian/Ubuntu):

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc -o /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code

dnf (Fedora/RHEL):

sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-code

apk (Alpine Linux):

wget -O /etc/apk/keys/claude-code.rsa.pub https://downloads.claude.ai/keys/claude-code.rsa.pub
echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories
apk add claude-code

2.2.5. npm

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

참고: Node.js 18 이상이 필요하다. sudo npm install -g는 권한 문제와 보안 위험이 있으므로 사용하지 말 것.

2.3. Windows 설정

- Native Windows: Git for Windows 권장, Sandboxing 미지원, Windows 네이티브 프로젝트에 사용
- WSL 2: WSL 2 활성화 필요, Sandboxing 지원, Linux 툴체인 또는 sandboxed 실행에 사용
- WSL 1: WSL 1 활성화 필요, Sandboxing 미지원, WSL 2를 사용할 수 없을 때 사용

Native Windows + Git Bash:

Git for Windows를 설치하면 Claude Code가 낶부적으로 Bash tool을 사용한다. 설치 경로를 찾지 못하면 settings.json에 명시할 수 있다.

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

2.4. 설치 확인

claude --version

더 자세한 진단은 claude doctor를 실행한다.

2.5. 업데이트

2.5.1. 자동 업데이트

Native 설치는 백그라운드에서 자동 업데이트된다. 채널 설정:

{
  "autoUpdatesChannel": "latest"
}

- latest (기본): 새 기능을 즉시 받음
- stable: 약 1주일 지연된 안정적인 버전

2.5.2. 수동 업데이트

claude update

2.5.3. 특정 버전 설치

stable 버전:
curl -fsSL https://claude.ai/install.sh | bash -s stable

특정 버전:
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

2.6. 제거

2.6.1. Native 설치

macOS/Linux/WSL:
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Windows PowerShell:
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

2.6.2. 설정 파일 제거

macOS/Linux/WSL:
rm -rf ~/.claude
rm ~/.claude.json

프로젝트별 설정 (프로젝트 디렉토리에서):
rm -rf .claude
rm -f .mcp.json

참고: VS Code 확장, JetBrains 플러그인, Desktop 앱도 ~/.claude/에 데이터를 저장한다. 완전히 제거하려면 해당 앱들도 먼저 제거한다.

2.7. 바이너리 무결성 검증

릴리스는 GPG 키로 서명된 manifest.json을 제공한다.

1. 공개 키 다운로드 및 가져오기
2. manifest.json과 서명 다운로드
3. gpg --verify manifest.json.sig manifest.json
4. 바이너리 SHA256 체크섬 비교

지문: 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE