본문으로 건너뛰기

대시보드 주소 한 줄 붙여넣었더니, AI가 3분 만에 404 원인을 찾았다

진성_

2026.08.05

📝 한줄 요약

만들어는 놨는데 세상에 못 내놓고 있던 사이트를, Claude Code와 함께 하루(약 8시간) 만에 배포까지 끝냈습니다. 배포해도 404만 뜨던 원인은 제 실수가 아니라 사이트가 두 개 있었던 것이었고, 그걸 알아낸 계기는 대시보드 주소를 그냥 붙여넣은 것이었습니다.

바쁘시면 이것만 읽어도 돼요:

  • Claude Code로 하루 만에 배포 · 데이터베이스 연결 · 담당자용 문서 다운로드 3종까지 (커밋 9개)

  • 404의 원인은 코드가 아니었습니다. 배포 플랫폼이 두 개 공존하고 있었고, 단서는 제가 붙여넣은 대시보드 주소 한 줄이었습니다

  • "왜 그렇게 했어?"를 되물으면 근거가 나옵니다. 되물은 뒤에야 우리 프로젝트의 진짜 상태가 정리됐습니다

  • "다 됐습니다"는 두 번 깨졌습니다. 로그인이 로컬호스트로 가고, PDF에서는 글자가 통째로 증발했습니다

  • 두 번째 문제는 AI가 "제 검증 방식이 실책이었습니다"라고 먼저 인정하고 방법을 바꿔서 잡았습니다

  • 배운 것 한 줄: 설명하려 애쓰지 말고 화면을 그대로 보여주세요


🎯 이런 분들께 도움돼요

  • AI로 코드는 나왔는데 배포 단계에서 멈춰 있는 분

  • 배포했는데 404가 뜨고 왜인지 알 방법이 없는 분

  • AI가 "다 됐습니다"라고 할 때 어떻게 확인해야 할지 모르겠는 분

  • 데이터베이스·보안처럼 손댈 엄두가 안 나는 영역을 남겨두고 있는 분


😫 문제 상황 (Before)

강사가 자기 소개 페이지를 링크 하나로 만들고, 그 링크로 들어온 강의 요청을 받는 서비스를 만들고 있었습니다.

코드는 있었습니다. 그런데 세상에 못 내놓고 있었습니다.

Cloudflare 대시보드에 들어가서 GitHub를 직접 연결해봤습니다. 화면상으로는 배포가 성공했다고 나옵니다. 그런데 주소를 열면 404. 재빌드를 눌러도 잘 안 됩니다.

가장 답답했던 건 뭐가 틀렸는지 알 방법이 없다는 것이었습니다. 빌드 로그를 열어봐도 무슨 말인지 모르겠고, 검색해서 나오는 글들은 전부 제 상황과 조금씩 달랐습니다. 며칠째 같은 자리였습니다.

여기에 아직 손도 못 댄 것들이 남아 있었습니다.

  • 데이터베이스에 테이블이 하나도 없음 (연결된 적이 없었습니다)

  • 기관 담당자가 결재에 올릴 파일(한글·PDF) 이 없음

  • 남의 개인정보를 받는 폼인데 보안 설정을 확인해본 적이 없음


🛠️ 사용한 도구

  • 도구: Claude Code (VS Code 확장으로 사용)

  • 모델: Claude Opus 5

  • 특이사항: 데이터베이스(Supabase)를 MCP로 연결해서, AI가 대시보드 대신 직접 확인하고 작업할 수 있게 했습니다


🔧 작업 과정

시작부터 제동이 걸렸다

Cloudflare 설정 화면을 띄워놓고 물어봤습니다.

cloudflare에 깃허브 연결하려는데 이렇게 하면 될까?

돌아온 답이 예상 밖이었습니다.

"그 화면 그대로 [저장 및 배포]를 누르면 빌드가 실패합니다."

그러고는 실패할 이유 두 가지를 짚어줬습니다. 저는 그냥 "이렇게 하면 되지?" 확인받으려던 거였는데, 누르기 전에 막아준 셈이었습니다.


"네가 대신 해줄 수 있어?" — 못 하는 건 못 한다고 했다

