무료 Cloudflare 계정에 Studio 올리기
웹사이트도, 도메인도, 호스팅도 없나요? Studio는 내가 소유한 무료 Cloudflare 계정에서 실행할 수 있습니다. 이 경우 공유 링크는 다음과 같은 주소에서 열립니다: snaps.yourname.workers.dev
- 적합 대상
- 웹사이트가 없거나 Wix, Squarespace, Shopify에 웹사이트가 있는 분.
- 필요한 것
- Studio가 있는 계정으로 로그인한 Windows용 또는 Mac용 Maxisnap, Cloudflare에서 사용할 이메일 주소, Cloudflare가 스토리지를 켜기 전에 요구할 경우에 대비한 카드 또는 PayPal, 그리고 컴퓨터에 설치된 AI 코딩 어시스턴트 또는 Node.js 20 이상을 사용할 수 있는 터미널.
- 소요 시간
- 처음에는 약 20분 걸립니다.
- 결과
- 비공개 라이브러리와 workers.dev로 끝나는 주소의 브랜드 공유 링크. 내 도메인은 나중에 아무것도 잃지 않고 추가할 수 있습니다.
- 비용
- Studio는 Cloudflare의 무료 요금제에서 실행되도록 만들어졌습니다. Cloudflare는 R2의 현재 무료 사용량과 요금을 공개합니다.
이 방법의 작동 방식
무료 Cloudflare 계정을 만들고 스토리지를 켭니다. 그러면 컴퓨터에서 실행하는 Claude Code, Codex, Cursor 같은 AI 코딩 어시스턴트가 Studio 다운로드에 들어 있는 배포 도구로 Studio를 만들며, 변경할 때마다 먼저 물어봅니다.
배포 도구는 계정에 세 가지를 만듭니다. Studio 앱(Cloudflare에서는 Worker라고 부릅니다), 캡처를 저장할 스토리지(R2), 라이브러리와 팀을 위한 작은 데이터베이스(D1)입니다. 계정의 다른 항목은 변경되지 않습니다. 터미널이 익숙하신가요? 개발자용 가이드를 보고 같은 도구를 직접 실행해 보세요.
Cloudflare 계정 만들기
- 브라우저에서 Cloudflare 가입 페이지를 여세요: dash.cloudflare.com/sign-up
- 매일 확인하는 이메일 주소를 사용하세요. 회사 이메일 주소도 괜찮습니다. 강력한 비밀번호를 정하고 안전한 곳에 보관하세요.
- 이메일 인증: Cloudflare가 링크를 보냅니다. 계속하기 전에 클릭하세요. 그렇지 않으면 일부 단계가 거부됩니다. 이메일이 오지 않으면 스팸 메일함을 확인하세요.
- 웹사이트를 추가하라는 Cloudflare의 질문은 건너뛰어도 됩니다. 웹사이트는 필요하지 않습니다.
스토리지 켜기
스크린샷과 동영상은 Cloudflare R2에 저장됩니다. 계정에서 한 번만 켜 두세요:
- Cloudflare 대시보드에서 Storage & databases → R2 → Overview를 여세요.
- Cloudflare의 결제 절차를 완료해 계정에 R2를 추가하세요. Cloudflare가 요구하면 카드 또는 PayPal을 추가하세요.
Studio 대시보드에서 사용 중인 스토리지 용량을 확인할 수 있습니다. 2026년 10월에 확인한 Cloudflare의 R2 문서에 따르면, R2는 매월 무료 사용량이 포함되어 있어 무료로 시작할 수 있으며, 사용량에 대해서는 월 단위로 청구됩니다.
컴퓨터에 Studio 받기
- Windows: Maxisnap에서 설정 → 계정 → Maxisnap Studio 설정 마법사를 열고 “시작하기”를 클릭한 다음 “대시보드 다운로드”를 클릭합니다. Maxisnap이 Studio ZIP 파일을 다운로드 폴더에 저장하고 그 폴더를 엽니다.
- Mac: Maxisnap에서 Settings → Welcome & Help → Studio Setup Guide를 열고 “Get Started”를 클릭한 다음 “Download Dashboard”를 클릭합니다. Maxisnap이 Studio ZIP 파일을 다운로드 폴더에 저장합니다.
ZIP 파일의 압축을 풉니다. Windows에서는 마우스 오른쪽 버튼으로 클릭하고 “모두 추출”을 선택합니다. Mac에서는 두 번 클릭합니다.
처음부터 로고와 색상을 적용하고 싶으신가요? “Maxisnap Studio - Start Here.html”을 두 번 클릭해 열고 브랜딩을 디자인한 다음 “Lock in my branding”을 클릭하세요. 어시스턴트가 이 설정을 사용합니다. 건너뛰고 나중에 대시보드의 Branding에서 브랜딩을 바꿔도 됩니다.
AI 어시스턴트에게 맡기기
- AI 코딩 어시스턴트를 여세요. Claude Code, Codex, Cursor 또는 컴퓨터에서 명령을 실행할 수 있는 다른 어시스턴트면 됩니다.
- 고객센터의 AI 어시스턴트 가이드에서 준비된 지침을 복사하고, 꺾쇠괄호로 표시된 줄을 Studio 폴더로 바꾼 다음 붙여넣으세요.
- 웹사이트가 없고 Studio의 무료 Cloudflare 에디션을 쓰고 싶다고 알려 주세요. 어시스턴트가 Studio 폴더의 지침 파일을 읽고, 각 단계를 실행하기 전에 설명해 줍니다.
배포 도구를 쓰려면 컴퓨터에 Node.js 20 이상이 있어야 하며, 설치되어 있는지는 어시스턴트가 확인할 수 있습니다. 지침에는 어시스턴트가 무엇이든 만들기 전에 먼저 물어보고, 계정에 이미 있는 것은 삭제하거나 교체하지 않도록 안내되어 있습니다.
어시스턴트가 요청하면 Cloudflare 키 만들기
배포하려면 내 계정에 Studio를 만들 권한이 필요합니다. 이 권한은 Cloudflare API 토큰으로 부여하며, 토큰은 이 작업 하나에만 쓰는 비밀번호와 같습니다.
- Cloudflare에서 My Profile → API Tokens를 열고 “Create Token”을 클릭한 다음 사용자 지정 토큰 만들기를 선택하세요.
- 다음 네 가지 권한을 추가하세요: Account Settings Read, Workers Scripts Edit, Workers R2 Storage Edit, D1 Edit.
- “Continue to summary”를 클릭한 다음 “Create Token”을 클릭하세요. Cloudflare는 토큰을 한 번만 보여 주므로 바로 복사하세요.
- 어시스턴트가 요청하면 토큰을 채팅이 아니라 터미널에 직접 붙여넣으세요.
Cloudflare의 API Tokens 페이지 열기.
Studio가 실행되고 나면 토큰을 삭제해도 됩니다. Studio는 계속 작동하며, 나중에 업데이트하거나 제거할 때는 같은 권한을 가진 새 토큰이 필요합니다.
Studio 주소 정하기
- 어시스턴트에게 소문자, 숫자, 대시로 이루어진 Studio 이름을 알려 주세요. 기본값은 snaps입니다.
- Cloudflare 계정에 아직 workers.dev 이름이 없다면 실행 계획에서 이름을 요구하고, 어시스턴트가 사용자에게 물어봅니다. 이 이름은 계정의 모든 항목이 함께 사용하고 나중에 바꾸기 어려우므로 회사 이름이 좋은 선택입니다.
주소는 다음과 같은 형태입니다: snaps.yourcompany.workers.dev
내 도메인은 나중에 아무것도 잃지 않고 추가할 수 있습니다.
실행 계획을 확인한 다음 Studio 만들기
승인하기 전에는 아무것도 만들어지지 않습니다. 어시스턴트가 먼저 실행 계획을 만들어 보여 줍니다. “Will create”에는 Worker 하나, R2 버킷 하나, D1 데이터베이스 하나가 표시되며, 새로 만들어지는 workers.dev 이름도 함께 표시됩니다. “Will not touch”에는 계정의 나머지 항목이 모두 표시됩니다.
- 실행 계획이 맞아 보이면 어시스턴트에게 진행하라고 말하세요. Studio를 만드는 데 약 1분이 걸립니다.
- 배포가 중간에 멈춰도 같은 명령을 다시 실행하면 멈춘 지점부터 이어서 진행하며, 아무것도 두 번 만들지 않습니다.
관리자 키 보관
- 배포가 끝나면 Studio 주소와 관리자 키가 한 번만 표시됩니다. 키는 비밀번호 관리자 같은 안전한 곳에 보관하세요. 이 키로 대시보드에 로그인하며, 키를 가진 사람은 누구나 내 Studio를 사용할 수 있습니다.
- cloudflare 폴더에 deployment.json이라는 파일도 만들어집니다. 나중에 Studio를 업데이트하거나 제거할 때 이 파일을 사용하므로 보관하세요.
Maxisnap을 연결하고 사용해 보기
- Windows용 Maxisnap: 설정 → 계정 → Maxisnap Studio 설정 마법사를 열고 “시작하기”를 클릭하고, 4단계 “Maxisnap 연결”이 나올 때까지 “다음”을 클릭합니다. Studio 주소와 키를 붙여넣고 “연결 테스트”를 클릭한 다음 “다음”을 클릭하고, 마지막 페이지에서 “완료 및 저장”을 클릭합니다. 설정할 때 받은 관리자 키도, 대시보드의 People & access에 있는 업로드 코드도 사용할 수 있습니다.
- Mac용 Maxisnap: Settings → Welcome & Help → Studio Setup Guide를 열고 “I already have a dashboard”를 선택합니다. Studio 주소와 키를 붙여넣고 “Test Connection”, “Next”, “Finish & Save”를 차례로 클릭합니다.
무엇이든 캡처한 다음 편집기에서 “업로드”를 클릭하세요. Windows에서는 Ctrl+Alt+7을 누르면 영역을 캡처하고 바로 업로드합니다. 공유 링크는 클립보드에 복사됩니다.
Windows용 Maxisnap과 Mac용 Maxisnap은 각 업로드를 Cloudflare Studio에 요청 한 번으로 보내며, Cloudflare Studio는 파일당 최대 25 MB까지 받습니다.
다음 단계: 대시보드의 People & access에서 팀원을 추가하세요(모든 팀원이 각자의 코드와 역할을 받습니다). 로고나 색상은 Branding에서 언제든 바꿀 수 있습니다.
문제가 생겼을 때
Cloudflare가 먼저 이메일 인증을 요구합니다
Cloudflare needs you to verify your email address first. Check your inbox for Cloudflare’s email, click the link, then try again.
가입할 때 Cloudflare가 보낸 이메일을 열고 링크를 클릭하세요. 받은 편지함에 없으면 스팸 메일함을 확인하세요. 그런 다음 같은 단계를 다시 시도하세요.
Cloudflare가 새 계정을 아직 검토하고 있습니다
Cloudflare is still reviewing this new account. This usually clears within a day; try again later.
Cloudflare는 일부 새 계정을 확인한 뒤에야 무언가를 만들 수 있게 합니다. 설정에는 문제가 없습니다. 기다린 다음 다시 시도하세요. 이미 만들어진 것은 그대로 유지됩니다.
스토리지가 켜져 있지 않습니다
R2 storage is not turned on for this Cloudflare account yet.
2단계에서 한 것처럼 Cloudflare 대시보드에서 R2를 켠 다음, 어시스턴트에게 실행 계획을 다시 만들도록 요청하세요.
Cloudflare가 카드 또는 PayPal을 요구합니다
정상입니다. 무료 사용량 범위 안에서 쓰더라도 Cloudflare가 R2를 켜기 전에 카드 또는 PayPal을 요구할 수 있습니다. Studio 대시보드에 사용 중인 스토리지 용량이 표시되므로 계속 확인할 수 있습니다.
Studio 이름이 이미 사용 중입니다
A Worker named “snaps” already exists in this account. Pick another name; Studio never replaces someone else’s Worker.
어시스턴트에게 snaps-yourcompany 같은 다른 이름을 알려 주세요. 스토리지나 데이터베이스 이름이 이미 사용 중이면 배포 도구가 다음으로 사용 가능한 이름을 알아서 고릅니다.
workers.dev 이름이 이미 사용 중입니다
That workers.dev name is taken. Pick another one.
다른 사람이 이미 그 이름을 사용하고 있습니다. 회사 이름에 단어를 붙여 yourcompany-studio처럼 시도해 보세요. 이 이름은 이 Cloudflare 계정의 모든 주소에 포함되므로 계속 써도 좋은 이름을 고르세요.
Cloudflare가 한 단계를 거부했습니다
Cloudflare refused this step: the connection does not have permission for it. Reconnect Cloudflare and approve every permission Studio asks for.
토큰에 권한 하나가 빠져 있습니다. 5단계의 권한으로 새 토큰을 만들고, 어시스턴트가 요청하면 터미널에 다시 붙여넣으세요.
설정이 중간에 멈췄습니다
어시스턴트에게 같은 배포 명령을 다시 실행하도록 요청하세요. 이 명령은 멈춘 지점부터 이어서 진행하며 아무것도 두 번 만들지 않습니다.
새 주소가 아직 열리지 않습니다
Studio did not come online in time (HTTP 404). Cloudflare can take a few minutes to publish a new address; try again shortly.
모든 항목은 만들어졌고, Cloudflare가 아직 주소를 켜는 중입니다. 몇 분 기다린 다음 주소를 다시 여세요.
관리자 키를 잃어버렸습니다
어시스턴트가 새 키를 설정할 수 있습니다. 어시스턴트는 Studio 다운로드의 cloudflare 폴더에서, 터미널에 Cloudflare 토큰을 입력한 상태로 이 명령을 실행합니다. 이 명령은 새 키를 한 번만 보여 줍니다. 그런 다음 그 키로 Maxisnap을 다시 연결하세요.
node deploy/cli.mjs update --record deployment.json --yes --new-admin-key큰 동영상이 업로드되지 않습니다
Windows용 Maxisnap과 Mac용 Maxisnap은 각 업로드를 Cloudflare Studio에 요청 한 번으로 보내며, Cloudflare Studio는 파일당 최대 25 MB까지 받습니다.
녹화 영상은 그 크기 이하로 유지하거나, 업로드하기 전에 길이를 줄이세요.
Maxisnap에서 키가 올바르지 않다고 합니다
저장해 둔 곳에서 키를 앞뒤 공백 없이 다시 복사하세요. 주소도 확인하세요. 설정할 때 표시된 주소이며, 다음 문자로 시작합니다: https://.
공유 링크에 “Error 1027”이 표시됩니다
Studio가 Cloudflare 무료 요금제의 하루 요청 한도에 도달했습니다. 한도는 UTC 자정에 초기화됩니다. 공유 링크를 한 번 열 때 요청이 약 두 건 사용됩니다.
그래도 해결되지 않나요?
이메일로 문의해 주시면 담당자가 보통 영업일 기준 하루 안에 답장해 드립니다. 아래 정보를 함께 보내 주시면 한 번에 답변해 드릴 수 있습니다:
- 선택한 설정 방법과 현재 진행 중인 단계.
- 화면 스크린샷(오류 메시지가 있다면 전체 내용이 보이게).
- Studio를 설치할 위치: 새 Cloudflare 계정 또는 기존 Cloudflare 계정, 또는 웹 호스팅 업체 이름.
- Maxisnap 버전: Windows에서는 설정 → 정보에서, Mac에서는 Maxisnap → About Maxisnap에서 확인할 수 있습니다.
관리자 키, Cloudflare 키, 비밀번호는 보내지 말아 주세요. 도움을 드리는 데 필요하지 않습니다.