누구나 AI와 대화하며 내 손으로 웹 서비스를 만드는 실전 가이드

바이브 코딩(Vibe Coding)
실전 입문서

윈도우 메모장 한 장에서 시작해 클라우드플래어(Cloudflare) 전 세계 배포까지, 비전공자와 교육자를 위한 가장 직관적인 AI 웹 개발 안내서

바이브 코딩 실전 입문서 표지 일러스트
"바이브 코딩은 쉽고 어렵습니다.
어려운 것은 미지의 영역이기 때문이고, 쉬운 건 든든한 AI 비서 덕분입니다.
확신은 시행착오의 담보이며, 인내는 결과의 보증수표라는 사실을 명심하세요.
확신을 가지고 인내로서 반복한다면 탄성회복력이 당신을 놀라운 성취로 이끌 것입니다."
지은이 · 한 민
CHAPTER 01

바이브 코딩이란

1. 코딩은 도구일 뿐, '의도 전달과 조율'의 시대

바이브 코딩(Vibe Coding)은 프로그래밍 언어의 복잡한 문법이나 세미콜론 하나까지 인간이 직접 타이핑하던 기존 개발 방식에서 벗어나, AI에게 자연어(한국어·영어)로 원하는 기능과 흐름(Vibe)을 설명하고, AI가 생성한 코드를 실행·검증·조율하며 결과물을 완성하는 새로운 개발 패러다임입니다.

과거에는 아이디어를 웹 페이지로 구현하기 위해 HTML, CSS, JavaScript, 서버 구축까지 수개월에서 수년의 학습 기간이 필요했습니다. 하지만 바이브 코딩 시대에는 '무엇을 왜 만들 것인가'라는 명확한 기획력과 문제를 쪼개어 질문하는 사고력이 곧 개발 실력이 됩니다.

힘겨운 작업자 vs 즐거운 지휘자 비교 일러스트
[그림 1-1] 코드를 직접 치는 '작업자'에서 AI 오케스트라를 이끄는 '지휘자'로의 전환
구분 전통적 코딩 (Traditional Coding) 바이브 코딩 (Vibe Coding)
핵심 역량 프로그래밍 문법 암기, 직접 코드 타이핑 명확한 기획력, 구조적 질문, 결과 검증 능력
개발 방식 한 줄씩 수동 작성 및 수동 디버깅 AI와 대화하며 프로토타입 즉시 생성 및 수정
진입 장벽 높음 (전공자·전문 개발자 중심) 낮음 (메모장과 브라우저만 있으면 누구나 시작 가능)
주요 역할 코드를 직접 작성하는 '작업자' 전체 방향과 품질을 지휘하는 '디렉터(설계자)'

2. 누구나 바이브 코딩을 할 수 있는 이유

아이디어 말하기, AI와 대화하며 코딩, 나만의 앱 완성 3단계
[그림 1-2] 말 한마디가 실제 웹 앱이 되는 바이브 코딩 3단계
  1. 자연어 이해력의 비약적 발전: AI가 추상적인 요구사항을 실제 동작하는 HTML, CSS, JavaScript 코드로 즉시 변환해 줍니다.
  2. 즉각적인 시각적 피드백: 코드를 작성하자마자 브라우저에서 화면을 눈으로 확인하고, 어색한 부분을 곧바로 대화로 고칠 수 있습니다.
  3. 무료 배포 인프라의 보편화: 별도의 비싼 서버를 구매하지 않고도 전 세계 어디서나 접속 가능한 웹사이트를 무료로 열 수 있습니다.

3. 프롬프트 엔지니어링과 바이브 코딩

① 프롬프트 엔지니어링이란: 생성형 AI가 원하는 고품질 결과를 내도록 입력 텍스트(프롬프트)를 설계하고 최적화하는 과정입니다. AI 모델을 직접 재학습시키지 않고도 지시와 맥락을 정교하게 다듬어 응답의 정확도와 일관성을 높입니다.

