1 회 차 가 이 드

바이브 코딩 첫 만남
+ 환경 구축

오늘 하루로 개발에 필요한 모든 도구를 갖춥니다

📅 10/2(금) 15:00~18:00  |  충경 AI Lab실
← 전체 프로그램

오늘은 이런 날입니다

🎯 오늘의 목표

바이브 코딩이 뭔지 눈으로 보고 손으로 해보고, 앞으로 쓸 도구를 전부 설치합니다. 오늘 하루만 고생하면 다음부터는 만들기에만 집중할 수 있어요.

🛠️ 오늘 설치하는 것

Claude 데스크탑 · Git · VS Code · GitHub · Vercel. 전부 무료이고, 하나씩 화면 보며 같이 합니다.

💡 이번 과정의 특징

연습용 과제로 시간을 쓰지 않습니다. 2회차부터 바로 내가 만들고 싶은 앱으로 시작해요. 그래서 오늘 마지막 시간에 내 앱 아이디어를 찾는 것이 아주 중요합니다.

📦 준비물

없습니다! 전산실 PC로 진행합니다.

💡 오늘 가장 중요한 마음가짐

설치가 많습니다. 막히면 바로 손 들어주세요. 설치에서 막히는 건 누구나 겪는 일이고, 부끄러운 게 아니에요. 혼자 끙끙대면 뒤처집니다.

이렇게 진행됩니다

15:00 ~ 15:10
📋 오프닝 & 사전 설문
전체 과정 안내, 사전 설문으로 현재 상태 점검
📌 사전 설문 하러 가기 →
15:10 ~ 15:15
📖 바이브코딩이란
지금 뭘 배우는 건지, 5분만에 짚고 갑니다
📌 개념 보기 →
15:15 ~ 15:40
🔥 라이브 시연
강사가 AI에게 한 줄 입력 → 앱이 뚝! → 써보고 고치는 과정까지
15:40 ~ 16:20
💻 환경 구축 ① — Claude + Git
Claude 데스크탑 설치, Git 설치, 환경 변수 설정
📌 설치 가이드 →
16:20 ~ 16:30
☕ 쉬는 시간
16:30 ~ 17:10
⚙️ 환경 구축 ② — VS Code · GitHub · Vercel
VS Code 설치 + Claude 연결, GitHub 가입, Vercel 가입
📌 설치 가이드 →
17:10 ~ 17:40
🎮 첫 앱 만들기
다 함께 같은 주제로 첫 앱을 만들어봅니다
📌 실습 프롬프트 →
17:40 ~ 18:00
💡 내 문제 정의하기 (POV)
다음 주에 만들 내 앱을, 문제 한 문장으로 정합니다
📌 문제 정의하기 →
🎯 오늘의 최소 목표

① 5개 도구 전부 설치 완료   ② 첫 앱 하나 만들어보기   ③ 내 문제를 POV 한 문장으로 정리. 이 3가지면 오늘 성공입니다!

바이브코딩이란 무엇인가

앞으로 계속 쓸 말이니 5분만 짚고 갑니다.

먼저, "바이브(vibe)"란

어떤 대상이나 장소에서 느껴지는 분위기·기운·느낌. "이 카페 바이브 좋다"처럼, 말로 딱 떨어지진 않지만 전체적으로 전해지는 인상을 뜻합니다.

바이브코딩 = 말로 설명하면 코드가 된다

어떤 문제를 풀지 명확하게 설명하면, AI와 함께 해법을 찾고 그 해법을 AI가 직접 코드로 구현하는 개발 방식입니다. 만드는 사람은 코드를 몰라도 됩니다.

📌 어디서 나온 말인가

2025년 2월, OpenAI 공동 창업자이자 전 테슬라 AI 총괄이었던 안드레 카파시(Andrej Karpathy)가 처음 썼습니다. AI에게 코드를 맡기고 "코드가 존재한다는 사실조차 잊는" 방식을 이렇게 불렀어요.

이 표현은 순식간에 퍼져서, 2025년 콜린스 사전 올해의 단어로 선정됐습니다.

🔨 그래서 뭘 만들 수 있나

