1장. 바이브코딩이란 & 개발 환경 셋업

1부를 시작하며. 이 부의 목표는 두 가지입니다. 첫째, 코드를 한 줄도 직접 타이핑하지 않고 AI에게 시켜서 웹 서비스를 만드는 방법(바이브코딩)에 익숙해지는 것. 둘째, 그렇게 만든 서비스를 Docker라는 도구로 "어디서든 똑같이 실행되는 상자"에 담는 것까지입니다.

지금 아무것도 깔려 있지 않은 노트북이라도 괜찮습니다. 이 1장은 그 노트북을 개발할 수 있는 상태로 만드는 것부터 시작합니다. 설명이 조금 길지만, 여기서 환경을 제대로 갖춰 두면 책 끝까지 막힘 없이 진행할 수 있습니다. 한 단계씩 천천히 따라오세요.

[지금 여기]

우리는 앞으로 22단계를 거쳐 "라이브 투표 서비스"를 직접 만들고, 컨테이너에 담아, AWS 클라우드에 배포합니다. 아래가 그 전체 여정 지도입니다. 지금은 맨 처음, 1단계에 있습니다.

1. 1장개발 환경 준비 (터미널 / Node.js / Git / GitHub / VS Code / Claude Code)
2. 2장Claude Code 사용법 익히기
3. 3장무엇을 만들지 기획 (라이브 투표 서비스)
4. 4장로컬에서 서비스 만들기 (React + Express + PostgreSQL)
5. 5장Docker 개념
6. 6장Dockerfile 작성
7. 7장컨테이너 빌드·실행
8. 8장AWS 시작 (계정 / IAM / 리전 / 비용)
9. 9장이미지 태깅
10. 10장ECR에 이미지 올리기
11. 11장VPC 네트워크 구성
12. 12장RDS 데이터베이스 생성
13. 13장SSM 터널로 RDS 초기화
14. 14장ECS Fargate + ALB로 배포 (기본 완성)
15. 15장CI/CD (GitHub Actions)
16. 16장IaC (Terraform)
17. 17장배포 자동화 연결
18. 18장현업 운영 구조 이해
19. 19장무중단 배포
20. 20장신규 버전 배포 & 롤백
21. 21장(심화) 프론트를 Vercel로 분리 배포
22. 22장마무리 (회고 + 리소스 삭제)

• 방금 끝낸 것: 아직 없습니다. 여기가 출발점입니다.
• 이번 장에서 하는 것: 아무것도 없는 노트북에 개발 도구를 갖추고, Claude Code를 실행해 첫 대화를 나눕니다.

이번 장에서 완성되는 것

한 문장으로: 내 노트북에서 vote-app 폴더를 열고 Claude Code를 실행해, AI와 한국어로 첫 대화를 나눌 수 있게 됩니다.

이렇게 되면 성공입니다: VS Code 안의 터미널에 claude라고 입력했을 때 AI 입력창이 뜨고, "이 폴더에 뭐가 들어 있어?"라고 물으면 AI가 실제로 내 폴더를 들여다보고 답해 줍니다.

사전 조건

이 장은 여정의 맨 처음이라 "앞 장 결과물"은 필요 없습니다. 대신 아래 두 가지만 준비돼 있으면 됩니다.

• 인터넷이 되는 노트북 (Windows 또는 macOS). 프로그램을 여러 개 내려받습니다.
• Claude 유료 플랜(Pro 또는 Max). Claude Code는 유료 플랜이 있어야 쓸 수 있습니다. 아직 없다면 이 장의 1.8절에서 안내하니, 그때 준비해도 됩니다. 미리 https://claude.ai 에서 결제해 두면 더 매끄럽습니다.

이 두 가지 외에 사전 지식은 필요 없습니다. "터미널이 뭔지", "Git이 뭔지" 전혀 몰라도 됩니다. 이 장에서 하나씩 설명합니다.

1.1 바이브코딩이 뭔가

먼저 용어부터 정리하고 넘어갑시다.