② 경쟁력이 되는 이유:

  • 결과물 품질의 격차: 모호한 지시는 평범한 답을 낳지만, 목적·조건·형식을 명확히 설계한 프롬프트는 곧바로 실무에 쓸 수 있는 결과물을 만듭니다.
  • 업무 생산성 극대화: 자료 조사, 초안 작성, 데이터 분류, 코딩 같은 반복 작업을 자동화해 핵심 의사결정에 더 많은 시간을 쓸 수 있습니다.
  • 추가 개발 비용 절감: 모델을 새로 학습시키지 않고도 지시문과 맥락 설계만으로 특정 도메인에 맞는 성능을 끌어낼 수 있습니다.

③ 단순한 '질문 기술'을 넘어 확장되는 역량:

  • 문제 정의 능력: AI에게 무엇을 시킬지 명확히 쪼개고 구조화하는 기획력이 중요합니다.
  • 컨텍스트 설계: 단일 문장을 잘 쓰는 수준을 넘어, 참고 문서·규칙·출력 기준을 체계적으로 결합해 일관된 결과를 만드는 역량입니다.
  • 결과 검증 및 개선: AI의 환각(오류)을 걸러내고, 피드백을 통해 프롬프트를 반복적으로 고도화하는 비판적 사고가 뒷받침되어야 합니다.
핵심 키워드: "쪼갠다" 우리가 원자와 분자를 다루듯 큰 목표와 문장을 작은 단위로 쪼개어 관리할 때, 비로소 문제는 명료하고 사실적인 조각이 됩니다. 이렇게 쪼개진 요소들은 어느 방향으로도 유연하게 연결될 수 있어, 시행착오를 이겨내는 탄성회복력의 가장 튼튼한 기반이 됩니다.
CHAPTER 02

바이브 코딩을 위한 기본 준비

거창한 개발 도구나 무거운 프로그램을 설치할 필요가 없습니다. 내 컴퓨터에 이미 깔려 있는 가장 가벼운 도구에서 출발해, 웹의 기본 언어를 이해하고 명령어 환경과 듀얼 모니터의 원리를 파악하면 충분합니다.

1. 메모장(Notepad)

바이브 코딩의 가장 위대한 출발점은 윈도우에 기본 내장된 '메모장'입니다. 전 세계 어떤 윈도우 PC에나 이미 깔려 있어 별도의 설치나 복잡한 환경 설정 없이 1초 만에 바로 실행할 수 있습니다. 화려한 에디터(VS Code, Cursor 등)는 나중에 속도를 높이는 보조 도구일 뿐, 웹 페이지의 본질은 결국 '글자(텍스트)로 이루어진 문서'입니다.

2. 메모장에서 웹으로 확장 (.html과 UTF-8)

메모장 txt에서 index.html로 변신하는 과정
[그림 2-1] 일반 텍스트(.txt)가 웹 문서(index.html)로 변신하는 마법
  • ① 확장자 .html의 의미: 파일을 저장할 때 파일명을 index.html로 바꾸고 파일 형식을 '모든 파일(*.*)'로 선택하면, 운영체제는 이 문서를 단순 메모가 아니라 '웹 브라우저로 열어야 하는 하이퍼텍스트(HTML) 문서'로 인식합니다.
  • ② UTF-8 인코딩의 의미: 한글이 깨지지 않고 전 세계 모든 브라우저에서 정상적으로 표시되도록 약속한 국제 표준 문자 인코딩 방식이 UTF-8입니다. 메모장 저장 시 인코딩을 'UTF-8'로 확인하고, 문서 상단에 <meta charset="UTF-8">을 적어주면 한글 깨짐을 완벽히 예방할 수 있습니다.
UTF-8 보안관과 통역사 캐릭터
[그림 2-2] 한글·영어·일본어 등 전 세계 글자가 깨지지 않게 지켜주는 UTF-8 통역사

3. HTML 개요 및 기초 실습 (예제 3선)

HTML(HyperText Markup Language)은 웹 페이지의 '뼈대와 구조'를 만드는 언어입니다. 꺾쇠 괄호(< >)로 이루어진 태그(Tag)를 사용해 제목, 본문, 입력창, 버튼의 위치를 지정합니다.

▶ 예제 1: 나의 첫 자기주도학습 웹 페이지 제목과 인사말 만들기

HTML · 예제 1
<!DOCTYPE html>
<html lang="ko">
<head>
  <meta charset="UTF-8">
  <title>나의 첫 웹 페이지</title>
