원보드 설치 마법사

단계마다 할 일 하나와 확인할 화면 하나를 보여 드립니다. 화면이 맞으면 「예」, 다르면 「아니요」를 눌러 그 경우의 해결 방법을 보세요. 이 페이지는 ChatGPT 화면을 볼 수 없어서, 확인은 직접 해 주셔야 합니다.

화면은 2026-10-18 ChatGPT 웹 기준입니다. 바뀌었을 수 있습니다. 설치 문장은 원보드 v0.1.0-beta.2 버전의 코드를 가져옵니다. 지금 단계는 이 브라우저에 기억되어, ChatGPT 탭에 다녀와도 같은 단계가 열립니다.

0단계. 요금제 확인하기

원보드는 ChatGPT 사이트(Sites)에 설치되고, Sites는 유료 요금제에서만 쓸 수 있습니다. ChatGPT(chatgpt.com) 왼쪽 아래의 계정 이름 밑에 지금 요금제가 보입니다.

ChatGPT 왼쪽 아래. 계정 이름 아래에 요금제 「Plus」가 보인다. — 계정 이름 아래의 요금제 표시. 이름은 가렸습니다.

요금제가 Plus·Pro·Business·Enterprise·Edu 중 하나인가요?

이런 경우에는

Free·Go 요금제: 베타 동안에는 원보드를 쓸 방법이 없습니다. 원보드는 무료지만, 설치되는 자리인 Sites를 이 요금제에서 쓸 수 없습니다. 기다려 주셔서 고맙습니다.
요금제 표시가 없거나 로그인 화면이 나온다: 먼저 ChatGPT에 로그인하세요.
유럽경제지역(EEA)·스위스·영국: 출시 시점에 Sites 사용이나 공개 게시에 제한이 있었습니다. 다음 단계에서 Work가 보이는지로 확인하세요.
회사·학교 계정: 관리자가 Sites를 꺼 두었을 수 있습니다. 관리자에게 묻거나 개인 계정을 쓰세요.

막혔어요 (문제 알리기)

1단계. ChatGPT를 Work 화면으로 열기

ChatGPT를 새 탭으로 열고, 화면 위쪽 가운데의 「Chat | Work」에서 Work를 누릅니다. 처음 열면 Chat이 골라져 있는데, Chat에는 Sites가 없어 설치가 시작되지 않습니다. 주소는 Chat과 Work 모두 chatgpt.com 그대로라서 이 버튼으로 Work를 바로 열 수는 없습니다.

ChatGPT 열기

처음 연 ChatGPT. 위쪽 가운데 전환에서 Chat이 골라져 있고 입력창 문구는 「ChatGPT에게 물어보세요」. — 처음 열면 Chat입니다. 여기에 붙여넣지 마세요.

Work를 누른 ChatGPT. 입력창 문구가 「ChatGPT로 Work 시작」으로 바뀌고 아래에 「개인 웹사이트 만들기」 카드가 보인다. — Work를 누르면 입력창 문구가 바뀝니다.

입력창에 「ChatGPT로 Work 시작」이 보이나요?

이런 경우에는

로그인 화면이 나온다: 유료 요금제 계정으로 로그인한 뒤 위쪽에서 Work를 누르세요.
「Chat | Work」 전환이 없다: 로그인했는지, 0단계의 요금제인지 확인하세요. 회사·학교 계정이라면 관리자가 기능을 꺼 두었을 수 있습니다. 전환이 없는 경우는 아직 확인되지 않았습니다. 해결되지 않으면 아래 「막혔어요」로 알려 주세요.
ChatGPT 데스크톱 앱을 쓰고 있다: 이 마법사는 웹(chatgpt.com) 기준입니다. 데스크톱 앱에서의 설치는 확인되지 않았으니 웹에서 하기를 권합니다.

· 막혔어요 (문제 알리기)

2단계. 설치 문장 보내기

