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

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

터미널이란 무엇인가

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

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

터미널 여는 방법

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

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

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

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

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

node --version

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

Node.js 설치 방법

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

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

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

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

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

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

claude --version

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

Claude Code는 Anthropic의 Claude API를 사용합니다. API를 사용하려면 API 키가 필요합니다.

1단계: Anthropic Console 접속

console.anthropic.com에 접속해 계정을 만듭니다. 이메일 인증 후 로그인합니다.

2단계: API 키 생성

로그인 후 왼쪽 메뉴에서 API Keys를 선택합니다. Create Key 버튼을 누르고 키 이름을 입력합니다(예: my-claude-code). 생성된 키는 sk-ant-로 시작하는 긴 문자열입니다.

주의: API 키는 생성 직후 한 번만 표시됩니다. 반드시 복사해서 안전한 곳에 보관하세요.

3단계: 크레딧 충전

API는 사용한 만큼 비용이 발생합니다. Console의 Billing 메뉴에서 크레딧을 충전합니다. 처음 시작한다면 $5~10 정도로 시작하는 것을 권장합니다. 가벼운 바이브코딩 작업 기준으로 $5가 꽤 오래 사용됩니다.

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

claude

처음 실행하면 API 키를 입력하라는 메시지가 나타납니다. 위에서 복사한 API 키를 붙여넣고 Enter를 누릅니다.

설정이 완료되면 아래와 같은 화면이 나타납니다.

Claude Code
✓ API key configured

>

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

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

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

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

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

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

터미널에서 특정 프로젝트 폴더로 이동하려면 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의 작업 품질을 크게 바꿔놓습니다.