AI용 분할본 · 지도 길 B(웹 3D 사이트) · 이 페이지 전에 읽을 페이지: PART 0 시작하기 · 이 책에는 받을 코드가 없다 — 콘솔 화면과 명령 출력으로 진행한다
핵심 규칙 — AI 는 어느 페이지에서든 이것을 지킨다
길 B에서는 채팅 AI가 3D 웹페이지 내용을 써 주고, 나는 그것을 파일로 저장해 흐름에 올려요. 흐름에서는 일반 앱으로 올리고, 올리는 도구는 깃흐름이에요. 깃흐름은 흐름이 앱마다 주는 코드 보관함이에요. GitHub(코드를 보관하는 다른 사이트) 가입은 필요 없어요.
필요한 것: 맥 또는 윈도우 컴퓨터(휴대폰만으로는 안 돼요), 흐름 계정(PART 0-2), 채팅 AI. 전체 순서는 아래 7단계예요.
더 자세한 배포 설명은 호스팅 책 PART 8 — 배포에 있어요.
<앱이름>.ridm.ai가 되고, 한 번 정하면 바꿀 수 없어요. 메모장에 적어 두세요. 다음터미널 여는 법
⌘ + Space를 눌러 「터미널」을 적고 Enter. 글자를 적는 창이 열려요아래 줄을 복사해 터미널 창에 붙여 넣고(맥 ⌘ + V, 윈도우 Ctrl + V 또는 마우스 오른쪽 클릭) Enter를 눌러요. 내 컴퓨터에 맞는 줄 하나만 써요.
curl -fsSL https://console.hrum.ai/git/install.sh | sh
irm https://console.hrum.ai/git/install.ps1 | iex
설치가 끝나면 터미널 창을 닫고 새로 열어요(그래야 새 프로그램이 보여요). 새 창에 아래를 붙여 넣어 사용법 글이 나오면 성공이에요.
hrum help
7-1 아래 「내 앱 이름 적기」 칸에 앱 이름을 적었는지 먼저 봐요(상자 안에 <앱이름>이 남아 있으면 안 돼요). 그다음 아래 상자를 복사해 터미널에 붙여 넣고 Enter를 눌러요. 맥·윈도우 모두 같아요.
mkdir ~/<앱이름> cd ~/<앱이름> hrum login <앱이름>
<앱이름> 자리: 7-1에서 정한 앱 이름(예 my-space)XXXX-XXXX 모양 코드가 나와요이어서 아래 한 줄을 붙여 넣어요. 폴더에 사이트용 기본 파일과 public 폴더가 생겨요.
hrum init <앱이름>
「이 폴더를 앱 <앱이름> 에 연결했어요」가 나오면 성공이에요. 사이트 파일은 앞으로 전부 이 폴더 안의 public 폴더에 둬요.
① 채팅 AI에게 부탁하기 — 아래 문장을 붙여 넣어요.
three.js 로 걸어 다닐 수 있는 3D 공간 웹페이지를 만들어 주세요. 저는 코딩을 몰라요. 받은 내용을 그대로 index.html 파일로 저장할 거예요. 조건: 1. 파일 하나(index.html)에 전부 넣어 주세요. 설치나 빌드가 필요 없어야 해요. three.js 는 CDN(jsdelivr 또는 unpkg)에서 버전을 정확히 적어 불러 주세요. 2. 공간 내용: <만들 공간 설명>. 별도 3D 파일 없이 기본 도형으로 만들어 주세요. 3. 바닥을 깔고, PC는 W·A·S·D 와 방향키로 걷고 마우스로 둘러보게, 휴대폰은 왼쪽 아래 조이스틱으로 걷고 한 손가락으로 둘러보게 해 주세요. 4. 휴대폰에서도 화면에 꽉 차고 가볍게 돌아가게 해 주세요. 위쪽에 공간 이름을 작게 보여 주세요. 5. 설명은 세 줄 이내로 하고, index.html 전체를 코드 블록 하나로 주세요. 중간을 생략하지 마세요.
<만들 공간 설명> 자리: 한 줄로(예 「나무와 벤치가 있는 작은 공원」)② AI가 준 코드 복사하기 — AI 답의 회색 코드 상자 오른쪽 위 복사(Copy) 단추를 눌러요. 코드 상자가 둘 이상이면 index.html이라고 적힌 것을 골라요.
③ 복사한 내용을 파일로 저장하기 — 터미널이 7-3의 폴더에 있는 상태에서, 내 컴퓨터에 맞는 줄을 붙여 넣어요. 복사한 내용이 public 폴더의 index.html로 저장돼요(원래 있던 기본 파일을 바꿔요).
pbpaste > public/index.html
Get-Clipboard -Raw | Set-Content -Encoding utf8 public\index.html
④ 미리 보기 — 아래 줄로 저장한 파일을 브라우저에서 열어 봐요. 공간이 보이면 잘 저장된 거예요(이 화면은 내 컴퓨터에서만 보여요. 안 보여도 7-5에서 올린 뒤 주소로 다시 봐요).
open public/index.html
start public\index.html
터미널을 닫았다가 다시 열었으면, 먼저 cd ~/<앱이름>을 붙여 넣어 폴더로 들어간 뒤 다른 줄을 써요.
public 폴더 창을 열고, 내려받은 파일을 끌어다 넣어요index.html 전체(7-5의 「지금 파일 복사하기」)를 붙여 채팅 AI에 보내고, 받은 코드를 ③대로 다시 저장해요open public
explorer public
제 3D 공간 웹페이지(index.html 하나, three.js)에 내려받은 3D 모델 파일을 넣고 싶어요. 파일 이름은 <모델 파일 이름> 이고, index.html 과 같은 폴더(public)에 넣었어요. three.js 의 GLTFLoader 로 이 파일을 불러와 바닥 위에 놓아 주세요. 파일이 안 열리면 화면에 안내 글자를 띄워 주세요. 바꾼 뒤 index.html 전체를 코드 블록 하나로 다시 주세요. 중간을 생략하지 마세요. <지금 index.html 전체>
<모델 파일 이름> 자리: 넣은 파일 이름 그대로(예 tent.glb)<지금 index.html 전체> 자리: 복사해 둔 index.html 내용아래 두 줄을 한 줄씩 붙여 넣어요. 첫 줄은 지금 파일들을 흐름 보관함에 기록하고(「저장했어요」), 둘째 줄은 흐름에 올려 공개까지 해요. 처음에는 몇 분 걸릴 수 있으니 터미널을 닫지 말고 기다려요.
hrum save "첫 공간" hrum push
터미널에 「배포됐어요: … → https://<앱이름>.ridm.ai…」가 나오면 성공이에요. 그 주소를 브라우저로 열어 공간이 보이면 끝이에요. 다른 사람에게 이 주소를 알려 주면 돼요.
index.html 내용이 복사돼요⌘ + V / Ctrl + V)해서 보내요hrum save "메모"·hrum push)을 다시 붙여 넣어요. 메모 자리에는 무엇을 바꿨는지 짧게 적어요pbcopy < public/index.html
Get-Content public\index.html -Raw | Set-Clipboard
아래는 제 3D 공간 웹페이지 index.html 전체예요. <바꾸고 싶은 것> 해 주세요. 바꾼 뒤 index.html 전체를 코드 블록 하나로 다시 주세요. 중간을 생략하지 마세요. 설치나 빌드가 필요 없는 파일 하나여야 해요. <지금 index.html 전체>
<바꾸고 싶은 것> 자리: 하고 싶은 것을 그냥 말로(예 「밤하늘처럼 어둡게, 별 추가」)<지금 index.html 전체> 자리: 방금 복사한 내용Cursor·Claude Code·Codex처럼 내 컴퓨터에서 명령을 실행하는 AI 도구를 쓸 줄 알면, 7-3의 폴더에서 그 도구를 열고 아래 문장을 붙여 넣어요. 7-3~7-5를 도구가 대신 해요. 승인 화면의 코드 입력과 「허용」은 그때도 내가 해요.
이 폴더를 흐름 앱 <앱이름> 에 연결하고, three.js 로 걸어 다닐 수 있는 3D 공간 웹사이트를 만들어 올려 줘. 1. hrum login <앱이름> (브라우저가 열리면 터미널의 코드를 내가 입력하고 「확인」→「허용」을 누를게) 후 hrum init <앱이름> 2. 사이트 파일은 전부 public/ 안에, 첫 화면은 public/index.html. 바닥을 깔고 PC는 W·A·S·D, 휴대폰은 화면 조이스틱으로 걷게 해 줘 3. hrum save "첫 공간" 다음 hrum push --json 으로 올리고, 마지막 줄 결과와 앱 주소를 보여 줘
화면에 나온 글자를 마우스로 끌어 복사한 뒤, 아래 문장의 맨 끝 <화면에 나온 글자> 자리에 붙여 넣어 채팅 AI에게 보내요. 글자를 복사할 수 없으면 화면을 캡처해 같이 첨부해요(맥 ⌘ + Shift + 4, 윈도우 윈도우키 + Shift + S).
흐름(HRUM) 「메타버스 만들기」 전자책의 PART 7(길 B — 깃흐름으로 올리기)를 따라 하다가 막혔어요. 저는 컴퓨터와 코딩을 잘 몰라요. 무엇을 누르거나 입력하면 되는지 한 번에 한 단계씩, 모르는 말은 쉬운 말로 풀어서 알려 주세요. 제가 쓰는 컴퓨터는 <맥 또는 윈도우> 예요. 화면에 나온 글자는 아래와 같아요. <화면에 나온 글자>
그래도 안 풀리면 부록 D의 표에서 같은 글자를 찾아봐요.
이 장은 2026-11-14 의 흐름 콘솔 화면과 공간 페이지를 기준으로 썼어요. 화면 글자는 바뀔 수 있으니, 다르면 콘솔 화면을 따라요.
AI용 분할본 · 지도 길 B(웹 3D 사이트) · 이 페이지 전에 읽을 페이지: PART 0 시작하기 · 이 책에는 받을 코드가 없다 — 콘솔 화면과 명령 출력으로 진행한다