본문으로 건너뛰기

[Claude Code] 코드 모르는 내가 내 사이트에 인터넷 데이터베이스를 붙였다 — 방문자가 글을 남기는 방명록 만들기

Joan

2026.08.11

📝 한줄 요약

내 웹사이트에 방명록을 붙였습니다. 방문자가 이름과 메시지를 남기면 인터넷 너머 데이터베이스에 저장됩니다. 제가 한 일은 값 두 개 붙여넣기, 그리고 시험 삼아 글 한 줄 남기기가 전부였습니다.

바쁘시면 이것만:

  • 비밀번호를 붙여넣었더니 AI가 먼저 검사했습니다 — "위험한 키를 잘못 보내신 건 아닌지" 열어서 확인

  • 또 마스터 프롬프트와 내 상황이 달랐고, AI가 설치를 시작하기 전에 알려줬습니다

  • AI가 "이건 확인 안 했습니다"라고 솔직하게 말했습니다 — 확인하려면 제 글을 진짜로 지워봐야 해서

  • 가장 헷갈렸던 것: 비밀번호 넣는 칸이 세 개고, 넣기만 해서는 반영이 안 된다는 것

  • 결과: 누구나 글을 남길 수 있지만 아무도 남의 글을 고치거나 지울 수 없는 방명록

🎯 이런 분들께 도움돼요

  • 같은 스터디의 비개발 참가자 — Supabase 미션을 받았는데 어디서부터 손대야 할지 막막한 분

  • 내 사이트에 "저장되는 기능"을 넣고 싶은 분 — 신청 폼, 후기, 문의 같은 것

  • 비밀번호(API 키) 다루는 게 무서운 분 — 실수로 인터넷에 올려버릴까 봐 손이 안 가는 분

😫 문제 상황 (Before)

지난주까지 만든 건 내 기록만 보는 사이트였습니다. 일정과 건강을 적으면 그래프가 나오고, 폰 홈화면에 앱처럼 올려두고 쓰는 것까지 했죠.

그런데 링크를 남에게 보내면 그 사람은 텅 빈 화면을 봅니다. 남길 말이 있어도 남길 데가 없고요.

이게 이번 스터디 미션이기도 했습니다. Supabase라는 인터넷 데이터베이스를 붙여 방명록을 만드는 것. 저는 데이터베이스가 뭔지도 잘 몰랐습니다.

🛠️ 사용한 도구

Claude Code (Opus 5) + Supabase. 터미널 명령과 코드는 전부 AI가 실행하고, 저는 값 붙여넣기와 확인만 했습니다.


🔧 작업 과정

1. 또 프롬프트와 내 상황이 달랐다

마스터 프롬프트 첫 줄이 이랬습니다.

"이 폴더는 지난주에 만든 my-dashboard 프로젝트다. Next.js + TypeScript + Tailwind로 되어 있고…"

그런데 AI가 부품 설치를 시작하지 않고 먼저 폴더를 열어보더니말했습니다.

프롬프트에는 "Next.js 프로젝트"라고 적혀 있는데, 확인해보니 이 폴더는 그게 아닙니다. 비유하자면 — 자전거에 자동차 엔진 부품을 주문한 상황입니다. 부품이 나쁜 게 아니라, 달 자리가 없습니다.

지난주에 제가 "새로 만들지 말고 기존 걸 쓰자"고 정했기 때문에 생긴 차이였습니다. 그대로 설치했으면 부품이 겉돌았을 겁니다.

배울 내용(데이터베이스 연동, 비밀번호 관리, 문단속)은 하나도 안 빠진다고 해서 기존 사이트에 붙이기로 했습니다.


2. 비밀번호를 붙여넣었더니, 저장하기 전에 검사했다

AI가 값을 한 번에 하나씩 물어봤습니다. 먼저 주소, 저장한 다음에 비밀번호. 그리고 비밀번호를 물을 때 경고를 먼저 줬습니다.

⚠️ 같은 화면에 service_role 이라고 적힌 키도 보일 겁니다. 그건 절대 보내지 마세요. 모든 문단속을 무시하고 데이터를 지울 수 있는 마스터 키입니다.

제가 키를 붙여넣자, 바로 저장하지 않고 검사부터 했습니다.

정말 anon 키가 맞는지 먼저 확인하고 저장하겠습니다.