버셀을 사용하지 않을거야. cloudflare에 브라우저 접근해서 너가 배포 해줄수 있을까?

여기서 인상적이었던 건 못 한다고 먼저 말한 것입니다.

"브라우저를 직접 조작하는 도구는 저한테 없습니다. 대신 명령줄로 제가 직접 배포할 수 있어요 — 로그인 한 번만 승인해주시면 그 뒤는 제가 다 합니다. 대시보드 방식보다 이 쪽이 확실합니다. 빌드가 로컬에서 돌아서 실패 원인이 바로 보이거든요."

"할 수 있다"고 하고 어설프게 시도했으면 시간만 더 버렸을 겁니다. 못 하는 걸 인정하고 대신 되는 방법과 그게 더 나은 이유를 함께 준 게 좋았습니다.

15분쯤 뒤에 실제로 접속되는 주소가 나왔습니다.

그런데 바로 이런 말이 이어졌습니다.

"/가 404입니다. 정적 페이지인데 404가 나오니 원인을 봐야 합니다."

또 404인가 싶었는데, 30초 뒤에 스스로 정정했습니다.

"/는 실제로 200입니다 — 첫 요청이 콜드 스타트라 제가 상태 코드를 잘못 잡았습니다."

자기가 방금 한 판독을 스스로 뒤집는 걸 처음 봤습니다.


"왜 Vercel을 추천했어?" — 되물으니 상황이 정리됐다

작업 초반에 AI는 Vercel이라는 다른 배포 서비스를 추천했었습니다. 그런데 지금은 Cloudflare로 가고 있었죠. 그냥 넘어가려다 되물었습니다.

클라우드 플레어 연동하는데 왜 버셀을 추천했어? 현재 우리상황 어떤데

이 질문이 이날 가장 값진 질문이었습니다. 판단 근거를 정리해 오면서, 제가 몰랐던 사실 하나를 같이 찾아왔기 때문입니다.

"확인해보니 이 저장소엔 데이터베이스가 연결된 적이 없습니다. 설정 파일도 없고 실제 프로젝트 참조도 없습니다."

배포가 안 되는 문제만 보고 있었는데, 그 밑에 데이터가 하나도 안 붙어 있다는 더 큰 구멍이 있었던 겁니다. 되묻지 않았으면 한참 뒤에 알았을 일이었습니다.


🔍 하이라이트 — 대시보드 주소를 그냥 붙여넣었더니

AI가 배포한 주소는 정상이었습니다. 그런데 제가 직접 만들었던 건 여전히 404였습니다. 뭐가 다른지 알 수 없어서, 설명하려 애쓰지 않고 주소를 그대로 붙여넣었습니다.

https://dash.cloudflare.com/.../pages/view/mycareerhome 내가 직접 클라우드 플레어
컴퓨트 추가해서 배포해보려 했는데 배포가 되어도 404 에러 뜨고, 재빌드도 잘 안돼.
너가 해준거랑 다른게 뭐야

11초 만에 답이 왔습니다.

"직접 만드신 게 Pages 프로젝트군요 (주소가 /pages/view/). 제가 배포한 건 Workers입니다 — 지금 계정에 서로 다른 두 개가 공존하고 있습니다."

제가 붙여넣은 주소 안에 pages라는 단어가 들어 있었고, AI는 그걸 보고 알아챈 겁니다. 저는 주소를 읽을 줄도 몰랐습니다.

더 좋았던 건 여기서 멈추지 않은 것입니다. 추측으로 끝내지 않고 두 개를 동시에 찔러봤습니다.

"확인됐습니다 — Pages는 404, Workers는 200."

그러고는 Pages 쪽 빌드 로그까지 열어보고 결론을 냈습니다.

"Pages 배포는 모든 경로가 404입니다 — 프로덕션도, 프리뷰도, 로그인 페이지도."

질문부터 진단 완료까지 1분 40초. 며칠을 헤맨 문제였습니다.

제가 한 일은 "404가 떠"라고 말한 게 아니라 주소를 붙여넣은 것뿐이었습니다.


"그럼 이렇게 할까?" — 시키는 대로 하지 않았다

남은 빈 Pages 프로젝트가 아까워서 물었습니다.