WOWD.LAB이 바이브코딩으로 직접 만들어 실무에서 쓰는 앱들이 있습니다. 타이머, 점심 메뉴 정하기, 일정 조율, PDF 도구, URL 단축기까지 — 전부 무료로 써볼 수 있어요.

앱 갤러리 보러 가기 →

💡 공통점이 하나 있습니다

저 앱들은 앱을 먼저 떠올린 게 아니라 "점심 메뉴 정할 때 눈치 보인다", "일정 잡느라 단톡방이 번거롭다" 같은 불편에서 출발했습니다. 먼저 문제가 있었고, 앱은 그 해법으로 뒤따라 나왔어요. 오늘 마지막 시간에 여러분도 이 순서로 시작합니다.

STEP 1
💻 Claude 데스크탑 + Git 설치

1-1. Claude 데스크탑 설치

1
다운로드 페이지 접속
https://claude.ai/download
"Download for Windows" 클릭 → 다운로드 시작
2
설치 파일 실행
다운로드된 파일을 더블클릭. 특별한 설정 없이 "다음" → "설치"만 누르면 됩니다. 1~2분이면 끝나요.
3
개인 계정으로 로그인
설치가 끝나면 Claude가 자동으로 열립니다. 각자 개인 계정으로 로그인하세요. 구글 계정이나 이메일로 가입할 수 있습니다.
⚠️ 계정이 없다면 지금 만들면 됩니다. 수업 시간에 같이 해요!

1-2. Git 설치  (Claude Code를 쓰려면 필요해요)

Claude 데스크탑에서 Claude Code를 선택하면 "Git이 설치되어 있지 않습니다"라는 메시지가 나타날 수 있어요. 당황하지 말고 아래 순서대로 하면 됩니다.

1
Git 다운로드
https://git-scm.com/download/win
"64-bit Git for Windows Setup" 클릭
2
Git 설치 — 모든 설정 기본값 그대로
설치 화면에서 여러 옵션이 나오는데 아무것도 바꾸지 말고 "Next" → "Next" → ... → "Install"만 눌러주세요.
⚠️ "Adjusting your PATH environment" 화면이 나오면 기본 선택된 "Git from the command line and also from 3rd-party software"를 그대로 두세요.
3
Claude 데스크탑 완전 재시작 → 여기서 끝나는 경우가 많아요
Git 설치 후 Claude 데스크탑을 완전히 종료했다가 다시 실행하면 대부분 해결됩니다.

창을 그냥 닫는 게 아니라, 작업표시줄 오른쪽 아래 ▲ 트레이에서 Claude 아이콘 우클릭 → "종료" → 다시 실행하세요.
✅ 여기서 Code 탭이 정상적으로 열리면

끝났습니다! 아래 1-3 환경 변수는 건너뛰고 STEP 2로 넘어가세요.

1-3. 환경 변수 설정  (재시작해도 안 될 때만)

🙋 재시작으로 해결됐다면 이 부분은 건너뛰세요. 아래는 그래도 Git을 못 찾는다고 나올 때만 하는 추가 설정입니다. 어렵지 않으니 겁먹지 마시고, 막히면 바로 손 들어주세요.

A~E를 순서대로 정확히 따라하세요.

A
시스템 속성 열기
키보드에서 Windows키(⊞) + R을 동시에 누르세요. "실행" 창이 뜨면 아래를 붙여넣고 확인.
sysdm.cpl
B
환경 변수 창 열기
상단 "고급" 탭 클릭 → 하단 "환경 변수(N)..." 버튼 클릭
C
새 사용자 변수 만들기
위쪽 "사용자 변수" 영역에서 "새로 만들기(N)..." 클릭
⚠️ 반드시 위쪽 "사용자 변수"입니다! 아래쪽 "시스템 변수"가 아니에요.
D
변수 이름과 값 입력
두 칸에 아래 내용을 복사 버튼으로 정확히 붙여넣으세요.
변수 이름
CLAUDE_CODE_GIT_BASH_PATH
변수 값
C:\Program Files\Git\bin\bash.exe
입력 후 "확인" → "확인" → "확인"으로 모든 창 닫기
⚠️ 오타가 나면 작동하지 않아요. 반드시 복사 버튼(📋)을 쓰세요!
E
Claude 데스크탑 완전 재시작
창을 그냥 닫는 게 아니라, 작업표시줄 오른쪽 아래 ▲ 트레이에서 Claude 아이콘 우클릭 → "종료" → 다시 실행
✅ 성공 확인

