HRUM APP HOSTING · METAVERSE · VIBE CODING SERIES

흐름으로 메타버스 만들기
— 앱 호스팅 안의 메타버스

흐름 앱 호스팅 안에는 메타버스가 들어 있어요. 3D 파일 하나를 올리고 「공개하기」만 누르면 내 주소에 같이 걷고 채팅하는 공간이 열려요. AI로 직접 만든 3D 웹사이트는 깃흐름으로 올리면 돼요. 코딩을 몰라도 PART 0부터 차례로 따라 하면 돼요.
채팅 AI와 같이 하면 더 쉬워요: 장마다 ChatGPT·Claude 같은 채팅 AI에 그대로 붙여 넣는 문장이 있어요. 용어를 몰라도 복사만 하면 돼요. 버튼 누르기와 파일 저장은 내가 하고, AI는 다음 할 일과 막힌 곳을 알려 줘요. 아래 문장은 링크를 열 수 있는 AI 도구용이에요.
링크를 열 수 있는 AI 도구에 붙여넣을 시작 문장
https://console.hrum.ai/spaceEbook/ 을 열고, 그 지도의 단계 순서대로 해당 페이지만 읽으며 [AI 시작 지침]대로 나와 함께 흐름으로 내 메타버스를 만들어줘. 콘솔 버튼은 내가 누를게.
AI용 지도: https://console.hrum.ai/spaceEbook/ — 링크를 못 여는 채팅 AI라면 이 문장 대신 PART 0-3의 「처음 한 번」 문장부터 붙여 넣어요.
HRUM 콘솔 가입하고 시작하기

PART 0 — 시작하기: 어느 쪽으로 만들까요?

흐름 앱 호스팅은 내가 만든 것을 내이름.ridm.ai 같은 내 주소로 세상에 여는 곳이에요. 서버(인터넷에 늘 켜져 있는 컴퓨터)를 빌리거나 설정할 필요가 없어요.

이 앱 호스팅 안에 메타버스가 하나 더 들어 있어요. 콘솔 왼쪽 메뉴 내 호스팅에서 호스팅 시작하기를 누르면 첫 단계 「어떤 앱을 만들까요?」에서 일반 앱과 메타버스 중 하나를 골라요. 이 책은 메타버스, 그러니까 사람들이 인터넷에서 같이 걸어 다니고 채팅하는 3D 공간을 여는 방법을 처음부터 알려 줘요.

0-1. 두 가지 길 — 내 상황에 맞는 쪽을 고르세요

길 A — 3D 파일 하나로

길 B — 채팅 AI와 같이 만든 3D 웹사이트

잘 모르겠으면 길 A부터 해 보세요. 3D 파일이 없어도 PART 2-5의 무료 모델로 시작할 수 있어요.

말 풀이: 3D 파일은 건물·방·숲 같은 입체 모양을 담은 파일이에요. 이 책에서 쓰는 3D 파일은 이름 끝이 .glb인 파일이에요. 터미널은 컴퓨터에 글자로 명령을 내리는 창이에요(길 B에서만 써요, PART 7-2).

0-2. 두 길 모두 처음 한 번 — 흐름 가입

  1. 흐름 콘솔을 열고 회원가입 탭을 눌러요
  2. 이메일, 이름(표시 이름 또는 회사 이름), 비밀번호를 적고 필수 동의 두 칸(이용약관·개인정보처리방침)에 표시한 뒤 회원가입을 눌러요
  3. 「가입했어요. 메일함에서 인증해 주세요」가 보이면 메일함을 열어요. 흐름에서 온 메일이 없으면 스팸함도 봐요
  4. 메일의 버튼을 누르고 비밀번호를 정해요. 이것으로 이메일 인증이 끝나요
  5. 콘솔로 돌아와 로그인 탭에서 이메일과 방금 정한 비밀번호로 로그인해요
  6. 왼쪽 메뉴에 내 호스팅이 보이면 준비 끝이에요

같은 흐름 계정 하나로 일반 앱과 메타버스를 다 써요. 가입을 더 자세히 보고 싶으면 호스팅 책 PART 1을 봐요.

0-3. 채팅 AI와 같이 하기

이 책은 ChatGPT·Claude 같은 웹 채팅 AI와 같이 하는 것을 기준으로 썼어요. 채팅 AI는 내 컴퓨터를 직접 만지지 못해요. 그래서 AI가 알려 주면 버튼 누르기·파일 저장·명령 붙여 넣기는 내가 해요.

더 쉬운 방법: Cursor·Claude Code·Codex처럼 내 컴퓨터에서 명령을 대신 실행하는 AI 도구를 쓸 줄 알면, 표지의 시작 문장을 그 도구에 붙여 넣어요. 그 도구가 확인과 명령을 대신 해요. 몰라도 괜찮아요.

이 책으로 하지 않는 것: 내가 산 도메인 연결(메타버스 공간에는 아직 열려 있지 않아요).

