Claude Code 설치 방법 — 터미널부터 첫 대화까지 단계별 가이드

바이브코딩을 시작하려면 가장 먼저 도구를 설치해야 합니다. 이 글에서는 Claude Code를 처음 설치하는 과정을 터미널 사용법부터 첫 번째 대화까지 단계별로 안내합니다. 개발 경험이 없어도 따라올 수 있도록 각 단계를 최대한 자세히 설명합니다.

터미널이란 무엇인가

터미널은 컴퓨터에 텍스트 명령을 입력해서 작업을 수행하는 도구입니다. 마우스로 아이콘을 클릭하는 대신, 키보드로 명령어를 입력해 프로그램을 설치하거나 실행합니다.

처음에는 낯설게 느껴지지만, 바이브코딩에서 터미널을 쓰는 명령어는 몇 가지로 정해져 있어 금방 익숙해집니다.

터미널 여는 방법

운영체제	방법
macOS	`Command + Space`로 Spotlight 검색 → “터미널” 입력 → Enter
Windows	`Windows + R` → `cmd` 입력 → Enter (또는 PowerShell 검색)

터미널을 열면 아래와 같은 화면이 나타납니다. 커서가 깜빡이고 있다면 명령어를 입력할 준비가 된 것입니다.

사용자이름@컴퓨터이름 ~ %

사전 준비: Node.js 설치

Claude Code는 Node.js 환경에서 동작합니다. 먼저 Node.js가 설치되어 있는지 확인합니다.

터미널에 아래 명령어를 입력하고 Enter를 누릅니다.

node --version

v20.0.0 같은 버전 숫자가 나오면 이미 설치된 것입니다. 아무것도 나오지 않거나 오류가 뜨면 Node.js를 설치해야 합니다.

Node.js 설치 방법

nodejs.org에 접속해 LTS 버전(Long Term Support, 안정 버전)을 다운로드합니다. 설치 파일을 실행하고 기본 설정 그대로 완료합니다.

설치 후 터미널을 새로 열고 node --version을 다시 실행해 버전이 표시되면 정상입니다.

Claude Code 설치

Node.js가 준비됐으면 Claude Code를 설치합니다. 터미널에 아래 명령어를 입력합니다.

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

-g는 컴퓨터 전체에서 사용할 수 있도록 전역 설치한다는 의미입니다. 설치에는 1~2분 정도 걸립니다.

설치가 완료되면 아래 명령어로 확인합니다.

claude --version

버전 번호가 출력되면 정상적으로 설치된 것입니다.

로그인 방법 정하기: 구독 또는 API 키

Claude Code를 사용하려면 로그인이 필요합니다. 로그인 방법은 크게 두 가지이며, 대부분의 개인 사용자에게는 첫 번째 방법을 권장합니다.

방법 1 (권장): Claude 구독으로 로그인

Claude Pro나 Max 같은 구독 요금제를 쓰고 있다면, 별도의 API 키 발급이나 크레딧 충전 없이 그 계정으로 바로 로그인할 수 있습니다. 사용량은 구독 요금제 한도 안에서 처리되므로, 매달 정액으로 쓰면서 사용할 때마다 비용이 얼마 나올지 신경 쓰지 않아도 됩니다. 아직 구독이 없다면 claude.ai에서 요금제를 확인할 수 있습니다.

방법 2: Anthropic API 키 사용

구독 대신 사용한 만큼 비용을 지불하는 방식(pay-as-you-go)을 원한다면 API 키를 발급받아 사용할 수 있습니다.

console.anthropic.com에 접속해 계정을 만들고 로그인합니다.
왼쪽 메뉴에서 API Keys를 선택한 뒤 Create Key를 눌러 키를 만듭니다. 키는 sk-ant-로 시작하는 긴 문자열이며, 생성 직후 한 번만 표시되므로 안전한 곳에 복사해 둡니다.
Billing 메뉴에서 크레딧을 충전합니다. 처음이라면 $5~10 정도면 가벼운 바이브코딩 작업을 꽤 오래 할 수 있습니다.

API 키 방식은 사용한 토큰만큼 요금이 청구됩니다. 구독 로그인은 정액제라 사용량 예측이 쉽고, 초보자라면 어느 쪽이든 부담이 크지 않습니다.

Claude Code 첫 실행

터미널에서 작업할 폴더로 이동한 뒤 Claude Code를 실행합니다.

claude

처음 실행하면 로그인 방법을 선택하는 화면이 나타납니다. 구독으로 로그인하려면 Claude 계정 로그인을 선택합니다. 웹 브라우저가 열리면 계정으로 로그인해 인증을 마칩니다. API 키를 쓰기로 했다면 해당 방법을 선택한 뒤 앞에서 복사한 키를 붙여넣고 Enter를 누릅니다.

로그인이 완료되면 아래와 같은 화면이 나타납니다.

Claude Code

>

> 뒤에 커서가 깜빡이면 준비가 된 것입니다.

첫 번째 프롬프트 보내기

Claude Code와 첫 대화를 시작해봅니다. > 뒤에 아래를 입력하고 Enter를 누릅니다.

안녕하세요. 간단한 HTML 파일을 하나 만들어주세요. 제목은 "안녕, 바이브코딩"이고, 가운데 정렬된 큰 텍스트로 "AI와 함께 만든 첫 페이지"라고 표시해주세요.

Claude Code가 파일을 생성하려고 할 때 권한을 묻는 메시지가 나타나면 y를 입력하고 Enter를 누릅니다.

잠시 후 index.html 파일이 생성됩니다. 이 파일을 브라우저에서 열면 방금 요청한 페이지가 나타납니다.

자주 쓰는 Claude Code 명령어

Claude Code를 사용하면서 알아두면 유용한 기본 명령어입니다.

명령어	설명
`claude`	Claude Code 실행
`/help`	사용 가능한 명령어 목록 표시
`/clear`	대화 내용 초기화
`/exit`	Claude Code 종료
`Ctrl + C`	현재 작업 중단

폴더 이동 방법

터미널에서 특정 프로젝트 폴더로 이동하려면 cd 명령어를 사용합니다.

cd 폴더경로

예를 들어 바탕화면에 my-project라는 폴더를 만들고 그 안에서 작업하려면 아래와 같이 입력합니다.

# macOS
cd ~/Desktop/my-project

# Windows
cd C:\Users\사용자이름\Desktop\my-project

현재 어느 폴더에 있는지 확인하려면 아래 명령어를 사용합니다.

# macOS / Linux
pwd

# Windows
cd

정리

지금까지 터미널을 열고, Node.js와 Claude Code를 설치하고, API 키를 발급해서 첫 번째 프롬프트를 보내는 과정을 마쳤습니다.

다음 편에서는 Claude Code가 내 프로젝트를 제대로 이해하도록 CLAUDE.md 파일을 작성하는 방법을 다룹니다. 이 파일 하나가 AI의 작업 품질을 크게 바꿔놓습니다.