Claude 데스크탑에서 Code 탭이 오류 없이 열리면 성공!

STEP 2
⚙️ VS Code · GitHub · Vercel

2-1. VS Code 설치

VS Code는 코드를 보고 관리하는 편집기예요. 내 프로젝트의 모든 파일이 한눈에 보입니다.

1
다운로드 & 설치
https://code.visualstudio.com/download
파란 "Windows" 버튼 → 파일 더블클릭 → 모든 설정 기본값으로 "다음" → "설치"
2
한국어로 바꾸기 (선택)
왼쪽 네모 4개 아이콘(Extensions) → korean 검색 → "Korean Language Pack" Install → "Change Language and Restart"
3
📁 "폴더 열기"로 시작하는 법 — 꼭 기억하세요
앱 하나는 폴더 하나입니다. 그 안에 파일들이 모여 하나의 앱이 돼요. 그래서 VS Code로 작업할 때는 항상 파일 > 폴더 열기(Open Folder)로 내 프로젝트 폴더를 열고 시작합니다.
⚠️ 폴더를 처음 열면 "이 폴더를 신뢰하시겠습니까?"(Trust the authors)라고 물어봅니다. 내가 만든 폴더이니 반드시 "신뢰"(Yes, I trust the authors)를 눌러야 정상 작업이 됩니다. 여기서 많이 막혀요!

2-2. VS Code에 Claude 연결

두 가지 방법이 있어요. 수업에서는 방법 A(CLI)를 기준으로 진행합니다.

방법 A — 터미널(CLI) 방식 · 수업 기준

더 강력하고 빠릅니다. 명령어 두 줄이면 끝나요.

1
터미널 열기
VS Code 상단 메뉴 "터미널" → "새 터미널". 화면 아래에 검은 창이 열립니다.
2
Claude Code 설치
터미널에 입력 후 Enter
npm install -g @anthropic-ai/claude-code
⚠️ "npm을 찾을 수 없습니다" 오류가 나면 Node.js부터 설치해야 해요.

① https://nodejs.org 접속
② 왼쪽 "LTS" 버튼 클릭 → 다운로드
③ 파일 더블클릭 → 기본값으로 "Next" → "Install"
④ VS Code를 완전히 종료했다가 다시 실행
⑤ 터미널 새로 열고 위 명령어 재입력

💡 제대로 설치됐는지 확인하려면 터미널에 node -v를 입력해보세요. v20.x.x처럼 버전 숫자가 나오면 정상입니다.
3
실행 & 로그인
터미널에 입력 후 Enter
claude
브라우저가 열리면 개인 계정으로 로그인 → 터미널에 Claude 로고가 뜨면 성공!

방법 B — Claude 확장팩 방식

터미널이 불편하면 이 방법으로. 왼쪽 네모 4개 아이콘 → Claude 검색 → 게시자가 "Anthropic"인 확장 Install → 왼쪽 Claude 아이콘 클릭 → "Sign in with Claude"

💡 둘 다 같은 Claude예요

입구만 다릅니다. 터미널이 무서우면 B로 시작하고, 나중에 A로 옮겨도 돼요.

2-3. GitHub 가입

GitHub은 코드를 안전하게 저장하는 인터넷 저장소예요. 다음 주에 배포할 때 Vercel과 연결되는 다리 역할을 합니다.

1
구글 계정으로 가입 (추천)
https://github.com/signup
"Continue with Google" 클릭 → 구글 계정 선택 → 비밀번호 없이 바로 가입!
⚠️ 구글 로그인이 막힌 환경이면 이메일+비밀번호로 가입하세요. 이메일 인증 코드 8자리를 입력하면 됩니다.
2
Username 정하기
영문으로 나만의 이름 (예: hong-gildong-2026). 이 이름이 내 저장소 주소가 됩니다!

2-4. GitHub Desktop 설치