처음 한 번 — 채팅 AI 입력창에 복사해서 붙여넣기
지금부터 흐름(HRUM) 「메타버스 만들기」 전자책을 따라 내 3D 공간을 인터넷에 열 거예요. 저는 컴퓨터, 코딩, 3D를 하나도 몰라요.
1. 제가 붙여 넣는 문장과 화면 글자를 보고, 한 번에 한 단계씩만 알려 주세요.
2. 버튼 이름과 화면 글자는 제가 알려 준 그대로 써 주세요. 모르는 말은 짧게 풀어 주세요.
3. 버튼은 제가 직접 눌러요. 제 비밀번호, 계좌번호, 인증번호는 묻지 마세요.
4. 요금이나 한도 숫자는 짐작하지 말고 콘솔 화면을 보라고 해 주세요.
제가 고른 길은 <길 A 또는 길 B> 이고, 쓰는 컴퓨터는 <맥 또는 윈도우> 예요. 다음 할 일을 알려 주세요.
AI 코딩 도구가 읽는 규칙 (사람은 안 읽어도 돼요)
  1. 먼저 묻는다, 한 번에. 길 A인지 B인지, 그리고 아래를 추천값과 함께 한 번에 묻고 사용자가 승인하기 전에는 다음 단계로 가지 않는다. 길 A: ① 공간 이름(예 별밤 갤러리) ② 주소 이름(<주소 이름>.ridm.ai, 소문자 영문·숫자·하이픈, 하이픈으로 시작·끝 금지 — 예 my-gallery) ③ 3D 파일이 있는가(없으면 PART 2-5). 길 B: ① 앱 주소 이름 ② 만들 공간의 한 줄 설명 ③ 3D 모델을 어디서 가져올지.
  2. 콘솔은 사용자가 누른다. 가입·로그인·약관 동의·본인 확인·콘솔 버튼은 사람만 한다. AI 는 누를 순서를 안내하고, 사용자가 화면에 보이는 것을 말해 주면 다음으로 간다. 짐작하지 않는다.
  3. 확인은 결과로 한다. 「됐다」고 말하기 전에 증거(명령 출력 또는 사용자가 본 화면)를 보인다. 진행 상황은 작업 폴더의 PROGRESS.md 에 적고, 이어서 할 때는 그 다음 단계부터 간다.
  4. 파일은 사용자 것이다. 3D 파일을 고치거나 변환하기 전에 무엇을 바꾸는지 말하고 승인을 받는다. 원본은 지우지 않는다. 남이 만든 모델은 올릴 권한이 있는지 묻는다.
  5. 이 책에 없는 기능은 약속하지 않는다. 내 도메인 연결은 범위 밖이다.
  6. 돈·한도 숫자는 콘솔 화면이 기준이다. 플랜·전송량·저장 용량·파일 크기는 기억으로 말하지 않고 화면을 보고 말해 달라고 한다.
  7. 사람용 본문은 웹 채팅 AI 기준이다. 사용자는 용어를 모른다. 사용자가 할 일은 버튼 이름·복사할 줄 단위로 말하고, 명령을 대신 실행할 수 있으면 실행 전에 무엇을 하는지 한 줄로 말한다.

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

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

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

<화면에 나온 글자>

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

출처

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

PART 1 — 메타버스는 어떻게 돌아가나요

1-1. 한 장으로 보기

흐름 앱 호스팅 안의 메타버스
흐름 콘솔 「내 호스팅」 → 「호스팅 시작하기」 → 「어떤 앱을 만들까요?」
   ├ 일반 앱 ── 내가 만든 웹사이트를 깃흐름으로 올림 (길 B, PART 7)
   └ 메타버스 ── 3D 파일(.glb) 하나로 여는 공간 (길 A, PART 2~6)

길 A 로 연 공간
   https://<주소 이름>.ridm.ai/
   ├ 앱 설치 없이 브라우저에서 바로 열려요 (PC·휴대폰)
   ├ 들어온 사람끼리 서로 보이고 같이 걸어요
   ├ 채팅 · 숨기기 · 신고
   ├ (원하면) 오른쪽 위 결제 버튼
   └ 메타모아에 저절로 등록 요청 → 확인 뒤 목록에

길 A는 흐름이 공간을 열어 주고, 같이 걷기·채팅도 흐름이 맡아요. 그래서 내가 할 일은 파일을 올리고 「공개하기」를 누르는 것뿐이에요. 같은 공간은 https://spaces.ridm.ai/s/<주소 이름>/ 에서도 열리지만, 사람들에게 알릴 때는 <주소 이름>.ridm.ai 를 써요.

1-2. 손님이 보는 화면

1-3. 메타모아

메타모아는 웹 메타버스를 모아 보여 주는 사이트예요. 흐름과 같은 회사(플로트 주식회사)가 운영해요. 길 A로 공간을 공개하면 메타모아에 저절로 등록 요청이 가요(PART 6). 길 B로 만든 사이트는 메타모아 「등록 요청」으로 직접 보내요.

1-4. 직접 만들기 어렵다면

3D 파일 준비가 어렵거나 브랜드·행사에 맞춘 공간이 필요하면 흐름 제작 지원에 문의할 수 있어요.

출처

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

PART 2 — 길 A: 3D 파일 준비하기

길 A에서 준비할 것은 3D 파일 하나뿐이에요. 가입(PART 0-2)은 먼저 해 두세요. 파일이 이미 있으면 2-2만 보고, 없으면 2-5로 가요.

2-1. 내 컴퓨터에서 파일 이름 끝 보이게 하기

파일 이름 끝의 .glb 같은 글자(확장자)가 안 보이면 어떤 파일인지 헷갈려요. 한 번만 켜 두세요.

2-2. 어떤 파일을 올리나요

파일이 조건에 맞는지 미리 몰라도 괜찮아요. 콘솔에 올리면 흐름이 검사하고, 안 맞으면 「이 파일은 올릴 수 없어요」와 이유를 보여 줘요. 그때 부록 D-2를 보면 돼요.

2-3. 너무 크거나 무겁다고 나올 때

3D 프로그램(무료 프로그램 Blender 등)에서 고쳐야 해요. 아래 문장을 채팅 AI에게 보내면 고치는 순서를 알려 줘요.

채팅 AI(ChatGPT·Claude 등) 입력창에 복사해서 붙여넣기
제 3D 파일(.glb)이 흐름(HRUM) 메타버스 콘솔에서 「<화면에 나온 글자>」라고 나오며 올라가지 않아요. 저는 3D 프로그램을 처음 써요.
무료 프로그램 Blender로 이 파일을 가볍게 고치는 법을 한 번에 한 단계씩 알려 주세요. 메뉴 이름은 Blender 화면 글자 그대로 써 주세요.
조건: 보이지 않는 면과 물체 지우기, 그림(텍스처) 크기 줄이기, 바닥은 남기기. 마지막에 「glTF 2.0 (.glb)」로 내보낼 때 그림을 파일 안에 넣고(Embedded), Draco 압축은 끄는 설정을 알려 주세요.
원본 파일은 그대로 두고 다른 이름으로 저장하게 해 주세요.

2-4. 파일이 맞는지 직접 보기

파일 이름 끝이 .glb인지 봐요(2-1을 켰으면 보여요). 그다음은 콘솔에 올려 보는 것이 가장 정확해요(PART 3-2).

AI 코딩 도구가 읽는 규칙 (사람은 안 읽어도 돼요)

