🎓 바이브코딩 연수 실습

단어 팡팡 게임 만들기

AI와 함께 영어 단어 게임을 단계별로 완성해요

연수 개요
바이브코딩으로 게임을 만드는 경험
코드를 몰라도 괜찮아요. AI에게 원하는 것을 말로 설명하면 됩니다.
이 연수는 프롬프트 → 결과 확인 → 개선 요청의 흐름을 반복하며 완성해 나갑니다.
⏱ 총 90~120분 🌱 코딩 완전 초보 대상 🤖 Claude.ai 사용
STEP 1
기본 틀 만들기
화면에 단어가 떨어지는 가장 간단한 버전
⏱ 15~20분
STEP 2
엑셀 연결
내 단어장 파일을 게임에 불러오기
⏱ 15~20분
STEP 3
기능 강화
점수·타이머·정답 효과 추가
⏱ 20~25분
STEP 4
디자인 꾸미기
색상·폰트·배경을 내 수업에 맞게
⏱ 15~20분
STEP 5
기능 추가 도전
카메라·2인 모드 등 확장 기능
⏱ 20~30분
💬
바이브코딩이란? 코드 문법을 외우는 대신, AI에게 "이렇게 만들어줘"라고 말로 요청해서 결과물을 만드는 방식이에요. 원하는 기능을 구체적으로 설명할수록 더 좋은 결과가 나옵니다.
📌
준비물 Claude.ai 계정 · 크롬 브라우저 · 엑셀 파일(단어, 뜻 2열 구성). 이 가이드의 프롬프트는 복사 버튼으로 그대로 붙여넣기 하세요.
STEP 1 · 15~20분
게임의 기본 틀 만들기
아무것도 없는 상태에서 시작합니다. 첫 프롬프트 하나로 게임의 뼈대를 만들어요.
🎯
이 단계 목표 — 화면에 영어 단어들이 위에서 아래로 떨어지고, 클릭하면 사라지는 HTML 파일 완성
프롬프트 1-1
게임 기본 구조 생성
영어 단어 학습 게임을 HTML 파일로 만들어줘. 기능: - 화면 위에서 영어 단어들이 랜덤으로 떨어져 내려옴 - 화면 아래쪽에 찾아야 할 단어의 뜻이 표시됨 (예: "농구") - 뜻에 해당하는 영어 단어를 클릭하면 사라지고 다음 문제로 넘어감 - 틀린 단어를 클릭하면 흔들리는 효과 - 60초 타이머와 점수판 표시 일단 아래 단어 5개로 테스트해줘: - basketball: 농구 - soccer: 축구 - tennis: 테니스 - baseball: 야구 - badminton: 배드민턴 하나의 HTML 파일로 만들어줘.
✅ 기대 결과
게임 화면이 나타나고, 단어들이 아래로 떨어지며, 클릭하면 반응하는 기본 게임이 완성됩니다.
프롬프트 1-2
잘 안 될 때 — 오류 수정 요청
파일을 열었는데 [문제 상황을 여기에 써줘]. 예) "단어가 안 떨어져요" / "클릭해도 반응이 없어요" / "타이머가 멈춰요" 수정해줘.
🔧
연수 강사 안내 — 오류가 생겼을 때 당황하지 말고 "어떤 문제가 있는지 AI에게 그대로 말하면 된다"는 것을 강조하세요. 오류 수정 요청도 바이브코딩의 핵심입니다.
STEP 2 · 15~20분
엑셀 단어장 연결하기
코드에 단어를 직접 넣는 대신, 엑셀 파일을 올리면 자동으로 읽어오게 만듭니다.
🎯
이 단계 목표 — 엑셀 파일(.xlsx)을 업로드하면 그 안의 단어들이 게임에 자동으로 반영되도록 연결
프롬프트 2-1
엑셀 파일 업로드 기능 추가
게임 시작 화면에 엑셀 파일(.xlsx)을 업로드하는 버튼을 추가해줘. 엑셀 파일 형식: - 1행: 헤더 (A열: "단어", B열: "뜻") - 2행부터: 실제 단어 데이터 파일을 올리면 그 단어들로 게임이 시작되게 해줘. xlsx 파일을 읽으려면 SheetJS 라이브러리를 CDN으로 불러와서 사용해.
✅ 기대 결과
게임 시작 전에 "엑셀 파일 고르기" 버튼이 생기고, 파일을 올리면 그 단어들로 게임이 진행됩니다.
프롬프트 2-2
엑셀에 시트가 여러 개일 때 — 단원 선택 기능
엑셀 파일에 시트가 여러 개 있을 때, 어떤 시트(단원)를 쓸지 고를 수 있게 해줘. 파일을 올리면 시트 목록이 버튼으로 나타나고, 원하는 시트를 누르면 그 단어들로 게임이 시작되게 해줘.
📂
엑셀 서식 안내 — 1행에 반드시 "단어", "뜻" 헤더가 있어야 합니다. 미리 만들어 둔 서식 파일(단어팡팡_단원별_단어장.xlsx)을 나눠주세요.
STEP 3 · 20~25분
게임 기능 강화하기
기본 게임에 재미 요소를 하나씩 추가합니다. 각 프롬프트를 순서대로 실습하세요.
🎯
이 단계 목표 — 효과음, 정답/오답 애니메이션, 게임 시간 설정, 결과 화면 완성
프롬프트 3-1
정답/오답 효과 추가
정답을 맞췄을 때와 틀렸을 때 효과를 추가해줘. - 정답: 단어가 팡! 하고 터지는 애니메이션 + 상쾌한 효과음 - 오답: 단어가 흔들리는 애니메이션 + 실패 효과음 - 효과음은 Web Audio API로 직접 만들어줘 (외부 파일 없이)
프롬프트 3-2
게임 시간 선택 기능 추가
게임 설정 화면에 게임 시간을 고를 수 있는 옵션을 추가해줘. 선택지: - 30초 (빠르게) - 60초 (보통) ← 기본값 - 90초 (여유롭게) - 120초 (넉넉하게)
프롬프트 3-3
게임 결과 화면 개선
게임이 끝났을 때 결과 화면을 더 풍성하게 만들어줘. - 최종 점수와 함께 칭찬 메시지 (점수에 따라 다르게) · 100점 이상: "완벽해요! 영어 왕! 👑" · 70~99점: "훌륭해요! 조금만 더! 🌟" · 70점 미만: "다시 도전해봐요! 💪" - "한 번 더 하기" 버튼 - 승리/패배 효과음
💡
연수 강사 안내 — 각 프롬프트를 하나씩 실습한 뒤 결과를 확인하는 시간을 주세요. "생각보다 잘 된다"는 성취감이 다음 단계의 동기가 됩니다.
STEP 4 · 15~20분
디자인 꾸미기
게임을 내 수업 분위기에 맞게 시각적으로 다듬습니다.
🎯
이 단계 목표 — 색상 테마 변경, 폰트 적용, 전체적인 분위기 통일
프롬프트 4-1
색상 테마 변경
게임의 전체 색상 테마를 바꿔줘. 원하는 스타일: [아래 중 하나를 골라 붙여넣기] 예시 1 — 오렌지 따뜻한 느낌: 주색: #E65100 (진한 오렌지) 배경: #FFFAF5 (크림색) 강조: #FF8F00 (황금 오렌지) 예시 2 — 파란 시원한 느낌: 주색: #1565C0 (진한 파랑) 배경: #E3F2FD (연파랑) 강조: #0288D1 (밝은 파랑) 예시 3 — 초록 자연 느낌: 주색: #2E7D32 (진한 초록) 배경: #F1F8E9 (연초록) 강조: #558B2F (올리브)
프롬프트 4-2
폰트와 전반적인 분위기 개선
게임의 폰트와 전체 분위기를 초등학생 영어 수업에 어울리게 바꿔줘. - 제목과 점수: 귀엽고 굵은 영문 폰트 (Baloo 2 추천) - 한글: 깔끔한 고딕 폰트 (Noto Sans KR) - 버튼: 모서리가 둥글고 눌리는 느낌 - 단어 카드: 입체감 있는 말풍선 스타일 Google Fonts에서 불러와서 사용해줘.
프롬프트 4-3
시작 화면 꾸미기
게임 시작 화면(오버레이)을 더 예쁘게 만들어줘. - 상단에 멋진 게임 제목 (예: "🏀 단어 팡팡 게임") - 제목 아래에 짧은 설명 문구 - 설정 영역은 흰 카드 스타일로 정리 - 시작 버튼은 크고 눈에 잘 띄게
STEP 5 · 20~30분 (선택)
기능 추가 도전!
여기서부터는 선택 도전입니다. 시간이 남는 분들을 위한 심화 프롬프트예요.
도전 A
📷 카메라 배경 추가
게임 배경에 웹캠 화면이 나오게 해줘. - 게임 화면 뒤에 카메라 영상이 거울처럼 뒤집혀서 나와야 해 - 카메라 영상 위에 반투명하게 게임 UI가 올라오는 느낌 - 카메라 권한을 거부했을 때는 그냥 배경색으로 대체해줘
도전 B
⚔️ 2인 대결 모드 추가
화면을 좌우로 나눠서 2명이 동시에 게임하는 모드를 추가해줘. - 화면 중앙에 세로 구분선이 생김 - 왼쪽(P1)과 오른쪽(P2)에 각자의 목표 단어와 점수가 표시됨 - 단어들이 각자의 영역 안에서만 떨어짐 - 60초 후 더 높은 점수인 사람이 승리 - 설정 화면에서 "1인 모드 / 2인 모드" 선택 가능
도전 C
✋ 손 동작으로 조작하기 (고급)
MediaPipe Hands 라이브러리를 사용해서 손가락으로 단어를 터치하는 기능을 추가해줘. - CDN: https://cdn.jsdelivr.net/npm/@mediapipe/hands/hands.js - 검지 손가락 끝 위치를 추적해서 단어 위에 올리면 클릭되게 해줘 - 손 포인터를 동그란 원으로 화면에 표시해줘 - 설정에서 "터치/마우스" 와 "손 동작" 중 선택 가능하게 해줘
🌟
도전 성공 시 — 완성한 게임을 HTML 파일로 저장해서 수업에 바로 활용할 수 있어요. 학교 컴퓨터나 태블릿에서 파일만 열면 됩니다. (인터넷 없이도 동작!)
Claude에게 붙여넣기
AI 개발 규칙 프롬프트
연수 시작 전, 이 프롬프트를 Claude 대화창에 먼저 붙여넣으세요.
이후 모든 요청이 일관된 방식으로 처리됩니다.
📌
사용 방법 — Claude.ai에서 새 대화를 시작하고, 아래 전체 프롬프트를 첫 메시지로 붙여넣기 하세요. 그 다음부터 게임 만들기 요청을 하면 됩니다.
0번 — 시스템 규칙
연수 시작 전 Claude에 입력하는 개발 규칙
너는 숙련된 프론트엔드 개발자이자 초등학생도 이해할 수 있게 설명하는 코딩 튜터다. 앞으로 내가 웹앱을 만들고 싶다고 요청하면 다음 규칙을 반드시 지켜라. [개발 규칙] 1. HTML, CSS, JavaScript를 반드시 하나의 HTML 파일에 작성한다. 2. 별도의 파일 분리는 하지 않는다. 3. 내가 바로 복사하여 실행할 수 있도록 완전한 코드만 제공한다. 4. 누락된 코드 없이 처음부터 끝까지 작성한다. 5. CDN 사용이 가능하면 설치가 필요 없는 방법을 우선 사용한다. 6. React, Vue 등의 프레임워크가 필요한 경우 CDN 방식으로 구현한다. 7. 특별한 이유가 없다면 순수 HTML/CSS/JavaScript를 우선 사용한다. 8. 모바일과 PC 모두 사용할 수 있도록 반응형으로 제작한다. 9. 디자인은 현대적이고 깔끔하게 만든다. 10. 색상은 보기 편한 색상을 사용한다. 11. 버튼, 입력창 등의 UI는 충분히 크게 만든다. 12. 오류가 발생하지 않도록 전체 코드를 검토한 후 제공한다. 13. 외부 API가 필요한 경우 사용 방법도 함께 설명한다. 14. 초보자가 이해할 수 있도록 코드 주석을 적절히 넣는다. 15. 내가 수정 요청을 하면 전체 코드를 다시 제공한다. 16. 기능 추가 시 기존 기능이 삭제되지 않게 유지한다. 17. 웹앱 제목과 주요 기능을 상단에 표시한다. 18. 저장 기능이 필요하면 LocalStorage를 활용한다. 19. 데이터가 많아질 경우 검색, 정렬, 필터 기능을 고려한다. 20. 접근성(Accessibility)을 고려한다. [응답 형식] 0. 내가 입력한 프롬프트 원문을 그대로 먼저 보여준다. 1. 먼저 구현 내용을 간단히 설명한다. 2. 그 다음 완성된 HTML 파일 전체를 제공한다. 3. 코드 중간 생략 금지. 4. "이후 계속 작성" 금지. 5. "나머지는 동일" 금지. 6. 항상 실행 가능한 최종본 제공. [추가 규칙] - 사용자가 초보자라고 가정한다. - 가장 간단하면서 유지보수가 쉬운 구조를 사용한다. - UI/UX 품질을 높인다. - 에러 방지 로직을 포함한다. - 필요한 경우 샘플 데이터도 생성한다.
✅
규칙 확인 방법 — 붙여넣기 후 Claude가 "알겠습니다"라고 답하면 성공! 이제 STEP 1 프롬프트를 다음 메시지로 보내세요.
💡
응답 형식 0번이란? — Claude가 답변할 때 내가 보낸 프롬프트 원문을 먼저 보여줍니다. 연수 참가자들이 "내가 뭘 요청했는지"를 되짚어 볼 수 있어 학습에 도움이 됩니다.
강사용 가이드
연수 운영 팁
초보자 대상 바이브코딩 연수를 효과적으로 운영하기 위한 팁들입니다.
🗣️
핵심 메시지 — 연수 시작 시 꼭 강조하세요 "오늘은 코드를 배우는 날이 아닙니다. AI에게 말하는 법을 배우는 날입니다. 틀려도 됩니다. AI는 다시 물어보면 되니까요."
공통 팁
잘 안 될 때 쓰는 만능 프롬프트
방금 만든 게임에서 문제가 생겼어. [증상을 여기에 구체적으로 설명] 예) "파일을 열면 빈 화면만 나와" 예) "단어를 클릭해도 아무 반응이 없어" 예) "타이머가 시작되지 않아" 전체 코드를 다시 주지 말고, 수정해야 할 부분만 알려줘.
⏱️
시간 배분 추천
도입 + 바이브코딩 개념 설명: 10분
STEP 1 (기본 틀): 20분
STEP 2 (엑셀 연결): 20분
STEP 3 (기능 추가): 25분
STEP 4 (디자인): 15분
STEP 5 (도전, 선택): 남는 시간
마무리 + 공유: 10분
✅
참가자 이탈 방지 방법
· STEP 1은 반드시 전체가 성공하고 넘어가기
· "빨리 끝난 분은 도전 A, B, C로" 차별화
· 막힌 부분은 프롬프트를 함께 수정해 보기
· 중간마다 "어떤 게 신기했나요?" 소감 나누기
📤
마무리 활동 제안
완성한 게임을 USB나 공유 드라이브에 저장 → 다음 날 실제 수업에 활용 → 다음 연수 때 "써봤어요!" 발표 시간 갖기