1
다운로드 & 설치
https://desktop.github.com/
"Download for Windows" → 파일 실행 → 자동 설치되고 바로 열립니다.
2
GitHub 계정 연결
① "Sign in to GitHub.com" 클릭
② 브라우저에서 방금 만든 계정으로 로그인
③ "Authorize desktop" 초록 버튼
④ "Configure Git" 화면 → 그대로 "Finish"

2-5. Vercel 가입

Vercel은 내 앱을 인터넷에 올려주는 서비스예요. 다음 주에 여기서 내 앱 URL이 나옵니다.

1
GitHub 계정으로 가입
https://vercel.com/signup
① "Hobby" 선택 → 이름 입력 → Continue
② "Continue with GitHub" (까만 버튼)
③ "Authorize Vercel" 초록 버튼 → 자동 연결!
🎉 설치 완료!

Claude 데스크탑 · Git · VS Code · GitHub · Vercel — 5개 도구가 모두 준비됐어요. 이제 다음 회차부터는 설치 없이 만들기에만 집중합니다!

STEP 3
🎮 첫 앱 만들어보기

이제 진짜 만들어볼 차례예요. 오늘은 다 같이 같은 주제로 만듭니다. 아래 3개 중 하나를 골라 Claude에 붙여넣어보세요.

① 당직 스케줄 생성기
인원 이름을 입력하고 시작 날짜와 기간을 설정하면, 자동으로 당직 스케줄을 생성해서 캘린더로 보여주는 웹앱 만들어줘
② 반응속도 테스트 게임
화면이 빨간색일 때 기다리다가 초록색으로 바뀌면 최대한 빨리 클릭하는 반응속도 테스트 게임 만들어줘. 반응 시간을 밀리초로 보여주고, 5번 테스트해서 평균도 알려줘
③ 간단 가계부
수입과 지출을 입력할 수 있고, 카테고리별로 분류해서 파이차트로 보여주는 가계부 웹앱 만들어줘. 이번 달 총 수입, 총 지출, 잔액도 보여줘

만들어졌다면 — 이제 고쳐보세요

바이브 코딩의 진짜 실력은 "만들기"가 아니라 "고치기"에서 나옵니다. 아래처럼 요청해보세요.

💬 수정 요청 예시

"여기에 삭제 버튼을 각 항목 옆에 추가해줘"
"글씨가 너무 작아. 모바일에서 보기 좋게 키워줘"
"색상을 좀 더 차분한 톤으로 바꿔줘"

💡 애매하게 말하면 엉뚱하게 나와요

"삭제 기능 추가해줘"라고 하면 전체 삭제만 생길 수 있어요. "각 항목 오른쪽에 X 버튼을 만들고, 누르면 그 항목만 지워줘"처럼 구체적으로!

STEP 4 — 오늘 가장 중요한 시간
💡 내 문제 정의하기

다음 주부터는 이걸로 계속 만듭니다. 최종 발표까지 가져갈 앱이니 오늘 안에 정해야 해요. 집에서 생각해오는 게 아니라 지금 이 자리에서 정합니다.

1️⃣ "어떤 앱?"이 아니라 "무슨 문제?"

대부분 이렇게 시작합니다. "나 이런 앱 만들 거야." 그런데 여기엔 함정이 있어요. 만들 앱을 먼저 정해버리면 AI는 딱 내가 상상한 그만큼만 만들어줍니다. 내 상상력이 한계가 되는 거예요.

✕ 답을 정해놓고 시작
"당직 스케줄 앱 만들어줘"
이미 정한 답을 AI에게 코딩만 시키는 것. AI를 내 상상력 안에 가둡니다.
✓ 문제를 정해놓고 시작
"이 문제를 풀고 싶어"
문제를 명확히 주고 AI와 협업. AI가 진단하고 더 나은 해법을 설계할 여지가 열립니다.

2️⃣ 문제는 "맥락"이 있어야 살아납니다

누가 · 어떤 상황에서 겪는 불편인지를 구체적으로 적어야 해요. 여기서 대부분 너무 뭉뚱그립니다.