그럼 페이지엔 랜딩페이지를 연결할까?

돌아온 답은 "네, 해드릴게요"가 아니었습니다.

"좋은 질문인데, 이건 하지 않는 걸 권합니다. 이유를 코드로 보여드리죠."

그러고는 제 프로젝트 코드를 열어서, 첫 화면이 나머지 앱과 붙어 있어 떼어낼 수 없다는 걸 보여줬습니다. 만약 시키는 대로 했다면 반나절은 더 썼을 겁니다.

시키는 대로 하지 않고, 거절하면서 근거를 보여주는 것 — 이게 제일 든든했던 부분입니다.


데이터베이스 붙이기 — 키를 어디서 찾는지부터 몰랐다

배포가 뚫린 뒤 데이터베이스를 붙일 차례였는데, 여기서도 막혔습니다.

NEXT_PUBLIC_SUPABASE_URL과 ANON_KEY는 어디서 찾아? 아님 만들어야해?

대시보드에 들어가니 처음 보는 키 종류가 여러 개였습니다. 뭘 복사해 줘야 하는지도 몰랐습니다. 여기서도 주소를 그냥 붙여넣었습니다. AI가 그 주소에서 프로젝트 정보를 뽑아내고, 제 화면에 뭐가 보이는지를 물어본 뒤, 정확히 어느 항목을 복사하면 되는지 짚어줬습니다.

키를 주자마자 바로 시험해보더니 이렇게 말했습니다.

"키는 정상 작동합니다. 그런데 응답을 보니 인증은 통과했는데 테이블이 없다는 뜻입니다. 즉 데이터베이스가 비어 있습니다."

이후 데이터베이스 연결이 계속 실패했는데(접속 방식이 바뀌어 있었습니다), 다른 길을 뚫어서 결국 테이블 4개를 만들고 보안 설정까지 켰습니다.

그리고 제가 시키지도 않은 걸 했습니다. 남의 개인정보를 받는 폼이라, 방어선이 실제로 작동하는지 직접 뚫어본 겁니다.

  • 동의 항목 없이 요청을 보내봄 → 정확히 거절당함 ✅

  • 동의를 넣고 다시 보냄 → 정상 접수 ✅

  • 로그인 안 한 상태로 그 요청을 훔쳐보려 시도 → 차단됨 ✅

  • 저장된 데이터 확인 → IP 원본은 없고 암호화된 값만 저장돼 있음 ✅

  • 그리고 자기가 넣은 시험용 가짜 데이터를 지웠습니다


끝난 줄 알았는데 (1) — 로그인이 로컬호스트로 갔다

여기까지 하고 마무리되나 싶었는데, 직접 로그인을 해보니 문제가 있었습니다.

https://mycareerhome.jinsung0403.workers.dev/ 에서 로그인하면 인증 이메일은 오는데
누르면 로컬호스트로 연결되서 오류나네.

AI는 코드부터 확인하더니 "코드는 정상입니다"라고 선을 그었습니다. 그리고 문제는 제 설정 쪽이라며, 추측으로 끝내지 않고 인증 기록(로그)을 직접 열어서 원인을 확정했습니다. 자기가 고칠 수 없는 부분이라 제가 대시보드에서 뭘 바꿔야 하는지 알려줬습니다.

덤으로 이런 것도 확인해줬습니다.

"가입 처리는 정상 작동했습니다 — 계정이 자동 생성됐고, 체험 상태로 규칙대로 들어가 있습니다."


끝난 줄 알았는데 (2) — PDF에서 글자가 사라졌다

기관 담당자가 결재를 올리려면 링크가 아니라 파일이 필요하다는 걸 알게 돼서, 한글·PDF·워드 3종 다운로드를 붙였습니다. AI는 "검증 완료"라고 했습니다. 그런데 실제로 받아보니 이랬습니다.

잘된다. 그런데 PDF 다운로드는 많이 깨진다.

여기서 이날 가장 인상적인 일이 벌어졌습니다.

AI는 이번엔 텍스트만 확인하지 않고 PDF를 그림으로 렌더링해서 눈으로 봤습니다. 그러자 바로 나왔습니다.

