[PASEO] 학습자 반응을 듣고 싶어서, 정적 사이트에 DB를 붙였다
2026.10.22
📝 한줄 요약
화면만 보여 주던 정적 퀴즈앱에 Supabase를 연결해, 학습자가 점수와 후기를 남기는 방명록을 오후 반나절 만에 열었습니다. Supabase는 이번에 처음 가입했는데, 보안 리뷰와 QA까지 마친 뒤 공개했습니다.
바쁘시면 이것만 읽어도 돼요:
목표: Claude Code로 정적 퀴즈앱을 데이터가 쌓이는 동적 사이트로 바꾸기. Supabase 첫 가입부터 배포까지 반나절 걸림
깨달은 점: 정적 사이트도 Supabase 같은 DB를 붙이면 방문자 데이터를 저장하고 보여 줄 수 있음
처음 알게 된 것: "anon 키"는 브라우저에 공개돼도 괜찮은 키. 무엇을 허용할지는 DB의 접근 정책이 정함
인상적인 순간: Claude가 에러 메시지 한 줄을 보고 "다른 프로젝트에서 실행하고 계신 것 같다"며 원인을 바로 짚음
재사용성: 코드가 GitHub에, 사이트가 Vercel에 있어서 퀴즈앱을 만든 PC가 아니어도 고치고 배포할 수 있었음
교훈: 만들고 끝내지 말고 "보안 리뷰랑 QA 해줘"를 꼭 요청하기. 이 한마디로 공개 전에 허점 4건을 잡음
PASEO를 써서 클로드만 쓸 때보다 더 빠르게 작업이 진행된 점 (비교는 못했음 ^^;)
🎯 이런 분들께 도움돼요
GitHub·Vercel로 정적 사이트를 배포해 봤고, 이제 데이터를 저장하는 기능을 붙여 보고 싶은 비개발자
퀴즈나 강의 자료를 공개했는데, 학습자 반응을 받을 방법이 없어 아쉬운 교육 콘텐츠 운영자
😫 문제 상황 (Before)
광고Biz 학습용 퀴즈앱을 만들어 공개해 두었습니다. 모듈 퀴즈, 오답 복습, 진단, 계산 연습까지 있는 앱인데, 한 가지가 계속 아쉬웠습니다. 누가 풀었는지, 풀고 나서 어떻게 느꼈는지 들을 방법이 없었습니다.
퀴즈앱은 정적 사이트입니다. 미리 만들어 둔 화면을 보여 주기만 할 뿐, 학습자가 무언가를 남기면 저장할 곳이 없습니다. 후기를 받으려면 데이터를 저장하는 곳, 즉 DB가 필요했습니다.
문제는 제가 DB를 다뤄 본 적이 없다는 점이었습니다. Supabase라는 이름은 들어 봤지만 가입도 안 해 본 상태였습니다.
🛠️ 사용한 도구
도구명: Claude Code (Windows PC), Paseo (퀴즈앱을 만든 맥미니)
모델: Claude Opus, Claude Sonnet
서비스: Supabase (DB), GitHub (코드 보관), Vercel (배포)
특이사항: Claude in Chrome으로 실제 브라우저를 조작해 QA를 진행
🔧 작업 과정
PASEO를 써서 계획부터 세우고, AI 여러 명에게 일을 나눴다
먼저 방명록을 퀴즈앱과 별도의 작은 앱으로 만들기로 했습니다. 퀴즈를 마친 학습자가 버튼을 누르면 방명록이 열리고, 맞힌 개수가 "15 / 20" 같은 점수 배지로 함께 표시되는 구조입니다.
Claude와 함께 "계약서"부터 썼습니다. DB에는 어떤 칸이 있고, 화면은 어떤 데이터를 주고받는지 미리 정해 둔 문서입니다. 그다음 DB, 데이터 처리, 화면을 세 명의 AI 에이전트에게 나눠 맡겼습니다. 각 에이전트에게는 브랜치 이름 한 단어만 입력했습니다.
guestbook-lib
계약서가 있으니 세 에이전트가 같은 시간에 따로 작업해도 결과물이 서로 잘 맞물렸습니다. 한 에이전트는 다른 에이전트와 같은 폴더를 쓰다 부딪히는 걸 알아채고, 스스로 작업 폴더를 따로 만들어 피하기도 했습니다.
Supabase 첫 가입, 화면을 보며 하나씩 따라 했다
코드가 다 합쳐지고 나니 진짜 DB가 필요했습니다. 처음이라 방법부터 물었습니다.
Supabase 프로젝트 설정 방법 알려줘. 이 프로젝트에서 진행하는 방법과 비교해줘
Claude는 두 가지 방법을 비교해 줬습니다. 하나는 웹 대시보드에서 클릭으로 하는 방법이고, 다른 하나는 터미널 명령어로 하는 방법입니다. 저는 화면을 보며 따라 할 수 있는 대시보드 방식을 골랐습니다.
안내는 정말 단계별이었습니다. 프로젝트 이름은 무엇으로 하고 지역은 서울로 고르라는 것부터, Claude가 만든 DB 설정을 SQL Editor라는 메뉴에 붙여 넣고 실행하는 것까지 알려줬습니다. 제대로 됐는지 확인하는 것도 막막해서 다시 물었습니다.
프로젝트 만들고 진행했어. Table Editor에 guestbook_entries가 생기고 RLS가 켜져 있는지 확인하는 법 알려줘.
"테이블 이름 옆에 주황색 Unrestricted 표시가 없으면 보안이 켜진 상태"처럼, 화면에서 무엇을 보면 되는지 콕 집어 알려줬습니다.
anon 키를 처음 알게 됐다
DB를 앱에 연결하려면 키가 필요했습니다. 여기서 처음 알게 된 것이 anon 키(요즘은 publishable 키라고도 부릅니다)입니다.
처음에는 "키를 사이트에 넣어도 되나?" 하고 걱정했습니다. Claude의 설명은 이랬습니다.
anon 키: 원래 브라우저에 공개되는 키입니다. 이 키로 무엇을 할 수 있는지는 DB의 접근 정책(RLS)이 정합니다. 이번 방명록은 "읽기와 쓰기만 허용하고, 수정·삭제는 막기"로 정해 두었습니다.
service_role 키: 모든 것을 할 수 있는 관리자 키입니다. 절대 보내지 마세요.
키를 넣자 Claude는 연결만 확인하고 끝내지 않았습니다. 방문자 권한으로 글 삭제를 시도해 보고, 숨김 글 쓰기도 시도해 봤습니다. 둘 다 "권한 없음"으로 거부되는 것까지 확인해 줬습니다. 보안 설정이 실제로 동작하는지 눈으로 확인하니 그제야 안심이 됐습니다.
GitHub와 Vercel 배포, 그리고 두 번 헷갈린 순간
로컬에서 글쓰기가 잘 되는 걸 확인하고 배포를 요청했습니다.
글쓰기 잘 돼, GitHub push랑 Vercel 배포 진행해줘
Claude는 진행 전에 두 가지를 물었습니다. 저장소를 공개로 할지 비공개로 할지, 그리고 Vercel 배포를 대시보드에서 할지 명령어로 할지였습니다. 비공개, 대시보드로 골랐습니다.
첫 번째로 막힌 곳은 GitHub 로그인이었습니다. 웹사이트에는 로그인돼 있었으니 당연히 될 줄 알았는데, Claude가 "터미널에서는 로그인이 안 된 상태"라고 알려줬습니다. 웹사이트 로그인과 터미널 로그인은 별개라는 걸 이때 처음 알았습니다. Claude가 알려준 대로 Claude Code 창에서 직접 로그인 명령을 한 번 실행하니, 그다음부터는 저장소 생성과 업로드를 Claude가 알아서 했습니다. 비밀 키가 담긴 파일이 실수로 올라가지 않았는지도 확인해 줬습니다.
두 번째는 배포 주소였습니다. Vercel에서 프로젝트 이름을 바꾸고 바뀐 주소라며 알려줬는데, 알고 보니 사이트 주소가 아니라 Vercel 관리 화면 주소였습니다. Claude는 "프로젝트 이름을 바꿔도 사이트 주소는 그대로이고, 주소를 바꾸려면 Domains 설정에서 추가해야 한다"고 차이를 설명해 줬습니다.
"보안 리뷰랑 QA 해줘" 한마디가 허점 4개를 잡았다
배포까지 끝나니 그냥 공개하고 싶은 마음이 컸습니다. 그래도 계획에 넣어 둔 단계라 요청했습니다.
보안 리뷰랑 QA 진행해줘
이 요청이 이번 작업에서 가장 잘한 결정이었습니다.
보안 리뷰에서는 심각한 문제는 없었지만, 중요한 허점이 하나 나왔습니다. 글을 30초에 한 번만 쓰게 막아 두었는데, 이 기록이 브라우저에만 저장돼 있었던 겁니다. 시크릿 창을 열면 바로 뚫리는 구조였습니다. anon 키는 공개된 키라서, 마음먹으면 누구나 글을 마구 넣을 수도 있었습니다.
QA는 Claude가 실제 Chrome 브라우저를 직접 조작해서 진행했습니다. 정상 작성, 빈 값, 글자 수 초과, 이모지, 휴대폰 화면 폭까지 하나씩 눌러 보더니 문제를 찾아냈습니다.
버튼을 아주 빠르게 3번 누르면 같은 글이 3건 저장됨
이모지 3개를 쓰면 글자 수가 "6 / 200"으로 표시됨
iPhone에서 입력칸을 누르면 화면이 저절로 확대됨
응 4가지 수정하고 push해줘
수정할 때 인상적인 부분이 있었습니다. 처음 제안은 "같은 IP에서 30초에 1건"이었는데, Claude가 먼저 문제를 짚었습니다. 강의장처럼 여러 명이 같은 인터넷 회선을 쓰면 수강생끼리 서로 막힌다는 것입니다. 그래서 "같은 IP에서 1분에 10건, 전체 1분에 200건"으로 한도를 바꿨습니다. 교육용 사이트라는 맥락을 반영한 결정이었습니다.
수정이 끝나자 Claude는 배포된 사이트에서 다시 브라우저를 조작해 확인했습니다. 연타해도 1건만 저장되고, 이모지 3개는 "3 / 200"으로 표시됐습니다.
에러 메시지 한 줄로 원인을 찾았다
DB에 새 설정을 적용하고, 잘 들어갔는지 확인하는 단계에서 에러가 났습니다. 처음에는 "에러가 났"까지만 보냈는데, Claude가 에러 메시지 전문을 달라고 했습니다. 받은 그대로 붙여넣었습니다.
Failed to run sql query: ERROR: 42P01: relation "public.guestbook_entries" does not exist
"방명록 테이블이 없다"는 뜻의 에러입니다. Claude는 방금 전까지 그 테이블에서 글을 읽어 왔으니 테이블이 없을 리 없다고 판단했습니다. 그리고 SQL Editor가 방명록이 아닌 다른 Supabase 프로젝트에 열려 있는 것 같다고 짚었습니다. 확인해 보니 정말 그랬습니다. 주소창의 프로젝트 ID를 보고 올바른 프로젝트로 바꾸는 방법까지 알려줘서, 다시 실행하자 바로 성공했습니다.
만든 PC가 아니어도 퀴즈앱을 고칠 수 있었다
마지막 단계는 퀴즈앱에서 방명록으로 이어지는 길을 만드는 것이었습니다.
퀴즈앱 링크 연결도 진행해줘
그런데 퀴즈앱은 맥미니에서 만든 앱이었고, 지금 작업하는 PC는 회사 Windows PC였습니다.
내가 퀴즈앱은 맥미니의 paseo에서 진행했어. 그래서 이 PC에서는 테스트가 안되는 것 같네. github.com 과 vercel 에 바로 수정하는 것은 안될까?
Claude의 답은 이랬습니다. "이미 그 방식으로 반영돼 있습니다." 퀴즈앱 코드가 GitHub에 있으니 이 PC로 받아 와서 고치면 되고, 고친 코드를 GitHub에 올리면 Vercel이 자동으로 다시 배포합니다. Vercel은 배포 전에 테스트를 돌리기 때문에, 문제가 있으면 배포가 멈추고 기존 사이트가 그대로 유지됩니다.
코드를 GitHub에, 사이트를 Vercel에 올려 둔 덕분에 어느 PC에서든 이어서 작업할 수 있었습니다. 저에게는 이번 작업에서 가장 의미 있는 깨달음 중 하나였습니다.
이렇게 모든 퀴즈 결과 화면에 "방명록에 후기 남기기" 버튼을 달았습니다. 20문제 중 15개를 맞히면 방명록에 "15 / 20" 배지가 붙어서 열립니다. 홈 화면 맨 아래에도 방명록 안내를 추가했습니다.
✅ 결과 (After)
Before vs After
항목 | Before | After |
|---|---|---|
사이트 종류 | 화면만 보여 주는 정적 사이트 | 학습자 글이 저장되고 공유되는 동적 사이트 |
학습자 반응 | 받을 방법 없음 | 퀴즈 결과 화면에서 바로 점수와 후기 남김 |
Supabase 경험 | 가입도 안 해 봄 | 가입, DB 생성, 보안 설정, 키 관리까지 직접 진행 |
공개 전 점검 | 계획 없음 | 보안 리뷰와 QA로 허점 4건 발견·수정 |
소요 시간 | - | 오후 반나절 (보안 점검·퀴즈앱 연결 포함) |
작업 환경 | 퀴즈앱을 만든 맥미니에서만 작업 가능하다고 생각함 | GitHub·Vercel 덕분에 다른 PC에서도 수정·배포 |
결과물
퀴즈앱 결과 화면의 "방명록에 후기 남기기" 버튼
점수 배지가 붙은 방명록 화면
가장 큰 변화는 자신감입니다. "정적 사이트도 DB를 붙이면 데이터를 저장할 수 있다"는 걸 직접 해 보고 나니, 다른 사이트에도 같은 방식으로 기능을 붙일 수 있겠다는 생각이 들었습니다.
💬 이 과정에서 배운 AI 활용 팁
효과적이었던 것
만들고 끝내지 말고 "보안 리뷰랑 QA 해줘"를 요청하세요. 잘 돌아가는 것처럼 보여도 시크릿 창 우회나 연타 중복 저장 같은 허점이 숨어 있었습니다. 한 줄 요청으로 공개 전에 잡았습니다.
처음 쓰는 서비스는 "대시보드 화면 기준으로 알려줘"라고 하세요. 어떤 메뉴를 누르고 무엇을 확인하면 되는지까지 알려줘서, 처음인데도 따라 할 수 있었습니다.
AI가 키를 요청하면 어떤 키를 줘야 하는지부터 확인하세요. anon 키처럼 공개돼도 되는 키가 있고, service_role 키처럼 절대 공개하면 안 되는 키가 있습니다.
코드는 GitHub에, 사이트는 Vercel에 올려 두세요. 어느 PC에서든 AI가 받아 와서 고치고 배포할 수 있습니다.
이렇게 하면 안 돼요
"에러 났어"만 보내지 마세요. 에러 메시지 전문을 그대로 붙여넣어야 AI가 원인을 찾을 수 있습니다.
웹사이트에 로그인했다고 터미널도 로그인된 건 아닙니다. GitHub처럼 터미널 로그인이 따로 필요한 경우가 있습니다.
Vercel 관리 화면 주소와 사이트 주소를 헷갈리지 마세요. 프로젝트 이름을 바꿔도 사이트 주소는 그대로입니다.
🌍 다른 업무에 적용한다면?
강의 자료 사이트: 수강생 질문 게시판이나 강의 만족도 설문을 붙일 수 있습니다.
행사·세미나 안내 페이지: 참가 신청이나 후기 남기기 기능을 붙일 수 있습니다.
포트폴리오 사이트: 방문자 방명록이나 문의 남기기 기능을 붙일 수 있습니다.
정적 사이트에 "방문자가 무언가를 남기는 기능"이 필요하다면 모두 같은 방식으로 할 수 있습니다.
🚀 앞으로의 계획
이번에 익힌 방식을 다른 정적 사이트에도 적용해 볼 계획입니다. 우선 강의 자료 사이트에 질문 게시판이나 설문을 붙여, 수강생과 주고받을 수 있는 창구를 늘려 보려고 합니다.
📋 재사용 가능한 프롬프트
프롬프트 1: 정적 사이트에 방명록(데이터 저장 기능) 붙이기
[내 사이트 이름]은 GitHub에 있고 Vercel로 배포된 정적 사이트야. 방문자가 [닉네임과 후기]를 남기고 다른 사람 글도 볼 수 있는 [방명록]을 Supabase로 만들고 싶어. 나는 Supabase가 처음이야. 방문자는 읽기와 쓰기만 할 수 있고 수정·삭제는 못 하게 해줘. 만들기 전에 어떤 순서로 진행할지 먼저 설명해줘.
프롬프트 2: 처음 쓰는 서비스 설정 안내받기
[Supabase] 프로젝트 설정 방법 알려줘. 웹 대시보드에서 하는 방법과 이 프로젝트에서 명령어로 하는 방법을 비교해줘. 나는 처음이라 화면 기준으로, 무엇을 누르고 무엇을 확인하면 되는지까지 알려줘.
프롬프트 3: 공개 전 보안 리뷰와 QA
배포된 [사이트 주소]의 보안 리뷰랑 QA 진행해줘. 보안은 공개된 키로 할 수 있는 일, 도배 방지 허점, 입력값 검증을 봐줘. QA는 정상 작성, 빈 값, 글자 수 초과, 이모지, 버튼 연타, 휴대폰 화면 폭을 실제로 눌러 보고, 문제는 심각도별로 정리해줘.
프롬프트 4: 다른 PC에서 만든 사이트에 기능 연결하기
[기존 사이트]는 다른 PC에서 만들었지만 GitHub [저장소 이름]에 있고 Vercel로 배포돼 있어. 이 PC에서 받아 와서 [결과 화면]에 [방명록으로 가는 버튼]을 추가하고 배포까지 해줘. 주소는 나중에 바꾸기 쉽게 한 곳에서만 관리해줘.
로그인하고 댓글을 남겨 주세요
DB를 다뤄 본 적 없는 상태에서 반나절 만에 정적 퀴즈앱에 방명록을 붙이신 기록이라 따라 해 보고 싶어져요. 계약서(DB 칸과 데이터 구조)를 먼저 쓰고 세 에이전트에게 나눠 맡겼더니 결과물이 서로 맞물렸다는 대목이 인상 깊었어요.
"anon 키를 사이트에 넣어도 되나?"라는 걱정을 접근 정책 설명으로 풀어낸 부분과, "보안 리뷰랑 QA 해줘" 한마디로 공개 전에 허점 4건을 잡은 교훈이 초보자에게 특히 도움이 될 것 같아요.
꼬리 살랑살랑, 응원하고 갈게요 🐈⬛

![[Paseo + Claude Code] 만들어 둔 리센느빵 테트리스 세션을 그대로 이어받아, 메뉴·2인 대전·배경음악·효과음까지 한 번에 붙였다 썸네일](/_next/image?url=https%3A%2F%2Fcdn-beta.gpters.org%2Fexternal%2Fdfa7f86bd93d21caba20bf53.jpg&w=3840&q=75)


정적 퀴즈앱에 Supabase와 방명록을 붙이고, anon 키와 RLS부터 실제 연타 QA까지 확인한 흐름이 이해하기 쉬웠어요. 공개 전에 보안 리뷰 한 번으로 허점 4개를 잡은 부분이 특히 실용적이네요.