🔭 더 멀리 보기
내가 더 멀리 보았다면, 그것은 거인의 어깨 위에 서 있었기 때문이다.
— 아이작 뉴턴 (Isaac Newton)

이제 그 거인은 AI입니다. 혼자라면 몇 달이 걸릴 일도, AI라는 거인의 어깨 위에서 더 멀리 보고 더 멀리 갈 수 있어요.
이 가이드는 그 어깨에 단단히 올라타는 법을 차근차근 안내합니다.

아래에서 시작하기

바이브 코딩 입문 가이드 🧭

AI에게 무작정 코드를 맡기기 전에 알아두면 좋은 기초와 5단계 흐름.
비유로 큰 그림을 잡고, (괄호) 안의 기술 용어로 또박또박 요청해 보세요.

👀 한눈에 보는 웹 제작 로드맵

0단계. 주방 차리기 & 기초 공사 (IDE · Node.js · npm)

AI 셰프와 함께 요리할 '주방(IDE)'을 차리고, 최신 웹 앱(React 등)을 돌릴 '전기 공사(Node.js)'와 '식자재 트럭(npm)'을 들이는 준비 단계

1. 화면 만들기

뼈대와 디자인 (HTML/CSS/JS)

2. 역할 나누기

홀과 주방의 분리 (Front/Back)

3. 데이터 보관

주머니와 금고 (Storage/DB)

4. 코드 백업

안전한 세이브 (Git/GitHub)

5. 세상에 공개

클라우드 배포 (Local/Deploy)

0. 기초 공사 (전기와 식자재 배달)

요즘 웹 개발은 단순한 문서 작성이 아닙니다. 로컬(내 PC)에 공장을 세워야 합니다.

Node.js (마법의 작업장 / 전기)

원래 브라우저(손님 테이블)에서만 놀던 자바스크립트를 내 컴퓨터 전체에서 쓸 수 있게 해줍니다. React, Vite 같은 최신 프레임워크를 돌리려면 이 기초 전기 공사가 반드시 선행되어야 합니다.

자세히 보기

npm (식자재 도매상 트럭)

Node.js를 깔면 딸려옵니다. 전 세계 개발자들이 만들어둔 수백만 개의 코드 부품(달력, 버튼 등)을 내 프로젝트로 즉시 배달해 주는 패키지 매니저입니다.

자세히 보기
"내 로컬 컴퓨터에 기초 공사인 (Node.js)가 설치되어 있어. 여기서 (npm) 명령어를 사용해서 (Vite 기반의 React 프로젝트)를 새로 생성하고 실행하는 터미널 명령어를 순서대로 알려줘."

0.5. 나의 주방 차리기 (AI 에디터)

전기(Node)를 깔았다면, 이제 셰프와 내가 함께 요리할 '주방(작업 공간)'이 필요합니다. 바로 IDE(코드 에디터)입니다.

왜 챗 말고 IDE(에디터)에서 작업할까?

문서 편집에 비유하면 쉬워요.

챗 인터페이스 = PDF 편집

AI 답을 복사해 파일에 붙여넣고, 또 복사해서 묻고… 간접적이고 번거로워요. (PDF처럼 직접 고치기 불편)

IDE 인터페이스 = Word 편집

AI가 실제 코드 파일을 그 자리에서 직접 열고 고쳐요. (Word 문서를 바로 편집하듯 자연스럽게)

기본 주방 설비 (VS Code)

전 세계 개발자가 표준으로 쓰는 무료 주방입니다. 코드 편집·터미널·확장(Extension)이 한곳에 모여 있어, 모든 AI 주방의 뼈대가 됩니다.

자세히 보기

AI 셰프 상주 주방 (래퍼)

VS Code 주방 위에 'AI 셰프'를 상주시킨 도구들입니다. (Cursor)는 에디터 자체에, (Claude Code · Codex)는 터미널에서 AI가 직접 코드를 읽고 고칩니다.

자세히 보기

주방의 주문 창구: 터미널 (Terminal)

