​
시스템 요구사항 확인

  • 운영 체제: macOS 10.15+, Ubuntu 20.04+/Debian 10+, 또는 WSL을 통한 Windows
  • 하드웨어: 최소 4GB RAM
  • 소프트웨어:
    • Node.js 18+
    • git 2.23+ (선택사항)
    • PR 워크플로우를 위한 GitHub 또는 GitLab CLI (선택사항)
  • 네트워크: 인증 및 AI 처리를 위해 인터넷 연결 필요
  • 지역: 지원 국가에서만 사용 가능
WSL 설치 문제 해결현재 Claude Code는 Windows에서 직접 실행되지 않으며, 대신 WSL이 필요합니다. WSL에서 문제가 발생하는 경우:
  1. OS/플랫폼 감지 문제: 설치 중 오류가 발생하면 WSL이 Windows npm을 사용하고 있을 수 있습니다. 다음을 시도해보세요:
    • 설치 전에 npm config set os linux 실행
    • npm install -g @anthropic-ai/claude-code --force --no-os-check로 설치 (sudo 사용하지 마세요)
  2. Node를 찾을 수 없음 오류: claude를 실행할 때 exec: node: not found 오류가 표시되면, WSL 환경이 Windows의 Node.js 설치를 사용하고 있을 수 있습니다. which npm과 which node로 확인할 수 있으며, 이는 /mnt/c/가 아닌 /usr/로 시작하는 Linux 경로를 가리켜야 합니다. 이를 해결하려면 Linux 배포판의 패키지 매니저나 nvm을 통해 Node를 설치해보세요.

​
설치 및 인증

1

Claude Code 설치

To install Claude Code, run the following command:
npm install -g @anthropic-ai/claude-code
2

프로젝트로 이동

bash cd your-project-directory
3

Claude Code 시작

bash claude
4

인증 완료

Claude Code는 여러 인증 옵션을 제공합니다: 1. Anthropic Console: 기본 옵션입니다. Anthropic Console을 통해 연결하고 OAuth 프로세스를 완료하세요. console.anthropic.com에서 활성 결제가 필요합니다. 2. Claude App (Pro 또는 Max 플랜): Claude의 Pro 또는 Max 플랜에 구독하여 Claude Code와 웹 인터페이스를 모두 포함하는 통합 구독을 이용하세요. 동일한 가격대에서 더 많은 가치를 얻으면서 한 곳에서 계정을 관리할 수 있습니다. Claude.ai 계정으로 로그인하세요. 출시 중에는 구독 유형과 일치하는 옵션을 선택하세요. 3. 엔터프라이즈 플랫폼: 기존 클라우드 인프라를 사용하는 엔터프라이즈 배포를 위해 Amazon Bedrock 또는 Google Vertex AI를 사용하도록 Claude Code를 구성하세요.

​
프로젝트 초기화

처음 사용하는 사용자에게는 다음을 권장합니다:
1

Claude Code 시작

bash claude
2

간단한 명령 실행

bash summarize this project
3

CLAUDE.md 프로젝트 가이드 생성

bash /init
4

생성된 CLAUDE.md 파일 커밋

Claude에게 생성된 CLAUDE.md 파일을 저장소에 커밋하도록 요청하세요.