메인 콘텐츠로 건너뛰기

​
시스템 요구사항

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

​
추가 종속성

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

​
표준 설치

To install Claude Code, use one of the following methods:
일부 사용자는 개선된 설치 방법으로 자동 마이그레이션될 수 있습니다.
설치 프로세스가 완료된 후 프로젝트로 이동하여 Claude Code를 시작하세요: 
cd your-awesome-project
claude
Claude Code는 다음 인증 옵션을 제공합니다:
  1. Claude Console: 기본 옵션입니다. Claude Console을 통해 연결하고 OAuth 프로세스를 완료하세요. console.anthropic.com에서 활성 청구가 필요합니다. “Claude Code” 워크스페이스가 사용 추적 및 비용 관리를 위해 자동으로 생성됩니다. Claude Code 워크스페이스에 대한 API 키를 생성할 수 없습니다. 이는 Claude Code 사용 전용입니다.
  2. Claude App (Pro 또는 Max 플랜 포함): Claude의 Pro 또는 Max 플랜을 구독하여 Claude Code와 웹 인터페이스를 모두 포함하는 통합 구독을 받으세요. 같은 가격에 더 많은 가치를 얻으면서 한 곳에서 계정을 관리하세요. Claude.ai 계정으로 로그인하세요. 시작 중에 구독 유형과 일치하는 옵션을 선택하세요.
  3. 엔터프라이즈 플랫폼: 기존 클라우드 인프라를 사용한 엔터프라이즈 배포를 위해 Claude Code를 Amazon Bedrock 또는 Google Vertex AI를 사용하도록 구성하세요.
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를 실행하여 설치 유형 및 버전을 확인하세요.

​
네이티브 설치 옵션

네이티브 설치는 권장 방법이며 여러 이점을 제공합니다:
  • 하나의 자체 포함 실행 파일
  • Node.js 종속성 없음
  • 개선된 자동 업데이터 안정성
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을 설정하세요.
Homebrew를 통해 설치된 Claude Code는 DISABLE_AUTOUPDATER 환경 변수로 명시적으로 비활성화되지 않는 한 brew 디렉토리 외부에서 자동 업데이트됩니다 (자동 업데이트 섹션 참조).
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
설치하기 전에 오래된 별칭이나 심볼릭 링크를 제거했는지 확인하세요.

​
NPM 설치

NPM이 선호되거나 필요한 환경의 경우: 
npm install -g @anthropic-ai/claude-code
sudo npm install -g를 사용하지 마세요. 이는 권한 문제 및 보안 위험으로 이어질 수 있습니다. 권한 오류가 발생하면 Claude Code 구성에서 권장 솔루션을 참조하세요.

​
AWS 또는 GCP에서 실행

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

​
Claude Code 업데이트

​
자동 업데이트

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

​
수동으로 업데이트

claude update