아래 버튼으로 설치 문장을 복사해, Work 화면의 입력창(「ChatGPT로 Work 시작」)에 붙여넣고 보냅니다. 문장을 고치지 않아도 되고, 모델은 기본값 그대로 두어도 됩니다.

설치 문장 보기

원보드(Wonboard)를 내 ChatGPT Sites에 설치해 주세요. 이 요청은 이미 있는 프로젝트를 Sites로 배포하는 웹사이트(website) 작업입니다.

원보드는 글과 사진을 쓰고 보관하는 오픈소스 글쓰기 도구입니다. 새 사이트를 만들어 달라는 요청이 아닙니다. 아래 저장소의 코드를 그대로 가져와 배포해 주세요. 화면과 기능을 새로 만들거나 고치지 마세요.

저장소: https://github.com/jiwonschol/wonboard (태그 v0.1.0-beta.2)

아래 순서대로 진행하고, 한 단계가 끝날 때마다 무엇을 했는지 한국어로 짧게 알려 주세요. 막히면 추측으로 넘어가지 말고, 어느 단계에서 왜 막혔는지 그대로 알려 주세요.

시작 전 확인
이 작업에는 저장소를 가져오고 명령을 실행하는 도구가 필요합니다. 지금 대화에서 저장소를 가져오거나 명령을 실행할 수 없다면 ZIP 파일을 달라고 하지 말고 여기서 멈춘 뒤, 저에게 다음과 같이 안내해 주세요.
- ChatGPT 화면 위쪽 가운데의 「Chat | Work」에서 Work를 고르고, 새 대화에 이 설치 문장을 다시 붙여넣어 주세요. 입력창에 「ChatGPT로 Work 시작」이 보이면 Work입니다.
- ChatGPT Plus·Pro·Business·Enterprise·Edu 중 하나의 유료 요금제 계정이어야 합니다.

1. 코드 가져오기
위 저장소에서 태그 v0.1.0-beta.2의 코드를 가져옵니다. main 브랜치나 다른 태그의 코드를 쓰지 마세요. 명령은 실행되는데 GitHub에서 저장소를 받지 못할 때만 여기서 멈추고, 제가 https://github.com/jiwonschol/wonboard/archive/refs/tags/v0.1.0-beta.2.zip 파일을 내려받아 이 대화에 첨부하도록 안내해 주세요.

2. 빌드
Node.js 22.13 이상과 pnpm 11.19.0을 씁니다. `pnpm install --frozen-lockfile`을 실행한 다음 `pnpm build:sites`를 실행합니다. 성공하면 화면 파일이 `dist/client`에, 서버 파일이 `dist/server/index.js`에 생깁니다.

3. Sites로 배포할 준비
저장소에 있는 설정 그대로 배포해 주세요. 배포 설정이나 DB 스키마를 새로 만들거나 코드를 고치지 마세요.
- 공식 Sites 연결은 `vite.sites-worker.config.ts`의 `@openai/sites-vite-plugin`이 빌드할 때 적용합니다. 서버 코드는 `apps/server/src/sites/worker.ts`이고, 기본 내보내기가 fetch 처리기입니다.
- `.openai/hosting.json`에 선언된 D1 `DB`, R2 `MEDIA`를 그대로 연결합니다. Sites가 새 프로젝트를 연결하면서 넣는 프로젝트 ID만 설치마다 달라집니다.
- `wrangler.json`의 `ASSETS` 선언대로 `dist/client`를 제공합니다. 배포 꾸러미에는 `dist/server/index.js`와 `dist/.openai/hosting.json`, `dist/.openai/drizzle`이 함께 있어야 합니다.
- 새 DB는 빌드에 포함된 `drizzle`의 초기 마이그레이션을 그대로 적용합니다. `apps/server/src/sites/schema.sql`은 로컬 검증용입니다. `apps/server/src/sites/migrations`의 기존 설치 업그레이드 SQL은 새 DB에 중복 적용하지 않습니다.
- `apps`와 `packages`의 화면과 저장 동작을 바꾸지 마세요. 그대로 배포할 수 없다면 설정을 즉석에서 바꾸지 말고 오류를 알려 주세요.