전통적인 개발은 이렇습니다. 개발자가 프로그래밍 언어 문법을 외우고, 한 줄 한 줄 코드를 타이핑하고, 오타가 나면 고치고, 안 되면 검색해서 해결책을 찾습니다. 이 과정을 배우는 데만 보통 몇 달에서 몇 년이 걸립니다.

바이브코딩은 순서를 바꿉니다. 여러분이 하는 일은 이런 식입니다.

• "투표를 만들고 결과를 보여주는 웹사이트를 만들어 줘"
• (AI가 코드를 만들어 보여줌)
• "결과를 막대그래프로 보여줬으면 좋겠어"
• (AI가 수정함)

즉, 여러분은 '무엇을 원하는지'만 정확히 말하면 되고, '어떻게 코드로 옮기는지'는 AI가 담당합니다. 이 책에서 여러분은 코드를 직접 짜지 않습니다. 대신 AI에게 잘 지시하고, 결과를 확인하고, 방향을 잡는 법을 배웁니다.

한 가지 오해를 미리 풀어 두겠습니다. 바이브코딩이라고 해서 개발 지식이 전혀 필요 없는 것은 아닙니다. "프론트엔드", "서버", "데이터베이스"가 각각 무슨 역할인지 정도는 알아야 AI에게 제대로 지시할 수 있습니다. 그래서 이 책은 그런 개념들을 필요한 만큼 그때그때 설명하면서 진행합니다.

1.2 우리가 쓸 도구 — Claude Code란

바이브코딩을 하려면 "AI에게 말을 걸고, AI가 실제로 내 컴퓨터에 파일을 만들고 고칠 수 있는" 도구가 필요합니다. 이 책에서는 Claude Code를 씁니다.

여러분이 웹브라우저에서 챗봇과 대화해 본 적이 있다면 그 느낌과 비슷합니다. 다만 결정적인 차이가 있습니다. 웹 챗봇은 코드를 "글로 보여주기만" 합니다. 그 코드를 복사해서 내 컴퓨터 어딘가에 붙여넣고 실행하는 건 사람 몫이죠.

Claude Code는 다릅니다. 실제로 내 컴퓨터의 폴더 안에서 파일을 만들고, 수정하고, 프로그램을 실행합니다. "투표 서비스 만들어 줘"라고 하면 진짜로 프로젝트 폴더에 파일들이 생깁니다. 그래서 바이브코딩에 잘 맞습니다.

Claude Code는 터미널이라는 화면 안에서 돕니다. 터미널이 처음이라면 뒤에서 자세히 설명하니 걱정하지 마세요. 이 책에서는 그 터미널을 VS Code라는 프로그램 안에 들어 있는 것으로 통일해서 씁니다. 이제부터 1.3절부터 차례로, Claude Code를 쓰기 위해 필요한 도구들을 하나씩 설치하고 마지막에 Claude Code까지 실행합니다. 순서대로만 따라오면 됩니다.

1.3 Node.js 설치

가장 먼저 Node.js를 설치합니다.

왜 필요한지만 짚고 갑시다. 우리가 이 책에서 만들 서비스(프론트엔드와 API 서버)는 자바스크립트로 만듭니다. 자바스크립트로 만든 프로그램을 내 컴퓨터에서 실행하려면 Node.js가 필요합니다. 또한 Claude Code를 설치할 때 쓰는 npm이라는 도구도 Node.js에 딸려 옵니다.

설치 방법

1. 웹브라우저(크롬, 사파리, 엣지 등 아무거나)를 열어 주소창에 https://nodejs.org 를 입력해 접속합니다.
2. 화면 가운데에 큰 버튼 두 개가 보입니다. 그중 LTS라고 적힌 쪽을 눌러 설치 파일을 내려받습니다.
   • [용어] LTS(Long Term Support): "오랫동안 안정적으로 지원되는 버전"이라는 뜻입니다. 최신 실험 버전 대신 이 안정 버전을 쓰는 게 안전합니다.