앞서 배운 (npm) 명령은 모두 이 내장 터미널에 입력합니다. 주방의 주문 단말기처럼, 내 컴퓨터에 직접 명령을 내리는 창구죠. (Prettier 같은 포매터) 확장을 더하면 코드도 깔끔하게 자동 플레이팅됩니다.

자세히 보기
"AI 셰프가 상주하는 (Cursor / Claude Code) 주방에서, (내장 터미널)을 열어 아까 만든 (Vite 프로젝트)를 실행하고, (Prettier 포매터)로 코드가 저장될 때마다 자동 정리되게 세팅하는 법을 알려줘."

1. 화면 만들기 (건축)

HTML (뼈대)
자세히
CSS (꾸미기)
자세히
JS (동작)
자세히

현대 웹의 마법: 상태 (State)

과거엔 메뉴 하나가 바뀌면 식당 전체를 새로고침해야 했습니다. 지금은 상태(State)라는 스마트 메모장을 써서 데이터가 바뀌면 화면 깜빡임 없이 즉시 그 부분만 바뀝니다.

자세히 보기
"화면을 꾸밀 때 (Tailwind CSS)를 사용하고, 버튼을 클릭하면 새로고침 없이 숫자가 즉시 바뀌도록 (React State 상태관리)를 적용해줘."

🎨 직접 해보기 (라이브 플레이그라운드)

왼쪽 코드를 바꾸면 오른쪽 화면이 실시간으로 바뀝니다. HTML(뼈대)·CSS(꾸미기)·JS(동작)가 어떻게 합쳐져 화면이 되는지 직접 확인해 보세요.

결과 화면 (실시간 렌더링)

💡 위 탭에서 HTML·CSS·JS를 바꿔보면, 같은 화면이 어떻게 달라지는지 바로 비교할 수 있어요.

2. 역할 분리와 소통 (메뉴판)

프론트 (홀)
자세히
API (메뉴판 양식)
백엔드 (주방)
자세히

프론트엔드가 백엔드에 마음대로 요구할 수 없습니다. 주방장이 정해둔 메뉴판 양식(API)에 맞춰 정확하게 요청해야 합니다.

잠깐, 백엔드가 항상 필요한 건 아니에요!

간단한 음료는 홀에서 바로 내드릴 수 있듯, 많은 서비스는 프론트(홀)만으로도 충분히 만들 수 있어요. '불을 써야 하는 요리'가 생길 때 비로소 주방(백엔드)이 필요해집니다.

프론트만으로 충분해요 (홀에서 해결)

  • 소개·포트폴리오·랜딩 페이지
  • 계산기·단위 변환기 같은 도구
  • 내 기기에만 저장하는 메모·투두 (로컬 스토리지)
  • 공개 API를 직접 부르는 화면 (예: 날씨 조회)
  • 글이 고정된 정적 블로그

이럴 땐 백엔드가 필요해요 (주방이 필요)

  • 회원가입·로그인 (비밀번호 안전 보관·인증)
  • 여러 사용자가 데이터를 공유·동기화 (게시판·댓글·채팅)
  • 결제·주문 처리
  • 숨겨야 하는 비밀 키(API Key)가 필요한 작업
  • 데이터베이스에 영구 저장·검색, 이메일 발송 등

💡 그래서 처음엔 프론트부터 빠르게 만들어 보고, 위 오른쪽 같은 기능이 필요해지는 순간 백엔드를 붙이는 순서를 추천해요.

"손님이 보는 (프론트 UI)와 데이터를 검증하는 (백엔드 로직)을 분리하고, 이 둘이 데이터를 주고받을 수 있게 (RESTful API 엔드포인트)를 만들어줘."

3. 데이터 보관 (주머니 vs 금고)

손님 주머니 (Local Storage)

내 폰에만 저장됩니다. 인터넷 없이도 작동하지만, 브라우저 기록을 지우거나 다른 기기로 접속하면 데이터가 영원히 날아갑니다.

자세히 보기

중앙 금고 (Database)