"문제가 보입니다. 굵은체 제목들이 깨졌습니다 — 이런 강의를 합니다가 이   다로만 나옵니다. 본문은 완벽합니다."

원인은 제 예상과 완전히 달랐습니다. 폰트가 아니라 PDF를 만드는 라이브러리 자체의 버그였습니다. 다른 폰트로 바꿔서 시험해봐도 똑같이 깨졌습니다.

폰트

글자가 살아남은 비율

나눔고딕

23%

Gothic A1

48%

폰트를 바꿔도 해결되지 않았을 문제였던 겁니다.

그런데 진짜는 그다음이었습니다. 제가 따지지도 않았는데 AI가 먼저 이렇게 적었습니다.

"제가 놓쳤던 이유 — 기록해둡니다. 지난번에 'PDF 검증 완료'라고 말씀드렸는데, 텍스트 추출로만 확인한 게 실책이었습니다. 깨진 파일에서도 한글은 완벽하게 추출됩니다 — 글자 정보는 멀쩡하고 그려지는 모양만 틀렸기 때문입니다. 이건 페이지를 이미지로 렌더링해서 봐야만 보입니다. 이번엔 두 쪽 모두 렌더링해서 확인했고, 기록에도 남겨뒀습니다."

"어떻게 확인했느냐"가 왜 중요한지를 이때 알았습니다. "확인했다"는 말은 같아도, 텍스트를 뽑아보는 것과 눈으로 보는 것은 전혀 다른 검사였던 겁니다.

그리고 고치면서 치른 대가도 먼저 밝혔습니다.

"PDF가 12KB → 1.5MB가 됐습니다. 폰트를 통째로 넣기 때문입니다. 글자가 빠진 문서는 결재에 못 쓰니 이쪽이 싼 거래라고 판단했습니다. 줄이려면 굵은체를 버리는 방법이 있는데, 제목 강조가 사라져 결재 문서로는 손해라 하지 않았습니다. 원하시면 바꾸겠습니다."

뭘 잃고 뭘 얻었는지, 왜 그렇게 판단했는지, 되돌릴 수 있는지까지 한 번에 왔습니다.


AI도 못 한 게 있었다 — 그리고 우회하지 않았다

하루 동안 AI가 막힌 지점이 세 번 있었습니다. 안전장치가 작동한 경우였는데, 매번 반응이 같았습니다.

"리전 스캔은 차단됐습니다 (여러 곳에 자격증명을 시도하는 패턴이라 그렇습니다 — 타당한 차단이라 우회하지 않겠습니다). 확실한 경로로 가죠."

"실행이 안전성 분류기에 막혔습니다. 인프라 삭제라 그렇습니다. 우회하지 않았습니다. 직접 하실 수 있는 방법 두 가지를 알려드리겠습니다."

몰래 돌아가지 않고 막혔다고 말한 뒤 대안을 준 것 — 결과적으로 제가 할 일 한 가지(빈 프로젝트 삭제)가 숙제로 남았지만, 이쪽이 훨씬 믿음이 갑니다.


✅ 결과 (After)

Before vs After

항목

Before

After

사이트

배포해도 404, 며칠째 제자리

실제 주소로 서비스 중 ✅

404 원인

알 방법 없음

사이트가 두 개 공존 — 1분 40초 만에 규명

데이터베이스

테이블 0개, 연결된 적 없음

테이블 4개 + 보안 설정 + 침투 시험 통과

담당자용 파일

없음 (링크만)

한글·PDF·워드 3종

개인정보 방어

확인해본 적 없음

익명 조회 차단·IP 원본 미저장 실측 확인

소요 시간

며칠째 진행 없음

하루 (약 8시간), 커밋 9개

결과물

  • 강사 소개 페이지가 실제 주소로 돌아가고, 직접 로그인해서 첫 페이지까지 발행했습니다

  • 페이지를 받은 기관 담당자는 버튼 하나로 한글·PDF·워드를 받아 바로 결재에 올릴 수 있습니다

  • 무엇보다 혼자였으면 시도조차 못 했을 영역(배포 플랫폼 선택, 데이터베이스, 보안 권한)을 하루에 통과했습니다


💬 이 과정에서 배운 AI 활용 팁

