클로드 코드로 웹사이트 만들기 — 코딩 몰라도 결제까지 된 실제 과정
글 장길웅 · 실제로 만들고 쓴 기록
결론부터 말하면, 클로드 코드로 웹사이트 만들기는 코딩을 몰라도 결제 기능까지 가능합니다. 다만 “만들어 줘” 한 줄로 끝나지는 않습니다. 제가 실제로 효과를 본 건 코드를 아는 것이 아니라 고치기 전에 되돌릴 길을 만들고, 올리기 전에 검사하고, 문제가 나면 옛 화면과 새 화면을 나란히 비교하는 습관이었습니다.
이 글은 제가 운영하는 AI 사주 사이트 귤나무사주를 클로드 코드로 만들고 고쳐 온 기록을 정리한 것입니다.
무엇을 만들었나
- 사이트 종류: 생년월일을 넣으면 사주를 계산하고, 무료 미리보기를 보여 준 뒤, 결제하면 전체 풀이가 열리는 사이트
- 만든 도구: 클로드 코드 (제가 말로 시키고, 클로드가 코드를 쓰고 고침)
- 사이트 뼈대: Next.js
- 올리는 곳: 버셀(Vercel)
- 결제: 그로블 결제 링크 + 결제가 끝나면 사이트에 알려 주는 연결(웹훅)
- 주소: 가비아에서 산 도메인
클로드 코드 사용법: 일을 시키는 방식
사이트가 커질수록 한 번에 많이 바꾸면 어디서 문제가 생겼는지 찾기 어렵습니다. 그래서 지금은 이렇게 나눠서 시킵니다.
- 바꿀 화면 하나만 정한다. 예: “결제 전 미리보기 화면에서 가격표만 바꿔 줘.”
- 안 바꿀 것을 같이 말한다. 예: “결제 연결과 가격은 건드리지 마.”
- 끝나면 무엇을 바꿨는지 표로 받는다. 고친 파일, 새로 만든 파일, 못 한 것.
3번이 생각보다 중요했습니다. 클로드가 “못 한 것”을 따로 적게 하면, 제가 직접 확인해야 할 부분이 바로 보입니다. 실제 기록에도 “결제 뒤 화면은 만들었지만 실제 결제로 시험하지 못했다” 같은 줄이 남아 있었고, 그런 부분은 제가 직접 결제해 보며 확인합니다.
올리기 전에 꼭 하는 3가지
코드를 몰라도 이 순서만은 매번 지킵니다. 클로드에게 “배포 전에 이거 해 줘”라고 시키면 됩니다.
| 순서 | 하는 일 | 왜 하나 |
|---|---|---|
| 1 | 고칠 파일 옆에 백업 파일 만들기 (파일이름.bak_날짜) |
문제가 나면 그 파일만 원래대로 덮어쓰면 됨 |
| 2 | 타입 검사 (npx tsc --noEmit) |
코드에 틀린 곳이 있는지 올리기 전에 잡음 |
| 3 | 빌드 (npx next build) |
실제로 사이트가 만들어지는지 미리 확인 |
이 3가지를 통과한 뒤에만 npx vercel --prod로 실제 사이트에 올립니다. 하루에 여러 번 고치는 날도 있었는데, 그날도 올릴 때마다 검사와 빌드를 먼저 통과시켰습니다.
비개발자에게 제일 무서운 건 “고쳤는데 사이트가 안 열리는 것”입니다. 백업 파일과 배포 전 검사만 있으면, 최악의 경우에도 몇 분 안에 원래대로 돌릴 수 있습니다.
실제로 막혔던 곳: 결제창이 안 열림
새 결제 화면을 만들어 올린 날, 결제 버튼을 누르니 결제창에서 이런 메시지가 떴습니다.
[AUTH0007] Referer 도메인 확인이 필요합니다
원인을 직접 찾는 대신 클로드에게 “결제가 잘 되는 옛 화면과 안 되는 새 화면을 나란히 놓고 다른 점을 찾아 줘“라고 시켰습니다.
찾은 차이는 한 줄이었습니다. 새 화면을 만들 때 “어디서 왔는지 정보를 보내지 않는다”는 설정(no-referrer)이 들어가 있었고, 그래서 결제 회사가 “이 요청이 어느 사이트에서 왔는지”를 확인하지 못한 것으로 보였습니다. 그 한 줄을 지우고, 결제 버튼이 하는 일을 옛 화면과 같은 줄, 같은 순서로 맞춘 뒤 다시 올렸습니다. 그 뒤로 결제는 정상적으로 됐습니다.
여기서 배운 것은 이겁니다.
- 원인을 몰라도 “잘 되는 것”과 “안 되는 것”을 비교하라고 시키면 클로드가 차이를 찾아 줍니다.
- 고친 뒤에는 같은 조건에서 다시 비교하게 합니다. 이때는 열린 결제 주소, 새 탭으로 열리는지, 보내는 정보까지 옛 화면과 같은지 표로 확인받았습니다.
- 그리고 클로드가 “이게 원인이라고 100% 단정은 못 한다”고 적은 부분은 그대로 믿지 않고, 제가 실제 결제로 확인했습니다.
또 하나 걸렸던 것: 시간 제한
결제 뒤에 긴 풀이(12장)를 한 번에 만드는 기능을 넣었을 때, 시험해 보니 다 만드는 데 214초(약 3분 34초)가 걸렸습니다. 결제 알림을 받는 쪽의 시간 한도가 300초여서 여유가 거의 없었습니다.
그래서 풀이를 장별로 나눠 만들어 앞 장부터 저장되게 하고, 중간에 끊기더라도 빈 부분만 다시 만들 수 있는 버튼을 화면에 두는 쪽으로 바꿨습니다. 코드를 몰라도 “몇 초 걸렸는지, 한도는 몇 초인지” 숫자로 받아 보면 문제를 미리 알 수 있습니다.
지금 다시 시작한다면
- 처음부터 큰 기능을 한 번에 시키지 않겠습니다. 화면 하나, 기능 하나씩.
- 백업 → 검사 → 빌드 → 배포 순서를 첫날부터 규칙으로 정하겠습니다.
- 결제는 반드시 직접 한 번 결제해 보고 손님에게 열겠습니다. 만든 것과 되는 것은 다릅니다.
- “못 한 것” 목록을 매번 받겠습니다. 제가 볼 곳이 거기에 다 있습니다.
다음 글에서는 이 사이트를 올린 곳인 버셀에 무료로 사이트를 올리는 방법과, 가비아에서 산 도메인을 연결하는 방법을 실제 순서대로 정리하겠습니다.