3. 내려받은 설치 파일을 더블클릭해 실행하고, 나오는 대로 "다음(Continue) → 다음 → 동의(Agree) → 설치(Install)"를 눌러 끝까지 진행합니다. 특별히 바꿀 설정은 없습니다. 중간에 비밀번호를 물으면 내 노트북 로그인 비밀번호를 입력합니다.

1.4 Git 설치 & GitHub 계정

이번에는 이름이 비슷해서 헷갈리는 두 가지, Git과 GitHub를 구분해서 알아 둡시다.

한 문장으로 정리하면, Git은 내 컴퓨터에서 코드 이력을 관리하는 도구, GitHub는 그 코드를 올려 두는 인터넷 창고입니다.

이 둘이 왜 필요할까요? 우리가 만든 서비스는 3부에서 GitHub에 올려 두고, "GitHub에 코드가 올라오면 자동으로 서버에 배포되게" 만들 겁니다. 그 준비를 위해 지금 미리 갖춰 둡니다.

Git 설치하기

• macOS: macOS에는 대개 Git이 이미 들어 있습니다. 없더라도 뒤에서 VS Code 터미널을 처음 열 때 자동으로 설치를 안내받게 됩니다. 그래서 지금은 따로 설치할 필요가 없습니다. 만약 미리 확실히 깔아 두고 싶다면, 뒤에서(1.7절) 터미널을 연 다음 xcode-select --install 을 입력해 안내대로 설치하면 Git이 함께 설치됩니다. (지금 단계에서는 그냥 넘어가도 됩니다.)
• Windows: 웹브라우저에서 https://git-scm.com 에 접속해 다운로드 버튼을 눌러 설치 파일을 내려받아 실행합니다. 설정은 기본값 그대로 "Next"를 눌러 끝까지 진행하면 됩니다.

Git 설치 역시 지금은 파일 실행만 끝내면 됩니다. 버전 확인은 1.7절에서 VS Code 터미널로 함께 합니다.

GitHub 계정 만들기

1. 웹브라우저에서 https://github.com 에 접속합니다.
2. 오른쪽 위 Sign up(가입) 버튼을 누릅니다.
3. 화면 안내에 따라 이메일 → 비밀번호 → 사용자 이름(username)을 차례로 입력합니다.
   • 사용자 이름은 나중에 코드 주소에 쓰이니, 영문 소문자와 숫자로 된 알아보기 쉬운 걸로 정하세요. (예: honggildong, mina-dev)
4. GitHub가 보낸 인증 코드를 이메일에서 확인해 입력하면 가입이 끝납니다.

1.5 코드 에디터(VS Code) 설치

가장 널리 쓰이는 무료 에디터인 VS Code(Visual Studio Code)를 설치합시다.

1. 웹브라우저에서 https://code.visualstudio.com 에 접속합니다.
2. 큰 다운로드 버튼을 눌러 내 운영체제(macOS/Windows)에 맞는 파일을 받습니다. (사이트가 자동으로 맞는 버전을 골라 줍니다.)
3. 내려받은 파일을 실행해 설치합니다.
   • Windows: 설치 화면 중간에 "Code로 열기(Open with Code)" 같은 체크박스가 여러 개 보이면 모두 켠 상태로 "다음"을 눌러 진행하면 나중에 편합니다.
   • macOS: 내려받은 파일의 압축이 풀리면 나오는 "Visual Studio Code" 앱 아이콘을, 응용 프로그램(Applications) 폴더로 끌어다 놓습니다.

[맛보기] VS Code 한 번 실행해 보기

설치가 끝나면 VS Code를 한 번 실행해 봅시다.

• macOS: Spotlight(Command + 스페이스)에서 Visual Studio Code를 검색해 실행합니다.
• Windows: 시작 버튼을 누르고 Visual Studio Code를 검색해 실행합니다.

파란색 로고와 함께 환영(Welcome) 화면이 뜨면 성공입니다. 지금은 열어만 보고 창을 닫아도 됩니다. 다음 절에서 이 VS Code로 작업 폴더를 열고, 그 안에서 터미널을 띄운 다음 Claude Code를 실행할 겁니다.

1.6 작업 폴더 만들고 VS Code로 열기