</head>
<body>
  <h1>자기주도학습 체크리스트</h1>
  <p>오늘도 5분 예습과 1분 복습으로 하루를 시작합니다.</p>
</body>
</html>
  • <!DOCTYPE html>: 이 문서가 최신 HTML5 표준 문서임을 브라우저에 선언합니다.
  • <head> 영역: 문서의 제목(<title>)과 문자 인코딩(UTF-8) 등 설정 정보를 담습니다.
  • <body> 영역: 실제 화면에 나타나는 콘텐츠가 들어갑니다. <h1>은 대제목, <p>는 문단을 의미합니다.

▶ 예제 2: 학습 순서 목록과 참고 링크 연결하기

HTML · 예제 2
<h2>오늘의 학습 루틴</h2>
<ol>
  <li>교재 목차 5분 예습하기</li>
  <li>핵심 키워드 추출하기</li>
  <li>백지에 1분 복습하기</li>
</ol>
<a href="https://jagijudo.com" target="_blank">자기주도학습 프로그램 바로가기</a>
  • <ol>과 <li>: 순서가 있는 번호 목록을 만들 때 사용합니다. (점 목록은 <ul>)
  • <a href="주소">: 다른 페이지로 이동하는 링크 태그이며, target="_blank"를 넣으면 새 탭에서 열립니다.

▶ 예제 3: 질문 입력창과 선택 버튼 만들기

HTML · 예제 3
<div>
  <p>Q1. 오늘 학습 목표를 플래너에 기록했습니까?</p>
  <label><input type="radio" name="q1" value="1"> 전혀 아니다 (1점)</label><br>
  <label><input type="radio" name="q1" value="4"> 항상 그렇다 (4점)</label><br><br>
  <button type="button" onclick="alert('제출되었습니다!')">결과 확인하기</button>
</div>

4. CSS 개요와 기본 예제

HTML이 건물의 철근과 콘크리트(뼈대)라면, CSS(Cascading Style Sheets)는 페인트칠, 조명, 가구 배치를 담당하는 '인테리어 디자인 언어'입니다.

