[Claude Code 번역] Claude Code 시작하기 (Getting started with Claude Code)

원문: Getting started with Claude Code

Claude Code 설치, 인증, 사용 시작 방법을 안내합니다.

시스템 요구 사항 확인

운영체제: macOS 10.15+, Ubuntu 20.04+/Debian 10+, 또는 Windows(WSL을 통해)
하드웨어: 최소 4GB RAM
소프트웨어:
- Node.js 18+
- git 2.23+ (선택 사항)
- PR 워크플로우를 위한 GitHub 또는 GitLab CLI (선택 사항)
- 향상된 파일 검색을 위한 ripgrep(rg) (선택 사항)
네트워크: 인증 및 AI 처리를 위해 인터넷 연결 필요
지역: 지원되는 국가에서만 사용 가능

현재 Claude Code는 Windows에서 직접 실행되지 않으며, WSL이 필요합니다. WSL에서 문제가 발생할 경우:

OS/플랫폼 감지 문제: 설치 중 오류가 발생하면 WSL이 Windows의 npm을 사용할 수 있습니다. 다음을 시도하세요:
- 설치 전 npm config set os linux 실행
- npm install -g @anthropic-ai/claude-code --force --no-os-check로 설치 (절대 sudo 사용 금지)
Node를 찾을 수 없음 오류: claude 실행 시 exec: node: not found 오류가 발생하면, WSL 환경이 Windows의 Node.js를 사용할 수 있습니다. which npm과 which node 명령어로 경로가 /usr/로 시작하는지 확인하세요. 아니라면, 리눅스 패키지 매니저나 nvm으로 Node를 설치하세요.

NodeJS 18+를 설치한 후, 다음 명령어를 실행하세요:

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

sudo npm install -g는 권한 문제 및 보안 위험이 있으므로 사용하지 마세요. 권한 오류가 발생하면 Claude Code 설정 가이드를 참고하세요.

cd your-project-directory

claude

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

Anthropic Console: 기본 옵션. Anthropic Console을 통해 연결하고 OAuth 과정을 완료합니다. console.anthropic.com에서 활성 결제가 필요합니다.
Claude App (Max 요금제): Claude의 Max 요금제에 가입하면 Claude Code와 웹 인터페이스를 모두 사용할 수 있습니다. Claude.ai 계정으로 로그인하세요. 실행 시 구독 유형에 맞는 옵션을 선택하세요.
엔터프라이즈 플랫폼: Amazon Bedrock 또는 Google Vertex AI를 사용하여 기존 클라우드 인프라에서 Claude Code를 구성할 수 있습니다.