4. 배포
버전을 저장하고 배포합니다. 사이트 접근 범위는 새 사이트의 처음 상태(소유자와 워크스페이스 관리자만 접근) 그대로 두고, 제가 따로 요청하기 전에는 범위를 넓히거나 공개로 바꾸지 마세요. 이 사이트에는 아직 원보드의 소유자가 없어서, 범위를 넓히면 먼저 로그인한 아무나 소유자가 됩니다. 배포가 끝나면 사이트 주소를 알려 주세요.

5. 로그인 안내
새 사이트에서는 처음 로그인한 계정이 원보드의 소유자로 기록됩니다. 배포가 끝나면 저에게 다음과 같이 안내해 주세요.
- 배포가 끝나고 열리는 사이트 미리보기 창에 “시작 전에 확인해주세요.” 안내가 보이면 제 계정이 소유자로 기록된 것입니다. 안내를 읽고 확인란에 표시한 뒤 “내 글쓰기 공간 열기”를 누르면 설치가 끝납니다.
- 미리보기 창이 없으면 사이트 주소를 다른 사람에게 알리기 전에 제가 바로 새 탭에서 엽니다. 「접속하려면 로그인하세요」 화면에서 「ChatGPT로 계속」을 누르고, 계정 목록에서 이 사이트를 만든 계정을 이름으로 골라 로그인합니다. 목록의 순서는 바뀔 수 있습니다.
- 계정을 고른 뒤 「세션이 종료되었습니다」가 나오면 사이트 주소를 다시 엽니다.
- 원보드 화면에 “이 사이트에는 아직 소유자가 없어요.”가 보이면 “ChatGPT로 로그인”을 누릅니다.
소유자를 정하려고 환경 값을 만들거나 코드를 고치지 마세요. 제가 사이트를 여는 것으로 충분하고, 연결 ID를 물어보지 않아도 됩니다.

6. 소유자가 잘못 정해졌을 때만
제가 “다른 계정의 글쓰기 공간입니다.”라는 안내가 보인다고 알리면, 다른 계정이 먼저 로그인해 소유자가 된 것입니다. 그때만 다음과 같이 안내해 주세요.
- 그 화면의 “계정 연결 정보”를 펼치고 “연결 정보 확인”을 누르면 연결 ID가 나옵니다.
- 그 연결 ID를 복사해 이 대화에 붙여넣습니다.
제가 연결 ID를 붙여넣으면 그 값을 이 사이트의 환경 값 `WONBOARD_OWNER_ID`로 저장하고, 4단계에서 저장한 버전을 그대로 다시 배포해 주세요. 환경 값은 다시 배포해야 적용되고, 이 값이 있으면 기록된 소유자보다 우선합니다. 값은 제가 붙여넣은 그대로 쓰고, 이름이나 이메일을 대신 넣지 마세요. 이 값을 코드나 `.openai/hosting.json` 같은 프로젝트 파일에 적지 마세요. 직접 저장할 수 없으면, 제가 Sites의 사이트 설정에서 `WONBOARD_OWNER_ID`를 직접 넣도록 안내해 주세요.

5단계 안내를 할 때 사이트 주소, 접근 범위, 배포한 버전과 그 버전을 만든 원보드 태그를 함께 정리해서 알려 주세요.

설치 문장을 보낸 뒤의 ChatGPT. 「Ran 4 commands」 아래에 「1단계: 지정하신 태그의 코드를 가져왔고」로 시작하는 진행 보고가 보인다. — 보낸 지 1분이 안 되어 코드를 가져왔다는 보고가 나옵니다.

1분쯤 안에 「저장소 클론하기」나 「1단계: … 코드를 가져왔고」 같은 진행 보고가 보이나요?