HTML 뼈대와 CSS 인테리어 비교 애니메이션
[그림 2-3] HTML(뼈대)과 CSS(인테리어)의 역할 비교
HTML + CSS · 카드 디자인 예제
<style>
  body { font-family: '맑은 고딕', sans-serif; background-color: #f8fafc; padding: 30px; }
  .card { background-color: #ffffff; border: 2px solid #2563eb; border-radius: 12px; padding: 20px; }
  h1 { color: #2563eb; }
</style>
<div class="card">
  <h1>깔끔한 블루 & 화이트 카드 디자인</h1>
  <p>CSS를 적용하면 화면의 가독성과 신뢰도가 크게 높아집니다.</p>
</div>

5. CMD 모드 이해 (구조적 배경)

AI 도구를 연동하거나 파일을 일괄 처리하고 배포할 때, 우리는 마우스로 아이콘을 클릭하는 GUI 대신 검은 화면에 글자로 명령을 내리는 CMD(명령 프롬프트, 터미널) 모드를 사용합니다.

마우스 GUI vs 명령 프롬프트 CMD 비교 애니메이션
[그림 2-4] 하나씩 옮기는 마우스(GUI)와 한 줄로 일괄 처리하는 명령 프롬프트(CMD)
  • ① GUI의 한계와 텍스트 명령의 효율성: 수백 개의 코드 파일을 생성하고 라이브러리를 설치하며 서버에 업로드하는 작업은 텍스트 명령어로 지시해야 0.1초 만에 정확히 반복 실행할 수 있습니다.
  • ② 운영체제(OS)와 AI의 직접 소통 통로: AI(LLM)는 마우스를 움직이지 못하고 '텍스트'를 입력받아 '텍스트'로 응답하는 엔진이므로, CMD가 OS와 AI를 잇는 가장 직접적인 통로가 됩니다.
  • ③ 최소한의 명령어만으로 충분한 제어: 폴더 생성(mkdir), 경로 이동(cd), 파일 목록 확인(dir) 등 몇 가지 핵심 구조만 알면 CMD는 가장 충실한 비서가 됩니다.

6. Dual Monitor (듀얼 모니터)

놀랍게도 지금까지 나열한 기본 준비물들이 듀얼 모니터에 비하면 존재감이 작게 느껴질 만큼, 듀얼 모니터는 바이브 코딩의 핵심 환경입니다. 결국 모든 과정을 이해하더라도 AI와 실시간으로 소통하며 한 걸음씩 전진해야 하기 때문입니다.

AI와의 대화에서 구체적인 질문은 프롬프트로 입력하지만, 진행 과정에서는 주로 스크린샷으로 현재 화면 상황을 전달하고 AI의 판단과 수정을 기다립니다. 한쪽 화면에는 AI 대화창을, 다른 쪽 화면에는 실행 중인 웹 브라우저와 메모장(또는 CMD)을 띄워두면 작업 속도가 배가 됩니다. 여건상 듀얼 모니터가 어렵다면 화면 분할 기능을 활용해 두 창을 나란히 배치해 보세요.

CHAPTER 03

기획 · 설계 · 교감 · 출력 · 분석 · 보완 · 배포

메모장에서 만든 웹 페이지를 실제 세상에 내놓고 사용자와 호흡하게 만드는 7단계 실전 워크플로우입니다. 비용 부담 없이 빠르고 안전한 배포를 지원하는 클라우드플래어(Cloudflare)를 중심으로 살펴봅니다.

7단계 순환 보드게임 맵 전체 여정 지도
[그림 3-1] 1단계 기획·설계부터 7단계 운영·확장까지 나아가는 7단계 여정 지도

1. 기획과 설계: 클라우드플래어(Cloudflare)

  • Cloudflare Pages: 우리가 만든 HTML, CSS, JavaScript 파일을 업로드하면 즉시 웹사이트 주소를 부여해 호스팅해 주는 서비스입니다.
  • CDN(콘텐츠 전송 네트워크): 전 세계 수백 개 도시에 서버를 두고, 접속자와 가장 가까운 서버에서 웹 페이지를 0.1초 만에 띄워주는 기술입니다.
  • DNS(도메인 네임 시스템): 사람이 읽기 쉬운 도메인 주소(예: jagijudo.com)를 실제 서버 위치와 연결해 주는 인터넷의 전화번호부입니다.

클라우드플래어는 개인이나 소규모 프로젝트가 시작하기에 트래픽 제한이 거의 없는 강력한 무료 요금제를 제공하며, 보안 인증서(HTTPS 자물쇠)를 자동으로 무료 적용해 줍니다.

2. 교감: 나만 보는 게 아니다

내 컴퓨터의 index.html 파일이 클라우드플래어에 올라가는 순간, 전 세계 누구나 스마트폰과 PC로 접속하게 됩니다. 따라서 '나만 편한 화면'이 아니라 '처음 접속한 타인도 설명서 없이 바로 이해하고 누를 수 있는 직관적인 화면(UI/UX)'을 AI에게 요청해야 합니다.

3. 출력: 클라우드플래어에서 임시 배포와 활용

정식 도메인을 연결하기 전, 클라우드플래어 Pages에 프로젝트 폴더를 올리면 프로젝트명.pages.dev 형태의 고유한 임시 배포(Preview) 주소가 즉시 생성됩니다.

클라우드플래어 구름 우체국 CDN 네트워크 애니메이션
[그림 3-2] 구름(Cloud) 초고속 배달 센터를 통해 전 세계로 0.1초 만에 전송되는 웹 페이지

4. 분석과 보완: 시행착오를 통한 완성도 높이기

임시 배포 링크를 스마트폰으로 열어보면 버튼이 삐져나오거나 점수가 어긋나는 등 예상치 못한 시행착오를 만납니다. 발견된 현상을 캡처해 AI에게 "모바일 화면에서 버튼 4개가 세로로 깔끔하게 정렬되도록 CSS를 수정해 줘"라고 요청하면 몇 초 만에 보완된 코드가 출력됩니다.

시행착오 분석-보완 핑퐁 일러스트
[그림 3-3] 학생이 돋보기로 문제를 짚어주면 AI 로봇이 즉시 수정하는 '분석-보완' 티키타카

5. 도메인 구입 및 최종 배포

임시 주소(*.pages.dev)로 검증이 끝났다면, 국내 등록 대행사(가비아, 후이즈 등)나 해외 등록처(Cloudflare Registrar, Namecheap 등)에서 고유 도메인을 구입해 클라우드플래어 대시보드에서 '사이트 추가(Add a domain)'로 등록합니다.

임시 배포에서 정식 도메인 간판 교체 및 HTTPS 안전 방패 설정
[그림 3-4] 연습 무대(*.pages.dev)에서 정식 간판(자기주도.com)과 HTTPS 안전 방패를 다는 과정

6. 도메인 설정 (네임서버 및 커스텀 도메인 연결)

  1. 네임서버 변경: 타사에서 도메인을 구입했다면 도메인 관리 메뉴에서 '네임서버(Nameserver)'를 클라우드플래어가 안내하는 2개의 주소로 변경합니다.
  2. 커스텀 도메인 연결: Cloudflare Pages 프로젝트의 '사용자 지정 도메인(Custom domains)'에 구입한 도메인 주소를 입력하면 DNS 레코드가 자동 연결됩니다.
  3. HTTPS 보안 활성화 확인: 몇 분 후 브라우저 주소창에 자물쇠 아이콘(SSL 보안)과 함께 웹 페이지가 열리면 전 세계 정식 배포가 완료됩니다.

7. 배포 이후의 운영과 지속적 확장

실제 사용자들의 피드백을 바탕으로 새로운 문항을 추가하고 AI 진단 프롬프트를 다듬으며, PDF 결과지 출력이나 학습 기록 저장 기능을 하나씩 붙여 나가며 나만의 플랫폼을 성장시킵니다.

[부록] 자주 만날 낯선 언어 모음집

용어 의미 쉬운 비유
Domain사람들이 주소창에 치고 들어올 내 웹사이트 이름가게 간판
Add a domain내가 사둔 도메인을 클라우드 시스템에 등록하기구청에 상호 등록하기
Nameserver도메인과 서버를 이어주는 연결고리건물 관리소
Workers & Pages내 웹사이트 파일을 올리고 실행하는 공간기계·장비가 들어갈 상가
Create application새 웹사이트 프로젝트를 담을 빈방 만들기상가 안에 내 점포 배정
Direct upload내 PC에 있는 폴더나 압축 파일을 끌어올리기인테리어 자재 트럭에 싣기
Deploy site올린 파일을 실제 인터넷에 배포하기가게 문 열고 영업 중 표시
Custom domain임시 도메인을 정식 도메인으로 전환임시 간판 떼고 정식 간판 달기
Production사람들이 실제로 보는 공식 운영 화면손님 맞이 본매장
Purge everything수정한 화면이 안 바뀔 때 강제로 이전 캐시 삭제새 전단지 붙이기
Wrangler명령어로 배포 전 파일을 한 번에 모아 올리는 도구포장이사
CHAPTER 04

나의 웹 페이지 만들기 (자기주도학습 AI 진단 체크리스트)

앞서 익힌 원리를 바탕으로 실제 교육 현장에서 활용할 수 있는 '자기주도학습 진단 체크리스트 웹 페이지(Jagijudo.com)'를 바이브 코딩으로 구현하는 실전 설계도입니다.

1. 핵심 기능 구조

자기주도학습 체크리스트 웹 페이지 화면 구성 안내도
[그림 4-1] ① 질문 입력창 · ② 진행률 게이지 바 · ③ 4지선다 점수 버튼 · ④ AI 처방전 결과 카드
  • ① 질문 입력 및 커스텀 창: 출제자(교사/원장)가 새로운 질문을 입력하고 4지선다 선택지(1점~4점 배점)를 추가·삭제할 수 있는 동적 관리 기능
  • ② 4지선다 응답 및 실시간 점수 합산: 학생이 문항을 클릭할 때마다 상단 진행률(Progress Bar)과 현재 합산 점수가 실시간으로 계산되는 반응형 설문 화면
  • ③ AI 맞춤형 학습 처방전 생성: 모든 문항 응답 후 총점과 선택 데이터를 바탕으로 [학습 성향 진단, 유형 분류, 취약점 분석, 3단계 실천 처방전]을 자동 생성하는 기능
점수 합산기와 AI 코치 처방전 발급 과정
[그림 4-2] 1점~4점 점수가 모여 AI 코치의 맞춤형 학습 처방전으로 발급되는 과정

2. AI에게 전달하는 실전 바이브 코딩 프롬프트

PROMPT · 복사해서 AI에게 그대로 붙여넣으세요
아래 기능을 갖춘 '자기주도학습 진단 체크리스트' 웹 페이지를 단일 HTML 파일(index.html)로 만들어줘.

1. 디자인: 신뢰감을 주는 깔끔한 로열 블루(#2563EB)와 화이트 배경의 카드형 UI, 모바일에서도 보기 편한 반응형 구조.
2. 질문 관리: 상단 '질문 추가' 버튼을 누르면 새로운 질문 텍스트를 입력해 리스트에 추가하고 삭제할 수 있는 기능.
3. 체크리스트: 각 질문마다 1점(전혀 아니다)~4점(항상 그렇다) 배점의 4지선다 버튼이 있고, 선택 시 실시간으로 진행률과 총점이 계산됨.
4. AI 결과 분석: '진단 결과 보기' 버튼을 누르면 총점과 문항별 응답 내역을 바탕으로 [종합 평가, 학습 유형, 보완점, 내일부터 실천할 3가지 행동 처방전]을 분석해 화면 하단 카드에 깔끔하게 출력해 줘.

✨ [웹북 독자 체험] 미니 자기주도학습 자가진단 맛보기

Q1. 공부하기 전에 오늘 끝낼 분량과 목표를 스스로 정한다.
Q2. 배운 내용을 책을 덮고 백지나 말로 1분 이상 복습한다.
CHAPTER 05

자기주도학습과 바이브 코딩

1. 질문하는 능력이 곧 실력이 되는 평행 이론

자기주도학습의 본질은 타인이 떠먹여 주는 지식을 수동적으로 받아적는 것이 아니라, 스스로 목표를 세우고(기획), 핵심 키워드를 찾아 질문하며(교감), 자신의 이해도를 점검하고(분석), 부족한 부분을 메워 나가는(보완) 주체적 학습 태도에 있습니다.

자기주도학습과 바이브 코딩 하이파이브 대칭 일러스트
[그림 5-1] 스스로 목표를 세우고 질문하는 '자기주도학습'과 '바이브 코딩'은 거울처럼 닮아 있습니다

놀랍게도 이 과정은 바이브 코딩의 7단계 워크플로우와 정확히 일치합니다. AI가 아무리 뛰어난 지능을 가지고 있어도 사용자가 '무엇을 만들지' 명확히 질문하지 않으면 아무것도 만들어내지 못합니다. 결국 좋은 질문을 던지는 자기주도적 인간만이 AI라는 강력한 도구를 온전히 지휘할 수 있습니다.

2. 학생과 교육자를 위한 새로운 도구

  • ▶ 학습자의 변화: 학생에게는 코딩 문법 암기라는 지루한 장벽을 넘어, 자신의 아이디어를 하루 만에 실제 작동하는 웹 서비스로 만들어 보는 성취감과 문제 해결력을 길러줍니다.
  • ▶ 교육자의 변화: 교사와 교육 기획자에게는 외주 개발사에 수백만 원을 맡기지 않고도, 자신의 교육 철학과 진단 노하우가 담긴 맞춤형 학습 도구와 워크북 연동 웹 앱을 직접 제작해 현장에 즉시 적용할 수 있는 날개를 달아줍니다.
소비자에서 창작자로 엔딩 일러스트
[그림 5-2] 남이 만든 앱을 쓰는 소비자에서, 내 아이디어를 세상에 여는 창작자로!
책을 마치며 지금 당장 바탕화면에서 '메모장'을 열어보세요. 작은 코드 몇 줄을 적고 index.html로 저장하는 그 순간, 당신은 이미 소비자를 넘어 창작자의 세계로 첫발을 내디딘 것입니다. AI와 함께 당신만의 교육과 비즈니스를 웹 위에 마음껏 펼쳐 보시길 응원합니다.