시스템 요구사항 확인

  • 운영체제: macOS 10.15+, Ubuntu 20.04+/Debian 10+, 또는 WSL을 통한 Windows
  • 하드웨어: 최소 4GB RAM
  • 소프트웨어:
    • Node.js 18+
    • git 2.23+ (선택사항)
    • PR 워크플로우를 위한 GitHub 또는 GitLab CLI (선택사항)
    • 향상된 파일 검색을 위한 ripgrep (rg) (선택사항)
  • 네트워크: 인증 및 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 npmwhich node로 확인할 수 있으며, /mnt/c/가 아닌 /usr/로 시작하는 Linux 경로를 가리켜야 합니다. 이를 해결하려면 Linux 배포판의 패키지 관리자나 nvm을 통해 Node를 설치해보세요.

설치 및 인증

1

Claude Code 설치

Install NodeJS 18+, then run:

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

Do NOT use sudo npm install -g as this can lead to permission issues and security risks. If you encounter permission errors, see configure Claude Code for recommended solutions.

2

프로젝트로 이동

cd your-project-directory 
3

Claude Code 시작

claude
4

인증 완료

Claude Code는 여러 인증 옵션을 제공합니다:

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

프로젝트 초기화

처음 사용하는 사용자의 경우 다음을 권장합니다:

1

Claude Code 시작

claude
2

간단한 명령어 실행

summarize this project
3

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

/init 
4

생성된 CLAUDE.md 파일 커밋

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

Was this page helpful?