이 키의 권한 등급: anon
→ anon 키가 맞습니다. 마스터 키 아님 ✓

이게 제일 인상 깊었습니다. 저는 "이거 맞겠지" 하고 보낸 건데, AI는 그 긴 문자열을 실제로 열어서 안에 뭐라고 적혀 있는지 읽고확인했습니다. 주소와 키가 같은 프로젝트를 가리키는지까지 대조했고요.

저 혼자 했으면 그냥 붙여넣고 넘어갔을 거예요.


3. 안 되는 게 두 번 나왔는데, 에러를 볼 일이 없었다

방명록을 만들고 열어봤더니 두 가지가 안 됐습니다. AI가 영어 에러 대신 이렇게 정리해줬습니다.

문제

원인

어떻게 고쳤나

방명록 주소가 안 열림

주소 뒤에 .html을 붙여야만 열리는 설정이었음

설정을 바꿔 .html 없이도 열리게

방명록이 비밀번호를 못 찾음

비밀번호 적은 파일은 다른 방식의 프로젝트가 읽는 파일이었음

Vercel 쪽에 등록하고 서버 재시작

두 번째가 새로웠습니다. 저는 비밀번호를 파일에 적으면 끝인 줄 알았거든요.

비슷한 맥락으로, AI가 프롬프트를 하나 어기기도 했습니다. 이름 앞에 NEXT_PUBLIC_을 붙이라고 돼 있었는데 안 붙이고는 이유를 설명했습니다.

NEXT_PUBLIC_은 "이 값은 방문자 브라우저에 노출된다" 는 표시입니다. 그런데 우리는 브라우저가 아니라 서버가 데이터베이스에 접속하므로, 붙이면 사실과 다른 표시가 됩니다.

"이 이름표는 장식이 아니라 사실을 적는 칸이구나" 하고 이해가 됐습니다.


4. 직접 글을 남겨봤고, AI는 "확인 안 한 것"을 말했다

AI가 알려준 주소로 들어가 이름과 메시지를 적고 눌렀더니 바로 목록에 떴습니다.

글이 목록에 떴어

그런데 여기서 예상 못 한 말을 들었습니다.

하나 솔직하게 말씀드릴 게 있습니다. "수정·삭제가 막혀 있는지"는 제가 확인하지 않았습니다. 확인하려면 실제 글을 지워봐야 하는데, 문단속이 안 걸려 있으면 님의 글이 진짜로 지워집니다.

"다 됐습니다"라고 했으면 저는 그냥 믿었을 겁니다. 확인 안 한 걸 확인 안 했다고 말해준 게 오히려 신뢰가 갔습니다.

그리고 올리기 전에는 비밀번호가 딸려 올라가지 않는지 세 가지를 검사했습니다 — 올릴 목록에 있나, 이미 올라가 있나, 과거 이력에 한 번이라도 올라간 적 있나. 세 번째가 왜 중요한지도 알려줬습니다.

한 번이라도 올라갔다면 파일을 지워도 이력에는 남습니다. 그런 경우엔 그 키를 폐기하고 새로 발급해야 합니다.

마지막으로 문단속(RLS)을 확인해야 했는데, 저는 어느 메뉴에 뭐가 있는지 몰랐습니다. "supabase 어디서 봐야해?" 라고 하니 볼 곳을 알려주고 브라우저로 직접 열어줬습니다.

확인할 것은 세 가지였고, 셋째가 제일 헷갈렸습니다.

확인할 것

정상이면

문단속이 켜져 있나

RLS enabled 표시

규칙이 2개인가

읽기 하나, 쓰기 하나

수정·삭제 규칙이 없나

하나도 없어야 정상

규칙에 안 적힌 행동은 전부 거부됩니다. 그래서 수정·삭제 규칙을 안 만든 게 곧 문단속입니다.

"규칙을 안 만드는 게 곧 금지" — 오늘 배운 것 중 제일 신기했습니다.

✅ 결과 (After)

항목

Before

After

남이 내 사이트에 오면

빈 화면만 보임

글을 남길 수 있음

저장되는 곳

내 기기 안에만

인터넷 데이터베이스

남의 글 고치기·지우기

—

아무도 못 함 (나도 화면에서는 못 지움)

방문자가 받는 파일에 비밀번호

—

없음 (확인 완료)