이제 우리 프로젝트가 자라날 작업 폴더를 하나 만들고, VS Code로 그 폴더를 엽니다.

1단계. 문서 폴더 안에 vote-app 폴더 만들기

우리 프로젝트 폴더 이름은 이 책 내내 vote-app으로 통일합니다. 이 폴더를 문서(Documents) 폴더 안에 만듭니다.

• macOS (Finder로):

  1. Dock(화면 아래 아이콘 줄)에서 파란 얼굴 모양의 Finder를 클릭합니다.
  2. 왼쪽 목록에서 문서(Documents)를 클릭합니다.
  3. 문서 폴더 안 빈 공간에서 마우스 오른쪽 버튼을 누르고 새로운 폴더(New Folder)를 선택합니다.
  4. 폴더 이름을 vote-app 으로 입력하고 Enter를 누릅니다.

• Windows (파일 탐색기로):

  1. 작업 표시줄에서 노란 폴더 모양의 파일 탐색기를 클릭합니다.
  2. 왼쪽 목록에서 문서(Documents)를 클릭합니다.
  3. 위쪽 메뉴의 새로 만들기 → 폴더를 누릅니다.
  4. 폴더 이름을 vote-app 으로 입력하고 Enter를 누릅니다.

이제 문서 폴더 안에 비어 있는 vote-app 폴더가 생겼습니다.

2단계. VS Code로 vote-app 폴더 열기

1. VS Code를 실행합니다. (1.5절 [맛보기]에서 실행해 본 방법 그대로: Spotlight 또는 시작 버튼에서 Visual Studio Code 검색 후 실행.)
2. 위쪽 메뉴에서 File(파일) → Open Folder…(폴더 열기)를 클릭합니다.
3. 열린 창에서 문서(Documents) → vote-app 폴더를 선택하고, 열기(Open) 버튼을 누릅니다.
   • macOS에서는 vote-app 폴더를 한 번 클릭해 선택한 뒤 "열기"를 누릅니다. (폴더 안으로 들어갈 필요 없이, 폴더 자체를 선택하면 됩니다.)
4. "이 폴더의 파일 작성자를 신뢰하시겠습니까?(Do you trust the authors?)" 같은 안내가 나오면 Yes, I trust the authors(예, 신뢰합니다)를 누릅니다.

이제 VS Code 왼쪽 위에 VOTE-APP이라고 폴더 이름이 보이면 성공입니다. (폴더가 비어 있어서 그 아래에는 아무 파일도 없습니다.)

1.7 VS Code 통합 터미널 준비하기

이제부터 이 책의 모든 명령은 VS Code 안에 들어 있는 터미널에서 실행합니다. 이걸 "통합 터미널"이라고도 부릅니다. 앞으로 이 책에서 그냥 "터미널"이라고 하면 언제나 이 VS Code 안의 터미널을 뜻합니다.

터미널이 낯설고 무섭게 느껴질 수 있는데, 이 책에서 터미널에 직접 복잡한 명령어를 외워서 칠 일은 거의 없습니다. 대부분은 Claude Code가 대신 해 줍니다. 다만 Claude Code 자체를 이 터미널에서 실행해야 하므로, 터미널을 여는 법 정도는 알아 둡시다.

(Windows만) 기본 터미널을 Git Bash로 바꾸기

Windows의 VS Code 터미널은 기본적으로 "PowerShell"이라는 것으로 열립니다. 그런데 이 책의 명령어는 macOS 기준이라, Windows에서도 똑같이 동작하게 하려면 1.4절에서 Git과 함께 깔린 Git Bash로 바꿔야 합니다. 아래대로 한 번만 설정하면 됩니다. (macOS 사용자는 이 부분을 건너뛰고 바로 다음 "터미널 열기"로 가세요.)