이런 경우에는

ChatGPT가 도구를 쓸 수 없다고 하거나, 코드 ZIP 파일을 첨부해 달라고 한다: Chat 화면에 보낸 것입니다. ZIP을 내려받지 마세요. 새 대화를 열고 위쪽에서 Work를 고른 뒤 설치 문장을 다시 붙여넣으세요(1단계).
Work 화면인데 일반 대답만 하고 작업을 시작하지 않는다: 입력창에서 @Sites를 직접 골라 넣은 뒤 설치 문장을 다시 보내세요.
복사가 되지 않는다: 「설치 문장 보기」를 펼쳐 글 전체를 직접 선택해 복사하세요.

· 막혔어요 (문제 알리기)

3단계. 배포가 끝날 때까지 기다리기

여기서는 ChatGPT가 일합니다. 대화 창을 닫지 말고 기다리세요. 진행 보고는 이 순서로 나옵니다.

1단계: 코드 가져오기
2단계: 빌드
3단계: 사이트 생성과 배포 준비
4단계: 버전 저장과 배포

2026-10-18 시험에서는 승인 요청 없이 4분쯤 걸렸습니다.

ChatGPT의 완료 보고. 「원보드 배포가 완료됐습니다」 아래에 접근 범위(기본 비공개), 배포한 버전(Sites 버전 1), 원본 태그를 담은 표가 있다. — 완료 보고와 요약 표. 표 위쪽에는 사이트 주소도 있습니다.

ChatGPT가 배포가 완료됐다고 말하고 사이트 주소가 담긴 요약 표를 보여 줬나요?

이런 경우에는

승인해 달라고 묻는다: 내용을 읽고 승인하세요. 처음 설치이므로 새 사이트를 만들겠다는 것은 정상입니다.
오류로 멈췄다: ChatGPT가 알려 준 오류를 그대로 복사해 아래 「막혔어요」로 보내 주세요.
ChatGPT가 오류를 피하려고 코드나 설정을 고치려 한다: 「고치지 말고 실패한 명령과 오류를 알려 주세요」라고 답하세요.
10분이 넘도록 진행 보고가 바뀌지 않는다: ChatGPT에 지금 어느 단계인지 물어보세요.
요금제 한도에 닿았다고 한다: 원보드가 풀 수 없는 제한입니다. ChatGPT가 보여 주는 한도 안내를 따르세요.

· 막혔어요 (문제 알리기)

4단계. 내 사이트 확인하기

배포가 끝나면 ChatGPT 오른쪽에 사이트 미리보기 창이 열리고, 원보드가 내 이름과 함께 안내를 보여 줍니다. 이 화면이 보이면 내 계정이 이미 원보드의 소유자로 기록된 것입니다. 사이트 주소는 이 단계를 마칠 때까지 다른 사람에게 알리지 마세요.

ChatGPT 오른쪽의 사이트 미리보기 창. 원보드 화면에 「내 이름, 시작 전에 확인해주세요.」와 안내 네 줄, 확인란, 「내 글쓰기 공간 열기」 버튼이 보인다. — 미리보기 창의 원보드. 이름과 사이트 주소는 가렸습니다.

미리보기 창에 내 이름과 함께 “시작 전에 확인해주세요.”가 보이나요?

이런 경우에는

미리보기 창이 없거나 닫았다: 요약 표의 사이트 주소를 새 탭에서 엽니다.
1. 원보드보다 먼저 Sites의 「접속하려면 로그인하세요」 화면이 나옵니다. 「ChatGPT로 계속」을 누릅니다.
2. 「ChatGPT로 원보드에 로그인하세요」 화면에 이 브라우저의 ChatGPT 계정이 모두 나옵니다. 사이트를 만든 계정을 이름과 이메일로 확인해 고르세요. 목록의 순서는 열 때마다 바뀔 수 있습니다.
3. 원보드의 “시작 전에 확인해주세요.” 화면이 나오면 「예」를 누르세요.
새 탭에서 먼저 나오는 Sites 화면