서버 깊숙한 곳에 보관됩니다. 데이터가 안전하게 보존되며, 로그인 시 어디서나 똑같은 데이터를 불러옵니다.

자세히 보기
"데이터가 유지되게 일단 브라우저 (로컬 스토리지)에 임시 저장되도록 짜줘. 나중에 실제 클라우드 금고 (Cloudflare D1 SQL 데이터베이스)로 교체할 수 있게 해둬."

4. 코드 저장과 백업 (타임머신)

Git (개인 타임머신)

AI가 코드를 망쳐도 어제로 되돌려주는 세이브 포인트(버전 관리)입니다.

자세히 보기

GitHub (클라우드 백업)

Git 기록을 인터넷에 백업하여 전 세계에 앱을 자동 배포(CI/CD)할 수 있게 해줍니다.

자세히 보기

Git 흐름 한눈에 보기 (브랜치 · 커밋 · 머지)

main (본 메뉴) feature 브랜치 (실험) 분기 머지

원본(main)은 그대로 두고 브랜치(가지)에서 실험 → 커밋으로 저장 → 완성되면 main에 머지(합치기). 아래 용어를 눌러 자세히 보세요.

"지금 작동이 잘 돼. 코드가 망가지기 전에 (Git Commit)으로 세이브 포인트를 만들고, (GitHub Repository)에 푸시(Push)하는 방법을 알려줘."

5. 세상에 공개 (정식 오픈)

로컬 (Local) 환경

내 컴퓨터(Localhost)에서만 접속하며 에러를 테스트하는 개발 환경입니다.

자세히 보기

배포 (Deploy) 환경

클라우드 서버에 코드를 올려 누구나 접속할 수 있는 실제 도메인 주소를 부여받습니다.

자세히 보기
"로컬 테스트를 마쳤어. 아까 올려둔 (GitHub)의 코드를 (Cloudflare Pages) 클라우드에 자동 배포(Deploy)하는 가이드를 줘."

☁️ 그래서, 어디에 배포할까? (클라우드 고르기)

위에서 본 '배포'를 실제로 어디에 할지 고를 차례예요. 입문자 친화 플랫폼부터 전문가용 종합 클라우드까지 — 카드를 눌러 자세히 보세요.

입문자 친화 (빠르고 쉽게 시작)

Cloudflare

GitHub만 연결하면 전 세계에 무료로 빠르게 배포(Pages). DB(D1)까지 손쉽게.

자세히 보기

Supabase

DB·로그인·저장소 등 백엔드 기능을 코드 조금으로. Firebase의 오픈소스 대안.

자세히 보기

Firebase

구글의 올인원 백엔드. 실시간 DB·로그인·호스팅을 앱에 빠르게 붙이기.

자세히 보기

전문가용 종합 클라우드 (강력하지만 러닝커브↑)

AWS

세계에서 가장 큰 클라우드. 수백 가지 서비스로 어떤 규모든 감당.

자세히 보기

Google Cloud

데이터 분석·AI/머신러닝과 구글 생태계 연동에 강한 클라우드.

자세히 보기

Azure

기업용 시스템과 윈도우/오피스·.NET 환경에 강한 MS 클라우드.

자세히 보기
"내 프로젝트는 (간단한 웹앱)이야. 처음엔 (Cloudflare)(Supabase) 같은 입문자 친화 플랫폼으로 빠르게 배포하고, 나중에 규모가 커지면 (AWS) 같은 전문 클라우드로 옮기는 전략을 알려줘."

✨ AI 셰프와 협업하는 법 (AI 하네스)

AI는 마법 지팡이가 아니라 '새로 온 셰프(요리사)'입니다. 이 셰프가 진짜로 요리하게 해주는 「레시피북 + 조리도구 + 주방 출입증」 묶음이 바로 'AI 하네스'예요.

챗봇처럼 '말로만' 주문받는 것과, 내 주방에서 '직접 칼을 잡고 요리하는' 것의 결정적 차이가 바로 이 하네스에 있습니다.

하우스 레시피 (Rules)