1. 위쪽 메뉴에서 Terminal(터미널) → New Terminal(새 터미널)을 클릭합니다. VS Code 아래쪽에 터미널 영역이 나타납니다. (지금은 PowerShell로 열립니다.)
2. 그 터미널 영역 오른쪽 위를 보면 +(새 터미널) 버튼이 있고, 그 바로 옆에 아래를 향한 화살표(∨)가 있습니다. 이 화살표를 클릭합니다.
3. 펼쳐진 메뉴에서 기본 프로필 선택(Select Default Profile)을 누릅니다.
4. 위쪽에 목록이 뜨면 그중 Git Bash를 클릭해 선택합니다.
   • 이 방법이 헷갈리면 대신 키보드로 Ctrl + Shift + P를 눌러 나오는 입력창에 Terminal: Select Default Profile을 입력하고 Enter를 누른 뒤, 목록에서 Git Bash를 골라도 똑같습니다.
5. 지금 열려 있는 (PowerShell) 터미널을 닫습니다. 터미널 영역 오른쪽 위의 휴지통(쓰레기통) 아이콘을 클릭하면 닫힙니다.
6. 다시 Terminal → New Terminal로 새 터미널을 엽니다. 이번에는 Git Bash로 열립니다. 프롬프트(커서 앞에 나오는 글자)의 끝이 $로 끝나 있으면 Git Bash가 맞습니다.

터미널 열기

아직 터미널을 열지 않았다면, 위쪽 메뉴에서 Terminal(터미널) → New Terminal(새 터미널)을 클릭합니다. VS Code 화면 아래쪽에 터미널 영역이 나타나고 커서가 깜빡입니다. (Windows에서 위 설정을 마쳤다면 이미 Git Bash 터미널이 열려 있을 겁니다.)

지금 이 터미널이 정말 vote-app 폴더에 있는지 확인해 봅시다. 아래를 입력하고 Enter를 누르세요.

pwd          # 지금 이 터미널이 있는 폴더의 경로를 보여 줍니다

출력의 맨 끝이 /vote-app 으로 끝나면(예: /Users/mac/Documents/vote-app) 제대로 온 겁니다.

[맛보기] 터미널에 명령어 한 줄 쳐 보기

터미널이 어떤 건지 손으로 느껴 봅시다. 터미널에 아래를 그대로 입력하고 Enter를 누르세요. (이 명령은 아무것도 바꾸지 않는, 안전한 "내 컴퓨터 사용자 이름 보기" 명령입니다.)

whoami       # 지금 로그인한 내 사용자 이름을 보여 줍니다

mac이나 hong 처럼 여러분의 사용자 이름이 한 줄 출력되면 성공입니다. 방금 여러분은 터미널에 명령을 내리고, 컴퓨터가 답하는 걸 처음 경험했습니다. 이게 터미널의 전부입니다. 명령을 한 줄 치고 Enter, 그리고 결과를 읽기.

앞서 설치한 것들 확인하기

이제 1.3~1.4절에서 설치한 Node.js와 Git이 잘 깔렸는지 이 터미널에서 확인합니다. 아래를 한 줄씩 입력하고 각 줄마다 Enter를 누르세요.

node -v          # 설치된 Node.js 버전을 보여 줍니다
npm -v           # Node.js에 딸려 온 npm 버전을 보여 줍니다
git --version    # 설치된 Git 버전을 보여 줍니다

v20.11.0, 10.2.4, git version 2.39.0 처럼 세 줄 모두 숫자로 된 버전이 나오면 성공입니다. (숫자는 사람마다 다를 수 있습니다. 나오기만 하면 됩니다.)

1.8 Claude Code 설치

이제 이 책의 주인공인 Claude Code를 설치할 차례입니다.

먼저 알아 둘 것: 유료 플랜이 필요합니다

Claude Code를 쓰려면 아래 중 하나가 있어야 합니다.

• Claude Pro 또는 Max 구독 (claude.ai에서 결제하는 개인 유료 플랜) — 이 책에서 권장
• 또는 Anthropic Console API 사용 (사용한 만큼 요금이 청구되는 방식)

무료(Free) 계정으로는 Claude Code를 쓸 수 없습니다. 아직 없다면 https://claude.ai 에 접속해 로그인한 뒤, 화면 안내에 따라 Pro 또는 Max 플랜을 결제해 두세요.

