​
시스템 요구사항

  • 운영 체제: macOS 10.15+, Ubuntu 20.04+/Debian 10+, 또는 Windows 10+ (WSL 1, WSL 2, 또는 Git for Windows 포함)
  • 하드웨어: 4GB+ RAM
  • 소프트웨어: Node.js 18+
  • 네트워크: 인증 및 AI 처리를 위한 인터넷 연결 필요
  • 셸: Bash, Zsh 또는 Fish에서 최적으로 작동
  • 위치: Anthropic 지원 국가

​
추가 종속성

  • ripgrep: 일반적으로 Claude Code에 포함됩니다. 검색 기능이 실패하는 경우 검색 문제 해결을 참조하세요.

​
표준 설치

To install Claude Code, run the following command: 
npm install -g @anthropic-ai/claude-code
권한 문제와 보안 위험을 초래할 수 있으므로 sudo npm install -g를 사용하지 마세요. 권한 오류가 발생하는 경우 권장 해결책은 Claude Code 구성을 참조하세요.
일부 사용자는 개선된 설치 방법으로 자동 마이그레이션될 수 있습니다. 설치 후 claude doctor를 실행하여 설치 유형을 확인하세요.
설치 과정이 완료된 후, 프로젝트로 이동하여 Claude Code를 시작하세요: 
cd your-awesome-project
claude
Claude Code는 다음과 같은 인증 옵션을 제공합니다:
  1. Anthropic Console: 기본 옵션입니다. Anthropic Console을 통해 연결하고 OAuth 프로세스를 완료하세요. console.anthropic.com에서 활성 청구가 필요합니다. 사용량 추적 및 비용 관리를 위해 “Claude Code” 워크스페이스가 자동으로 생성됩니다.
  2. Claude App (Pro 또는 Max 플랜 포함): Claude Code와 웹 인터페이스를 모두 포함하는 통합 구독을 위해 Claude의 Pro 또는 Max 플랜을 구독하세요. 동일한 가격대에서 더 많은 가치를 얻으면서 한 곳에서 계정을 관리할 수 있습니다. Claude.ai 계정으로 로그인하세요. 시작 시 구독 유형과 일치하는 옵션을 선택하세요.
  3. 엔터프라이즈 플랫폼: 기존 클라우드 인프라를 사용한 엔터프라이즈 배포를 위해 Amazon Bedrock 또는 Google Vertex AI를 사용하도록 Claude Code를 구성하세요.
Claude Code는 자격 증명을 안전하게 저장합니다. 자세한 내용은 자격 증명 관리를 참조하세요.

​
Windows 설정

옵션 1: WSL 내에서 Claude Code
  • WSL 1과 WSL 2 모두 지원됩니다
옵션 2: Git Bash를 사용한 네이티브 Windows에서 Claude Code
  • Git for Windows가 필요합니다
  • 포터블 Git 설치의 경우 bash.exe 경로를 지정하세요: 
    $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"

​
대체 설치 방법

Claude Code는 다양한 환경에 맞는 여러 설치 방법을 제공합니다. 설치 중 문제가 발생하는 경우 문제 해결 가이드를 참조하세요.
설치 후 claude doctor를 실행하여 설치 유형과 버전을 확인하세요.

​
전역 npm 설치

위의 설치 단계에 표시된 전통적인 방법

​
네이티브 바이너리 설치 (베타)

기존 Claude Code 설치가 있는 경우 claude install을 사용하여 네이티브 바이너리 설치를 시작하세요. 새로 설치하는 경우 다음 명령을 실행하세요: macOS, Linux, WSL: 
# 안정 버전 설치 (기본값)
curl -fsSL https://claude.ai/install.sh | bash

# 최신 버전 설치
curl -fsSL https://claude.ai/install.sh | bash -s latest

# 특정 버전 번호 설치
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58
Alpine Linux 및 기타 musl/uClibc 기반 배포판: 네이티브 빌드에는 libgcc, libstdc++, ripgrep 설치가 필요합니다. 설치하고 (Alpine: apk add libgcc libstdc++ ripgrep) USE_BUILTIN_RIPGREP=0을 설정하세요.
Windows PowerShell: 
# 안정 버전 설치 (기본값)
irm https://claude.ai/install.ps1 | iex

# 최신 버전 설치
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) latest

# 특정 버전 번호 설치
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58
Windows CMD: 
REM 안정 버전 설치 (기본값)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

REM 최신 버전 설치
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd latest && del install.cmd

REM 특정 버전 번호 설치
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 1.0.58 && del install.cmd
네이티브 Claude Code 설치 프로그램은 macOS, Linux, Windows에서 지원됩니다.
오래된 별칭이나 심볼릭 링크를 제거했는지 확인하세요. 설치가 완료되면 claude doctor를 실행하여 설치를 확인하세요.

​
로컬 설치

  • npm을 통한 전역 설치 후 claude migrate-installer를 사용하여 로컬로 이동
  • 자동 업데이터 npm 권한 문제 방지
  • 일부 사용자는 이 방법으로 자동 마이그레이션될 수 있습니다

​
AWS 또는 GCP에서 실행

기본적으로 Claude Code는 Anthropic의 API를 사용합니다. AWS 또는 GCP에서 Claude Code 실행에 대한 자세한 내용은 서드파티 통합을 참조하세요.

​
Claude Code 업데이트

​
자동 업데이트

Claude Code는 최신 기능과 보안 수정 사항을 제공하기 위해 자동으로 최신 상태를 유지합니다.
  • 업데이트 확인: 시작 시 및 실행 중 주기적으로 수행
  • 업데이트 프로세스: 백그라운드에서 자동으로 다운로드 및 설치
  • 알림: 업데이트가 설치되면 알림을 받게 됩니다
  • 업데이트 적용: 다음에 Claude Code를 시작할 때 업데이트가 적용됩니다
자동 업데이트 비활성화: 셸 또는 settings.json 파일에서 DISABLE_AUTOUPDATER 환경 변수를 설정하세요: 
export DISABLE_AUTOUPDATER=1

​
수동 업데이트

claude update