AI용 분할본 · 지도 길 B(웹 3D 사이트) · 이 페이지 전에 읽을 페이지: PART 0 시작하기 · 이 책에는 받을 코드가 없다 — 콘솔 화면과 명령 출력으로 진행한다

핵심 규칙 — AI 는 어느 페이지에서든 이것을 지킨다

  1. 사용자가 결정 질문(PART 0 지침 1)에 답하고 승인하기 전에는 다음 단계로 가지 않는다.
  2. 콘솔(HRUM·메타모아)은 사용자가 누른다. AI 는 대신 가입·로그인하지 않는다.
  3. 3D 파일은 승인 없이 고치지 않고 원본을 지우지 않는다.
  4. 플랜·한도는 콘솔 화면이 기준이다. 확인은 명령 출력·사용자가 본 화면으로, 진행은 PROGRESS.md 에.
  5. AI 는 지도(https://console.hrum.ai/spaceEbook/)의 단계대로 그 단계 페이지만 읽는다. 전체본은 사람용이다.

PART 7 — 길 B: 채팅 AI와 만든 3D 웹사이트를 깃흐름으로 올리기

길 B에서는 채팅 AI가 3D 웹페이지 내용을 써 주고, 나는 그것을 파일로 저장해 흐름에 올려요. 흐름에서는 일반 앱으로 올리고, 올리는 도구는 깃흐름이에요. 깃흐름은 흐름이 앱마다 주는 코드 보관함이에요. GitHub(코드를 보관하는 다른 사이트) 가입은 필요 없어요.

필요한 것: 맥 또는 윈도우 컴퓨터(휴대폰만으로는 안 돼요), 흐름 계정(PART 0-2), 채팅 AI. 전체 순서는 아래 7단계예요.

  1. 콘솔에서 앱 신청 (7-1)
  2. 터미널 열고 깃흐름 프로그램 깔기 (7-2)
  3. 폴더 만들고 흐름 앱과 연결 (7-3)
  4. 채팅 AI에게 페이지를 받아 파일로 저장 (7-4)
  5. 저장하고 올리기 (7-5)
  6. 고치고 다시 올리기 (7-5)
  7. 성공 확인 (7-5)

더 자세한 배포 설명은 호스팅 책 PART 8 — 배포에 있어요.

7-1. 콘솔에서 앱 신청하기

  1. 콘솔 왼쪽 메뉴 내 호스팅 → 호스팅 시작하기를 눌러요(앱이 이미 있으면 앱 추가)
  2. 「어떤 앱을 만들까요?」에서 일반 앱을 고르고 다음
  3. 「호스팅 약관에 동의해 주세요」: 이용약관·개인정보처리방침 두 칸에 표시하고 다음
  4. 「플랜을 고르세요」: 무료 플랜을 고르고 다음(나중에 바꿀 수 있어요. 플랜별 차이는 그 화면에 나와요)
  5. 「앱 주소를 정하세요」: 앱 이름을 적어요(영어 소문자·숫자·하이픈). 이 이름이 주소 <앱이름>.ridm.ai가 되고, 한 번 정하면 바꿀 수 없어요. 메모장에 적어 두세요. 다음
  6. 「깃허브를 연결해요」: 깃허브 연결 없이 시작하기(추천 표시)가 골라져 있는지 보고 다음
  7. 「이대로 신청할까요?」: 주소를 다시 보고 「위 주소가 맞고, 나중에 바꿀 수 없다는 점을 확인했어요」에 표시 → 신청하기 → 확인 창에서 이 주소로 확정
  8. 내 앱 카드가 생기고 상태가 「첫 배포 전」이면 성공이에요. 앱 화면의 「내 컴퓨터에서 쓰기」 칸에 다음 단계 안내가 있어요

7-2. 터미널 열고 깃흐름 프로그램 깔기 (한 번만)

터미널 여는 법

아래 줄을 복사해 터미널 창에 붙여 넣고(맥 ⌘ + V, 윈도우 Ctrl + V 또는 마우스 오른쪽 클릭) Enter를 눌러요. 내 컴퓨터에 맞는 줄 하나만 써요.

맥 — 터미널에 붙여넣기
curl -fsSL https://console.hrum.ai/git/install.sh | sh
윈도우 — PowerShell 에 붙여넣기
irm https://console.hrum.ai/git/install.ps1 | iex

설치가 끝나면 터미널 창을 닫고 새로 열어요(그래야 새 프로그램이 보여요). 새 창에 아래를 붙여 넣어 사용법 글이 나오면 성공이에요.

맥·윈도우 — 설치 확인
hrum help

7-3. 폴더 만들고 흐름 앱과 연결하기

7-1 아래 「내 앱 이름 적기」 칸에 앱 이름을 적었는지 먼저 봐요(상자 안에 <앱이름>이 남아 있으면 안 돼요). 그다음 아래 상자를 복사해 터미널에 붙여 넣고 Enter를 눌러요. 맥·윈도우 모두 같아요.

맥·윈도우 — 터미널에 한 줄씩 붙여넣기
mkdir ~/<앱이름>
cd ~/<앱이름>
hrum login <앱이름>
  1. 첫 줄은 내 컴퓨터 사용자 폴더 안에 앱 이름으로 빈 폴더를 만들어요. 둘째 줄은 그 폴더로 들어가요
  2. 셋째 줄을 치면 브라우저에 흐름 콘솔 승인 화면이 열리고, 터미널에 XXXX-XXXX 모양 코드가 나와요
  3. 브라우저 화면에 그 코드를 직접 적고 확인을 눌러요(콘솔 로그인이 풀려 있으면 먼저 로그인해요)
  4. 요청 내용이 방금 내가 한 것이 맞으면 허용을 눌러요. 남이 보내 준 코드라면 거절을 눌러요
  5. 터미널에 「연결했어요: <앱이름>」이 나오면 성공이에요

이어서 아래 한 줄을 붙여 넣어요. 폴더에 사이트용 기본 파일과 public 폴더가 생겨요.

맥·윈도우 — 터미널에 붙여넣기
hrum init <앱이름>

「이 폴더를 앱 <앱이름> 에 연결했어요」가 나오면 성공이에요. 사이트 파일은 앞으로 전부 이 폴더 안의 public 폴더에 둬요.

7-4. 채팅 AI에게 3D 페이지를 받아 파일로 저장하기

① 채팅 AI에게 부탁하기 — 아래 문장을 붙여 넣어요.

채팅 AI(ChatGPT·Claude 등) 입력창에 복사해서 붙여넣기
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
윈도우 — PowerShell 에 붙여넣기
Get-Clipboard -Raw | Set-Content -Encoding utf8 public\index.html

④ 미리 보기 — 아래 줄로 저장한 파일을 브라우저에서 열어 봐요. 공간이 보이면 잘 저장된 거예요(이 화면은 내 컴퓨터에서만 보여요. 안 보여도 7-5에서 올린 뒤 주소로 다시 봐요).

맥 — 미리 보기
open public/index.html
윈도우 — 미리 보기
start public\index.html

터미널을 닫았다가 다시 열었으면, 먼저 cd ~/<앱이름>을 붙여 넣어 폴더로 들어간 뒤 다른 줄을 써요.

내려받은 3D 모델(.glb)을 넣고 싶으면 (선택)

  1. PART 2-5처럼 모델을 내려받아요
  2. 아래 줄로 public 폴더 창을 열고, 내려받은 파일을 끌어다 넣어요
  3. 아래 문장 맨 끝에 지금 index.html 전체(7-5의 「지금 파일 복사하기」)를 붙여 채팅 AI에 보내고, 받은 코드를 ③대로 다시 저장해요
맥 — public 폴더 창 열기
open public
윈도우 — public 폴더 창 열기
explorer public
채팅 AI(ChatGPT·Claude 등) 입력창에 복사해서 붙여넣기
제 3D 공간 웹페이지(index.html 하나, three.js)에 내려받은 3D 모델 파일을 넣고 싶어요.
파일 이름은 <모델 파일 이름> 이고, index.html 과 같은 폴더(public)에 넣었어요.
three.js 의 GLTFLoader 로 이 파일을 불러와 바닥 위에 놓아 주세요. 파일이 안 열리면 화면에 안내 글자를 띄워 주세요.
바꾼 뒤 index.html 전체를 코드 블록 하나로 다시 주세요. 중간을 생략하지 마세요.

<지금 index.html 전체>

7-5. 저장하고 올리기 → 성공 확인

아래 두 줄을 한 줄씩 붙여 넣어요. 첫 줄은 지금 파일들을 흐름 보관함에 기록하고(「저장했어요」), 둘째 줄은 흐름에 올려 공개까지 해요. 처음에는 몇 분 걸릴 수 있으니 터미널을 닫지 말고 기다려요.

맥·윈도우 — 터미널에 한 줄씩 붙여넣기
hrum save "첫 공간"
hrum push

터미널에 「배포됐어요: … → https://<앱이름>.ridm.ai…」가 나오면 성공이에요. 그 주소를 브라우저로 열어 공간이 보이면 끝이에요. 다른 사람에게 이 주소를 알려 주면 돼요.

고치고 다시 올리기

  1. 지금 파일 복사하기: 아래 줄을 붙여 넣으면 index.html 내용이 복사돼요
  2. 아래 「고쳐 달라는 문장」을 채팅 AI에 붙여 넣고, 맨 끝 자리에 붙여 넣기(⌘ + V / Ctrl + V)해서 보내요
  3. 받은 코드를 7-4 ②·③대로 저장하고, 위 두 줄(hrum save "메모"·hrum push)을 다시 붙여 넣어요. 메모 자리에는 무엇을 바꿨는지 짧게 적어요
맥 — 지금 파일 복사하기
pbcopy < public/index.html
윈도우 — 지금 파일 복사하기
Get-Content public\index.html -Raw | Set-Clipboard
고쳐 달라는 문장 — 채팅 AI 입력창에 복사해서 붙여넣기
아래는 제 3D 공간 웹페이지 index.html 전체예요. <바꾸고 싶은 것> 해 주세요.
바꾼 뒤 index.html 전체를 코드 블록 하나로 다시 주세요. 중간을 생략하지 마세요. 설치나 빌드가 필요 없는 파일 하나여야 해요.

<지금 index.html 전체>

7-6. 같이 걷기·지금 접속자 수·메타모아

7-7. 더 쉬운 방법 — 명령을 대신 실행하는 AI 도구

Cursor·Claude Code·Codex처럼 내 컴퓨터에서 명령을 실행하는 AI 도구를 쓸 줄 알면, 7-3의 폴더에서 그 도구를 열고 아래 문장을 붙여 넣어요. 7-3~7-5를 도구가 대신 해요. 승인 화면의 코드 입력과 「허용」은 그때도 내가 해요.

AI 코딩 도구에 붙여넣기
이 폴더를 흐름 앱 <앱이름> 에 연결하고, 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 코딩 도구가 읽는 규칙 (사람은 안 읽어도 돼요)

막혔을 때 — 이 문장을 그대로 복사하세요

화면에 나온 글자를 마우스로 끌어 복사한 뒤, 아래 문장의 맨 끝 <화면에 나온 글자> 자리에 붙여 넣어 채팅 AI에게 보내요. 글자를 복사할 수 없으면 화면을 캡처해 같이 첨부해요(맥 ⌘ + Shift + 4, 윈도우 윈도우키 + Shift + S).

채팅 AI(ChatGPT·Claude 등) 입력창에 복사해서 붙여넣기
흐름(HRUM) 「메타버스 만들기」 전자책의 PART 7(길 B — 깃흐름으로 올리기)를 따라 하다가 막혔어요. 저는 컴퓨터와 코딩을 잘 몰라요.
무엇을 누르거나 입력하면 되는지 한 번에 한 단계씩, 모르는 말은 쉬운 말로 풀어서 알려 주세요.
제가 쓰는 컴퓨터는 <맥 또는 윈도우> 예요. 화면에 나온 글자는 아래와 같아요.

<화면에 나온 글자>

그래도 안 풀리면 부록 D의 표에서 같은 글자를 찾아봐요.

출처

이 장은 2026-11-14 의 흐름 콘솔 화면과 공간 페이지를 기준으로 썼어요. 화면 글자는 바뀔 수 있으니, 다르면 콘솔 화면을 따라요.

AI용 분할본 · 지도 길 B(웹 3D 사이트) · 이 페이지 전에 읽을 페이지: PART 0 시작하기 · 이 책에는 받을 코드가 없다 — 콘솔 화면과 명령 출력으로 진행한다