설치 방법 (npm으로 설치)

앞에서 Node.js를 설치했으니, 거기 딸려 온 npm으로 Claude Code를 설치합니다. 이 방법은 macOS의 기본 터미널(zsh)과 Windows의 Git Bash 양쪽에서 똑같이 동작하기 때문에, 이 책은 이 방식으로 통일합니다.

1.7절에서 연 VS Code 터미널에 아래를 그대로 붙여넣고 Enter를 누르세요.

npm install -g @anthropic-ai/claude-code    # Claude Code를 내 컴퓨터에 설치

설치가 끝날 때까지 잠시 기다립니다. 진행 메시지가 여러 줄 지나가고 완료되면 다시 커서가 깜빡입니다.

설치가 됐는지 확인하기

터미널에 아래를 입력합니다.

claude --version    # 설치된 Claude Code 버전을 보여 줍니다

버전 번호가 나오면 설치 성공입니다.

로그인은 언제 하나

로그인은 Claude Code를 처음 실행할 때 자동으로 진행됩니다. 그래서 따로 로그인 명령을 외울 필요는 없습니다. 실제 실행(과 로그인)은 바로 다음 절인 1.9에서 하니, 여기서는 미리 흐름만 눈에 익혀 두세요.

1. claude를 실행하면 웹브라우저가 자동으로 열립니다.
2. 브라우저에서 내 Claude 계정(위에서 유료 플랜을 준비한 그 계정)으로 로그인합니다.
3. "로그인 성공" 화면이 뜨면 터미널로 돌아옵니다.
4. 터미널에 Login successful이 표시되고 Enter를 누르면 준비 완료입니다.

한 번 로그인하면 그다음부터는 다시 로그인할 필요가 없습니다. (로그인 정보는 컴퓨터에 안전하게 저장됩니다.)

1.9 Claude Code 첫 실행 & 첫 대화

이제 마지막입니다. 지금까지 계속 써 온 VS Code 터미널(vote-app 폴더에서 열려 있는)에서 Claude Code를 실행해 첫 대화를 나눠 봅시다.

1단계. 터미널 위치 한 번 더 확인

혹시 터미널을 닫았다면 Terminal → New Terminal로 다시 열고, 아래로 지금 위치가 vote-app인지 확인합니다.

pwd          # 경로 끝이 /vote-app 이어야 합니다

끝이 /vote-app이 아니면 1.6절 2단계로 돌아가 VS Code에서 vote-app을 다시 여세요.

2단계. Claude Code 첫 실행

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

claude

1.8절에서 설명한 로그인 흐름(브라우저 열림 → 로그인 → 터미널 복귀)이 처음 한 번 진행됩니다. 로그인이 끝나면 입력을 기다리는 AI 입력창이 나옵니다. 이제 여기에 사람에게 말하듯 한국어로 지시하면 됩니다.

3단계. [맛보기] 첫 대화 나눠 보기

가볍게 인사부터 건네 봅시다. AI 입력창에 이렇게 써 보세요.

안녕! 나는 웹 개발을 처음 배우는 사람이야.
지금 이 폴더에 뭐가 들어 있는지 알려줄래?

입력한 뒤 Enter를 누르면, Claude Code가 지금 폴더가 비어 있다는 걸 직접 확인하고 답해 줍니다. 축하합니다. 방금 여러분은 AI에게 첫 지시를 내렸고, AI가 실제로 여러분의 폴더를 들여다보고 답했습니다. 이것이 바이브코딩의 기본 동작입니다.

[확인]

이번 장이 제대로 끝났는지 눈으로 확인합니다. VS Code 아래쪽 터미널에서 Claude Code를 실행했을 때:

• AI 입력창이 떴다.
• 안녕! 나는 웹 개발을 처음 배우는 사람이야. 지금 이 폴더에 뭐가 들어 있는지 알려줄래? 라고 물었더니, AI가 "이 폴더는 비어 있다"는 취지로 답했다.

여기까지 보였다면 개발 환경이 모두 갖춰진 것입니다.

막히면

