Claude Code 시작하기
Claude Code를 설치하고 인증하며 사용을 시작하는 방법을 알아보세요.
시스템 요구사항 확인
- 운영 체제: macOS 10.15+, Ubuntu 20.04+/Debian 10+, 또는 WSL을 통한 Windows
- 하드웨어: 최소 4GB RAM
- 소프트웨어:
- 네트워크: 인증 및 AI 처리를 위해 인터넷 연결 필요
- 지역: 지원 국가에서만 사용 가능
WSL 설치 문제 해결
현재 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
로 확인할 수 있으며, 이는/mnt/c/
가 아닌/usr/
로 시작하는 Linux 경로를 가리켜야 합니다. 이를 해결하려면 Linux 배포판의 패키지 매니저나nvm
을 통해 Node를 설치해보세요.
설치 및 인증
Claude Code 설치
Install NodeJS 18+, then run:
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.
프로젝트로 이동
bash cd your-project-directory
Claude Code 시작
bash claude
인증 완료
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를 구성하세요.
프로젝트 초기화
처음 사용하는 사용자에게는 다음을 권장합니다:
Claude Code 시작
bash claude
간단한 명령 실행
bash summarize this project
CLAUDE.md 프로젝트 가이드 생성
bash /init
생성된 CLAUDE.md 파일 커밋
Claude에게 생성된 CLAUDE.md 파일을 저장소에 커밋하도록 요청하세요.