시스템 요구사항

  • 운영 체제: 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 지원 국가

표준 설치

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에서 활성 결제가 필요합니다.
  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

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

네이티브 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를 시작할 때 업데이트가 적용됩니다

자동 업데이트 비활성화:

# 구성을 통해
claude config set autoUpdates false --global

# 또는 환경 변수를 통해
export DISABLE_AUTOUPDATER=1

수동 업데이트

claude update