파일을 만질 수 있는 AI 코딩 도구는 파일이 있는 폴더에서 아래를 실행해 출력을 보인다. 첫 줄은 파일과 크기, 둘째 줄이 glTF 면 .glb 형식이다. 아니면 .glb 로 다시 내보내게 안내하고, 크기가 콘솔에 적힌 크기를 넘으면 2-3 대로 줄인다. 고친 파일은 원본과 다른 이름으로 저장한다(PART 0 지침 4).

명령 (파일이 있는 폴더)
ls -l 내공간.glb
head -c 4 내공간.glb; echo

2-5. 3D 파일이 없을 때 — 무료 모델 사이트 Polyfork

Polyfork는 단순한 모양(로우폴리)의 3D 모델을 모아 둔 사이트예요. 2026-11-08 공식 안내 기준으로 로우폴리 모델은 전부 무료이고, 파일을 .glb로 받을 수 있어요. Polyfork 파일은 그림 없이 색으로 칠해져 있고, 2026-11-08에 받아 본 무료 모델은 특수 압축이 없었어요. 그래서 2-2의 조건과 잘 맞아요.

  1. polyfork.dev를 열고 검색 칸에 영어로 찾을 것을 적어요(예 tent, tree, room)
  2. 마음에 드는 모델을 눌러 GLB로 내려받아요. 내려받은 파일은 보통 「다운로드」 폴더에 있어요
  3. 모델 하나에 바닥이 있으면 그 파일을 그대로 PART 3에서 올려요
  4. 텐트·나무·바위처럼 여러 개를 한 공간에 모으려면 Blender로 합쳐 파일 하나로 만들어야 해요. 아래 문장을 채팅 AI에게 보내면 순서를 알려 줘요
채팅 AI(ChatGPT·Claude 등) 입력창에 복사해서 붙여넣기
무료 3D 프로그램 Blender를 처음 써요. 내려받은 .glb 파일 <파일 개수>개를 한 장면에 모으고, 바닥 판을 하나 깔고, 파일 하나로 내보내고 싶어요.
한 번에 한 단계씩, 메뉴 이름은 Blender 화면 글자 그대로 알려 주세요.
1. Blender 설치하고 새 파일 열기  2. .glb 파일 불러오기(File → Import → glTF 2.0)  3. 바닥 판 넣고 크기 맞추기  4. 물체를 바닥 위로 옮기기
5. File → Export → glTF 2.0 에서 형식은 「glTF Binary (.glb)」, 그림은 파일 안에 넣고, Draco 압축은 끄기
6. 이름은 <파일 이름>.glb 로 저장하기

쓸 수 있는 조건(라이선스)

Polyfork 라이선스 페이지는 무료 모델에 두 가지 중 하나를 고르게 해요.

내 공간에 모델을 넣어 공개하는 것은 앞의 「안에 넣어 쓰는」 쪽이에요. 그래도 공개 전에 라이선스 페이지를 한 번 직접 읽어요. 조건은 바뀔 수 있고, 유료 HD 판과 .mjs 원본에는 Polyfork 라이선스만 적용돼요. 어떤 모델을 어디서 받았는지 메모장에 적어 두면 나중에 편해요.

AI 코딩 도구가 읽는 규칙 (사람은 안 읽어도 돼요)

Polyfork 는 MCP 서버(AI 도구가 직접 모델을 찾고 받는 연결)를 열어 두었다. 둘러보기와 무료 모델은 키 없이 된다. 아래는 공식 연결 안내의 키 없는 형태다. 설정 파일 위치는 도구마다 다르니 그 도구의 MCP 문서를 본다. 무료 키(헤더 Authorization: Bearer)를 쓰면 코드나 커밋에 적지 않는다. MCP 를 못 쓰면 https://polyfork.dev/prompt.txt 를 읽고 따르거나 npx polyfork search 단어 · npx polyfork add 모델id(Node 18 이상)로 받는다.

Claude Code
claude mcp add --transport http polyfork https://polyfork.dev/mcp
Codex
codex mcp add polyfork --url https://polyfork.dev/mcp
Cursor (MCP 설정 JSON)
{
  "mcpServers": {
    "polyfork": {
      "type": "http",
      "url": "https://polyfork.dev/mcp"
    }
  }
}

모델을 고를 때는 미리보기 그림·실제 크기·삼각형 수를 보여 주고 사용자가 고르게 한다. 가능하면 같은 키트(같은 색·격자)에서 고른다. 받은 GLB 는 작업 폴더의 models/ 에 두고 모델마다 이름·페이지 주소·라이선스를 PROGRESS.md 에 적는다. 바닥을 깔고 배치해 파일 하나(예 campsite.glb)로 합친다 — 그림은 파일 안에, Draco·meshopt 압축 없이, 원본은 지우지 않는다. 다 되면 2-4 확인 명령의 출력을 보인다. 콘솔에 올리는 것은 PART 3 대로 사람이 한다.

Polyfork 부분은 2026-11-08 의 공식 페이지를 기준으로 썼어요: polyfork.dev · polyfork.dev/licensing · polyfork.dev/agents · polyfork.dev/llms.txt. 바뀌었으면 공식 페이지를 따라요.

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

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

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

<화면에 나온 글자>

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

출처

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

PART 3 — 길 A: 공간 만들고 공개하기

3-1. 메타버스 화면 열기

  1. 콘솔 왼쪽 메뉴 내 호스팅을 눌러요
  2. 호스팅 시작하기를 눌러요(일반 앱이 이미 있으면 앱 추가)
  3. 「어떤 앱을 만들까요?」에서 메타버스를 고르고 다음을 눌러요
  4. 「메타버스 만들기」 화면이 열리면 성공이에요. 다음부터는 「내 호스팅」의 내 공간 목록에서 「관리하기」를 눌러 와요

메타버스는 무료 플랜으로 바로 시작돼요. 이 단계에서 약관·플랜을 따로 고르지 않아요. 플랜은 나중에 화면 아래 「플랜」 칸에서 바꿔요(PART 5-4).

3-2. 이름과 주소 → 파일 → 공개

