상품 소개 페이지 만들기
1. 한라봉을 돌려 보는 상품 페이지
GLB 모델 파일로 제주상점 한라봉을 만듭니다. 왼쪽은 돌려 보는 한라봉, 오른쪽은 설명·가격·담아 보기 버튼입니다. 휴대폰에서는 위아래로 놓습니다.

먼저 제공된 한라봉으로 만들어 보고, 나중에 내 물건으로 바꿔 보세요. 이번부터 Claude Desktop의 Code 탭, Local에서 여러 파일을 만들고 실행합니다.
2. 모델 파일과 재료 준비하기
2.1 glTF와 GLB
GLB는 웹용 3D 형식인 glTF를 바이너리로 담은 파일입니다. 모양·재질·이미지를 한 파일에 담을 수 있습니다. 실습의 한라봉 두 파일에는 이미지까지 들어 있습니다.
2.2 제공 모델 꺼내기
아래 ZIP을 풀어 02-product-page 폴더를 참고용으로 둡니다. 모델과 출처 파일만 꺼내 새 페이지를 만들어 봅시다.
- 새 작업 폴더
my-product를 만듭니다. - 그 안에
public, 그 안에models폴더를 만듭니다. 02-product-page/public/models/의product.glb와product-green.glb를 복사합니다.02-product-page의에셋출처.md,THREE-LICENSE.txt,VITE-LICENSE.md도 새 작업 폴더에 복사합니다.
my-product/
├── public/
│ └── models/
│ ├── product.glb
│ └── product-green.glb
├── 에셋출처.md
├── THREE-LICENSE.txt
└── VITE-LICENSE.md
product.glb는 햇살빛, product-green.glb는 청귤빛 한라봉입니다. 위니브가 교재 실습용으로 만든 두 모델의 출처 문서를 함께 보관하세요.
3. Code 탭에서 프로젝트 만들기
3.1 폴더를 열고 Node 준비하기
- Claude Desktop 왼쪽 위 Code 탭을 엽니다.
- 입력창 아래 줄의 첫 칸에서 Local 묶음의 맨 위 항목을 고릅니다.
- 바로 옆 폴더 칸의 Open folder…로
my-product를 고릅니다.
Vite 실행에는 Node.js가 필요합니다. 먼저 준비됐는지 물어봅니다.
이 폴더에서 Vite 프로젝트를 만들려고 해.
Node.js와 npm이 준비되어 있는지 확인해줘.
Vite 8.3.5의 Node 조건은 ^20.19.0 || >=22.12.0이야.
맞지 않거나 설치되어 있지 않으면 공식 설치 방법을 안내해줘.
public/models의 모델과 출처 문서는 유지해줘.
설치가 필요하면 아래 공식 다운로드에서 LTS 설치 파일을 받아 설치합니다. Claude Desktop을 완전히 닫았다가 다시 열고, 같은 폴더에서 "node 버전을 확인해줘"라고 요청하세요.
작업 중 명령 실행이나 파일 수정의 승인을 묻는 창이 나오면 내용을 읽고 허용합니다.
터미널이 편한 분: my-product에서 claude를 실행하고 이 절의 요청을 그대로 입력해도 됩니다.
3.2 첫 상품 페이지 요청하기
상품과 파일 위치, 원하는 동작을 알려 줍니다.
한라봉을 손으로 돌려 보며 소개를 읽는 상품 페이지를 만들어줘.
따뜻한 크림색 배경에 왼쪽은 3D 뷰어, 오른쪽은 상품 설명으로 해줘.
모바일에서는 뷰어 다음에 설명이 나오게 해줘.
- Vite 8.3.5와 JavaScript, Three.js 0.186.1을 사용해줘.
- 이미 있는 public/models/product.glb와 출처 문서는 보존해줘.
- GLTFLoader로 모델을 불러오고, 크기와 중심을 계산해 전체가 잘 보이게 해줘.
- OrbitControls로 마우스와 터치 드래그를 지원해줘.
- 가만히 둘 때 천천히 자동 회전하고, 회전 멈추기와 처음 각도 버튼을 넣어줘.
- 주황색이 너무 밝게 날아가지 않도록 조명과 노출을 맞춰줘.
- 상점 이름은 제주상점으로 해줘.
- 제목은 한라봉, 카피는 '제주의 햇살을, 당신의 하루에.'로 해줘.
- 구매 버튼은 실제 결제 없이 페이지 안에 안내 문구만 보여줘.
- 모델 주소는 import.meta.env.BASE_URL을 반영해 배포 경로가 바뀌어도 맞게 해줘.
- 설치와 실행을 확인한 뒤, 내가 열 주소와 확인한 내용을 알려줘.
Claude가 알려 준 localhost 주소를 Code 탭의 Browser 창에서 열거나 Chrome·Edge 주소창에 붙여 넣습니다. 보통 http://localhost:5173이나 http://127.0.0.1:5173이며, 번호가 달라도 실제 안내받은 주소를 쓰세요.
한라봉과 설명이 보이고 드래그되면 성공입니다. 가격과 빛깔 선택은 뒤에서 더합니다.
명령으로 직접 실행하고 싶다면
package.json이 있는 my-product에서 실행합니다. Claude가 실행했다면 그대로 쓰세요.
npm install
npm run dev
완성본은 npm install 대신 npm ci를 씁니다. 출력된 주소로 엽니다.
어떤 주소로 여나요: 이 프로젝트는 별도 JavaScript와 모델을 읽으므로, 더블클릭 대신 Vite로 실행한 localhost 주소를 엽니다.
개념 사전: localhost · 콘솔과 오류 메시지
4. 화면을 확인하고 다듬기
4.1 모델과 조작 확인하기
잎과 꼭지까지 보이나요? 드래그한 뒤 [처음 각도]로 돌리고 회전을 껐다 켜 보세요.
| 증상 | Claude에게 이렇게 말하세요 |
|---|---|
| 모델이 너무 작거나 잘립니다 | 모델의 크기와 중심, 카메라를 계산해서 전체가 보이는 범위 안에서 더 크게 보여줘 |
| 모델이 안 보입니다 | 모델 요청의 주소와 404 여부를 먼저 확인해줘. 파일은 public/models/product.glb에 있어 |
| 모델이 검게 보입니다 | 모델 로드 성공 여부와 재질·텍스처·조명을 차례로 확인해줘 |
| 한라봉이 하얗게 날아갑니다 | 주황색과 표면 질감이 보이도록 조명과 노출을 조정해줘 |
| 회전을 멈춰도 조금씩 돕니다 | 자동 회전을 끄면 남은 관성도 즉시 멈추게 해줘. 수동 드래그는 유지해줘 |
정지 버튼의 글자와 함께 모델도 멈추는지 보세요.
4.2 설명과 색상 전환 더하기
예시 가격과 구성, 빛깔 선택을 더합니다.
한라봉 아래에 받침대와 그림자가 보이게 해줘.
설명에는 가격 19,800원, 한 상자 3kg과 특징 세 가지를 넣고,
'교재 실습용 상품입니다. 가격과 구성은 예시입니다.'라고 적어줘.
구매 버튼은 '한 상자 담아 보기'로 하고 누르면 안내만 보여줘.
'햇살빛'과 '청귤빛' 버튼으로 두 GLB를 전환하게 해줘.
햇살빛은 public/models/product.glb,
청귤빛은 public/models/product-green.glb야.
빠르게 번갈아 눌러도 마지막으로 고른 모델이 남아야 해.
두 모델 모두 배포 base를 반영한 주소로 불러와줘.