우리 가게의 맛·플레이팅 규칙을 적어두면 매번 설명할 필요가 없습니다. 예: Claude Code의 (CLAUDE.md), Cursor의 (.cursorrules). 셰프에게 건네는 '하우스 레시피'죠.

자세히 보기

조리 도구 (Tools)

AI가 직접 재료를 손질(파일 편집)하고, 식재료를 찾고(검색), (터미널 명령)이라는 불까지 다루는 능력. 단순 챗봇과의 결정적 차이를 만드는 '진짜 칼과 불'입니다.

자세히 보기

식자재 거래처 연결 (MCP)

GitHub·데이터베이스·디자인 도구 등 외부 시스템에 AI를 잇는 표준 납품 라인입니다. (MCP, Model Context Protocol) 덕분에 주방 밖 거래처와도 연결됩니다.

자세히 보기

서빙 전 검수 (Permissions)

재료 폐기·메뉴 출시(배포)처럼 돌이키기 어려운 작업 전에 내 확인을 받게 하는 안전장치입니다. (승인/Approval)로 설익은 요리가 손님에게 나가는 걸 막죠.

자세히 보기

전문 비법 레시피 (Skill)

특정 메뉴(작업)를 위한 절차·요령·도구를 하나로 묶은 '비법 레시피 키트'입니다. 필요할 때만 꺼내 써서 그 작업을 늘 일관되게 처리해요. (Claude Code의 Agent Skills)가 대표적이에요.

자세히 보기
"앞으로 이 주방에선 (설명은 한국어로) 하고 (들여쓰기는 2칸)을 지켜줘. 이 레시피 규칙을 (CLAUDE.md 파일)에 저장해서 매번 기억하게 해줘. 그리고 코드를 (삭제하기 전)엔 꼭 나한테 먼저 물어봐."

🚑 바이브 코딩 생존 원칙

거인의 힘은 AI가 주지만, 방향(계획)과 확인(검증)은 사람의 몫이에요. AI를 마법 지팡이처럼 한 번에 휘두르지 마세요.

작게 쪼개기 (Iterative)

  • "로그인 화면 뼈대(HTML) 짜줘."
  • "그 다음 작동 로직(JS/State) 붙여."
  • "잘 됐으니 GitHub에 백업(Git)할게."

설계부터 또렷이 (계획 먼저)

코드부터 짜지 말고 무엇을·어떤 로직으로 만들지 말로 먼저 정하세요. AI에게도 바로 시키지 말고 (계획)부터 세우게 하면 길을 덜 잃어요.

만든 건 반드시 검증 (테스트·TDD)

동작 확인 없이 넘어가지 마세요. 기대 결과를 먼저 정하고 그대로 되는지 확인하는 습관이 (TDD)의 출발이에요.

그레이존을 두지 말기

집계·결제·로그인 같은 중요 로직을 '아마 되겠지'로 남기지 마세요. 핵심은 (직접 검증)해야 진짜 완성입니다.

에러는 복붙이 생명

빨간 에러창이 뜨면 당황하지 말고 에러 로그를 그대로 복사해서 물어보세요.

npm ERR! code ENOENT...

🪄 "터미널에 이런 에러가 났어. 해결 방법과 수정된 코드 줘."

🚨 자주 만나는 에러 간단 사전

처음 보면 무섭지만, 사실 단골 손님 같은 에러들이에요. 뜻만 알면 AI에게 물어보기도 쉬워집니다.

CORS 에러

blocked by CORS policy

뜻: 브라우저가 '다른 출처(도메인)'의 데이터를 함부로 못 가져오게 막는 보안 규칙에 걸린 거예요.

해결: 보통 서버(백엔드)에서 CORS 허용 설정을 추가해야 해요. 프론트 잘못이 아닌 경우가 많아요.

404 Not Found

GET /page 404 (Not Found)

뜻: 찾는 주소(파일·API 경로)가 없어요.

해결: 경로 오타·대소문자·파일 위치를 확인하세요.

500 Internal Server Error

500 Internal Server Error