/guestbook 에서 이름과 메시지를 남기면 최신순으로 쌓입니다. 메인 화면 맨 아래 "방명록" 링크로도 갈 수 있습니다.

💬 배운 AI 활용 팁

효과적이었던 것

  1. 비밀번호를 보낼 때는 "이거 맞는지 확인해줘"라고 하기. 저는 붙여넣기만 했는데 AI가 열어서 확인해줬습니다. 안 해주면 요청하면 됩니다.

  2. "어디서 보는지 모르겠어"라고 그냥 말하기. 화면 위치를 모르는 건 코드를 모르는 것과 다른 문제고, 물어보면 브라우저까지 열어줍니다.

  3. 모르는 용어가 나오면 바로 "쉽게 말해줘". 환경변수, RLS, 정책을 하나도 몰랐는데 매번 비유로 설명해줘서 끝까지 따라갔습니다.

이렇게 하면 안 돼요

  1. 비밀번호를 두 개 다 보내지 마세요. anon과 service_role 중 anon만 보내면 됩니다. 헷갈리면 "어느 게 맞는지 모르겠어"라고 물어보세요.

  2. "파일에 적었으니 됐겠지" 하고 넘어가지 마세요. 적는 것과 반영되는 것은 다릅니다. 칸이 세 개인 것도, 등록 후 다시 배포해야 하는 것도 몰랐습니다.

  3. "됐어" 하기 전에 진짜로 눈으로 보세요. 직접 글을 남겨보고 목록에 뜨는 걸 확인했습니다.

🌍 다른 업무에 적용한다면?

  • 신청 폼 / 설문 / 후기 받기 — "방명록"을 "신청서"로 바꾸면 그대로입니다.

  • "누가 뭘 할 수 있는지" 정해야 할 때 — 공유 문서나 팀 폴더 권한도 "허용할 것만 적고 나머지는 비워두는" 방식이 안전합니다.

🚀 앞으로의 계획

  • 광고 글 막기 — 지금은 누구나 무제한으로 쓸 수 있어서, 쌓이면 막는 방법을 붙이려고 합니다.

  • 기록부 본체로 돌아가기 — 실제 일정을 채워 쓰면서 알림과 입력 단순화를 해보려고 합니다.

📋 재사용 가능한 프롬프트

프롬프트 1: 비밀번호(API 키) 안전하게 넘기기

[서비스 이름]의 키를 알려줄 건데, 넘기기 전에 이것부터 알려줘.

  1. 이 값이 어디에 저장되고 왜 안전한지 한 줄로

  2. 이 서비스에 위험한 키와 안전한 키가 따로 있는지, 있다면 어떻게 구분하는지

그리고 내가 값을 보내면 바로 저장하지 말고 먼저 검사해줘. 권한이 너무 센 키를 잘못 보낸 건 아닌지 확인하고 알려줘. 키는 절대 코드에 직접 적지 말고, 코드에는 "설정에서 꺼내 쓰라"고만 적어줘.

올리기 전에는 이 키가 GitHub에 딸려 올라가지 않는지 세 가지를 다 검사해줘 — 올릴 목록에 있는지, 이미 올라가 있는지, 과거 이력에 한 번이라도 올라간 적 있는지. 마지막 게 걸리면 파일을 지워도 소용없으니 키를 폐기하고 새로 발급해야 한다고 알려줘.

프롬프트 2: 확인 안 한 것을 솔직하게 받기

다 됐다고 말하기 전에, 실제로 확인한 것과 확인하지 못한 것을 나눠서 알려줘.

  • 확인한 것은 어떻게 확인했는지 근거와 함께

  • 확인 못 한 것은 왜 못 했는지 이유와 함께

  • 확인하려다 내 데이터가 지워지거나 망가질 위험이 있으면, 하지 말고 나에게 먼저 말해줘

1

함께 이야기해요 1

로그인하고 댓글을 남겨 주세요

김미르사 프로필 이미지
김미르사2026.08.11

글 잘봤구요 위에 글중에 이런 내용이 좋네요 " 수정삭제가 막혔는지 제가 확인 하지 않았습니다,

"다 됐습니다"라고 했으면 저는 그냥 믿었을 겁니다. 확인 안 한 걸 확인 안 했다고 말해준 게 오히려 신뢰가 갔습니다."

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기