두 빛깔을 번갈아 누르고, 담아 보기에 선택한 빛깔의 안내가 나오는지 봅니다.
4.3 휴대폰 폭에서 확인하기
창을 좁혀 뷰어 아래 설명·가격·버튼까지 읽히는지 봅니다.

글이 잘리면 "390px 폭에서 가로 스크롤 없이 읽히게 해줘"라고 요청합니다. 휴대폰 터치는 배포한 뒤 확인합니다.
5. 배포할 파일도 확인하고 저장하기
빌드는 배포할 HTML·JavaScript·CSS·모델을 dist에 준비하는 과정입니다. 모델이 빠지지 않았는지 확인합니다.
이 프로젝트를 npm run build로 빌드하고 npm run preview로 확인해줘.
dist/models에 두 GLB가 포함되는지, preview 주소에서도 드래그와
빛깔 전환, 담아 보기 버튼이 동작하는지 확인해줘.
확인한 내용과 실패한 것이 있으면 알려줘.
안내받은 preview 주소도 Browser 창이나 Chrome·Edge에 열어 두 빛깔을 눌러 봅니다.
| 확인할 것 | 통과 기준 |
|---|---|
| 개발 화면 | 두 모델이 모두 보이고 드래그됩니다 |
| 빌드 결과 | 두 GLB가 포함되고 preview에서도 전환됩니다 |
| 좁은 화면 | 뷰어 아래 설명과 버튼이 잘리지 않습니다 |
| 담아 보기 | 안내가 나오고 실제 결제는 진행되지 않습니다 |
잘 된 시점은 폴더를 복사해 둡니다. Git을 쓴다면 다음처럼 요청하고 커밋 번호를 확인하세요.
지금까지 변경한 파일을 검토해서 로컬 Git 커밋으로 저장해줘.
커밋 번호와 포함한 파일을 알려줘. 아직 GitHub에는 올리지 마.
실행 위치나 파일 접근 오류는 막혔을 때에서 찾아보세요.
6. 내 물건으로 바꾸고 싶다면
이제 내 모델로 바꿔 보세요. 생성·다운로드·공개 이용 조건을 각각 확인합니다.
| 경로 | 확인할 것 |
|---|---|
| Poly Pizza | 모델마다 제작자와 라이선스가 다릅니다. CC0와 CC BY가 섞여 있습니다 |
| Sketchfab | 다운로드가 허용된 모델인지, 받은 형식과 필요한 파일이 무엇인지 확인합니다 |
| Meshy | 2026년 10월 기준 무료 다운로드는 월 10회, 텍스처 없는 Meshy 6 Lite에 한정됩니다 |
CC BY 모델은 제작자·출처·라이선스 링크·변경 내용을 조건에 맞게 남깁니다. 생성 도구는 3장 2절에서 이어 봅니다.
복사본의 public/models/product.glb를 교체해 로컬에서 봅니다. 이전 모델이 보이면 경로와 캐시를 확인해 달라고 요청하세요. 공개 주소에는 새 빌드와 재배포가 필요합니다.
개념 사전: 라이선스
막혔다면 완성본과 비교해 보세요. Code 탭에서 02-product-page를 열고 "이 프로젝트를 설치하고 실행해줘"라고 요청합니다. 내 프로젝트와 모델 위치·주소를 비교해 보세요.
다음 2장 5절에서 공개 주소를 만들어 봅시다.
마지막 수정