✕ 뭉뚱그린 상태
"당직 편성하는 게 매번 번거롭다."
누가? 무엇이 왜 번거로운지? 아무것도 없습니다. 이 상태로 주면 AI도 평균적인 답만 내놓아요.
✓ 맥락이 구체화된 상태
"인사 담당 3년차 김 중사는 매달 30여 명의 당직을 편성한다. 휴가·교육·훈련 일정을 각각 따로 확인해가며 엑셀로 짜는데, 중복 배정이 나면 전부 다시 맞춰야 해서 매번 두세 시간이 든다."
누가(김 중사), 어떤 맥락(30명·월 단위), 무엇이 왜 문제(중복 배정·재작업·시간)인지가 다 보입니다. 이 정도라야 AI가 정확히 진단하고 딱 맞는 해법을 설계해요.

3️⃣ 먼저 펼쳐보세요 (발산)

처음부터 완벽한 문제 하나를 찾으려 하지 마세요. 요령은 반대입니다. 누구의 · 어떤 상황의 어려움인지 최대한 많이 펼쳐보는 것이에요.

발산 프롬프트 — 혼자 짜내지 말고 AI와 함께
나는 부대에서 [내가 하는 업무]를 담당하고 있어. 우리 부서 사람들이 업무하면서 겪는 불편을 최대한 많이 같이 펼쳐보고 싶어. "누가 · 어떤 상황에서 · 무엇이 불편한지" 형태로 10가지 정도 나열해줘. 아직 해결책은 말하지 말고, 문제만 펼쳐줘.

💡 펼치면 이런 일이 생깁니다

① 보지 못했던 문제까지 보이기 시작한다
② 문제들 사이에서 패턴이 보인다
③ 그 패턴에서 새로운 관점이 떠오른다
④ 무엇부터 풀어야 할지 우선순위가 판단된다

4️⃣ 펼친 문제를 POV 한 문장으로

이제 핵심 문제를 한 문장으로 언어화할 차례입니다. 그 도구가 POV(Point Of View)예요. 이 문제를 어떤 관점에서 봐야 하는지, 왜 풀어야 하는지를 한 문장에 담습니다.

WHO
누가
(구체적인 그 사람)
WHAT
무엇이 필요한가
(진짜 니즈)
WHY
왜 중요한가
(그 이유)
김 중사 사례를 POV로
WHO 매달 30여 명의 당직을 편성하는 인사 담당 김 중사는
WHAT 휴가·교육 일정을 일일이 대조하는 수작업을 덜어내고 싶다.
WHY 중복 배정이 날 때마다 전부 다시 짜야 해서, 정작 중요한 일이 밀리기 때문이다.
POV 정리 프롬프트
펼친 문제 중에서 [고른 문제]가 제일 와닿아. 이걸 POV 한 문장으로 정리해줘. - WHO: 누가 (구체적인 그 사람) - WHAT: 무엇이 필요한가 - WHY: 왜 중요한가 그리고 이 POV를 풀 수 있는 앱의 핵심 기능 3개도 뽑아줘.

5️⃣ 이 문제, 앱이 될까? — 4가지로 가늠하기

아래 질문에 하나라도 "그렇다"면 시작해도 좋습니다.

❓ 반복되는가

매일·매주 반복하는 일인가? 반복될수록 앱으로 만들 가치가 큽니다.

❓ 기록하거나 계산하는가

뭔가를 적어두거나, 세거나, 계산하는 일인가?

❓ 지금 불편한가

엑셀·수첩·머릿속으로 억지로 하고 있는 일인가?

❓ 화면으로 보면 나은가

눈으로 보이면 더 편해질 일인가?

⚠️ 여기에 더해 결제·회원가입·AI가 핵심이면 기간 안에 완성이 어렵습니다. 그런 기능은 빼고 접근하세요.

💡 80% 마음에 들면 그걸로 정하세요

완벽한 문제를 찾다가 시간을 다 씁니다. 만들면서 발전시키는 게 훨씬 빨라요. 3회차까지는 바꿀 수 있고, 4회차부터는 고정합니다.

✅ 오늘 나가기 전에 메모할 것

① POV 한 문장 (WHO·WHAT·WHY)   ② 앱 이름   ③ 핵심 기능 3개