이 장에서 초보자가 자주 막히는 지점과 대처법입니다.

• command not found: node / git / claude가 나온다. 방금 설치한 프로그램을 터미널이 아직 인식하지 못한 경우가 가장 많습니다. 터미널 영역 오른쪽 위의 휴지통 아이콘으로 터미널을 닫고, Terminal → New Terminal로 새 터미널을 연 다음 다시 입력해 보세요. 그래도 안 되면 해당 절로 돌아가 설치를 다시 진행합니다.

• (Windows) VS Code 터미널에서 claude(또는 다른 명령)가 안 먹힌다. Windows에서는 터미널이 Git Bash여야 이 책의 명령이 제대로 동작합니다. 먼저 터미널을 휴지통 아이콘으로 닫고 Terminal → New Terminal로 새로 열어 보세요. 그래도 안 되면 기본 터미널이 Git Bash로 지정돼 있는지 확인합니다. 터미널 오른쪽 위 + 옆 아래화살표(∨) → 기본 프로필 선택(Select Default Profile) → Git Bash를 고른 뒤, 기존 터미널을 닫고 새 터미널을 엽니다. 새로 열린 터미널의 프롬프트 끝이 $이면 Git Bash가 맞습니다. (1.7절 참고.)

• Node.js 설치 파일 실행이 안 되거나 중간에 멈춘다. 내려받다 만 파일일 수 있습니다. https://nodejs.org 에서 LTS 파일을 다시 내려받아 실행하세요. 설치 중 비밀번호를 물으면 내 노트북 로그인 비밀번호를 입력합니다.

• claude를 실행했는데 "로그인해야 한다"거나 요금제 관련 안내가 뜬다. 무료 계정으로는 Claude Code를 쓸 수 없습니다. 1.8절대로 https://claude.ai 에서 Pro 또는 Max 플랜을 결제한 뒤, 그 계정으로 다시 로그인하세요.

• 로그인할 때 브라우저가 안 열린다 (주로 Windows WSL). 터미널에 표시되는 로그인 코드(또는 URL)를 복사해 브라우저 주소창에 붙여넣고 로그인한 뒤, 안내에 따라 진행하세요. (WSL이 뭔지 모른다면 해당 사항이 아니니 그냥 넘어가도 됩니다.)

• pwd를 쳤는데 끝이 /vote-app이 아니다. VS Code가 다른 폴더를 연 상태입니다. File → Open Folder(폴더 열기)로 문서(Documents) 폴더 안의 vote-app을 다시 여세요. VS Code 왼쪽 위에 VOTE-APP이 보여야 합니다.

• vote-app 폴더를 어디에 만들었는지 헷갈린다. 반드시 문서(Documents) 폴더 안에 있어야 합니다. Finder(파일 탐색기)에서 문서 → vote-app이 보이는지 확인하세요. 다른 곳에 만들었다면 문서 폴더로 옮기고, VS Code에서 다시 엽니다.

[체크리스트]

아래가 모두 됐는지 확인해 보세요. 하나라도 안 됐다면 해당 절로 돌아가 다시 진행합니다.

• □ Node.js 설치 파일을 실행해 끝까지 설치했다
• □ (Windows) Git for Windows를 설치해 Git Bash가 함께 깔렸다
• □ GitHub 계정을 만들어 로그인된 상태다
• □ VS Code를 설치하고 환영 화면을 한 번 봤다
• □ 문서 폴더에 vote-app 폴더를 만들고, VS Code로 그 폴더를 열었다
• □ (Windows) VS Code 기본 터미널을 Git Bash로 지정했다 (프롬프트가 $로 끝남)
• □ VS Code 터미널에서 pwd가 /vote-app으로 끝나는 걸 확인했다
• □ VS Code 터미널에서 whoami로 명령 한 줄을 실행해 봤다
• □ node -v, npm -v, git --version이 버전을 보여 준다
• □ claude --version이 버전을 보여 준다
• □ VS Code 터미널에서 claude를 실행해 첫 대화를 나눴다

모두 체크됐다면 개발 준비가 끝난 겁니다.