효과적이었던 것

  1. 설명하려 애쓰지 말고 화면을 그대로 보여주세요. 저는 "404가 떠"라고만 말할 줄 알았습니다. 대신 대시보드 주소를 붙여넣었더니 그 주소 안의 단어 하나에서 원인이 나왔습니다. 며칠 걸린 문제가 1분 40초 만에 풀렸습니다. 요약하지 마세요. 날것 그대로가 단서입니다.

  2. "왜 그렇게 했어?"를 되물으세요. 그냥 넘어갈 수 있었던 질문이었는데, 되물은 덕분에 데이터베이스가 아예 연결된 적 없다는 더 큰 문제가 드러났습니다.

  3. "어떻게 확인했어?"를 물으세요. "검증 완료"라는 같은 말도, 텍스트를 뽑아본 것과 눈으로 본 것은 전혀 다른 검사였습니다. 결과물이 있는 작업이라면 열어서 봤는지를 물어보세요.

  4. 못 한다고 말할 여지를 주세요. "네가 브라우저로 해줄 수 있어?"에 "못 합니다, 대신 이 방법이 더 낫습니다"가 돌아온 게 이날 가장 빠른 지름길이었습니다.

이렇게 하면 안 돼요

  1. "다 됐습니다"를 그대로 믿기. 이날만 두 번 깨졌습니다 — 로그인이 로컬호스트로 갔고, PDF에서는 글자가 통째로 사라졌습니다. 둘 다 제가 직접 써보고 발견했습니다. AI 검증과 내 눈은 별개입니다.

  2. 문제를 내 말로 요약해서 전달하기. 제 요약은 이미 한 번 걸러진 정보입니다. 제가 중요하다고 생각한 게 실제 단서가 아닐 수 있습니다.

  3. 눈에 보이는 결과물을 안 열어보기. PDF는 파일이 멀쩡하고 글자 정보도 정상인데 화면에는 안 보이는 상태였습니다. 열어보지 않으면 절대 모릅니다.


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

  • 오류가 나는데 뭐가 문제인지 모를 때 — 설명하려 애쓰지 말고 오류 화면, 주소, 메시지를 그대로 붙여넣으세요. 엑셀 오류든 노션 자동화든 같습니다.

  • AI가 만들어준 문서·자료를 받았을 때 — "확인했어?"가 아니라 "열어서 눈으로 봤어?" 라고 물으세요. 표가 밀렸거나 글자가 깨진 건 열어야만 보입니다.

  • AI가 어떤 방법을 추천할 때 — "왜 그걸 골랐어? 지금 우리 상황은 어때?"를 한 번 되물으세요. 근거를 정리하는 과정에서 몰랐던 문제가 딸려 나옵니다.

  • 중요한 결정을 내렸을 때 — 왜 그렇게 정했는지를 메모나 문서로 남기게 하세요. 안 적어두면 다음에 반대로 갑니다.


🚀 앞으로의 계획

솔직히 다음 걸 아직 정하지 못했습니다. 배포라는 큰 벽을 넘은 참이라 잠깐 숨 고르는 중입니다.

다만 이날 작업에서 AI가 정리해준 숙제가 남아 있습니다.

남은 일

상태

요청이 들어왔을 때 강사에게 알림 메일 보내기

⏳ 미완 — 지금은 요청이 와도 알 방법이 없습니다

들어온 요청을 모아 보는 관리 화면

⏳ 미착수

404 나는 빈 프로젝트 삭제

⚠️ AI가 막혀서 제 몫으로 남음

우선순위는 AI가 이미 짚어줬습니다.

"알림 메일이 가장 급합니다. 지금 상태로는 기관이 강의 요청을 넣어도 강사에게 메일이 안 갑니다. 이미 페이지를 발행해두셨으니, 그 링크로 실제 요청이 들어오면 지금은 알 방법이 없습니다."

받는 그릇은 만들어놨는데 종이 안 울리는 상태라는 뜻이더군요. 여기부터 손보고, 그다음에 실제 강사분께 링크를 써보게 할 생각입니다.

함께 이야기해요 0

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

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

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

이런 사례도 있어요

사례 전체 보기