이 POV가 다음 주 PRD의 첫 줄이 됩니다. 그대로 이어집니다!

막히면 확인하세요

npm을 찾을 수 없다는 오류가 나요
Node.js가 없어서 그래요.
① nodejs.org → 왼쪽 LTS 버튼
② 기본값으로 설치
③ VS Code 완전 종료 후 재실행 (이게 중요!)
④ 터미널 새로 열고 다시 입력
⑤ 확인: node -v 입력 → v20.x.x 같은 버전이 나오면 정상
Claude Code에서 Git을 못 찾는다고 해요
환경 변수를 설정해야 합니다. 위의 1-3. 환경 변수 설정 A~E를 그대로 따라하세요. 특히 "사용자 변수"에 만들어야 하고(시스템 변수 아님), 설정 후 Claude 데스크탑을 트레이에서 완전 종료했다가 다시 켜야 적용됩니다.
GitHub 인증 메일이 안 와요
스팸함을 먼저 확인하세요. 그래도 없으면 "Resend code"를 누르거나, 구글 계정 가입 방식으로 바꿔보세요.
앱이 만들어지다가 중간에 멈춰요
채팅창에 "계속해줘" 또는 "이어서 완성해줘"라고 입력하면 이어서 작업합니다.
권한 허용 창이 계속 떠요
"항상 허용"을 선택하세요. 같은 종류의 작업은 그 뒤로 묻지 않습니다.
에러 메시지가 떴어요
에러는 적이 아니라 힌트예요. 메시지를 요약하지 말고 통째로 복사해서 "이런 에러가 났어. 고쳐줘."와 함께 Claude에게 보내면 됩니다.

내일 준비 & 체크리스트

📝 내일(10/3 토)까지 준비할 것

딱 하나 — 오늘 정한 내 앱 아이디어를 잊지 않기.

메모장에 적어둔 앱 이름 · 한 문장 설명 · 핵심 기능 3개를 내일 가져오세요. 내일은 이걸로 바로 PRD를 쓰고 배포까지 갑니다!

⏰ 내일은 연속 수업입니다

10/3(토) 13:00~16:00. 오늘 설치한 환경 그대로 씁니다. 오늘 못 끝낸 설치가 있으면 내일 시작 전에 도와드릴게요.

오늘 배운 것 체크리스트

자주 묻는 질문

Claude Pro 계정을 제공해주나요?
개인적으로 결제 후 비용을 지급합니다. 각자 본인 계정으로 Claude Pro를 결제해서 사용하시고, 결제 내역을 제출하면 비용을 지급해드립니다.
진짜 코딩을 몰라도 되나요?
네, 코드를 직접 쓰지 않습니다. AI에게 "이런 거 만들어줘"라고 말하면 AI가 코드를 만들어줘요. 여러분은 무엇을 만들지 생각하는 역할입니다.
왜 이렇게 설치할 게 많나요?
각 도구의 역할이 달라요.
· Claude — 코드를 만들어주는 AI
· Git — Claude Code가 작동하는 데 필요한 기반
· VS Code — 만들어진 파일을 보고 관리하는 편집기
· GitHub — 코드를 안전하게 저장하는 인터넷 저장소
· Vercel — 내 앱을 인터넷에 올려주는 서비스

오늘 한 번에 다 해두면, 다음부터는 만들기에만 집중할 수 있습니다.
오늘 만든 앱은 계속 쓰나요?
아니요. 오늘 만든 건 "이렇게 만들어지는구나"를 체험하는 연습이에요. 내일부터는 각자 정한 내 앱으로 처음부터 다시 시작합니다.
아이디어를 나중에 바꿔도 되나요?
3회차(10/9)까지는 가능합니다. 4회차부터는 본격적인 개발 구간이라 바꾸면 시간이 부족해져요. 80% 마음에 들면 일단 시작하면서 발전시키는 걸 권합니다.
다음 시간에는 뭘 하나요?
2회차(10/3 토)에는 오늘 정한 내 아이디어로 PRD를 쓰고, 개발해서, 인터넷에 배포까지 합니다. 내일 끝날 때 여러분 앱의 진짜 URL이 생겨요!