계정 선택. 계정 이름과 이메일은 예시로 바꿨습니다.
「세션이 종료되었습니다」가 나온다: 계정 선택 화면을 오래 열어 두면 나옵니다(시험에서는 50분쯤). 사이트 주소를 다시 열어 처음부터 하세요.
“다른 계정의 글쓰기 공간입니다.”가 나온다: 다른 계정이 먼저 소유자가 됐거나 다른 계정으로 로그인한 것입니다. 사이트를 만든 계정으로 다시 로그인해 보고, 그래도 같으면 설치 안내의 소유자를 직접 정하거나 바로잡기를 따르세요.
“계정을 확인하지 못했어요.”가 나오고 다시 해도 같다: 지금 방식으로는 설치를 끝낼 수 없습니다. 아래 「막혔어요」로 꼭 알려 주세요.
“이 사이트에는 아직 소유자가 없어요.”가 나온다: “ChatGPT로 로그인”을 눌러 사이트를 만든 계정으로 로그인하세요. 2026-10-18 시험에서는 이 화면을 보지 못했습니다(확인되지 않음).

· 막혔어요 (문제 알리기)

5단계. 안내 읽고 시작하기

원보드의 안내 네 줄을 읽고 “자료가 저장되는 곳과 사진이 공개되는 시점을 이해했습니다.”에 표시한 뒤 “내 글쓰기 공간 열기”를 누릅니다. 미리보기 창이 좁으면 사이트를 새 탭에서 열어도 됩니다.

원보드의 시작 전 확인 화면. 안내 네 줄 아래에 확인란과 「내 글쓰기 공간 열기」 버튼이 있다. — 확인란에 표시하면 버튼이 켜집니다.

원보드 편집기. 왼쪽에 「내 글」 목록과 빈 「제목 없음」 글, 가운데에 편집기, 오른쪽 아래에 Sites가 넣은 「사이트 편집」 버튼이 떠 있다. — 설치가 끝난 화면

글 편집기와 “내 글” 목록이 보이나요?

이런 경우에는

“내 글쓰기 공간 열기”가 눌리지 않는다: 확인란에 표시했는지 보세요. 표시해야 버튼이 켜집니다.
그 밖의 화면이나 오류가 나온다: 화면에 나온 안내를 적어 아래 「막혔어요」로 알려 주세요.

· 막혔어요 (문제 알리기)

설치가 끝났습니다

처음 열면 빈 “제목 없음” 글 하나가 만들어져 있습니다. 바로 쓰기 시작하면 됩니다. 앞으로 챙길 것 세 가지입니다.

사이트 주소를 즐겨찾기에 넣으세요. 다음부터는 그 주소로 엽니다.
중요한 글은 “PC 저장”으로 백업(.zip)을 받으세요. 백업은 지금 연 글 하나와 그 글의 사진을 담습니다. Sites는 베타입니다.
사이트 접근 범위는 넓히지 않아도 됩니다. 게시판에 붙인 사진을 남에게 보이려면 그때 설치 안내의 설치한 뒤를 보세요.

오른쪽 아래에 떠 있는 「사이트 편집」 버튼은 Sites가 넣은 것이고 원보드를 쓰는 데는 필요 없습니다.

각 단계를 더 자세히 설명한 글은 단계별 설치 안내(자세한 설명)에 있습니다. 이미 설치했다면 새 버전으로 올리기를 보세요.

다른 사람의 계정에서는 아직 확인되지 않음. 이 마법사는 2026-10-18에 만든 사람의 Plus 계정으로 ChatGPT 웹의 Work 화면에서 끝까지 설치한 기록으로 만들었습니다. 다른 계정에서 막히면 그 단계의 「막혔어요」로 알려 주세요. 그 내용으로 마법사를 고칩니다.