[Claude Code] 코드 모르는 내가 내 사이트에 인터넷 데이터베이스를 붙였다 — 방문자가 글을 남기는 방명록 만들기
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가 영어 에러 대신 이렇게 정리해줬습니다.
문제 | 원인 | 어떻게 고쳤나 |
|---|---|---|
방명록 주소가 안 열림 | 주소 뒤에 | 설정을 바꿔 |
방명록이 비밀번호를 못 찾음 | 비밀번호 적은 파일은 다른 방식의 프로젝트가 읽는 파일이었음 | Vercel 쪽에 등록하고 서버 재시작 |
두 번째가 새로웠습니다. 저는 비밀번호를 파일에 적으면 끝인 줄 알았거든요.
비슷한 맥락으로, AI가 프롬프트를 하나 어기기도 했습니다. 이름 앞에 NEXT_PUBLIC_을 붙이라고 돼 있었는데 안 붙이고는 이유를 설명했습니다.
NEXT_PUBLIC_은 "이 값은 방문자 브라우저에 노출된다" 는 표시입니다. 그런데 우리는 브라우저가 아니라 서버가 데이터베이스에 접속하므로, 붙이면 사실과 다른 표시가 됩니다.
"이 이름표는 장식이 아니라 사실을 적는 칸이구나" 하고 이해가 됐습니다.
4. 직접 글을 남겨봤고, AI는 "확인 안 한 것"을 말했다
AI가 알려준 주소로 들어가 이름과 메시지를 적고 눌렀더니 바로 목록에 떴습니다.
글이 목록에 떴어
그런데 여기서 예상 못 한 말을 들었습니다.
하나 솔직하게 말씀드릴 게 있습니다. "수정·삭제가 막혀 있는지"는 제가 확인하지 않았습니다. 확인하려면 실제 글을 지워봐야 하는데, 문단속이 안 걸려 있으면 님의 글이 진짜로 지워집니다.
"다 됐습니다"라고 했으면 저는 그냥 믿었을 겁니다. 확인 안 한 걸 확인 안 했다고 말해준 게 오히려 신뢰가 갔습니다.
그리고 올리기 전에는 비밀번호가 딸려 올라가지 않는지 세 가지를 검사했습니다 — 올릴 목록에 있나, 이미 올라가 있나, 과거 이력에 한 번이라도 올라간 적 있나. 세 번째가 왜 중요한지도 알려줬습니다.
한 번이라도 올라갔다면 파일을 지워도 이력에는 남습니다. 그런 경우엔 그 키를 폐기하고 새로 발급해야 합니다.
마지막으로 문단속(RLS)을 확인해야 했는데, 저는 어느 메뉴에 뭐가 있는지 몰랐습니다. "supabase 어디서 봐야해?" 라고 하니 볼 곳을 알려주고 브라우저로 직접 열어줬습니다.
확인할 것은 세 가지였고, 셋째가 제일 헷갈렸습니다.
확인할 것 | 정상이면 |
|---|---|
문단속이 켜져 있나 |
|
규칙이 2개인가 | 읽기 하나, 쓰기 하나 |
수정·삭제 규칙이 없나 | 하나도 없어야 정상 |
규칙에 안 적힌 행동은 전부 거부됩니다. 그래서 수정·삭제 규칙을 안 만든 게 곧 문단속입니다.
"규칙을 안 만드는 게 곧 금지" — 오늘 배운 것 중 제일 신기했습니다.
✅ 결과 (After)
항목 | Before | After |
|---|---|---|
남이 내 사이트에 오면 | 빈 화면만 보임 | 글을 남길 수 있음 |
저장되는 곳 | 내 기기 안에만 | 인터넷 데이터베이스 |
남의 글 고치기·지우기 | — | 아무도 못 함 (나도 화면에서는 못 지움) |
방문자가 받는 파일에 비밀번호 | — | 없음 (확인 완료) |
/guestbook 에서 이름과 메시지를 남기면 최신순으로 쌓입니다. 메인 화면 맨 아래 "방명록" 링크로도 갈 수 있습니다.
💬 배운 AI 활용 팁
효과적이었던 것
비밀번호를 보낼 때는 "이거 맞는지 확인해줘"라고 하기. 저는 붙여넣기만 했는데 AI가 열어서 확인해줬습니다. 안 해주면 요청하면 됩니다.
"어디서 보는지 모르겠어"라고 그냥 말하기. 화면 위치를 모르는 건 코드를 모르는 것과 다른 문제고, 물어보면 브라우저까지 열어줍니다.
모르는 용어가 나오면 바로 "쉽게 말해줘". 환경변수, RLS, 정책을 하나도 몰랐는데 매번 비유로 설명해줘서 끝까지 따라갔습니다.
이렇게 하면 안 돼요
비밀번호를 두 개 다 보내지 마세요.
anon과service_role중anon만 보내면 됩니다. 헷갈리면 "어느 게 맞는지 모르겠어"라고 물어보세요."파일에 적었으니 됐겠지" 하고 넘어가지 마세요. 적는 것과 반영되는 것은 다릅니다. 칸이 세 개인 것도, 등록 후 다시 배포해야 하는 것도 몰랐습니다.
"됐어" 하기 전에 진짜로 눈으로 보세요. 직접 글을 남겨보고 목록에 뜨는 걸 확인했습니다.
🌍 다른 업무에 적용한다면?
신청 폼 / 설문 / 후기 받기 — "방명록"을 "신청서"로 바꾸면 그대로입니다.
"누가 뭘 할 수 있는지" 정해야 할 때 — 공유 문서나 팀 폴더 권한도 "허용할 것만 적고 나머지는 비워두는" 방식이 안전합니다.
🚀 앞으로의 계획
광고 글 막기 — 지금은 누구나 무제한으로 쓸 수 있어서, 쌓이면 막는 방법을 붙이려고 합니다.
기록부 본체로 돌아가기 — 실제 일정을 채워 쓰면서 알림과 입력 단순화를 해보려고 합니다.
📋 재사용 가능한 프롬프트
프롬프트 1: 비밀번호(API 키) 안전하게 넘기기
[서비스 이름]의 키를 알려줄 건데, 넘기기 전에 이것부터 알려줘.
이 값이 어디에 저장되고 왜 안전한지 한 줄로
이 서비스에 위험한 키와 안전한 키가 따로 있는지, 있다면 어떻게 구분하는지
그리고 내가 값을 보내면 바로 저장하지 말고 먼저 검사해줘. 권한이 너무 센 키를 잘못 보낸 건 아닌지 확인하고 알려줘. 키는 절대 코드에 직접 적지 말고, 코드에는 "설정에서 꺼내 쓰라"고만 적어줘.
올리기 전에는 이 키가 GitHub에 딸려 올라가지 않는지 세 가지를 다 검사해줘 — 올릴 목록에 있는지, 이미 올라가 있는지, 과거 이력에 한 번이라도 올라간 적 있는지. 마지막 게 걸리면 파일을 지워도 소용없으니 키를 폐기하고 새로 발급해야 한다고 알려줘.
프롬프트 2: 확인 안 한 것을 솔직하게 받기
다 됐다고 말하기 전에, 실제로 확인한 것과 확인하지 못한 것을 나눠서 알려줘.
확인한 것은 어떻게 확인했는지 근거와 함께
확인 못 한 것은 왜 못 했는지 이유와 함께
확인하려다 내 데이터가 지워지거나 망가질 위험이 있으면, 하지 말고 나에게 먼저 말해줘



글 잘봤구요 위에 글중에 이런 내용이 좋네요 " 수정삭제가 막혔는지 제가 확인 하지 않았습니다,
"다 됐습니다"라고 했으면 저는 그냥 믿었을 겁니다. 확인 안 한 걸 확인 안 했다고 말해준 게 오히려 신뢰가 갔습니다."