뜻: 서버 안에서 코드가 터졌어요(서버 쪽 오류).

해결: 서버 로그(터미널)를 열어 진짜 원인 메시지를 찾는 게 먼저예요.

TypeError (undefined)

Cannot read properties of undefined

뜻: 아직 없는(빈) 값을 사용하려다 난 거예요.

해결: 데이터가 도착한 뒤에 쓰는지 확인, 옵셔널 체이닝 ?. 활용.

패키지 설치 에러

npm ERR! code ENOENT

뜻: 패키지 설치 중 파일·버전 문제가 생겼어요.

해결: node_modules 삭제 후 재설치, Node 버전 확인.

포트 사용 중

EADDRINUSE: address already in use :::3000

뜻: 그 포트(예: 3000번)를 이미 다른 프로그램이 쓰고 있어요.

해결: 기존 실행을 종료하거나 다른 포트로 실행하세요.

🪄 어떤 에러든 빨간 메시지를 그대로 복사해서 "이 에러가 났어. 원인과 해결 방법, 수정된 코드 줘"라고 물어보면 가장 빠릅니다.

🏢 사내 환경에서 결과물 활용 꿀팁

회사 보안 환경에선 일반 배포와 다른 점이 많아요. 미리 알아두면 삽질을 크게 줄일 수 있습니다.

1

SPA를 적극 활용하세요

파일을 반입할 때 HTML·CSS·JS를 매번 여러 개 올리긴 번거로워요. 개발은 파일을 나눠(모듈화) 하더라도, 배포용은 하나의 SPA(단일 HTML 파일)로 합쳐서 반입하면 훨씬 수월합니다.

2

패키지 설치(npm·pip)는 막혀 있어요 → 로컬에서 빌드

보안 때문에 사내에선 npm·pip 같은 패키지 설치가 대개 안 됩니다. 그래서 내 PC(로컬)에서 개발·빌드를 끝내고, 완성된 결과물만 반입해야 해요.

📦 빌드(Build)란? 사람이 나눠 쓴 코드와 라이브러리를, 브라우저가 바로 읽을 수 있는 최종 파일로 묶고 압축하는 과정이에요. (자세히는 위 '빌드' 단어를 눌러보세요)

3

CDN은 보통 동작해요 (unpkg·jsDelivr)

패키지 설치가 막혀도 CDN으로 라이브러리를 불러오는 방식은 대개 동작합니다. unpkg·jsDelivr 등을 쓰세요. 다만 환경에 따라 특정 CDN이 차단돼 있기도 하니, 자주 쓰는 CDN은 미리 동작하는지 확인하세요.

4

SharePoint·Outlook·OneDrive에선 <script>가 막히기도

이 환경들에선 보안상 HTML 안의 <script>(자바스크립트)가 작동하지 않는 경우가 많아요. 대신 파일을 다운로드해서 열면 정상 동작합니다. 어디로 배포·공유할지를 미리 정하고 거기에 맞춰 만드세요.

5

사내 데이터는 절대 AI에 넘기지 마세요

사내 데이터 파일엔 문서보안(DRM) 솔루션이 걸려 있어요. 데이터를 보여주거나 가공하는 작업은 데이터를 CSV로 import해서 화면에서 처리하게 만드세요.

🚨 AI에게는 데이터의 '컬럼(항목) 구조'만 알려주고, 실제 데이터 내용은 절대 전달하지 마세요.

📺 추천 영상

바이브 코딩 입문에 도움이 되는 영상을 모았어요. 썸네일을 누르면 유튜브로 이동합니다.

추천 영상 1 썸네일
추천 영상 ①
추천 영상 2 썸네일
추천 영상 ②
추천 영상 3 썸네일
추천 영상 ③

🪜 거인의 어깨 위로

이제 AI라는 거인의 어깨에 올라탈 차례예요. 배운 내용으로 사내 HR 데이터를 대시보드로 만들어 보세요. VS Code와 로컬 Git만 있으면 됩니다.

거인의 어깨 위로 올라가기
1 / 1