3과3-4
Claude Code 설치하기
Node.js와 Claude Code를 설치하고 첫 실행을 해봅니다
설치 전 준비물
Claude Code를 사용하려면 두 가지가 필요합니다.
1. Node.js: Claude Code가 실행되는 환경입니다. Node.js는 자바스크립트를 서버에서 실행하게 해주는 런타임입니다. 프로그래밍을 몰라도 됩니다. 설치 파일을 실행하는 수준입니다.
2. Anthropic 계정: Claude Code는 Claude API를 사용하므로 Anthropic 계정이 필요합니다. 사용량에 따라 요금이 부과되지만 처음에는 $5 크레딧이 제공됩니다.
설치는 macOS와 Windows 모두 지원하며, 약 10분이면 완료됩니다.
TIP: Node.js는 LTS(Long Term Support) 버전을 설치하세요. 홈페이지(nodejs.org)에서 다운로드하면 됩니다. LTS 버전이 가장 안정적입니다.
Claude Code 설치 단계별 가이드
Node.js 설치 후 터미널을 열고 아래 명령어를 실행합니다.
# 1. Node.js 설치 확인
node --version # v20.x.x 이상이면 OK
npm --version # 10.x.x 이상이면 OK
# 2. Claude Code 설치
npm install -g @anthropic-ai/claude-code
# 3. 설치 확인
claude --version
# 4. 로그인 (브라우저가 열립니다)
claude
# 처음 실행 시 Anthropic 계정으로 로그인하는 화면이 뜹니다.
# 로그인 후 터미널로 돌아오면 설치 완료!첫 실행 — Hello, Claude Code!
설치 후 아무 폴더에서 `claude` 명령어를 입력하면 Claude Code가 시작됩니다. 터미널에 프롬프트가 나타나면 자연어로 대화할 수 있습니다.
첫 번째로 해볼 것: 빈 폴더를 하나 만들고 그 안에서 claude를 실행한 뒤 '안녕하세요. 이 폴더에 index.html 파일을 만들고 Hello World를 출력하는 간단한 웹페이지를 만들어줘'라고 입력해보세요.
Claude Code가 파일을 생성하고, 코드를 설명하며, 브라우저에서 확인하는 방법까지 안내해줄 것입니다. 코드를 한 줄도 모르는 분도 첫 웹페이지를 만들 수 있습니다.
핵심 정리
- ✓Claude Code 설치는 Node.js 설치 후 npm install -g @anthropic-ai/claude-code 명령어 하나로 완료됩니다.
- ✓Anthropic 계정과 로그인이 필요하며, 처음 $5 크레딧이 제공됩니다.
- ✓설치 후 첫 실행에서 자연어로 웹페이지를 만들어보며 바이브코딩의 감각을 익히세요.
자주 묻는 질문
Claude Code 사용 요금은 얼마인가요?+
Claude Code는 Anthropic API를 사용하므로 토큰 기반 요금이 부과됩니다. 일반적인 개인 업무용으로는 월 $10~30 수준입니다. Claude Pro($20/월) 구독자는 Claude Code를 포함한 혜택을 받을 수 있습니다.
설치 중 오류가 나면 어떻게 하나요?+
오류 메시지를 그대로 복사해서 Claude에게 물어보세요. 'Claude Code 설치 중 이런 오류가 났어: [오류 메시지]'라고 하면 해결 방법을 안내해줍니다. 또는 관련 강의 페이지에서 설치 가이드를 확인하세요.