내 공간 칸의 새 공간 만들기를 누르면 「이름과 주소」 → 「3D 파일 올리기」 → 「공개」 세 단계가 차례로 열려요.

  1. 공간 이름을 적어요. 손님에게 보이는 이름이에요(예 별밤 갤러리)
  2. 주소를 적어요. 영어 소문자·숫자·하이픈(-)만 돼요. 완성된 주소(https://<주소 이름>.ridm.ai/)가 같이 보여요. 주소는 사람들에게 알릴 이름이니 짧고 쉽게 정해요
  3. 만들기를 눌러요. 「이미 쓰이는 주소예요」가 나오면 다른 이름을 골라요
  4. 「3D 파일 올리기」에서 파일 고르기를 누르고 PART 2의 .glb 파일을 골라요
  5. 「올리는 중…」이 끝나면 「공개」 단계로 넘어가요. 「이 파일은 올릴 수 없어요」가 나오면 아래 이유를 부록 D-2 표에서 찾아 고쳐요

3-3. 공개하기 — 메타모아에 올릴지 먼저 정해요

공개하면 공간이 메타모아(PART 6)에 저절로 등록 요청돼요. 「메타모아에 올리기」 스위치는 공개 단계가 아니라 내 공간 목록의 그 공간 줄에 있어요.

「공개 대기 중이에요」 또는 「가입 확인이 끝나면 공개할 수 있어요」가 나오면, 흐름이 새 계정을 확인하는 중이에요. 공간을 만들고 파일을 올리는 건 지금도 돼요. 확인이 끝나면 공간 줄의 공개하기를 다시 눌러요.

3-4. 성공 표시

내 공간 목록 그 줄에 「공개 중」과 주소 링크가 보이면 성공이에요. 그 주소를 눌러 PART 4로 가요.

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

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

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

<화면에 나온 글자>

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

출처

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

PART 4 — 내 공간에 들어가 보기

4-1. 주소 열어 보기

공간 줄의 주소를 눌러요. 막대가 차오른 뒤 공간이 나타나면 성공이에요. 「공간을 불러오지 못했어요」가 나오면 부록 D-3을 봐요.

AI 코딩 도구가 읽는 규칙 (사람은 안 읽어도 돼요)

명령을 실행할 수 있는 AI 는 아래로 주소가 응답하는지 확인한다. 첫 줄에 200 이면 열린 것이다.

명령
curl -sI https://<주소 이름>.ridm.ai/ | head -n 1

4-2. 걷는 법

PC휴대폰
걷기W·A·S·D 또는 방향키 (Shift 누르고 있으면 달리기)왼쪽 아래 막대를 끌기
둘러보기마우스로 끌기한 손가락으로 끌기
가까이·멀리마우스 휠두 손가락으로 벌리고 오므리기
그 자리로 가기바닥을 클릭바닥을 톡

4-3. 같이 걷기·채팅 해 보기

  1. 휴대폰과 PC(또는 브라우저 두 개)로 같은 주소를 열어요
  2. 서로 다른 이름으로 들어가요
  3. 서로의 아바타와 이름이 보이고, 「함께 있어요」 인원이 2명이 되면 성공이에요
  4. 「채팅」으로 한 줄 보내 다른 쪽에 뜨는지 봐요

여기까지 되면 공간이 제대로 열린 거예요. 운영은 PART 5, 메타모아는 PART 6을 봐요.

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

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

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

<화면에 나온 글자>

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

출처

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

PART 5 — 길 A: 공간 운영하기

공간을 연 뒤에 쓰는 버튼과 화면이에요. 모두 「내 호스팅」 → 「메타버스」 화면에 있어요.

5-1. 공간 줄의 버튼

버튼하는 일
파일 바꾸기새 .glb 파일로 공간을 바꿔요. 주소는 그대로예요
비공개로 / 공개하기공간을 잠시 닫거나 다시 열어요. 닫힌 동안은 주소로 들어올 수 없고, 파일과 설정은 그대로 남아요
지우기공간을 지워요. 되돌릴 수 없어요. 다른 공간이 쓰지 않는 3D 파일도 같이 지워지니, 원본 파일은 내 컴퓨터에 꼭 남겨 둬요
결제 버튼 달기 / 바꾸기공개 중인 공간에만 보여요. 공간 오른쪽 위에 결제 버튼을 달아요(부록 E)
메타모아에 올리기켜 두면 공개한 공간이 메타모아에 올라가요. 옆에 지금 상태가 한 줄로 나와요(PART 6)

5-2. 이번 달 사용량

화면 위쪽 이번 달 사용량 칸에 이번 달 전송량(손님이 공간을 열 때 받아 가는 양), 공간 수, 같이 접속할 수 있는 인원, 저장한 파일 양이 나와요. 손님이 공간을 열 때마다 전송량이 쌓여요. 많이 쓰면 화면에 미리 알림이 떠요.

5-3. 「같이 접속이 닫혔어요」 알림

전송량을 다 쓰는 등으로 같이 접속이 닫혀도 공간은 그대로 열리고, 손님은 혼자 둘러볼 수 있어요. 화면 위 알림이 이유와 다시 여는 방법(전송량 추가, 크레딧 충전, 다음 달까지 기다리기 등)을 알려 줘요. 그 알림대로 하면 돼요.

5-4. 플랜

플랜은 메타버스 무료·메타버스 베이직·메타버스 프로가 있고, 처음에는 무료 플랜이에요. 공간 수, 같이 접속 인원, 전송량, 저장 용량은 플랜마다 달라요. 화면 아래 플랜 칸에서 플랜별로 볼 수 있어요.

  1. 바꿀 플랜의 버튼을 눌러요
  2. 확인 창이 지금 낼 금액과 적용 시점을 먼저 보여 줘요. 읽고 맞으면 확정해요
  3. 유료 플랜은 흐름 크레딧(콘솔에 미리 충전해 두는 돈)으로 내요. 충전은 콘솔 → 결제에서 해요

5-5. 공간을 지키는 습관

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

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

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

<화면에 나온 글자>

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

출처

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

PART 6 — 메타모아에 내 공간 올리기

길 A로 공개한 공간은 메타모아 목록에 올라가 더 많은 사람이 찾게 돼요. 공간 줄의 메타모아에 올리기가 처음부터 켜져 있어서, 공개하면 흐름이 메타모아에 등록 요청을 저절로 보내요. 신청서를 따로 쓸 필요가 없어요. 길 B 사이트는 6-3의 「등록 요청」으로 직접 보내요.

6-1. 흐름이 대신 하는 일 (나는 기다리기만 해요)

  1. 등록 요청: 공개하면 흐름이 공간 이름과 주소를 메타모아에 보내요
  2. 심사: 메타모아 운영자가 공간을 확인해요
  3. 주인 확인: 심사를 통과하면 흐름이 「이 공간 주인이 맞다」는 확인을 메타모아와 마저 해요
  4. 목록에 올라감: 공간 줄에 「메타모아에 올라가 있어요」가 떠요
  5. 지금 접속자 수: 그 뒤로 흐름이 몇 분마다 지금 들어와 있는 인원을 메타모아에 보내요. 공간 줄의 「지금 N명」과 메타모아 목록의 인원이 이 숫자예요

중간에 실패해도 흐름이 시간을 두고 다시 해요. 공개 자체는 메타모아를 기다리지 않아요. 내가 직접 할 일은 목록에 올라간 뒤 대표 이미지를 넣는 것(6-4) 하나예요.

AI 코딩 도구가 읽는 규칙 (사람은 안 읽어도 돼요)

6-2. 공간 줄에 보이는 상태

공간 줄의 글자뜻과 할 일
공개하면 메타모아에 자동으로 올라가요아직 비공개예요. 공개하면 보내요
메타모아에 보내는 중이에요보내고 있어요. 「잠시 뒤 다시 보내요」가 붙어도 흐름이 알아서 다시 보내요
메타모아 심사 중이에요메타모아 운영자가 확인하고 있어요. 기다려요
메타모아 심사를 통과했어요. 공간 주인 확인 중이에요흐름이 주인 확인을 마저 해요. 할 일은 없어요
메타모아에 올라가 있어요목록에 올라갔어요. 지금 들어와 있는 인원이 같이 보이고, 「메타모아에서 보기」로 메타모아의 내 공간 페이지를 열어요
메타모아에서 올리지 않기로 했어요심사에서 빠졌어요. 공간을 고친 뒤 스위치를 껐다가 다시 켜면 한 번 더 보내요
메타모아에 올리지 않아요스위치를 꺼 두었어요

6-3. 올리고 싶지 않을 때 · 목록에 올라간 뒤

6-4. 대표 이미지 넣기 (메타모아 목록·링크 미리보기 그림)

흐름 공간 페이지에는 대표 이미지가 들어 있지 않아요. 그래서 공간 주소를 카톡 등에 붙이면 그림 없는 카드가 떠요. 공간 페이지는 흐름이 만들어서 내가 고칠 수 없어요. 대신 메타모아 목록의 그림은 내가 직접 넣어요.

  1. 내 공간에 들어가 가장 보기 좋은 장면에서 화면을 캡처해요(맥 ⌘ + Shift + 4, 윈도우 윈도우키 + Shift + S). 브라우저 창을 가로로 넓게 두고 찍어요
  2. 채팅 AI에 캡처를 첨부하고 아래 문장을 보내요. 그림을 다룰 수 있는 채팅 AI(예 ChatGPT)는 잘라서 내려받을 파일로 줘요
  3. 받은 그림을 내려받아요
  4. 메타모아 「내 공간 관리」에 로그인해 그 그림을 올려요
채팅 AI(ChatGPT·Claude 등) 입력창에 복사해서 붙여넣기
첨부한 화면 캡처를 링크 미리보기용 대표 이미지로 만들어 주세요.
1. 가로 1200, 세로 630 PNG 로 잘라 주세요. 가운데 가장 보기 좋은 부분을 남겨 주세요.
2. 글자나 사람 얼굴이 가장자리에 걸리지 않게 해 주세요.
3. 내려받을 수 있는 파일로 주세요. 이름은 og-image.png 로 해 주세요.
그림 파일을 만들 수 없다면, 제가 직접 자르는 방법을 <맥 또는 윈도우> 기본 프로그램으로 한 단계씩 알려 주세요.

6-5. 내가 만든 사이트에 검색·미리보기 정보 넣기 (길 B)

길 B처럼 내가 만든 사이트는 검색 결과와 링크 미리보기에 나올 이름표(제목·설명·대표 이미지)를 직접 넣을 수 있어요. 이것을 SEO 기본이라고 해요. 없으면 링크를 붙여도 그림 없는 빈 카드가 떠요. 사이트를 공개하기 전에 넣는 게 가장 쉬워요.

  1. 지금 index.html 내용을 복사해요(PART 7-5의 「지금 파일 복사하기」 명령)
  2. 아래 문장을 채팅 AI에 붙여 넣고, 맨 끝 자리에 복사한 내용을 붙여 넣어 보내요
  3. AI가 준 index.html·robots.txt·sitemap.xml을 PART 7-4의 방법대로 public 폴더에 저장해요. 대표 이미지는 6-4대로 만들어 og-image.png로 public 폴더에 넣어요
  4. PART 7-5대로 저장하고 올려요
  5. 카톡 등에 내 주소를 한 번 붙여 보고 그림이 뜨면 성공이에요. 미리보기는 처음 읽은 내용을 한동안 기억해서, 그림을 바꿔도 바로 안 바뀔 수 있어요
채팅 AI(ChatGPT·Claude 등) 입력창에 복사해서 붙여넣기
내 웹사이트를 공개하기 전에 검색과 링크 미리보기(카톡 등)에 필요한 SEO 기본을 넣고 싶어요. 저는 코딩을 몰라요.
아래에 제 index.html 전체를 붙여 넣을게요. 아래 10가지를 하나도 빠짐없이 넣은 index.html 전체를 코드 블록 하나로 다시 주세요. 공개 주소는 https://<앱이름>.ridm.ai/ 예요.
1. <html lang="ko">
2. <title> — 「이름 — 무엇을 하는 곳인지」 한 줄
3. <meta name="description"> — 누가 무엇을 할 수 있는지 한두 문장
4. <link rel="canonical"> — 위 공개 주소
5. og:title · og:description · og:url · og:type(website) · og:site_name · og:locale(ko_KR)
6. og:image — https://<앱이름>.ridm.ai/og-image.png (https 로 시작하는 전체 주소), og:image:width 1200 · og:image:height 630 · og:image:alt
7. twitter:card = summary_large_image, twitter:title · twitter:description · twitter:image 는 og 와 같은 값
8. 파비콘 <link rel="icon"> 과 apple-touch-icon
9. robots.txt 파일 내용(User-agent: * / Allow: / / Sitemap: 줄)을 따로 주세요
10. sitemap.xml 파일 내용을 따로 주세요(공개 페이지 주소만)
제목과 설명 문구는 먼저 두세 개 보여 주고 제가 고르게 해 주세요. 과장 표현(1위·최고·무조건)은 쓰지 마세요.
파일마다 어떤 이름으로 public 폴더에 저장하는지 알려 주세요.

<지금 index.html 전체>
AI 코딩 도구가 읽는 규칙 (사람은 안 읽어도 돼요)

흐름 공간 페이지가 넣어 두는 것: <html lang="ko"> · <title>(공간 이름) · meta description(「공간 이름 — 걸어 다니며 둘러보는 3D 공간」) · og:title · og:type. og:image 는 없다. 공간 페이지의 태그는 사용자가 고칠 수 없다.

체크리스트 10개: ① <html lang> ② <title> 60자 안팎 ③ meta description ④ canonical(페이지마다 그 페이지의 진짜 주소) ⑤ og:title · og:description · og:url · og:type=website · og:site_name · og:locale=ko_KR ⑥ og:image 1200×630, https:// 절대 주소, og:image:width · height · alt ⑦ twitter:card=summary_large_image + title · description · image ⑧ 파비콘 + apple-touch-icon(180×180 PNG) ⑨ robots.txt(User-agent: * / Allow: / / Sitemap: https://주소/sitemap.xml, 관리자·비밀 주소는 적지 않음) ⑩ sitemap.xml(공개 페이지만, 절대 주소, 로그인 화면·/api/ 제외).

대표 이미지: 그림 기능이 있으면 1200×630 으로 만들고, 없으면 1200×630 HTML 카드(이름·한 줄 설명·대표 색)를 브라우저 캡처로 PNG 저장. 글자는 가운데, 파일은 가볍게(보통 수백 KB).

공개 뒤 확인 명령
file public/og-image.png        # "1200 x 630"
curl -s -A "Mozilla/5.0" https://<주소>/ | grep -oE '<html[^>]*>|<title>[^<]*|<meta (name|property)="(description|og:[a-z:_]+|twitter:[a-z:]+)"[^>]*>|<link rel="(canonical|icon|apple-touch-icon)"[^>]*>'
curl -sI -A "Mozilla/5.0" https://<주소>/og-image.png | head -n 1
curl -s -A "Mozilla/5.0" https://<주소>/robots.txt
curl -s -A "Mozilla/5.0" https://<주소>/sitemap.xml | head -n 5

둘째 명령은 html lang · title · description · og:* · twitter:* · canonical · icon · apple-touch-icon 이 모두 나와야 하고 og:image 가 https:// 로 시작해야 한다. og-image.png 는 200, robots.txt 는 세 줄, sitemap.xml 은 <urlset 으로 시작.

6-6. 검색엔진에 알리기 (길 B, 선택)

흐름 공간 주소(길 A)는 흐름이 만드는 페이지라 검색엔진 등록에 필요한 확인 글자를 넣을 수 없어요. 등록은 길 B처럼 내가 만든 사이트에 해요. 등록하지 않아도 검색엔진이 언젠가 찾아오지만, 등록하면 더 빨리 읽어 가요. 네 곳 모두 무료예요.

순서는 네 곳 모두 같아요: ① 내 사이트라고 확인 → ② 사이트맵 주소 알려 주기 → ③ 첫 화면 주소 읽어 가 달라고 요청. 로그인과 「확인」·「제출」 버튼은 내가 눌러요. 화면 글자를 그대로 채팅 AI에게 보내면 무엇을 할지 알려 줘요.

채팅 AI(ChatGPT·Claude 등) 입력창에 복사해서 붙여넣기
제 웹사이트 https://<앱이름>.ridm.ai/ 를 <검색엔진 이름>에 등록하려고 해요. 저는 처음이에요.
이 사이트는 흐름(HRUM) 깃흐름으로 올리고, 파일은 public 폴더에 있어요. 도메인은 제 것이 아니라서 DNS 방식은 못 써요. 구글이면 「URL 접두어」로 추가해야 해요.
1. 사이트 소유 확인을 「HTML 태그」(메타 태그) 방식으로 하는 순서를 알려 주세요. 다음 웹마스터도구는 robots.txt 에 넣는 인증 줄 방식이에요.
2. 화면에 나온 확인 태그(또는 인증 줄)를 제가 붙여 넣으면, 제 index.html(또는 robots.txt) 어디에 넣는지 넣은 전체 파일로 주세요.
3. 그다음 사이트맵 제출(https://<앱이름>.ridm.ai/sitemap.xml)과 첫 화면 주소 수집 요청 순서를 알려 주세요.
확인 태그는 확인이 끝나도 지우면 안 된다고 알려 주세요. 제 계정 비밀번호와 다음 PIN코드는 묻지 마세요.

검색에 나오기까지 며칠에서 몇 주 걸릴 수 있고, 순위는 누구도 보장할 수 없어요. 확인 태그·파일·인증 줄은 확인이 끝나도 지우지 않아요.

AI 코딩 도구가 읽는 규칙 (사람은 안 읽어도 돼요)
검색엔진소유 확인사이트맵 → 수집 요청
Google Search Console「URL 접두어」 속성 → HTML 태그(google-site-verification) 또는 HTML 파일(google….html)「Sitemaps」 → 「URL 검사」에 첫 화면 주소 → 「색인 생성 요청」
Bing Webmaster Tools메타 태그(msvalidate.01) 또는 XML 파일(BingSiteAuth.xml). Google Search Console 에서 가져오기도 된다「Sitemaps」 → URL 제출(URL Submission)
네이버 서치어드바이저웹마스터 도구 → 사이트 등록 → HTML 태그(naver-site-verification) 또는 HTML 파일 업로드「요청」 → 「사이트맵 제출」 → 「웹 페이지 수집」
다음 웹마스터도구「PIN코드 발급받기」에서 사이트 주소와 PIN코드(사용자가 정하는 비밀번호)를 넣으면 #DaumWebMasterTool: 로 시작하는 robots.txt 인증 줄을 준다사이트 주소 + PIN코드로 들어가 사이트맵·수집 요청 메뉴(이름은 화면을 따른다)

역할: 로그인·확인·제출은 사람. AI 는 태그는 <head>, 확인 파일은 사이트 맨 위 폴더(깃흐름 기본 구성에서는 public/), 다음 인증 줄은 robots.txt 맨 아래에 넣고 배포한 뒤 실제 주소에서 보이는지 출력으로 보이고, 사이트맵 주소가 열리는지와 요청할 주소 목록을 준다. 다음 PIN코드와 계정 비밀번호는 받지 않는다.

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

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

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

<화면에 나온 글자>

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

출처

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

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 의 흐름 콘솔 화면과 공간 페이지를 기준으로 썼어요. 화면 글자는 바뀔 수 있으니, 다르면 콘솔 화면을 따라요.

부록 D — 막힐 때

화면에 나온 글자를 아래 표에서 찾아요. 표에 없으면 맨 아래 「막혔을 때」 문장을 채팅 AI에게 보내요.

D-1. 길 A — 콘솔에서 막힐 때

화면에 나온 말이유와 할 일
이미 쓰이는 주소예요다른 사람이 그 주소를 써요. 다른 이름을 골라요
주소는 소문자 영문·숫자·하이픈 …대문자·한글·밑줄(_)·점(.)을 빼요. 하이픈(-)으로 시작하거나 끝나지 않게 고쳐요
파일이 너무 커요PART 2-3대로 줄여요. 올릴 수 있는 크기가 같이 나와요
이 파일은 올릴 수 없어요 + 이유아래 D-2 표에서 이유를 찾아요
저장 공간이 모자라요안 쓰는 공간을 지우거나 플랜을 올려요(PART 5-4)
공간 수를 다 썼어요 · 열 수 있는 공간 수를 넘었어요먼저 만든 공간을 지우거나 플랜을 올려요
공개 대기 중이에요 · 가입 확인이 끝나면 공개할 수 있어요흐름이 새 계정을 확인하는 중이에요. 공간 만들기와 파일 올리기는 지금도 돼요. 확인이 끝나면 공간 줄의 「공개하기」를 다시 눌러요
크레딧이 부족해요같이 나오는 「충전하기」로 크레딧을 충전한 뒤 다시 해요
지금은 파일을 받을 수 없어요 · 서버에 연결할 수 없어요잠시 뒤 다시 해요

D-2. 「이 파일은 올릴 수 없어요」 아래의 이유

이유는 영어 글자로 나와요. 아래에서 같은 글자를 찾고, 고치는 법을 PART 2-3의 채팅 AI 문장에 같이 적어 보내요.

이유뜻과 고치는 법
external_reference그림이 파일 밖에 따로 있어요. 3D 프로그램에서 그림을 파일 안에 넣어(Embedded) .glb로 다시 내보내요
extension_unsupported:…공간이 읽지 못하는 기능이 들어 있어요. Draco·meshopt 압축이나 KTX2 그림이면 끄고 다시 내보내요
gltf_version오래된 형식이에요. 3D 프로그램의 「glTF 2.0」 내보내기로 다시 만들어요
image_type:… · image_unreadable:…그림이 PNG·JPEG·WebP가 아니거나 깨졌어요. 그 그림을 PNG나 JPEG로 바꿔 다시 넣어요
texture_too_large · too_many_images그림이 너무 크거나 많아요. 그림 크기를 줄이거나 개수를 줄여요
too_many_vertices · too_many_meshes모양이 너무 복잡해요. 안 보이는 부분을 지우고, 물체를 합치거나 단순하게 만들어요
buffers_multiple · buffer_bounds · 그 밖의 이유파일 구조가 맞지 않아요. 3D 프로그램에서 .glb로 새로 내보내요

D-3. 길 A — 공간에 들어갈 때

보이는 것이유와 할 일
주소가 열리지 않아요공간 줄이 「공개 중」인지 봐요. 「비공개」거나 「플랜 한도로 비공개」면 「공개하기」를 누르거나 플랜을 정리해요
공간을 불러오지 못했어요새로 고침해요. 계속되면 「파일 바꾸기」로 파일을 다시 올려요
지금은 혼자 둘러볼 수 있어요같이 접속이 닫혔어요. 「내 호스팅 → 메타버스」 화면 위 알림대로 해요(PART 5-3)
다른 사람이 안 보여요두 쪽 모두 같은 주소인지, 두 쪽 모두 이름 단계를 지나 들어왔는지 봐요
지금은 채팅이 꺼져 있어요공간의 채팅이 꺼져 있어요. 걷기와 같이 접속은 그대로예요
조금 천천히 보내 주세요짧은 사이에 메시지를 많이 보냈어요. 잠시 뒤 보내요
휴대폰에서 느려요파일을 PART 2-3대로 가볍게 만들어 「파일 바꾸기」로 올려요

D-4. 길 B — 깃흐름으로 올릴 때

보이는 것이유와 할 일
hrum 을 찾을 수 없다 · command not found · 인식되지 않습니다설치 뒤 터미널을 새로 열지 않았어요. 창을 닫고 새로 연 뒤 다시 해요(PART 7-2)
로그인이 필요해요 · 이 컴퓨터는 아직 … 연결되지 않았어요hrum login <앱이름>을 다시 붙여 넣고, 브라우저에서 코드 입력 → 「확인」 → 「허용」을 눌러요
연결 요청이 만료됐어요 · 거절됐어요10분이 지났거나 「거절」을 눌렀어요. hrum login <앱이름>부터 다시 해요
그 이름의 앱이 내 계정에 없어요(HRUM_E_APP_NOT_FOUND)앱 이름이 틀렸거나 7-1 신청을 안 했어요. 콘솔 「내 호스팅」의 앱 이름을 그대로 써요
이 폴더에 앱 코드와 다른 파일이 있어요빈 폴더가 아니에요. 다른 이름으로 빈 폴더를 만들어 7-3부터 다시 해요
이 폴더는 아직 흐름 앱과 연결되지 않았어요다른 폴더에 있어요. cd ~/<앱이름>으로 들어가요. 그래도 나오면 hrum init <앱이름>
저장하지 않은 변경이 있어요hrum save "메모"를 먼저 하고 hrum push를 다시 해요
바뀐 파일이 없어요파일 저장(7-4 ③)이 안 됐어요. 코드를 다시 복사해 저장 줄을 다시 붙여 넣어요
한 번에 올리는 양이 너무 커요큰 모델 파일은 한 번에 하나씩 넣고 저장·올리기를 나눠서 해요
주소를 열면 공간이 안 보이고 하얀 화면이에요AI가 준 코드가 중간에 잘렸을 수 있어요. 7-5의 「고쳐 달라는 문장」에 「화면이 하얗게 나와요」라고 적어 보내요
호스팅 시작하기가 안 보여요 · 로그인이 풀려요이메일 인증과 로그인을 마쳤는지 봐요(PART 0-2)
AI 코딩 도구가 읽는 규칙 (사람은 안 읽어도 돼요)

깃흐름 오류는 --json 결과의 code(HRUM_E_…)로 판단한다. 배포 실패는 failMessage·failHelpUrl·failReason·logTail 을 본다. 종료 코드 0 성공, 1 고칠 수 있는 문제, 2 서버·네트워크, 3 로그인 필요. 전체 표는 배포 가이드 — 깃흐름.

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

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

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

<화면에 나온 글자>

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

출처

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

부록 E — 길 A: 공간에서 판매하기(결제)

공개한 공간 오른쪽 위에 결제 버튼을 달아 전시 입장권, 도록, 굿즈 같은 것을 팔 수 있어요. 결제는 흐름의 다른 판매와 같은 흐름 결제로 받고, 정산(판 돈을 내 계좌로 받는 것)도 같은 길로 받아요. 코드도 카드 결제 회사(PG) 계약도 필요 없어요. 판매는 선택이에요.

E-1. 먼저 — 판매자 등록

  1. 콘솔 「정산」 → 「정산 계좌」를 열어요
  2. 판매자 정보와 정산 계좌를 적어 내요. 개인·개인사업자·법인 가운데 골라요
  3. 흐름이 확인하고 승인하면 판매가 열려요. 승인 전에 결제 버튼을 저장하면 「판매자 승인이 끝나야 결제를 받을 수 있어요」가 나와요

계좌번호·사업자등록번호는 콘솔에 내가 직접 넣어요. 채팅 AI에게 보내거나 파일에 적지 않아요.

E-2. 결제 버튼 달기

  1. 공간 줄이 「공개 중」인지 봐요. 결제 버튼은 공개한 공간에만 달 수 있어요
  2. 공간 줄의 결제 버튼 달기를 눌러요
  3. 버튼 글자(예 입장권 사기), 파는 것(예 전시 입장권), 가격 (원)을 적고 저장해요. 손님은 여기 적은 가격으로만 결제해요
  4. 공간 줄에 「결제 버튼」 표시와 버튼 글자·파는 것이 보이면 끝이에요
  5. 바꾸려면 결제 버튼 바꾸기, 내리려면 그 창의 결제 버튼 떼기를 눌러요

E-3. 손님이 보는 것

  1. 공간 오른쪽 위의 버튼을 눌러요(휴대폰에서는 「흐름으로 만듦」 바로 아래)
  2. 흐름 결제 창이 열려요. 상품·금액·판매자 정보와 청약철회 안내를 확인하고 결제해요
  3. 결제를 마치면 공간으로 돌아오고, 버튼 아래에 「파는 것 구매 완료」가 나와요. 결제를 끝내지 않고 돌아오면 「결제가 아직 끝나지 않았어요」가 나와요

공간은 결제 창을 열고 구매 완료를 보여 주는 데까지만 해요. 산 사람만 들어오게 막지는 않아요. 산 사람에게 무엇을 줄지(입장 안내, 실물 보내기 등)는 내가 정하고 처리해요.

E-4. 판매와 정산 보기

E-5. 무엇을 팔면 좋을까요

공간에 들어와 보고, 걷고, 만나는 일에 붙는 것을 팔아요. 전시 입장권, 공연·행사 참가권, 작품 도록, 굿즈, 후원 같은 것이에요.

E-6. 막힐 때

화면에 나온 말이유와 할 일
판매가 아직 열리지 않은 계정이에요판매자 등록을 아직 안 했어요. E-1을 해요
판매자 승인이 끝나야 결제를 받을 수 있어요등록은 했고 흐름이 확인 중이에요. 승인 뒤 다시 저장해요
판매하기에서 판매자 정보를 먼저 채워 주세요콘솔 「정산」의 판매자 정보를 마저 채워요
공개한 공간에만 결제 버튼을 달 수 있어요공간을 먼저 공개해요(PART 3)
이 공간에 등록할 수 있는 상품 수를 다 썼어요새로 달지 말고 「결제 버튼 바꾸기」로 고쳐요
이 가격으로는 팔 수 없어요가격을 확인해 다시 적어요
(손님) 지금은 결제할 수 없어요이 공간의 판매가 잠시 닫혀 있어요. 콘솔 「정산」의 판매자 상태를 봐요
(손님) 잠시 뒤에 다시 눌러 주세요결제 창을 짧은 사이에 너무 자주 열었거나 잠시 연결이 안 됐어요. 조금 뒤 다시 눌러요
AI 코딩 도구가 읽는 규칙 (사람은 안 읽어도 돼요)

수수료·지급일·정산 숫자는 기억으로 말하지 않고 콘솔 「정산」 화면을 보라고 한다. 계좌번호·사업자등록번호는 받지 않는다.

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

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

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

<화면에 나온 글자>

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

출처

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

© 플로트 주식회사 (FLOAT Co., Ltd.) · console.hrum.ai — HRUM 메타버스 만들기와 RIDM Apps 호스팅