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.
프로젝트로 이동
Claude Code 시작
인증 완료
Claude Code는 여러 인증 옵션을 제공합니다:
- Anthropic Console: 기본 옵션입니다. Anthropic Console을 통해 연결하고 OAuth 프로세스를 완료하세요. console.anthropic.com에서 활성화된 결제가 필요합니다.
- Claude 앱(Max 플랜 포함): Claude의 Max 플랜을 구독하면 Claude Code와 웹 인터페이스를 모두 포함하는 단일 구독을 이용할 수 있습니다. 동일한 가격으로 더 많은 가치를 얻으면서 한 곳에서 계정을 관리하세요. Claude.ai 계정으로 로그인하세요. 시작할 때 구독 유형에 맞는 옵션을 선택하세요.
- 엔터프라이즈 플랫폼: 기존 클라우드 인프라를 사용하는 엔터프라이즈 배포를 위해 Amazon Bedrock 또는 Google Vertex AI를 사용하도록 Claude Code를 구성하세요.
프로젝트 초기화
처음 사용하는 사용자의 경우 다음을 권장합니다:
Claude Code 시작
간단한 명령어 실행
CLAUDE.md 프로젝트 가이드 생성
생성된 CLAUDE.md 파일 커밋
Claude에게 생성된 CLAUDE.md 파일을 저장소에 커밋하도록 요청하세요.