레이블이 PC인 게시물을 표시합니다. 모든 게시물 표시
레이블이 PC인 게시물을 표시합니다. 모든 게시물 표시

2026년 11월 16일 월요일

안티그래비티 AI 사용법: 홈페이지 디자인부터 SEO까지 한 번에 업그레이드하는 프롬프트 20가지

안티그래비티 AI를 활용한 홈페이지 디자인 개선과 모바일 최적화 및 SEO 작업

홈페이지를 하나 만들었다고 끝일까요?

처음에는 마음에 들었던 홈페이지도 시간이 지나면 아쉬운 부분이 보입니다. 디자인이 조금 촌스럽기도 하고, 휴대폰에서는 글자가 작거나 버튼이 잘 보이지 않을 수도 있습니다.

안티그래비티 AI를 활용하면 이런 문제를 하나씩 개선할 수 있습니다.

이번 글에서는 이미 만들어 놓은 홈페이지를 더 보기 좋고, 읽기 쉽고, 믿을 수 있는 사이트로 발전시키는 방법을 알아보겠습니다.

어려운 코딩을 직접 하지 않아도 됩니다. AI에게 정확한 지시를 내릴 수 있도록 준비된 프롬프트를 복사해서 사용하면 됩니다.

이번 글에서 배울 내용

  • AI로 내 홈페이지의 문제점 찾기
  • 전문가처럼 보이는 디자인 만들기
  • 방문자가 이해하기 쉬운 글 작성하기
  • 휴대폰에서도 편리한 홈페이지 만들기
  • 구글 검색과 SNS 공유 설정하기
  • AI가 만들어 낸 잘못된 정보 점검하기

1. 안티그래비티란 무엇일까?

안티그래비티(Antigravity)는 구글의 AI 기반 개발 도구입니다.

일반적인 AI 채팅 도구는 주로 질문에 답하거나 코드를 작성해 줍니다. 반면 안티그래비티는 프로젝트에 연결된 작업 공간에서 코드를 살펴보고 수정하며, 터미널과 브라우저를 활용한 작업도 수행할 수 있습니다.

쉽게 비유하면 다음과 같습니다.

일반적인 AI

홈페이지를 어떻게 꾸미면 좋을지 설명해 주는 디자인 상담사

안티그래비티 AI

실제 홈페이지의 코드를 확인하고, 요청에 따라 직접 수정 작업까지 도와주는 개발 파트너

예를 들어 다음과 같이 요청할 수 있습니다.

“내 홈페이지의 첫 화면을 더 전문적으로 바꿔 줘.”

그러면 AI가 프로젝트의 코드를 확인하고 개선 방향을 제안할 수 있습니다.

물론 AI가 수정한 결과가 항상 완벽한 것은 아닙니다. 반드시 화면을 확인하고 잘못된 부분이 없는지 검토해야 합니다.

공식 안내: Google Antigravity 공식 홈페이지

2. 홈페이지를 업그레이드하기 전 준비할 것

가장 먼저 안티그래비티에서 기존 홈페이지 프로젝트를 열어야 합니다.

1단계. 홈페이지 프로젝트 열기

  1. 안티그래비티를 실행합니다.
  2. 내가 만든 홈페이지 프로젝트 폴더를 엽니다.
  3. AI 채팅창에서 프로젝트를 확인할 수 있는지 살펴봅니다.
  4. 현재 홈페이지가 정상적으로 실행되는지 확인합니다.

2단계. 한 번에 하나씩 요청하기

여러 가지 작업을 한꺼번에 요청하면 문제가 생겼을 때 원인을 찾기 어렵습니다.

따라서 디자인을 먼저 수정하고, 결과를 확인한 다음 모바일 화면을 개선하는 방식으로 진행하는 것이 좋습니다.

3단계. 수정 전후 비교하기

수정하기 전 화면을 캡처해 두세요.

수정한 다음 화면과 비교하면 어떤 부분이 좋아졌는지 쉽게 확인할 수 있습니다.

3. 가장 중요한 안전 약속부터 설정하기

AI에게 홈페이지 수정을 맡길 때 가장 주의해야 할 부분은 무엇일까요?

바로 내가 요청하지 않은 부분까지 AI가 마음대로 수정하는 것입니다.

예를 들어 홈페이지의 색상만 바꾸려고 했는데 메뉴 구조나 다른 기능까지 변경된다면 곤란하겠죠.

이런 문제를 줄이려면 작업을 시작하기 전에 공통 규칙을 알려줘야 합니다.

복사해서 사용하는 기본 프롬프트

먼저 무엇을 어떻게 바꿀지 계획만 보여 줘.
내가 "진행해"라고 하면 그때 실제로 수정해 줘.

이 프로젝트 폴더 밖의 파일은 절대 수정하지 마.
없는 사실, 후기, 숫자는 지어내지 마.
확인할 수 없는 정보는 [ ] 빈칸으로 남겨 줘.
기존 기능이 사라지거나 작동하지 않도록 주의해 줘.
수정 전 관련 파일과 변경 범위를 확인해 줘.
작업이 끝나면 변경된 파일과 내용을 설명해 줘.

왜 이 약속이 중요할까요?

AI에게 먼저 계획을 보여 달라고 하면 실제 수정 전에 변경 범위를 검토할 수 있습니다.

다만 프롬프트만으로 파일 접근을 완벽하게 차단할 수 있는 것은 아닙니다. 실제 권한과 프로젝트 설정도 확인해야 합니다.

가능하면 수정 전에 Git으로 현재 상태를 저장해 두는 것이 좋습니다.

4. 내 홈페이지의 문제점부터 찾아보자

무작정 디자인을 바꾸기보다 먼저 현재 홈페이지의 상태를 점검해야 합니다.

다음 프롬프트를 사용하면 방문자 입장에서 홈페이지를 평가하도록 요청할 수 있습니다.

복사해서 사용하는 진단 프롬프트

이 홈페이지를 처음 방문한 사람의 입장에서 평가해 줘.

다음 항목을 각각 10점 만점으로 평가해 줘.

1. 첫 화면을 3초 안에 이해할 수 있는가?
2. 색상과 글꼴, 여백이 통일되어 있는가?
3. 휴대폰에서도 편리하게 사용할 수 있는가?
4. 글을 읽기 쉽고 이해하기 쉬운가?
5. 방문자가 다음에 무엇을 해야 하는지 명확한가?

각 항목의 점수와 평가 이유를 설명해 줘.

가장 효과가 큰 개선 사항 3가지를
우선순위에 따라 추천해 줘.

아직 코드는 수정하지 마.

이렇게 하면 홈페이지의 부족한 부분을 먼저 파악할 수 있습니다.

예를 들어 첫 화면에서 어떤 서비스를 제공하는지 알기 어렵다면 디자인보다 소개 문구를 먼저 바꾸는 것이 좋습니다.

점수가 낮은 부분부터 하나씩 개선하면 됩니다.

5. 디자인 업그레이드하기

홈페이지를 방문했을 때 가장 먼저 눈에 들어오는 것은 디자인입니다.

하지만 전문적인 홈페이지를 만들기 위해 화려한 효과가 필요한 것은 아닙니다.

색상과 글꼴, 여백을 통일하는 것만으로도 훨씬 깔끔해 보일 수 있습니다.

5-1. 홈페이지 색상과 글꼴 통일하기

홈페이지마다 여러 가지 색상을 사용하면 복잡해 보일 수 있습니다.

주 색상 하나와 강조 색상 하나를 정하고, 배경과 글자 색상을 통일하는 것이 좋습니다.

다음 프롬프트를 사용해 보세요.

디자인 통일 프롬프트
내 홈페이지를 [따뜻한 / 믿음직한 / 세련된]
분위기로 개선하고 싶어.

다음 디자인 규칙을 정해서 적용해 줘.

1. 주 색상 1개
2. 강조 색상 1개
3. 배경 색상과 글자 색상
4. 제목과 본문에 사용할 글꼴
5. 제목과 본문의 글자 크기 단계

한글을 지원하는 무료 글꼴을 사용해 줘.
예를 들어 Pretendard나 나눔고딕을 검토해 줘.

색상 코드는 한곳에서 관리할 수 있도록
CSS 변수로 정리해 줘.

기존 홈페이지 기능은 유지해 줘.
먼저 변경 계획을 보여 줘.

5-2. 마음에 드는 홈페이지 디자인 참고하기

마음에 드는 홈페이지가 있다면 화면을 캡처해서 AI에게 보여줄 수 있습니다.

다만 다른 사이트의 내용을 그대로 복사하는 것은 피해야 합니다.

레이아웃, 여백, 글자 크기, 버튼 모양처럼 디자인의 특징만 참고하는 것이 좋습니다.

디자인 참고 프롬프트
첨부한 화면은 내가 좋아하는 홈페이지 디자인이야.

내용이나 문장을 복사하지 말고
레이아웃, 여백, 글자 크기, 버튼 모양 등
디자인의 느낌만 참고해서 내 홈페이지에 적용해 줘.

수정하기 전에 참고할 디자인 요소를
목록으로 먼저 정리해 줘.

내 홈페이지의 고유한 내용과 기능은 유지해 줘.

디자인 참고 자료는 다음 사이트에서 찾을 수 있습니다.

5-3. 첫 화면을 새롭게 구성하기

홈페이지를 열었을 때 방문자가 가장 먼저 보는 화면을 히어로(Hero) 영역이라고 합니다.

이곳은 홈페이지의 첫인상을 결정하는 중요한 공간입니다.

방문자는 첫 화면을 보고 다음과 같은 질문에 답할 수 있어야 합니다.

  • 이 홈페이지는 무엇을 하는 곳인가?
  • 나에게 어떤 도움을 주는가?
  • 다음에는 무엇을 누르면 되는가?
첫 화면 개선 프롬프트
내 홈페이지의 첫 화면을 새롭게 구성해 줘.

다음 요소를 포함해 줘.

1. 홈페이지의 목적이 드러나는 큰 제목 한 줄
2. 내용을 설명하는 짧은 문장 1~2줄
3. 방문자가 누를 수 있는 버튼 1~2개
4. 오른쪽 또는 배경에 들어갈 이미지 영역

버튼은 [문의하기 / 둘러보기]로 구성해 줘.

처음 방문한 사람이 3초 안에
홈페이지의 목적을 이해할 수 있도록 만들어 줘.

먼저 디자인 계획을 보여 줘.

5-4. 여백과 정렬 정돈하기

전문적인 홈페이지와 아마추어 홈페이지의 차이는 작은 간격에서 나타나기도 합니다.

제목과 본문 사이의 간격이 제각각이거나 카드의 크기가 다르면 화면이 어수선해 보입니다.

색상과 내용은 그대로 두고 간격만 정돈해도 훨씬 깔끔해질 수 있습니다.

여백 정돈 프롬프트
홈페이지 전체의 여백과 정렬을 정돈해 줘.

1. 섹션 사이의 간격을 일정하게 유지해 줘.
2. 글이 한 줄에 지나치게 길게 표시되지 않게 해 줘.
3. 카드의 크기와 모서리를 통일해 줘.
4. 그림자와 내부 여백을 일관되게 적용해 줘.
5. 제목과 본문 정렬을 자연스럽게 맞춰 줘.

색상과 내용은 변경하지 말고
간격과 정렬만 개선해 줘.

5-5. 휴대폰 화면 최적화하기

요즘은 컴퓨터보다 스마트폰으로 홈페이지를 방문하는 사람이 많습니다.

그런데 PC 화면에서는 멀쩡하던 홈페이지가 휴대폰에서는 깨지는 경우가 있습니다.

글자가 너무 작거나 버튼이 화면 밖으로 밀려나기도 합니다.

이런 문제를 해결하려면 모바일 반응형 디자인이 필요합니다.

모바일 최적화 프롬프트
내 홈페이지를 휴대폰 화면에 최적화해 줘.

가로 너비 375px 화면을 기준으로
다음 사항을 확인하고 수정 계획을 작성해 줘.

1. 글자가 너무 작지 않은가?
2. 화면 밖으로 밀려나는 요소가 있는가?
3. 이미지가 화면을 벗어나지 않는가?
4. 버튼을 손가락으로 누르기 편한가?
5. 메뉴가 휴대폰에 적합한 형태인가?
6. 가로 스크롤이 불필요하게 발생하지 않는가?

PC 화면의 디자인도 유지하면서
모바일 화면을 개선해 줘.

직접 확인하는 방법

  1. 크롬에서 내 홈페이지를 엽니다.
  2. 키보드에서 F12를 누릅니다.
  3. 개발자 도구에서 휴대폰 모양 아이콘을 누릅니다.
  4. 화면 너비를 375px로 설정합니다.
  5. 메뉴, 글자, 이미지, 버튼을 확인합니다.

5-6. 은은한 움직임 효과 넣기

화면을 아래로 내릴 때 내용이 부드럽게 나타나면 홈페이지가 조금 더 생동감 있게 느껴집니다.

버튼에 마우스를 올렸을 때 색상이 부드럽게 변하는 효과도 좋습니다.

움직임 효과 프롬프트
홈페이지에 자연스러운 움직임 효과를 추가해 줘.

1. 스크롤할 때 섹션이 부드럽게 나타나도록 해 줘.
2. 버튼에 마우스를 올리면 자연스럽게 색상이 바뀌게 해 줘.
3. 애니메이션 시간은 0.3~0.6초 정도로 설정해 줘.
4. 움직임이 과도하지 않도록 해 줘.
5. prefers-reduced-motion 설정을 사용하는
방문자에게는 움직임 효과를 줄이거나 꺼 줘.

홈페이지 속도와 사용성을 해치지 않도록 해 줘.

6. 홈페이지 콘텐츠 업그레이드하기

디자인이 좋아도 홈페이지에 담긴 내용이 어렵거나 이해하기 힘들면 방문자는 떠날 수 있습니다.

방문자가 원하는 정보를 쉽게 찾을 수 있도록 글과 메뉴를 개선해야 합니다.

6-1. 첫 화면의 문장 다듬기

첫 화면의 제목은 홈페이지를 설명하는 가장 중요한 문장입니다.

예를 들어 단순히 '행복한 미래를 만듭니다'라고 쓰는 것보다 어떤 사람에게 어떤 도움을 주는지 구체적으로 표현하는 것이 좋습니다.

다음 프롬프트를 활용해 보세요.

첫 문장 개선 프롬프트
내 홈페이지는 [누구]를 위한 [무엇] 사이트야.

다른 곳과 다른 점은 [내 강점]이야.

이 내용을 바탕으로 다음 문장을 작성해 줘.

1. 첫 화면의 큰 제목 후보 5개
2. 제목 아래에 들어갈 설명 문장 후보 3개

어려운 전문 용어와 과장된 표현은 사용하지 마.
방문자가 얻을 수 있는 도움이 바로 드러나게 해 줘.

아직 홈페이지 코드는 수정하지 마.

6-2. 소개 글을 내 이야기로 만들기

사람들은 홈페이지에서 제공하는 서비스뿐 아니라 그 서비스를 제공하는 사람이 누구인지도 궁금해합니다.

소개 글에 실제 경험과 시작한 계기를 담으면 방문자에게 더 친근하게 다가갈 수 있습니다.

소개 글 작성 프롬프트
다음 메모를 바탕으로 홈페이지 소개 글을 작성해 줘.

나는 [어떤 사람]이야.
이 일을 시작한 계기는 [ ]야.
내가 도와줄 수 있는 것은 [ ]야.

친근한 존댓말 또는 단정한 존댓말을 사용해 줘.
전체 문장은 3~5문장으로 작성해 줘.

메모에 없는 경력이나 숫자,
실적과 수상 경력은 절대 만들어 내지 마.

6-3. 홈페이지 메뉴와 섹션 순서 정리하기

홈페이지에 좋은 내용이 많아도 순서가 뒤죽박죽이면 방문자는 원하는 정보를 찾기 어렵습니다.

방문자가 홈페이지를 둘러보면서 자연스럽게 문의하거나 신청하도록 구성하는 것이 좋습니다.

일반적으로 다음과 같은 순서가 효과적입니다.

  1. 첫 화면: 홈페이지가 제공하는 가치
  2. 고객의 고민: 어떤 문제를 해결할 수 있는가?
  3. 해결 방법: 어떤 서비스를 제공하는가?
  4. 사례와 결과물: 실제로 보여줄 수 있는 자료
  5. 자주 묻는 질문: 방문자의 궁금증 해결
  6. 연락하기: 문의와 신청으로 연결
섹션 구성 개선 프롬프트
현재 홈페이지의 섹션 순서를 확인해 줘.

방문자가 홈페이지를 둘러보고
자연스럽게 문의하고 싶어지도록
섹션 순서를 추천해 줘.

다음 흐름을 참고해 줘.

첫 화면 → 방문자의 고민 → 해결 방법
→ 사례와 결과물 → 자주 묻는 질문 → 연락하기

빠진 섹션이 있다면 [ ]로 표시해 줘.
실제 내용은 내가 작성할 수 있도록 비워 둬.

아직 코드는 수정하지 마.

6-4. 자주 묻는 질문 만들기

방문자는 홈페이지를 이용하기 전에 여러 가지 궁금증을 가질 수 있습니다.

가격은 얼마인지, 어떻게 신청하는지, 이용 방법은 무엇인지 궁금할 것입니다.

이런 질문을 미리 정리해 놓으면 방문자가 필요한 정보를 쉽게 찾을 수 있습니다.

FAQ 작성 프롬프트
내 홈페이지를 처음 방문한 사람이
궁금해할 질문 6개를 선정해 줘.

각 질문에 대한 답변도 작성해 줘.

답변은 확인된 정보만 사용해 줘.
가격, 이용 기간, 운영 시간 등
확실하지 않은 정보는 [ ]로 남겨 줘.

질문을 누르면 답변이 펼쳐지는
FAQ 형태의 홈페이지 섹션을 만들어 줘.

모바일에서도 편리하게 사용할 수 있도록 해 줘.

6-5. 문의와 신청 버튼 만들기

홈페이지를 방문한 사람이 관심을 갖게 되었다면 다음 행동으로 자연스럽게 이어져야 합니다.

그런데 연락처를 찾기 어렵거나 문의 버튼이 없다면 방문자는 그냥 나갈 수 있습니다.

따라서 첫 화면과 페이지 하단에 문의 버튼을 배치하는 것이 좋습니다.

문의 버튼 개선 프롬프트
방문자가 해야 할 주요 행동은 [문의하기 / 신청하기 /
카카오톡 채널 / 이메일]이야.

홈페이지 맨 아래에 눈에 잘 띄는
연락 및 문의 섹션을 만들어 줘.

첫 화면에 있는 버튼도
같은 문의 영역이나 실제 연락 링크로 연결해 줘.

링크 주소는 [ ]야.

실제 주소가 없는 경우 임의로 만들지 말고
[링크 주소 입력]으로 남겨 줘.

휴대폰에서도 버튼을 쉽게 누를 수 있게 해 줘.

7. 홈페이지에 신뢰감을 더하는 방법

홈페이지가 보기 좋고 내용이 훌륭해도 방문자가 믿지 못한다면 좋은 결과를 기대하기 어렵습니다.

특히 검색 결과와 SNS에 표시되는 정보, 깨진 링크, 잘못된 연락처는 신뢰도를 떨어뜨릴 수 있습니다.

7-1. 검색 결과와 SNS 미리보기 설정하기

구글에서 홈페이지를 검색하면 제목과 설명이 표시됩니다.

카카오톡이나 SNS에 홈페이지 주소를 공유하면 대표 이미지와 제목, 설명이 나타날 수도 있습니다.

이런 정보를 미리 설정하면 방문자가 홈페이지의 내용을 더 쉽게 이해할 수 있습니다.

SEO 및 공유 설정 프롬프트
내 홈페이지의 검색 및 공유 정보를 설정해 줘.

사이트 이름은 [ ]야.
사이트 설명은 [ ]야.

다음 항목을 확인하고 개선해 줘.

1. 브라우저 탭에 표시되는 제목
2. 검색 결과에 표시되는 메타 설명
3. 카카오톡과 SNS 공유용 제목
4. SNS 공유용 설명
5. 대표 이미지
6. 브라우저 탭에 표시되는 파비콘

Open Graph 메타 태그도 확인해 줘.

없는 정보나 이미지는 임의로 만들지 말고
필요한 항목은 [ ]로 남겨 줘.

알아두세요!

메타 설명을 설정했다고 해서 구글 검색 순위가 자동으로 올라가는 것은 아닙니다. 검색엔진이 실제 검색어에 따라 다른 설명을 표시할 수도 있습니다.

7-2. 없는 페이지와 깨진 링크 점검하기

홈페이지 주소를 잘못 입력하면 페이지를 찾을 수 없다는 화면이 나타납니다.

이때 아무런 안내가 없다면 방문자는 홈페이지에 문제가 생겼다고 생각할 수 있습니다.

404 페이지를 별도로 만들어 홈으로 돌아갈 수 있도록 안내하는 것이 좋습니다.

404 페이지 개선 프롬프트
내 홈페이지 디자인에 맞는 404 페이지를 만들어 줘.

잘못된 주소로 들어온 방문자에게
친절한 안내 문구를 보여 줘.

홈페이지 첫 화면으로 돌아가는 버튼도 만들어 줘.

추가로 홈페이지 전체를 점검해 줘.

1. 눌러도 이동하지 않는 링크
2. 잘못된 주소로 연결되는 링크
3. 표시되지 않는 이미지
4. 잘못된 페이지 연결

발견한 문제를 목록으로 정리해 줘.

8. AI가 만든 홈페이지 정보, 믿어도 될까?

이번 자료에서 특히 주목해야 할 부분입니다.

AI는 홈페이지를 빠르게 만들 수 있지만, 모든 정보를 정확하게 작성하는 것은 아닙니다.

예를 들어 실제로 존재하지 않는 고객 후기를 만들거나 확인되지 않은 경력을 소개 글에 넣을 수도 있습니다.

이런 정보가 홈페이지에 게시되면 방문자에게 잘못된 정보를 전달하게 됩니다.

따라서 홈페이지를 완성하기 전에 반드시 사실관계를 확인해야 합니다.

AI가 만든 정보 점검하기

최종 검수 프롬프트

내 홈페이지 전체를 점검해 줘.

아직 아무것도 수정하지 말고
문제가 될 수 있는 부분을 목록으로만 보여 줘.

다음 네 가지 항목을 집중적으로 확인해 줘.

1. 사실 확인이 필요한 내용
- 경력
- 숫자와 통계
- 고객 후기
- 주소와 전화번호

2. 출처가 불분명한 자료
- 이미지
- 글꼴
- 아이콘
- 외부 콘텐츠

3. 기술적인 오류
- 화면 오류
- 콘솔 오류
- 깨진 링크
- 작동하지 않는 기능

4. 개인정보 노출
- 개인 전화번호
- 이메일 주소
- 공개되면 안 되는 개인정보

실제로 확인되지 않은 내용은
사실이라고 단정하지 마.

AI가 만들어 낸 가짜 후기와 숫자는
반드시 확인이 필요하다고 표시해 줘.

여기서 중요한 원칙은 간단합니다.

  • 실제로 하지 않은 경력을 넣지 않습니다.
  • 존재하지 않는 고객 후기를 만들지 않습니다.
  • 확인되지 않은 통계와 숫자를 사용하지 않습니다.
  • 이미지와 글꼴의 사용 권리를 확인합니다.
  • 공개해도 되는 개인정보인지 확인합니다.

AI가 만들어 준 문장이라고 해서 사실이 되는 것은 아닙니다.

9. 마지막 단계: 저장하고 홈페이지에 반영하기

모든 수정이 끝났다면 마지막으로 변경 사항을 저장해야 합니다.

자료에서 안내하는 방식은 Git을 활용한 커밋과 푸시입니다.

쉽게 설명하면 다음과 같습니다.

  • 커밋(Commit): 현재 수정 내용을 기록하는 것
  • 푸시(Push): 기록한 내용을 원격 저장소에 올리는 것
  • 배포(Deploy): 실제 방문자가 접속하는 홈페이지에 변경 내용을 반영하는 것

커밋과 푸시만으로 홈페이지가 자동으로 바뀌는 것은 아닙니다. 사용하는 호스팅 서비스의 자동 배포 설정에 따라 별도의 배포 과정이 필요할 수 있습니다.

마지막 작업 프롬프트
오늘 수정한 내용을 한 줄로 요약해서
Git 커밋 메시지를 작성해 줘.

먼저 변경된 파일과 내용을 확인하고
문제가 없는지 점검해 줘.

테스트 결과와 변경 사항을 나에게 보여 줘.

내가 승인하기 전에는 커밋이나 푸시를 하지 마.

승인 후에는 커밋하고 푸시해 줘.

푸시가 완료되면 배포 상태를 확인하고
실제 홈페이지에 접속해 변경된 화면이
정상적으로 표시되는지 확인해 줘.

실패한 작업이 있으면 그 내용을 알려 줘.

특히 푸시하기 전에는 변경된 파일을 직접 확인하는 것이 좋습니다.

이전 상태로 되돌릴 수 있도록 Git 기록도 유지하세요.

10. 실제 홈페이지 개선은 어떤 순서로 할까?

지금까지 살펴본 내용을 처음부터 모두 적용할 필요는 없습니다.

초보자라면 다음 순서대로 진행하는 것을 추천합니다.

  1. 첫째: 홈페이지의 문제점 진단하기
  2. 둘째: 색상과 글꼴 통일하기
  3. 셋째: 첫 화면과 소개 문구 개선하기
  4. 넷째: 여백과 정렬 정돈하기
  5. 다섯째: 휴대폰 화면 최적화하기
  6. 여섯째: FAQ와 문의 버튼 만들기
  7. 일곱째: 검색 및 SNS 공유 정보 설정하기
  8. 여덟째: 오류와 사실관계 확인하기
  9. 아홉째: 변경 내용을 저장하고 배포하기

오늘의 핵심 정리

홈페이지를 잘 만드는 것만큼 중요한 것은 꾸준히 개선하는 것입니다.

안티그래비티 AI를 활용하면 디자인과 콘텐츠, 모바일 화면, 검색 설정까지 단계적으로 개선할 수 있습니다.

AI에게 모든 것을 맡기기보다, AI가 제안하고 사람이 확인하는 방식으로 작업하세요.

자주 묻는 질문(FAQ)

Q1. 코딩을 전혀 몰라도 홈페이지를 개선할 수 있나요?

네. 원하는 결과를 쉬운 말로 설명하고 프롬프트를 활용하면 AI의 도움을 받아 홈페이지를 개선할 수 있습니다. 다만 결과 확인과 기본적인 파일 관리 방법은 익혀 두는 것이 좋습니다.

Q2. 프롬프트를 한꺼번에 여러 개 입력해도 되나요?

가능하면 하나씩 입력하는 것이 좋습니다. 작업을 나누면 수정 결과를 확인하기 쉽고 문제가 발생했을 때 원인을 찾기도 편합니다.

Q3. AI가 홈페이지를 잘못 수정하면 어떻게 하나요?

수정 전 Git 기록이 있다면 이전 상태로 되돌릴 수 있습니다. Git을 사용하지 않는다면 수정 전 파일을 별도로 백업해 두는 것이 좋습니다.

Q4. 모바일 최적화는 꼭 해야 하나요?

네. 스마트폰으로 방문하는 사람도 편리하게 이용할 수 있도록 반응형 디자인을 적용하는 것이 좋습니다.

Q5. SEO 설정만 하면 구글 검색 상위에 노출되나요?

그렇지는 않습니다. 제목과 설명은 기본적인 설정입니다. 실제 검색 노출에는 콘텐츠의 품질, 검색 의도와의 일치, 사이트 구조, 기술적인 상태 등 다양한 요소가 영향을 줍니다.

Q6. AI가 작성한 고객 후기와 실적을 사용해도 되나요?

실제 고객의 동의와 확인 없이 AI가 만들어 낸 후기를 실제 경험처럼 게시하면 안 됩니다. 실적과 통계도 확인할 수 있는 근거가 있어야 합니다.

마치며: 홈페이지는 만들고 끝나는 것이 아닙니다

처음 만든 홈페이지가 완벽할 필요는 없습니다.

중요한 것은 방문자의 입장에서 부족한 점을 찾고 하나씩 개선하는 것입니다.

오늘 소개한 프롬프트를 활용해 작은 부분부터 바꿔 보세요.

첫 화면의 문장 하나를 바꾸는 것부터 시작해도 좋습니다. 그다음에는 모바일 화면을 점검하고, 방문자가 쉽게 문의할 수 있도록 버튼을 만들어 보세요.

그리고 마지막으로 반드시 기억하세요.

AI는 훌륭한 작업 도구이지만, 최종 결과에 대한 책임은 홈페이지를 운영하는 사람에게 있습니다.

AI의 편리함을 활용하면서도 사실을 확인하고 안전하게 관리하는 것. 그것이 좋은 홈페이지를 만드는 중요한 방법입니다.

2026년 11월 9일 월요일

구글 애널리틱스 GA4 설치 방법|웹사이트 방문자와 유입 경로 확인하기

웹사이트를 만들고 인터넷에 공개했다면 다음으로 궁금해지는 것이 있습니다.

과연 누가 내 웹사이트에 방문하고 있을까요?

방문자는 몇 명인지, 구글 검색으로 들어왔는지, 스마트폰으로 접속했는지 알고 싶을 것입니다.

이런 정보를 확인할 수 있는 도구가 바로 구글 애널리틱스(Google Analytics 4, GA4)입니다.

이번 글에서는 GA4 계정 만들기부터 Next.js 웹사이트 연결, 실시간 방문자 확인, 방문 통계 분석까지 초보자도 쉽게 따라 할 수 있도록 설명하겠습니다.

구글 애널리틱스 GA4 웹사이트 방문자 통계와 접속 기기 분석


이 글에서 배울 내용
  • 구글 애널리틱스란 무엇인가?
  • GA4 계정과 측정 ID 만들기
  • AI를 이용해 웹사이트에 설치하기
  • 실시간 방문자 확인하기
  • 방문 경로와 접속 기기 분석하기
  • 구글 서치 콘솔과 연결하기
  • 개인정보처리방침과 애드센스 알아보기

1. 구글 애널리틱스란 무엇인가?

구글 애널리틱스는 웹사이트 방문자의 행동을 분석하는 무료 서비스입니다.

쉽게 말하면 내 웹사이트에 설치하는 방문자 통계 시스템입니다.

오프라인 가게를 생각해 보세요.

가게에 손님이 몇 명 왔는지, 어떤 상품을 구경했는지, 어디에서 찾아왔는지 알 수 있다면 장사를 개선하는 데 도움이 됩니다.

웹사이트도 마찬가지입니다.

GA4로 확인할 수 있는 정보
  • 방문자 수와 활성 사용자 수
  • 방문자가 접속한 지역
  • 스마트폰과 컴퓨터의 접속 비율
  • 방문자가 처음 들어온 경로
  • 사람들이 많이 보는 페이지
  • 페이지에서 발생한 주요 행동

서치 콘솔과 애널리틱스의 차이

지난 글에서 구글 서치 콘솔을 등록했습니다. 그렇다면 애널리틱스와 무엇이 다를까요?

구글 서치 콘솔

구글 검색에서 내 웹사이트가 어떻게 보이는지 확인합니다.

  • 어떤 검색어로 노출되었는가?
  • 검색 결과에 얼마나 나타났는가?
  • 검색을 통해 얼마나 클릭했는가?

구글 애널리틱스

웹사이트에 들어온 방문자가 무엇을 하는지 확인합니다.

  • 몇 명이 방문했는가?
  • 어떤 경로로 들어왔는가?
  • 어떤 페이지를 보았는가?

두 서비스를 함께 사용하면 검색 결과부터 실제 방문자의 행동까지 파악할 수 있습니다.

2. 구글 애널리틱스 계정 만들기

먼저 구글 애널리틱스에 접속합니다.

구글 애널리틱스 바로가기 →

가능하면 지난번 구글 서치 콘솔에 등록했던 것과 같은 구글 계정을 사용하세요.

① 계정 생성

  1. 구글 계정으로 로그인합니다.
  2. 측정 시작 또는 계정 만들기를 선택합니다.
  3. 계정 이름을 입력합니다.
  4. 데이터 공유 설정을 확인합니다.
  5. 다음 단계로 이동합니다.

계정 이름은 관리하기 편한 이름이면 됩니다.

예를 들어 개인 웹사이트라면 '나의 웹사이트'라고 입력해도 좋습니다.

② 속성 만들기

이번에는 속성을 만듭니다.

속성은 애널리틱스에서 웹사이트의 데이터를 관리하는 공간입니다.

  1. 속성 이름을 입력합니다.
  2. 보고 시간대를 대한민국으로 변경합니다.
  3. 통화를 대한민국 원(KRW)으로 변경합니다.
  4. 다음 단계로 이동합니다.
중요한 설정

시간대가 미국으로 설정되어 있으면 방문 통계의 날짜와 시간이 한국 시간과 다르게 표시될 수 있습니다. 대한민국 시간대로 변경하세요.

③ 비즈니스 정보 입력

웹사이트의 운영 목적에 맞게 선택하면 됩니다.

  • 업종: 내 웹사이트와 가장 가까운 분야
  • 규모: 개인 또는 소규모 운영에 맞는 항목

정확히 일치하는 업종이 없다면 가장 가까운 항목을 선택하면 됩니다.

④ 비즈니스 목표 선택

여러 가지 목표가 표시됩니다.

개인 웹사이트라면 웹 또는 앱 트래픽 파악과 관련된 목표를 선택합니다.

화면에 표시되는 안내에 따라 만들기 또는 다음을 누릅니다.

⑤ 약관 동의

약관 화면에서 국가를 대한민국으로 선택합니다.

필요한 동의 항목을 확인하고 동의합니다.

3. 웹사이트 데이터 수집 설정하기

계정과 속성을 만들었다면 이제 방문자 데이터를 수집할 웹사이트를 등록해야 합니다.

① 웹 데이터 수집 선택

데이터 수집 방법을 선택하는 화면이 나타납니다.

여기서 웹(Web)을 선택합니다.

Android 앱이나 iOS 앱이 아니라 웹사이트를 선택해야 합니다.

② 웹사이트 주소 입력

웹사이트 주소와 스트림 이름을 입력합니다.

예를 들어 Vercel에 다음과 같이 배포했다면,

https://mywebsite.vercel.app

주소 입력 화면에서는 프로토콜과 주소 칸이 나뉘어 있을 수 있습니다.

  • 앞부분: HTTPS 선택
  • 뒷부분: mywebsite.vercel.app 입력
  • 스트림 이름: 내가 알아보기 쉬운 사이트 이름

입력을 마치면 만들기 또는 스트림 생성 버튼을 누릅니다.

③ 측정 ID 확인하기

웹 스트림이 생성되면 측정 ID가 발급됩니다.

측정 ID는 G-로 시작하는 문자와 숫자의 조합입니다.

예를 들면 다음과 같은 형태입니다.

G-XXXXXXXXXX

이 번호가 웹사이트와 구글 애널리틱스를 연결하는 식별자입니다.

측정 ID와 API 키는 다릅니다.

API 키는 외부에 노출되지 않도록 보호해야 하는 경우가 많습니다.

반면 GA4 측정 ID는 웹페이지에 포함되는 공개 식별자입니다. 비밀번호처럼 숨길 필요는 없습니다.

측정 ID를 복사해 메모장에 잠시 보관합니다.

설정 창을 닫았다면 다음 경로에서 다시 확인할 수 있습니다.

관리 → 데이터 스트림 → 등록한 웹 스트림 → 측정 ID

4. AI를 이용해 웹사이트에 GA4 설치하기

이제 발급받은 측정 ID를 웹사이트에 연결하겠습니다.

Next.js와 Vercel로 만든 웹사이트라면 AI 코딩 도구를 활용하면 편리합니다.

직접 코드를 작성할 필요 없이 설치 작업을 요청할 수 있습니다.

① AI 코딩 도구 실행하기

Antigravity 등 사용 중인 AI 코딩 도구를 실행합니다.

그리고 내 웹사이트 프로젝트를 엽니다.

예를 들어 프로젝트 이름이 my-first-site라면 해당 폴더를 열면 됩니다.

② 아래 프롬프트 복사하기

GA4 설치 요청 프롬프트

아래 내용을 복사해서 AI에게 입력하세요.

이 사이트는 Next.js App Router 프로젝트야.

구글 애널리틱스(GA4)를 모든 페이지에 설치해줘.

측정 ID:
G-내측정ID

설치 조건:

1. Next.js 공식 패키지인
@next/third-parties의 GoogleAnalytics를 사용해줘.

2. app/layout.tsx에 설치해줘.
src/app/layout.tsx 구조라면 해당 파일을 사용해줘.

3. 현재 프로젝트의 Next.js 버전에 맞는
패키지를 설치해줘.

4. Next.js 버전은 업그레이드하지 마.

5. 기존 레이아웃과 기능은 변경하지 말고
필요한 부분만 수정해줘.

6. 빌드 오류가 없는지 확인해줘.

7. 작업이 끝나면 커밋하고 GitHub에 push해줘.

커밋 메시지:
구글 애널리틱스 연결

여기서 G-내측정ID 부분을 실제 발급받은 측정 ID로 바꿔야 합니다.

③ AI 작업 허용하기

AI가 필요한 패키지를 설치하거나 파일을 수정할 때 실행 허용 창이 나타날 수 있습니다.

변경 내용과 실행 명령을 확인한 뒤 허용합니다.

패키지 설치, 빌드 검사, GitHub push 과정에서 여러 번 허용을 요청할 수 있습니다.

④ GitHub와 Vercel 배포 확인

AI가 작업을 완료하면 다음 순서로 확인합니다.

  1. 변경된 app/layout.tsx 파일을 확인합니다.
  2. GoogleAnalytics 컴포넌트가 추가되었는지 확인합니다.
  3. GitHub에 커밋과 push가 완료되었는지 확인합니다.
  4. Vercel에서 최신 배포 상태가 Ready인지 확인합니다.

정상적으로 설치되었다면 웹사이트 전체 페이지에서 방문 데이터를 수집할 수 있는 상태가 됩니다.

참고하세요.

GA4 설치 방식은 프로젝트의 Next.js 버전과 구성에 따라 달라질 수 있습니다. AI가 기존 버전을 유지하면서 설치하도록 요청하는 것이 중요합니다.

5. 실시간 방문자 확인하기

이제 가장 재미있는 단계입니다.

내가 만든 웹사이트에 실제로 방문자가 들어오는지 확인해 보겠습니다.

① Vercel 배포 상태 확인

먼저 Vercel에 접속합니다.

최신 배포가 Ready 상태인지 확인합니다.

② GA4 실시간 보고서 열기

구글 애널리틱스로 돌아갑니다.

왼쪽 메뉴에서 다음 항목을 선택합니다.

보고서 → 실시간 개요

③ 내 웹사이트 직접 방문하기

이제 브라우저에서 내 웹사이트를 엽니다.

약 30초에서 1분 정도 기다려 보세요.

실시간 보고서의 활성 사용자 숫자가 올라가는지 확인합니다.

실시간 확인 예시

컴퓨터에서 웹사이트 접속

활성 사용자 1명

스마트폰에서 같은 사이트 접속

활성 사용자 2명

이해를 돕기 위한 예시입니다. 실제 숫자는 방문 환경과 집계 방식에 따라 달라집니다.

내 방문이 실시간 보고서에 나타나면 GA4 연결이 정상적으로 작동하고 있다는 뜻입니다.

④ 스마트폰에서도 접속하기

이번에는 스마트폰으로 내 웹사이트를 열어 보세요.

실시간 보고서에서 활성 사용자와 기기 정보가 바뀌는지 확인합니다.

가족이나 친구에게도 주소를 보내 방문을 부탁해 보세요.

다른 사람이 내 웹사이트에 방문하는 모습도 실시간으로 확인할 수 있습니다.

6. 꼭 알아야 할 GA4 보고서 3가지

GA4에는 다양한 보고서가 있습니다.

처음부터 모든 메뉴를 공부할 필요는 없습니다.

초보자는 다음 세 가지부터 익히면 충분합니다.

① 트래픽 획득 보고서

방문자가 어디에서 들어왔는지 확인하는 보고서입니다.

예를 들어 다음과 같은 방문 경로를 확인할 수 있습니다.

  • 구글이나 네이버 검색
  • 다른 웹사이트의 링크
  • 카카오톡과 SNS 공유 링크
  • 주소를 직접 입력한 방문

이 보고서를 보면 어떤 경로가 내 웹사이트 방문에 도움이 되는지 알 수 있습니다.

메뉴 위치는 보통 보고서 → 획득 영역에서 찾을 수 있습니다.

② 기술 세부정보 보고서

방문자가 어떤 기기로 접속했는지 확인합니다.

대표적으로 다음 정보를 볼 수 있습니다.

  • 스마트폰
  • 데스크톱 컴퓨터
  • 태블릿
  • 브라우저와 운영체제

예를 들어 스마트폰 방문자가 대부분이라면 모바일 화면을 더 편리하게 개선하는 것이 좋습니다.

③ 페이지 및 화면 보고서

어떤 페이지가 많이 조회되었는지 확인합니다.

방문자가 특정 글을 많이 읽는다면 그 주제에 관심이 높다는 뜻일 수 있습니다.

이 데이터를 이용하면 다음 콘텐츠를 기획하는 데 도움이 됩니다.

메뉴는 보통 보고서 → 참여도 → 페이지 및 화면에서 확인할 수 있습니다.

처음에는 이것만 기억하세요.
  • 트래픽 획득: 어디에서 왔을까?
  • 기술 세부정보: 어떤 기기로 왔을까?
  • 페이지 및 화면: 무엇을 보았을까?

일반 보고서는 데이터가 처리되는 데 시간이 걸릴 수 있습니다. 설치 직후 숫자가 적거나 비어 있어도 실시간 보고서부터 확인하세요.

7. 구글 서치 콘솔과 애널리틱스 연결하기

지난 시간에 등록한 구글 서치 콘솔을 GA4와 연결할 수 있습니다.

두 서비스를 연결하면 검색 데이터와 방문 데이터를 함께 분석하는 데 도움이 됩니다.

① 제품 링크 메뉴 열기

구글 애널리틱스 왼쪽 아래의 관리 메뉴를 선택합니다.

다음 경로로 이동합니다.

관리 → 제품 링크 → Search Console 링크

② 서치 콘솔 속성 선택

연결 버튼을 누르고 지난 시간에 등록했던 웹사이트를 선택합니다.

해당 사이트의 소유권이 확인되어 있어야 합니다.

③ 웹 스트림 연결

  1. 연결할 Search Console 속성을 선택합니다.
  2. 내 웹사이트를 확인합니다.
  3. 웹 스트림을 선택합니다.
  4. 다음과 제출을 눌러 연결을 완료합니다.

목록에 내 사이트가 보이지 않는다면 다음을 확인하세요.

  • 두 서비스가 같은 구글 계정인지 확인합니다.
  • 서치 콘솔에서 소유권이 확인되었는지 확인합니다.
  • GA4 속성에 필요한 권한이 있는지 확인합니다.

연결 후 검색 관련 보고서가 표시되기까지 시간이 걸릴 수 있습니다.

8. 방문 통계 안내와 개인정보처리방침

웹사이트에 방문자 분석 기능을 설치했다면 방문자에게 어떤 데이터를 수집하는지 안내하는 것도 중요합니다.

GA4는 방문과 사용 행태를 분석하기 위한 데이터를 수집합니다.

따라서 웹사이트 하단에 방문 통계 사용 사실을 안내하고 개인정보처리방침을 준비하는 것이 좋습니다.

① 웹사이트 하단에 안내 문구 넣기

AI에게 다음과 같이 요청할 수 있습니다.

AI 요청 프롬프트
내 웹사이트 하단에 방문 통계 사용 안내를 추가해줘.

안내 내용:
이 사이트는 방문 통계 분석을 위해
Google Analytics를 사용합니다.

1. 개인정보처리방침 페이지를 만들어줘.
2. 웹사이트 하단에 개인정보처리방침 링크를 추가해줘.
3. 실제 사용하는 데이터 수집 기능에 맞게
개인정보처리방침 초안을 작성해줘.
4. 불필요한 개인정보 수집 내용을
임의로 추가하지 마.
5. 내가 직접 검토하고 수정할 수 있도록
확인할 항목을 별도로 정리해줘.
6. 작업 후 커밋하고 GitHub에 push해줘.

② 개인정보처리방침 직접 확인하기

AI가 작성한 개인정보처리방침은 반드시 직접 검토해야 합니다.

특히 다음 내용을 확인하세요.

  • 웹사이트 운영자 정보
  • 실제로 수집하는 데이터의 종류
  • Google Analytics 사용 사실
  • 데이터 처리 목적과 보관 관련 안내
  • 문의할 수 있는 연락처
  • 시행일과 개인정보 관련 안내
주의할 점

개인정보처리방침은 단순한 형식 문서가 아닙니다. 실제 사이트에서 사용하는 분석 도구와 데이터 처리 방식에 맞아야 합니다. 필요한 동의와 쿠키 관련 조치도 운영 지역과 방문자에 적용되는 법규에 따라 검토하세요.

9. 구글 애드센스는 무엇일까?

웹사이트에 방문자가 늘어나면 광고 수익에도 관심이 생길 수 있습니다.

구글 애드센스는 웹사이트 운영자가 광고를 게재하고 광고 수익을 얻을 수 있도록 해주는 서비스입니다.

방문자가 내 사이트에 들어와 광고를 보거나 상호작용하면 정책과 광고 유형에 따라 수익이 발생할 수 있습니다.

애드센스에 관심이 있다면 아래 사이트에서 내용을 확인할 수 있습니다.

구글 애드센스 바로가기 →

애드센스 신청 전에 준비할 것

  • 직접 작성한 독창적인 콘텐츠
  • 방문자에게 도움이 되는 정보
  • 사용하기 편리한 웹사이트 구조
  • 개인정보처리방침 등 필요한 안내 페이지
  • 애드센스 프로그램 정책 준수

웹사이트를 만들자마자 광고 신청부터 할 필요는 없습니다.

먼저 유용한 콘텐츠를 충분히 준비하고 사이트를 안정적으로 운영하는 것이 좋습니다.

애드센스 승인 여부는 사이트 전체의 품질과 정책 준수 여부 등을 종합적으로 심사해 결정합니다.

10. 자주 발생하는 오류와 해결 방법

문제 1. 실시간 방문자가 표시되지 않아요.

다음 순서로 확인해 보세요.

  1. Vercel 배포 상태가 Ready인지 확인합니다.
  2. 측정 ID가 정확한지 확인합니다.
  3. GA4가 모든 페이지에 설치되었는지 확인합니다.
  4. 광고 차단 확장 프로그램을 잠시 끕니다.
  5. 시크릿 창에서 웹사이트를 다시 엽니다.
  6. 1~2분 정도 기다린 뒤 확인합니다.

문제 2. 측정 ID를 잃어버렸어요.

다시 발급받을 필요 없이 기존 ID를 확인하면 됩니다.

관리 → 데이터 스트림 → 내 웹사이트 스트림 → 측정 ID

문제 3. 측정 ID를 잘못 입력했어요.

AI에게 다음과 같이 요청합니다.

app/layout.tsx에 설치된 GA4 측정 ID를
다음 값으로 변경해줘.

새 측정 ID:
G-새로운측정ID

다른 설정은 수정하지 말고
빌드 확인 후 커밋하고 GitHub에 push해줘.

문제 4. Vercel 배포가 실패했어요.

Vercel의 Deployments 메뉴에서 실패한 배포를 선택합니다.

오류 메시지를 복사해 AI에게 전달합니다.

Vercel 배포가 실패했어.

아래 오류 메시지를 분석하고
문제가 발생한 파일을 찾아 수정해줘.

기존 Next.js 버전은 변경하지 말고
다른 기능도 유지해줘.

문제 5. 서치 콘솔 사이트가 목록에 나오지 않아요.

  • GA4와 서치 콘솔의 구글 계정을 확인합니다.
  • 서치 콘솔 소유권 인증 상태를 확인합니다.
  • 필요한 계정 권한이 있는지 확인합니다.

11. 설치 완료 후 최종 점검

이제 모든 설정이 끝났습니다.

다음 항목을 하나씩 확인해 보세요.

GA4 설치 확인
  • GA4 계정을 만들었는가?
  • 웹사이트 속성을 생성했는가?
  • G-로 시작하는 측정 ID를 받았는가?
  • Next.js 프로젝트에 설치했는가?
  • GitHub push가 완료되었는가?
  • Vercel 배포가 Ready인가?
방문자 분석 확인
  • 실시간 보고서에 방문자가 표시되는가?
  • 스마트폰 접속도 확인했는가?
  • 트래픽 획득 보고서를 확인했는가?
  • 기술 세부정보를 확인했는가?
  • 페이지 및 화면 보고서를 확인했는가?
운영 준비 확인
  • 서치 콘솔을 연결했는가?
  • 방문 통계 안내를 추가했는가?
  • 개인정보처리방침을 검토했는가?

마무리: 이제 내 웹사이트의 방문자를 분석해 보세요

웹사이트를 만드는 것과 운영하는 것은 조금 다릅니다.

웹사이트를 만들었다면 사람들이 실제로 방문하는지 확인해야 합니다.

어떤 콘텐츠를 좋아하는지, 어디에서 방문하는지, 스마트폰과 컴퓨터 중 어떤 기기를 많이 사용하는지 알아야 사이트를 개선할 수 있습니다.

구글 애널리틱스는 이런 정보를 확인할 수 있는 유용한 도구입니다.

처음부터 복잡한 분석을 할 필요는 없습니다.

먼저 방문자 수를 확인하고, 유입 경로와 인기 페이지를 살펴보세요.

작은 데이터가 쌓이면 내 웹사이트를 어떻게 발전시켜야 할지 조금씩 보이기 시작할 것입니다.

바이브코딩 웹사이트 검색 등록 방법|구글·네이버 서치 콘솔과 사이트맵 설정

바이브코딩으로 웹사이트를 만들었다면 이제 해야 할 일이 있습니다. 바로 구글과 네이버에 내 웹사이트를 등록하는 것입니다.

웹사이트를 만들었다고 해서 자동으로 검색 결과에 나타나는 것은 아닙니다. 검색엔진이 내 사이트를 발견하고 내용을 수집할 수 있도록 알려줘야 합니다.

이번 글에서는 Vercel과 Next.js로 만든 웹사이트를 기준으로 검색 등록부터 사이트맵 설정, 카카오톡 공유 미리보기까지 차근차근 알아보겠습니다.

바이브코딩으로 만든 웹사이트의 구글 네이버 검색 등록과 사이트맵 SEO 설정


이번 글에서 배울 내용
  • 구글 서치 콘솔에 웹사이트 등록하기
  • 네이버 서치어드바이저에 사이트 등록하기
  • 사이트 소유권 확인하기
  • sitemap.xml 만들기
  • robots.txt 만들기
  • 카카오톡 미리보기 카드 설정하기

1. 웹사이트를 검색엔진에 등록해야 하는 이유

인터넷에 웹사이트를 공개했다고 해서 구글이나 네이버가 즉시 그 사이트를 검색 결과에 보여주는 것은 아닙니다.

검색엔진은 인터넷을 돌아다니며 새로운 웹사이트를 발견하고 내용을 수집합니다. 이때 사이트 운영자가 검색엔진에 자신의 사이트를 알려주면 발견과 수집을 돕는 데 유리합니다.

이 과정을 이해하기 쉽게 비유해 보겠습니다.

웹사이트 = 새로 출판한 책

구글과 네이버 = 책을 보관하는 도서관

검색 등록 = 도서관에 책을 등록하는 신청서

사이트맵 = 책에 들어 있는 목차

웹사이트를 만들었다면 이제 검색엔진이라는 도서관에 내 사이트를 알려줘야 합니다.

오늘은 구글과 네이버 두 곳에 등록하겠습니다.

2. 구글 서치 콘솔에 사이트 등록하기

먼저 구글에 내 웹사이트를 등록하겠습니다.

구글 서치 콘솔(Google Search Console)은 구글 검색에서 내 웹사이트가 어떻게 수집되고 노출되는지 확인할 수 있는 무료 서비스입니다.

아래 주소로 접속합니다.

구글 서치 콘솔 바로가기 →

① 웹사이트 추가하기

  1. 구글 계정으로 로그인합니다.
  2. 처음 사용하는 경우 웹사이트 추가를 선택합니다.
  3. 기존 사용자는 왼쪽 위 속성 메뉴에서 속성 추가를 선택합니다.
  4. 오른쪽에 있는 URL 접두어를 선택합니다.

여기서 중요한 점이 있습니다. 초보자는 왼쪽의 도메인 방식보다 오른쪽의 URL 접두어 방식을 이용하면 HTML 태그로 간편하게 소유권을 확인할 수 있습니다.

주의!

URL 접두어에는 반드시 https://부터 시작하는 전체 주소를 입력해야 합니다.

예를 들어 다음과 같습니다.

https://mywebsite.vercel.app

실제 사용하는 도메인 주소를 입력한 다음 계속을 누릅니다.

② HTML 확인 태그 복사하기

웹사이트 소유권을 확인하는 여러 방법이 나타납니다.

여기서 HTML 태그를 선택합니다.

다음과 비슷한 코드가 나타납니다.

<meta name="google-site-verification"
content="발급받은인증코드" />

이 코드를 복사해서 메모장에 임시로 보관합니다.

아직 확인 버튼을 누르지 마세요. 먼저 내 웹사이트에 이 태그를 넣어야 합니다.

3. 네이버 서치어드바이저 등록하기

구글 등록이 끝나면 네이버에도 등록해야 합니다.

네이버 서치어드바이저는 네이버 검색에서 내 웹사이트가 수집되고 검색될 수 있도록 관리하는 서비스입니다.

아래 주소로 접속합니다.

네이버 서치어드바이저 바로가기 →

① 사이트 등록하기

  1. 네이버 계정으로 로그인합니다.
  2. 웹마스터 도구를 선택합니다.
  3. 사이트 등록 칸에 내 웹사이트 주소를 입력합니다.
  4. 등록 버튼을 누릅니다.

② HTML 태그 복사하기

사이트 소유권 확인 화면이 나타납니다.

확인 방법 중 HTML 태그를 선택합니다.

다음과 같은 코드가 표시됩니다.

<meta name="naver-site-verification"
content="발급받은인증코드" />

이 코드도 복사해서 메모장에 보관합니다.

이제 메모장에는 구글과 네이버의 확인 태그 두 개가 들어 있습니다.

4. 바이브코딩 AI에게 확인 태그 설치 요청하기

이제 복사한 확인 태그를 실제 웹사이트에 넣어야 합니다.

직접 코드를 수정할 필요는 없습니다. Antigravity와 같은 AI 코딩 도구에 요청하면 됩니다.

Next.js App Router 프로젝트에서는 보통 app/layout.tsx 파일의 metadata 설정에 인증 정보를 넣습니다.

AI에게 그대로 입력할 프롬프트

아래 내용을 복사해서 사용하세요.

이 사이트는 Next.js App Router 프로젝트야.

구글 서치 콘솔과 네이버 서치어드바이저의 소유권 확인 태그를 추가해줘.

1. app/layout.tsx의 metadata에 verification 설정을 추가해줘.
2. 구글 인증 코드는 google 항목에 content 값만 넣어줘.
3. 네이버 인증 코드는 other 항목에 naver-site-verification 이름으로 content 값만 넣어줘.
4. 기존 metadata와 다른 코드는 수정하지 마.
5. 작업이 끝나면 변경된 코드를 확인해줘.
6. 커밋 메시지는 "검색 등록 확인 태그"로 작성하고 GitHub에 push해줘.

구글 인증 코드:
[구글에서 복사한 content 값]

네이버 인증 코드:
[네이버에서 복사한 content 값]

AI가 작업을 마치면 변경된 파일을 확인하고 허용 또는 Accept all을 선택합니다.

GitHub에 push한 다음 Vercel에서 배포가 완료될 때까지 기다립니다.

Vercel의 배포 상태가 Ready인지 확인하는 것이 중요합니다.

설치가 제대로 되었는지 확인하기

  1. Vercel에서 최신 배포 상태가 Ready인지 확인합니다.
  2. 내 웹사이트를 엽니다.
  3. 키보드에서 Ctrl + U를 누릅니다.
  4. 소스 코드 화면에서 Ctrl + F를 누릅니다.
  5. verification을 검색합니다.
  6. 구글과 네이버 인증 정보가 들어 있는지 확인합니다.

태그가 정상적으로 보이면 다시 구글 서치 콘솔로 돌아갑니다.

HTML 태그 확인 버튼을 누릅니다. 구글에서 소유권이 확인되었다는 메시지가 나타나면 성공입니다.

네이버에서도 소유확인을 누르고 필요한 보안 문자를 입력합니다.

소유권 확인 완료!

이제 구글과 네이버에 내 웹사이트가 누구의 사이트인지 알려주는 과정이 끝났습니다.

5. 사이트맵(sitemap.xml) 만들기

이제 검색엔진이 내 웹사이트의 페이지를 쉽게 찾을 수 있도록 사이트맵을 만들어야 합니다.

사이트맵(Sitemap)은 웹사이트에 어떤 페이지가 있는지 알려주는 지도와 같습니다.

검색 로봇이 사이트의 구조와 페이지 주소를 파악하는 데 도움을 줍니다.

Next.js에서는 별도의 XML 파일을 직접 만들지 않아도 됩니다. 공식 규칙에 따라 app/sitemap.ts 파일을 만들면 됩니다.

① 사이트맵 만들기 요청

AI에게 입력할 프롬프트
Next.js 공식 규칙에 맞게 사이트맵을 만들어줘.

1. app/sitemap.ts 파일을 생성해줘.
2. 내 사이트 주소는 다음과 같아.

https://내사이트주소

3. 현재 메인 페이지(/)를 사이트맵에 포함해줘.
4. Next.js MetadataRoute.Sitemap 형식을 사용해줘.
5. 다른 파일은 불필요하게 수정하지 마.
6. 작업 후 커밋하고 GitHub에 push해줘.

커밋 메시지:
사이트맵과 미리보기 카드

작업이 끝나면 app 폴더 안에 sitemap.ts 파일이 생성되었는지 확인합니다.

② 사이트맵이 만들어졌는지 확인하기

Vercel 배포가 완료되면 인터넷 주소창에 다음 주소를 입력합니다.

https://내사이트주소/sitemap.xml

XML 형식의 주소 목록이 나타나면 정상적으로 작동하는 것입니다.

화면에 글자와 주소만 가득 나타나도 걱정하지 마세요. 검색 로봇이 읽는 사이트 지도이기 때문에 정상입니다.

6. robots.txt 만들기

사이트맵을 만들었다면 이번에는 robots.txt를 설정합니다.

robots.txt는 검색 로봇에게 웹사이트의 어느 부분을 방문해도 되는지 알려주는 안내판입니다.

예를 들어 모든 검색 로봇이 사이트를 방문할 수 있도록 허용할 수 있습니다.

① AI에게 robots.txt 생성 요청하기

Next.js에서는 app/robots.ts 파일을 생성하는 방법을 사용할 수 있습니다.

AI에게 입력할 프롬프트
Next.js 공식 규칙에 맞게 robots.txt를 만들어줘.

1. app/robots.ts 파일을 생성해줘.
2. 모든 검색 로봇의 사이트 접근을 허용해줘.
3. sitemap 주소를 지정해줘.

사이트 주소:
https://내사이트주소

4. 기존 파일은 불필요하게 수정하지 마.
5. 작업 후 GitHub에 push해줘.

② robots.txt 확인하기

배포가 끝나면 다음 주소를 열어 봅니다.

https://내사이트주소/robots.txt

다음과 비슷한 내용이 보이면 정상입니다.

User-Agent: *
Allow: /
Sitemap: https://내사이트주소/sitemap.xml
  • User-Agent: * 모든 검색 로봇을 의미합니다.
  • Allow: / 사이트 전체 접근을 허용합니다.
  • Sitemap: 사이트맵의 위치를 알려줍니다.

7. 카카오톡 공유 미리보기 설정하기

웹사이트 주소를 카카오톡으로 보냈는데 주소만 달랑 표시된다면 조금 아쉽겠죠?

제목과 설명, 대표 이미지까지 함께 표시되도록 설정할 수 있습니다.

이 기능을 오픈그래프(Open Graph, OG)라고 합니다.

오픈그래프를 설정하면 카카오톡이나 SNS에 웹사이트 주소를 공유할 때 미리보기 카드가 표시될 수 있습니다.

미리보기 카드에 표시되는 정보
  • 대표 이미지
  • 웹사이트 제목
  • 간단한 설명

① AI에게 오픈그래프 설정 요청하기

Next.js에서는 app/layout.tsx의 metadata에 관련 정보를 설정합니다.

AI에게 입력할 프롬프트
Next.js 공식 방식으로 카카오톡과 SNS 공유 미리보기를 설정해줘.

1. app/layout.tsx의 metadata를 수정해줘.
2. metadataBase에 내 웹사이트 주소를 설정해줘.

주소:
https://내사이트주소

3. title에 웹사이트 제목을 넣어줘.
4. description에 웹사이트 소개 문장을 넣어줘.
5. openGraph에 제목, 설명, 대표 이미지를 설정해줘.
6. 대표 이미지는 public 폴더에 있는 실제 이미지 중 하나를 사용해줘.
7. 이미지 경로와 주소가 올바르게 연결되는지 확인해줘.
8. 기존 설정은 유지하고 필요한 부분만 수정해줘.
9. 작업이 끝나면 GitHub에 push해줘.

여기서 가장 중요한 설정은 metadataBase입니다.

이 항목에는 실제로 사용하는 웹사이트 주소를 입력해야 합니다.

잘못된 주소를 입력하면 공유 이미지나 링크가 제대로 표시되지 않을 수 있습니다.

② 카카오톡에서 확인하기

  1. Vercel 배포가 완료되었는지 확인합니다.
  2. PC 카카오톡을 실행합니다.
  3. 나와의 채팅방을 엽니다.
  4. 내 웹사이트 주소를 입력해 전송합니다.
  5. 제목, 설명, 이미지가 표시되는지 확인합니다.

정상적으로 설정되었다면 웹사이트 주소 아래에 미리보기 카드가 나타납니다.

만약 이전 이미지나 제목이 계속 보인다면 카카오톡이 예전 정보를 저장하고 있을 수 있습니다.

이럴 때는 카카오 개발자 사이트의 공유 디버거를 이용해 캐시를 초기화한 다음 다시 확인합니다.

카카오 개발자 사이트 바로가기 →

8. 구글과 네이버에 사이트맵 제출하기

사이트맵과 robots.txt를 만들었다면 이제 구글과 네이버에 사이트맵을 제출해야 합니다.

① 구글 서치 콘솔에 제출하기

  1. 구글 서치 콘솔에 접속합니다.
  2. 등록한 내 웹사이트를 선택합니다.
  3. 왼쪽 메뉴에서 Sitemaps를 선택합니다.
  4. 새 사이트맵 추가 칸에 sitemap.xml을 입력합니다.
  5. 제출 버튼을 누릅니다.

구글에서는 다음과 같이 입력하면 됩니다.

sitemap.xml

사이트맵이 정상적으로 제출되었다는 메시지가 나타나면 완료입니다.

② 네이버 서치어드바이저에 제출하기

  1. 네이버 서치어드바이저에 로그인합니다.
  2. 등록한 사이트를 선택합니다.
  3. 요청 메뉴를 엽니다.
  4. 사이트맵 제출을 선택합니다.
  5. 전체 사이트맵 주소를 입력합니다.
  6. 확인 버튼을 누릅니다.

네이버에서는 다음과 같이 전체 주소를 입력합니다.

https://내사이트주소/sitemap.xml

필요하다면 같은 요청 메뉴에 있는 웹 페이지 수집 기능을 이용해 메인 페이지의 수집도 요청할 수 있습니다.

9. 내 웹사이트가 검색되는지 확인하기

이제 모든 등록 과정이 끝났습니다. 그렇다면 실제로 구글에서 내 사이트가 검색되는지 확인해 보겠습니다.

① 구글에서 검색 확인하기

구글 검색창에 다음과 같이 입력합니다.

site:내사이트주소

예를 들어 다음과 같습니다.

site:mywebsite.vercel.app

이 명령어는 특정 웹사이트에 포함된 페이지가 구글 검색에 색인되었는지 확인할 때 사용합니다.

② 검색 결과가 나오지 않는다면?

검색 등록을 완료했는데 아무것도 나오지 않을 수 있습니다.

이것은 반드시 오류가 발생했다는 뜻은 아닙니다.

검색엔진이 사이트를 발견하고 내용을 수집한 뒤 검색 결과에 반영하기까지 시간이 필요하기 때문입니다.

기억하세요!

사이트 등록과 검색 노출은 다른 과정입니다. 등록했다고 바로 검색되는 것은 아니며, 며칠에서 몇 주 이상 걸릴 수도 있습니다.

일주일 뒤 한 번, 한 달 뒤 한 번 다시 확인하는 것을 추천합니다.

10. 자주 발생하는 오류와 해결 방법

문제 1. 구글 소유권 확인에 실패하는 경우

  • Vercel 배포 상태가 Ready인지 확인합니다.
  • 웹사이트 소스 코드에 인증 태그가 들어 있는지 확인합니다.
  • 구글에 등록한 주소와 실제 웹사이트 주소가 같은지 확인합니다.
  • 문제가 없다면 다시 확인 버튼을 누릅니다.

문제 2. 네이버 소유권 확인이 안 되는 경우

  • 네이버 인증 태그가 제대로 들어 있는지 확인합니다.
  • Vercel 배포가 완료되었는지 확인합니다.
  • 소스 보기에서 naver-site-verification을 검색합니다.

문제 3. sitemap.xml을 열면 404 오류가 발생하는 경우

Next.js 프로젝트에 app/sitemap.ts 파일이 있는지 확인합니다.

AI에게 다음과 같이 요청하면 됩니다.

sitemap.xml을 열면 404 오류가 발생해.

app/sitemap.ts 파일이 있는지 확인하고
Next.js 공식 규칙에 맞게 수정해줘.

Vercel 배포 오류도 함께 확인해줘.

문제 4. 카카오톡 미리보기 이미지가 나오지 않는 경우

  • metadataBase에 실제 사이트 주소가 들어 있는지 확인합니다.
  • 대표 이미지가 public 폴더에 있는지 확인합니다.
  • 이미지 경로가 올바른지 확인합니다.
  • 카카오 공유 디버거에서 캐시를 초기화합니다.

문제 5. Vercel 배포가 실패하는 경우

Vercel의 Deployments 메뉴에서 실패한 배포를 선택합니다.

오류 메시지를 복사한 다음 AI에게 전달합니다.

Vercel 배포가 실패했어.

아래 오류 메시지를 분석하고
문제가 발생한 파일을 찾아 수정해줘.

다른 기능은 변경하지 말고
기존 기능이 정상적으로 작동하는지도 확인해줘.

11. 최종 점검 체크리스트

모든 작업이 끝났다면 다음 항목을 하나씩 확인해 보세요.

검색 등록

  • 구글 서치 콘솔에 사이트를 등록했는가?
  • 네이버 서치어드바이저에 사이트를 등록했는가?
  • 두 곳 모두 소유권 확인이 완료되었는가?

사이트 설정

  • app/sitemap.ts 파일이 있는가?
  • app/robots.ts 파일이 있는가?
  • sitemap.xml이 정상적으로 열리는가?
  • robots.txt가 정상적으로 열리는가?

공유 설정

  • metadataBase에 실제 사이트 주소가 들어 있는가?
  • 카카오톡 미리보기 이미지가 표시되는가?
  • 제목과 설명이 정상적으로 표시되는가?

마무리: 웹사이트를 만들었다면 검색엔진에도 알려주세요

바이브코딩으로 웹사이트를 만드는 것만큼 중요한 것이 검색엔진에 사이트를 등록하는 일입니다.

오늘 배운 내용을 정리하면 다음과 같습니다.

  1. 구글 서치 콘솔에서 웹사이트 소유권을 확인합니다.
  2. 네이버 서치어드바이저에서도 소유권을 확인합니다.
  3. Next.js의 sitemap.ts와 robots.ts를 생성합니다.
  4. 카카오톡 공유를 위한 오픈그래프를 설정합니다.
  5. 구글과 네이버에 사이트맵을 제출합니다.
  6. 시간이 지난 뒤 검색 결과를 확인합니다.

이제 여러분의 웹사이트는 검색엔진에 자신을 알릴 준비를 마쳤습니다.

다음 단계에서는 방문자가 내 사이트에 얼마나 들어오는지, 어떤 페이지를 많이 보는지 분석하는 방법을 알아보겠습니다.

다음 학습: 구글 애널리틱스 설정

웹사이트 방문자 수와 유입 경로, 페이지별 방문 현황을 확인하는 방법을 배워보겠습니다.

2026년 11월 2일 월요일

Vercel 도메인 연결 방법 완벽 가이드


VIBE CODING · WEBSITE GUIDE

Vercel 도메인 연결 방법

무료 주소 변경부터 개인 도메인 연결, DNS 설정까지 초보자도 쉽게 따라 할 수 있는 실전 가이드입니다.

AI로 웹사이트를 만들고 Vercel에 배포했다면 이제 나만의 주소를 연결할 차례입니다.

처음 배포하면 vercel.app이라는 주소가 제공됩니다. 이 주소를 그대로 사용해도 되지만, 개인 도메인을 연결하면 더욱 전문적인 웹사이트를 운영할 수 있습니다.

이번 글에서는 무료 주소 변경 방법과 개인 도메인 연결 방법을 단계별로 알아보겠습니다.

Vercel 도메인 연결 방법 완벽 가이드


이 글의 목차

  1. 도메인과 DNS 이해하기
  2. Vercel 도메인 연결 방식
  3. 무료 주소 변경하기
  4. 개인 도메인 구매하기
  5. Vercel에 도메인 등록하기
  6. A 레코드와 CNAME 설정하기
  7. 연결 오류 해결하기

01. 도메인과 DNS 이해하기

도메인은 인터넷에서 내 웹사이트를 찾아올 수 있도록 만들어 주는 주소입니다.

예를 들어 다음과 같은 주소가 있습니다.

google.com

naver.com

mywebsite.com

웹사이트는 실제로 서버의 IP 주소를 통해 접속합니다. 하지만 숫자로 된 주소는 기억하기 어렵기 때문에 사람이 쉽게 기억할 수 있는 도메인을 사용합니다.

DNS란 무엇일까?

DNS는 도메인 이름을 실제 서버 주소와 연결해 주는 시스템입니다.

도메인 : 웹사이트 주소

DNS : 도메인과 서버를 연결하는 시스템

DNS 레코드 : 연결에 필요한 설정 정보

02. Vercel 도메인 연결 방식

Vercel에서는 기본 제공 주소를 사용하거나 별도로 구매한 개인 도메인을 연결할 수 있습니다.

방법 A. 무료 Vercel 주소

예시: myblog.vercel.app

별도의 도메인 구매 비용 없이 사용할 수 있습니다. 개인 프로젝트나 테스트용 웹사이트에 적합합니다.

방법 B. 개인 도메인

예시: mywebsite.com

직접 구매한 도메인을 연결하는 방법입니다. 브랜드나 사업용 웹사이트에 적합합니다.

추천

처음에는 무료 Vercel 주소를 사용하세요. 웹사이트가 완성된 뒤 개인 도메인을 연결해도 늦지 않습니다.

03. 무료 Vercel 주소 변경하기

무료 주소는 별도의 도메인을 구매하지 않고 사용할 수 있습니다.

변경 전

my-first-site.vercel.app

변경 후 예시

myblog.vercel.app

STEP 1. Vercel 로그인

Vercel 대시보드 바로가기

로그인한 뒤 주소를 변경할 프로젝트를 선택합니다.

STEP 2. 프로젝트 설정

프로젝트의 Settings 메뉴에서 Domains 항목으로 이동합니다.

STEP 3. 주소 변경

현재 등록된 기본 주소를 확인합니다. 변경 가능한 주소 설정에서 원하는 이름을 지정합니다.

STEP 4. 저장 및 확인

변경 사항을 저장한 다음 새 주소로 접속합니다.

주의: 이미 다른 사용자가 등록한 주소는 사용할 수 없습니다. 또한 Vercel의 프로젝트 이름과 배포 도메인은 서로 다른 설정일 수 있으므로 Domains 메뉴에서 실제 연결 상태를 확인하세요.

04. 개인 도메인 구매하기

나만의 도메인을 사용하려면 먼저 도메인 등록 업체에서 원하는 주소를 구매해야 합니다.

국내에서는 가비아 등의 서비스를 이용할 수 있습니다.

가비아 공식 홈페이지 바로가기

구매 전 확인할 사항

  • 도메인 이름이 짧고 기억하기 쉬운가?
  • 첫해 등록 비용은 얼마인가?
  • 다음 해 갱신 비용은 얼마인가?
  • 자동 연장 설정은 어떻게 되어 있는가?
  • 원하는 도메인을 사용할 수 있는가?

특히 첫해 할인 가격만 확인하지 마세요. 다음 해 갱신 비용까지 비교하는 것이 좋습니다.

05. 구매한 도메인을 Vercel에 등록하기

STEP 1. Domains 메뉴 열기

Vercel 대시보드에서 연결할 프로젝트를 선택합니다.

Settings → Domains 메뉴로 이동합니다.

STEP 2. 도메인 추가

Add Domain 또는 Add Existing 버튼을 클릭합니다.

구매한 도메인 주소를 입력합니다.

mywebsite.com

입력할 때 https://는 제외합니다.

STEP 3. DNS 설정값 확인

도메인을 추가하면 Vercel에서 DNS 설정에 필요한 정보를 안내합니다.

이 정보를 확인한 다음 도메인 등록 업체의 DNS 관리 페이지로 이동합니다.

06. A 레코드와 CNAME 설정하기

DNS 설정에서 가장 많이 사용하는 레코드는 A 레코드와 CNAME입니다.

① A 레코드

A 레코드는 도메인을 IPv4 주소와 연결합니다.

항목 설정 예시
타입A
호스트@
값Vercel 안내 IP 주소

② CNAME 레코드

CNAME은 www와 같은 하위 도메인을 다른 도메인 이름으로 연결합니다.

항목 설정 예시
타입CNAME
호스트www
값Vercel 안내 주소
중요한 설정 주의사항

위 표는 이해를 돕기 위한 일반적인 예시입니다. 실제 IP 주소와 CNAME 값은 프로젝트별 안내에 따라 입력해야 합니다.

기존 DNS 레코드와 충돌하지 않는지도 확인하세요.

DNS 설정을 저장한 다음 Vercel로 돌아옵니다.

정상적으로 연결되면 Valid Configuration 상태를 확인할 수 있습니다.

07. 도메인 연결 확인하기

DNS 설정을 마쳤다면 다음 항목을 확인합니다.

연결 확인 체크리스트

□ Vercel Domains 메뉴에서 상태 확인

□ Valid Configuration 표시 확인

□ 기본 도메인 접속 테스트

□ www 주소 접속 테스트

□ HTTPS 보안 연결 확인

DNS 정보는 변경 후 전파되는 시간이 필요합니다. 따라서 설정 직후 접속되지 않더라도 잠시 기다린 후 다시 확인하세요.

08. 도메인 연결 오류 해결하기

Invalid Configuration 오류

DNS 레코드가 잘못되었거나 아직 전파되지 않았을 수 있습니다.

  • A 레코드 값 확인
  • CNAME 값 확인
  • 중복되거나 충돌하는 레코드 확인

기존 웹사이트가 계속 나타나는 경우

브라우저 캐시 또는 DNS 캐시 문제일 수 있습니다.

  • Ctrl + F5로 새로고침
  • 시크릿 창에서 접속
  • DNS 전파 시간 기다리기

SSL 인증서 오류

DNS 검증이 완료되지 않았거나 인증서 발급이 진행 중일 수 있습니다. Vercel의 도메인 상태를 먼저 확인하세요.

09. 도메인 연결 후 해야 할 일

도메인 연결이 완료되었다면 웹사이트 운영을 위한 마무리 작업을 진행하세요.

  • GitHub README에 새 주소 기록하기
  • 이메일 서명에 웹사이트 주소 추가하기
  • Google Search Console에 사이트 등록하기
  • www 주소와 기본 도메인 연결 확인하기
  • 도메인 갱신일 기록하기

마무리: 나만의 웹사이트 주소 만들기

Vercel 도메인 연결은 처음에는 복잡하게 느껴질 수 있습니다.

하지만 기본 원리를 이해하면 어렵지 않습니다.

무료 주소를 사용한다면 Vercel에서 기본 주소를 설정하면 됩니다. 개인 도메인을 사용한다면 도메인을 등록하고 DNS 레코드를 연결하면 됩니다.

처음에는 무료 주소로 시작하고, 웹사이트가 완성되면 나만의 도메인을 연결해 보세요.

AI 웹사이트 제작 · Vercel 활용 가이드


2026년 10월 31일 토요일

Gemini API 연결 방법: Google AI Studio와 Vercel로 나만의 AI 웹사이트 만들기

Gemini API 연결 방법 

Gemini API를 연결해 인공지능 답변 기능을 구현하는 웹사이트 구조


웹사이트에 인공지능 기능을 추가하고 싶으신가요? Gemini API 연결 방법을 알면 단순한 웹페이지를 사용자의 질문에 답하는 AI 웹사이트로 바꿀 수 있습니다.

이번 글에서는 Google AI Studio에서 API 키를 발급받고, Next.js로 만든 웹사이트에 Gemini를 연결하는 방법을 알아보겠습니다.

코딩을 처음 접하는 분도 따라 할 수 있도록 API 키 발급부터 Vercel 배포까지 단계별로 정리했습니다.

이번 글에서 완성할 기능

  • 웹사이트에서 사용자가 질문을 입력합니다.
  • 서버가 Gemini API에 질문을 전달합니다.
  • Gemini가 생성한 답변을 웹페이지에 표시합니다.
  • 로컬 컴퓨터와 인터넷에 공개된 사이트에서 모두 작동하는지 확인합니다.

1. Gemini API란 무엇인가?

Gemini API는 Google의 인공지능 모델을 외부 프로그램에서 사용할 수 있도록 제공하는 연결 통로입니다.

쉽게 말하면 웹사이트와 Gemini가 대화할 수 있도록 연결해 주는 창구입니다.

예를 들어 사용자가 웹사이트에 다음과 같이 입력했다고 가정해 보겠습니다.

사용자 질문

오늘 하루를 긍정적으로 시작할 수 있는 문장을 만들어 줘.

웹사이트는 이 질문을 서버로 전달합니다.

서버는 Gemini API를 통해 질문을 보내고, Gemini가 생성한 답변을 다시 웹사이트로 전달합니다.

이 과정은 다음과 같습니다.

사용자

질문 입력

↓

내 웹사이트

서버에 질문 전달

↓

Gemini API

인공지능 답변 생성

↓

내 웹사이트

답변을 화면에 표시

이처럼 API를 연결하면 별도의 인공지능 모델을 직접 개발하지 않아도 AI 기능을 웹사이트에 추가할 수 있습니다.

2. 실습용 스타터 프로젝트 준비하기

이번 실습에서는 화면이 미리 만들어진 프로젝트를 사용합니다.

화면을 처음부터 제작하는 대신, Gemini를 연결하는 부분에 집중할 수 있습니다.

① GitHub 스타터 저장소 열기

아래 주소를 열어 실습용 프로젝트를 확인합니다.

AI Mini App Starter GitHub 저장소

② 내 저장소 만들기

  1. GitHub에 로그인합니다.
  2. 저장소 오른쪽 위의 Use this template을 누릅니다.
  3. Create a new repository를 선택합니다.
  4. Repository name에 my-first-ai-app을 입력합니다.
  5. 공개 범위는 Public을 선택합니다.
  6. Create repository를 눌러 저장소를 만듭니다.

이제 내 계정에 실습용 프로젝트가 복사됩니다.

③ 내 컴퓨터로 프로젝트 가져오기

안티그래비티에서 File → Open Folder를 선택합니다.

바탕화면에 my-first-ai-app이라는 새 폴더를 만들고 엽니다.

그다음 AI 도구에 다음 내용을 요청합니다.

복사용 프롬프트

이 폴더는 비어 있습니다. GitHub에 만든 내 저장소를 현재 폴더 안으로 받아 주세요. git clone 주소 . 명령을 사용해 주세요. 그다음 npm install을 실행해 필요한 패키지를 설치해 주세요. 작업이 끝나면 결과를 한국어로 설명해 주세요.

여기서 내 저장소 주소는 방금 만든 GitHub 저장소 주소로 바꿔야 합니다.

설치가 끝나면 왼쪽 파일 목록에서 app, lib, .env.example, .gitignore 파일을 확인합니다.

3. Google AI Studio에서 Gemini API 키 발급받기

Gemini API를 사용하려면 먼저 API 키가 필요합니다.

API 키는 내 웹사이트가 Google AI 서비스에 접근할 수 있도록 인증하는 비밀 열쇠입니다.

① Google AI Studio 접속

아래 공식 주소를 엽니다.

Google AI Studio API 키 발급 페이지

개인 Google 계정으로 로그인합니다.

② API 키 만들기

  1. Create API key 또는 API 키 만들기를 누릅니다.
  2. 프로젝트 선택 화면이 나오면 안내에 따라 프로젝트를 선택합니다.
  3. API 키가 생성되면 복사 아이콘을 누릅니다.
  4. 복사한 키를 다음 단계에서 사용할 수 있도록 준비합니다.

API 키 보안 주의사항

API 키는 비밀번호처럼 관리해야 합니다. 코드 파일이나 GitHub에 올리면 안 됩니다.

AI 채팅창, 카카오톡, 이메일, 캡처 화면에도 붙여 넣지 마세요.

③ 무료 사용 시 주의할 점

Gemini API에는 무료 사용 등급이 있습니다.

다만 모든 모델과 기능을 무제한으로 사용할 수 있는 것은 아닙니다. 모델별 요청 횟수와 사용량 제한이 적용됩니다.

무료 등급으로 전송한 콘텐츠는 Google 제품 개선에 사용될 수 있다고 안내되어 있습니다.

따라서 실습용 웹사이트에는 이름, 전화번호, 주소, 건강 정보 등 민감한 개인정보를 입력하지 않는 것이 좋습니다.

사용량과 요금은 변경될 수 있으므로 실제 사용 전 공식 요금표를 확인하세요.

Gemini API 공식 요금 안내

4. .env 파일에 API 키 안전하게 보관하기

API 키를 발급받았다면 이제 내 컴퓨터에 안전하게 보관해야 합니다.

이때 사용하는 파일이 .env입니다.

.env는 API 키와 같은 민감한 정보를 소스 코드와 분리해서 보관하는 환경 변수 파일입니다.

① 먼저 .gitignore 확인하기

API 키를 입력하기 전에 반드시 .gitignore 파일부터 확인합니다.

파일 안에 다음 내용이 있는지 확인하세요.

.env*

!.env.example

첫 번째 줄은 .env로 시작하는 파일을 Git이 추적하지 않도록 합니다.

두 번째 줄은 예시 파일인 .env.example은 저장소에 포함할 수 있도록 예외 처리합니다.

② .env 파일 만들기

.env.example 파일을 복사해 같은 폴더에 .env라는 이름으로 저장합니다.

파일을 열어 다음 항목을 확인합니다.

GEMINI_API_KEY=여기에_본인_API_키

안내 문구를 지우고 복사한 실제 API 키를 붙여 넣습니다.

등호 앞뒤에 공백이나 불필요한 따옴표를 넣지 않습니다.

입력한 뒤 Ctrl + S를 눌러 저장합니다.

③ Git에서 .env가 제외되었는지 확인

터미널에서 다음 명령어를 실행합니다.

git status

변경 파일 목록에 .env가 나타나지 않아야 합니다.

.env.example은 보여도 괜찮습니다. 실제 API 키가 들어 있는 .env가 보이지 않는지 확인하는 것이 중요합니다.

중요한 보안 확인

이미 Git이 .env 파일을 추적하고 있었다면 .gitignore에 추가하는 것만으로는 충분하지 않습니다.

이 경우 커밋이나 푸시를 멈추고 추적 상태를 먼저 바로잡아야 합니다.

5. Gemini API를 웹사이트에 연결하기

이제 웹사이트와 Gemini를 실제로 연결할 차례입니다.

스타터 프로젝트에는 Gemini API를 호출할 파일이 준비되어 있습니다.

안티그래비티 왼쪽 파일 목록에서 다음 경로를 엽니다.

app/api/gemini/route.ts

파일 안에 있는 TODO 부분을 채우도록 AI에게 요청합니다.

Gemini 연결 복사용 프롬프트

이 route.ts 파일의 TODO 부분을 완성해 주세요.

  • Google 공식 패키지 @google/genai를 사용해 주세요.
  • 모델은 gemini-3.5-flash-lite를 사용해 주세요.
  • 사용자가 입력한 prompt를 Gemini API에 전달해 주세요.
  • 생성된 답변은 { text: '답변 내용' } 형식으로 NextResponse.json에 담아 반환해 주세요.
  • API 키는 process.env.GEMINI_API_KEY에서 읽어 주세요.
  • API 키를 코드에 직접 작성하지 마세요.
  • API 키가 없거나 요청에 실패하면 적절한 HTTP 오류 상태와 메시지를 반환해 주세요.
  • 서버에서만 API를 호출하고 브라우저에 API 키가 노출되지 않도록 해 주세요.

AI가 패키지를 설치하거나 파일을 수정하겠다고 요청하면 내용을 확인하고 진행합니다.

수정된 코드에서 확인할 부분

AI가 작업을 마쳤다면 다음 두 가지를 확인합니다.

  • @google/genai 패키지를 사용하는지 확인합니다.
  • process.env.GEMINI_API_KEY에서 API 키를 읽는지 확인합니다.

실제 API 키 문자열이 코드 안에 들어 있다면 해당 코드를 그대로 사용하지 마세요.

Gemini 모델은 변경될 수 있습니다. 모델을 찾을 수 없다는 오류가 나오면 Google 공식 모델 목록에서 현재 사용 가능한 모델명을 확인해야 합니다.

Gemini API 공식 모델 목록

6. 내 컴퓨터에서 Gemini 연결 테스트하기

코드 수정이 끝났다면 먼저 인터넷에 공개하기 전에 내 컴퓨터에서 테스트합니다.

안티그래비티에 다음과 같이 요청합니다.

사이트를 실행해 주세요. npm run dev 명령을 사용하고, 브라우저에서 접속할 주소를 알려 주세요.

서버가 실행되면 보통 다음 주소가 표시됩니다.

http://localhost:3000

브라우저에서 안내된 주소를 엽니다.

스타터 화면에는 다음과 같은 AI 기능 카드가 준비되어 있습니다.

  • AI 자기소개 도우미
  • 내 마음 위로 받기
  • 한 줄 일기 펼치기
  • AI 명언 생성기
  • 메일 문구 다듬기

카드 하나를 선택하고 간단한 질문을 입력합니다.

버튼을 눌렀을 때 Gemini가 생성한 답변이 화면에 나타나면 연결에 성공한 것입니다.

.env 파일을 수정했다면 서버 재시작

개발 서버는 실행할 때 환경 변수를 읽습니다.

따라서 API 키를 새로 입력하거나 변경했다면 기존 서버를 종료해야 합니다.

  1. 터미널에서 Ctrl + C를 누릅니다.
  2. 개발 서버를 다시 실행합니다.
  3. 브라우저를 새로 고침합니다.
  4. 질문을 입력해 다시 테스트합니다.

7. GitHub에 올리고 Vercel에 배포하기

내 컴퓨터에서 Gemini가 정상적으로 작동한다면 이제 인터넷에 공개할 차례입니다.

여기서 꼭 알아야 할 점이 있습니다.

Vercel은 GitHub에 올라간 코드만으로 내 컴퓨터의 .env 파일을 자동으로 가져오지 못합니다.

따라서 Vercel에도 API 키를 별도로 등록해야 합니다.

① GitHub에 코드 업로드

안티그래비티에 변경 내용을 커밋하고 GitHub로 푸시해 달라고 요청합니다.

지금까지 수정한 내용을 GitHub에 커밋하고 푸시해 주세요. 커밋 메시지는 '제미나이연결'로 해 주세요. 먼저 git status로 변경 파일을 보여 주고 .env가 포함되지 않았는지 확인해 주세요.

푸시하기 전에 변경 파일 목록에 .env가 없는지 다시 확인합니다.

GitHub 저장소를 열어 .env.example은 있지만 .env는 없는지 확인합니다.

② Vercel에서 프로젝트 가져오기

  1. Vercel 공식 사이트에 접속합니다.
  2. 대시보드에서 Add New를 선택합니다.
  3. Project를 선택합니다.
  4. GitHub에 올린 my-first-ai-app 저장소를 찾습니다.
  5. Import를 누릅니다.

③ 환경 변수 등록하기

프로젝트 설정 화면에서 Environment Variables 항목을 찾습니다.

다음과 같이 입력합니다.

Name

GEMINI_API_KEY

Value

Google AI Studio에서 발급받은 실제 API 키

이름은 반드시 GEMINI_API_KEY로 입력해야 합니다.

대소문자와 밑줄까지 정확하게 입력하세요.

Value에는 실제 API 키를 붙여 넣습니다.

등록이 끝나면 Deploy를 눌러 배포를 시작합니다.

④ 배포 완료 확인하기

배포 상태가 Ready로 바뀌면 Vercel이 제공하는 공개 주소를 엽니다.

로컬 테스트 때와 마찬가지로 질문을 입력하고 답변이 나오는지 확인합니다.

인터넷에 공개된 주소에서도 정상적으로 답변이 나오면 Gemini API 연결이 완료된 것입니다.

⑤ 환경 변수를 나중에 등록했다면 Redeploy

처음 배포할 때 API 키를 등록하지 않았다면 나중에 환경 변수를 추가할 수 있습니다.

다만 환경 변수 변경은 이미 완료된 기존 배포에 자동으로 적용되지 않습니다.

  1. Vercel 프로젝트에서 Settings를 엽니다.
  2. Environment Variables를 선택합니다.
  3. GEMINI_API_KEY 항목을 추가하거나 수정합니다.
  4. Save를 누릅니다.
  5. Deployments 메뉴로 이동합니다.
  6. 최신 배포의 메뉴에서 Redeploy를 선택합니다.
  7. 새 배포가 Ready 상태가 되면 사이트를 다시 확인합니다.

기억해야 할 핵심

Vercel에 환경 변수를 새로 등록하거나 변경했다면 새 배포가 필요합니다. Redeploy를 완료해야 변경된 값이 적용됩니다.

8. Gemini API 연결 오류와 해결 방법

처음 API를 연결할 때는 오류가 발생할 수 있습니다.

오류 메시지를 확인하고 아래 순서대로 점검하면 대부분의 문제를 찾을 수 있습니다.

① 내 컴퓨터에서는 되지만 공개 사이트에서 오류가 발생하는 경우

Vercel에 API 키가 등록되지 않았거나 새 배포가 적용되지 않았을 가능성이 있습니다.

  • Vercel Settings에서 환경 변수를 확인합니다.
  • GEMINI_API_KEY 이름이 정확한지 확인합니다.
  • 값이 정상적으로 저장되었는지 확인합니다.
  • Redeploy를 실행합니다.

② 404 또는 모델을 찾을 수 없다는 오류

코드에 입력한 모델명이 잘못되었거나 더 이상 제공되지 않는 모델일 수 있습니다.

Google 공식 모델 목록에서 현재 사용할 수 있는 모델명을 확인한 뒤 코드의 모델명을 수정합니다.

③ 429 또는 quota 오류

무료 등급의 요청 횟수나 사용량 한도에 도달했을 수 있습니다.

잠시 기다린 후 다시 요청하거나 Google AI Studio의 사용량 제한을 확인합니다.

④ API 키 인증 오류

API 키가 잘못 입력되었거나 삭제·폐기된 경우 발생할 수 있습니다.

  • Google AI Studio에서 키가 유효한지 확인합니다.
  • .env의 키 값에 공백이 들어갔는지 확인합니다.
  • Vercel의 환경 변수 값도 확인합니다.
  • 키를 새로 발급했다면 로컬 서버를 재시작하고 Vercel도 Redeploy합니다.

⑤ 아직 Gemini API가 연결되지 않았다는 메시지

스타터 프로젝트의 TODO 부분이 아직 수정되지 않았을 수 있습니다.

app/api/gemini/route.ts 파일을 다시 확인하고 Gemini 연결 작업이 완료되었는지 확인합니다.

9. API 키가 노출되었다면 어떻게 해야 할까?

API 키가 GitHub나 채팅창에 공개되었다면 단순히 파일에서 지우는 것으로 끝내면 안 됩니다.

다른 사람이 이미 키를 복사했을 가능성이 있기 때문입니다.

다음 순서로 조치하는 것이 안전합니다.

  1. Google AI Studio에서 노출된 API 키를 삭제하거나 폐기합니다.
  2. 새 API 키를 발급받습니다.
  3. 내 컴퓨터의 .env에 새 키를 입력합니다.
  4. Vercel의 GEMINI_API_KEY 값도 교체합니다.
  5. Vercel에서 Redeploy를 실행합니다.
  6. GitHub 커밋 기록에 키가 남아 있다면 저장소 기록에서도 제거 조치를 합니다.

API 키는 코드에 직접 넣지 마세요.

브라우저에서 실행되는 코드에 API 키를 넣으면 방문자가 개발자 도구 등을 통해 키를 확인할 수 있습니다.

서버에서 API를 호출하고 비밀 키는 환경 변수로 관리해야 합니다.

10. Gemini API 연결 과정 정리

이번 실습에서 진행한 내용을 간단히 정리해 보겠습니다.

  1. GitHub 스타터 프로젝트를 내 저장소로 복사합니다.
  2. 내 컴퓨터에 프로젝트를 내려받습니다.
  3. Google AI Studio에서 Gemini API 키를 발급받습니다.
  4. .gitignore를 확인한 뒤 .env 파일을 만듭니다.
  5. GEMINI_API_KEY에 실제 키를 입력합니다.
  6. route.ts 파일의 TODO 부분을 완성합니다.
  7. 로컬 웹사이트에서 Gemini 답변을 테스트합니다.
  8. API 키가 제외된 코드만 GitHub에 업로드합니다.
  9. Vercel에 환경 변수를 등록합니다.
  10. 배포 후 공개 사이트에서 다시 테스트합니다.

이제 단순히 정해진 글자만 보여 주는 웹페이지가 아니라, 사용자의 질문에 따라 답변을 생성하는 AI 웹사이트를 만들 수 있습니다.

마무리: 내 웹사이트에 AI 기능 추가하기

Gemini API를 연결하는 과정에서 가장 중요한 것은 API 키를 안전하게 관리하는 것입니다.

내 컴퓨터에서는 .env 파일에 보관하고, Vercel에서는 환경 변수로 등록합니다.

그리고 GitHub에는 실제 API 키가 포함된 파일을 올리지 않아야 합니다.

이번 과정을 완료했다면 AI 자기소개 도우미, 일기 작성 도우미, 문장 다듬기 등 다양한 기능을 직접 확장할 수 있습니다.

먼저 간단한 질문과 답변 기능부터 완성해 보세요. 작은 기능 하나를 직접 연결해 보는 것이 AI 웹서비스 개발의 좋은 출발점입니다.

Vercel과 Resend API 연결하기: 웹사이트에 이메일 문의 기능 만들기

Vercel과 Resend API 연결하기: 

웹사이트에 이메일 문의 기능 만들기

Resend API와 Vercel을 연결해 웹사이트에서 이메일을 보내는 구조


AI로 웹사이트를 만들었다면 다음 단계는 방문자가 직접 나에게 연락할 수 있도록 기능을 추가하는 것입니다.

예를 들어 웹사이트에 이름과 문의 내용을 입력하고 보내기 버튼을 누르면 내 이메일로 편지가 도착하는 기능입니다.

이 기능을 만들 때 사용할 수 있는 서비스가 바로 Resend API입니다.

Resend는 웹사이트나 프로그램에서 이메일을 보낼 수 있도록 도와주는 서비스입니다.

이번 글에서는 안티그래비티로 만든 웹사이트에 Resend를 연결하고, Vercel에 배포한 사이트에서도 이메일을 받을 수 있도록 설정하는 방법을 알아보겠습니다.

이번 글에서 배울 내용
  • API와 API 키의 개념
  • Resend 회원가입 및 API 키 발급
  • .env 파일에 비밀 정보 저장하기
  • .gitignore로 API 키 보호하기
  • 안티그래비티로 연락하기 기능 만들기
  • 내 컴퓨터에서 이메일 전송 테스트
  • Vercel 환경 변수 등록하기
  • Redeploy로 공개 웹사이트에 적용하기

1. API란 무엇일까?

API라는 말을 처음 들으면 어렵게 느껴질 수 있습니다.

하지만 식당에서 주문하는 과정을 생각하면 쉽게 이해할 수 있습니다.

식당에 가서 음식을 주문하면 직원이 주방에 주문 내용을 전달합니다.

주방에서는 주문에 맞춰 음식을 만들고 다시 손님에게 전달합니다.

API도 비슷합니다.

내 웹사이트가 외부 서비스에 필요한 작업을 요청하면 해당 서비스가 결과를 돌려줍니다.

이메일 서비스로 이해하기

식당 주문과 API 비교

메뉴판 : Resend의 사용 설명서

주문서 : 내 웹사이트가 보내는 이메일 요청

주방 : Resend 이메일 서비스

음식 : 내 메일함에 도착한 이메일

멤버십 카드 : API 키

내 웹사이트에서 방문자가 문의 내용을 작성하면 Resend에 이메일 발송을 요청합니다.

Resend는 요청을 확인한 후 이메일을 전송합니다.

이처럼 서로 다른 프로그램이 정해진 방식으로 정보를 주고받는 통로가 API입니다.

2. API 키란 무엇일까?

Resend API를 사용하려면 API 키가 필요합니다.

API 키는 외부 서비스에 접근할 수 있도록 해주는 인증 정보입니다.

쉽게 말하면 내 웹사이트가 Resend 서비스를 사용할 수 있도록 허락하는 열쇠입니다.

이 열쇠를 다른 사람에게 알려 주면 다른 사람이 내 계정의 권한으로 이메일을 보낼 수도 있습니다.

API 키는 절대 공개하면 안 됩니다.

다음과 같은 곳에 API 키를 입력하지 마세요.

  • 공개된 소스코드
  • GitHub 저장소
  • 안티그래비티 AI 채팅창
  • 카카오톡이나 이메일
  • 화면 캡처 및 녹화 영상

API 키는 내 컴퓨터의 .env 파일이나 Vercel의 환경 변수에 저장해야 합니다.

3. Resend 회원가입하고 API 키 발급받기

먼저 이메일을 보내는 서비스를 준비해야 합니다.

이번 실습에서는 Resend를 사용하겠습니다.

Resend 공식 홈페이지 바로가기

① Resend 가입하기

Resend 홈페이지에 접속합니다.

오른쪽 위의 Get started를 클릭합니다.

가입 화면에서 Google 계정으로 로그인할 수 있습니다.

이미 계정이 있다면 Log in을 선택합니다.

가입에 사용한 이메일 주소를 기억해 두세요.

이번 실습에서는 이 이메일 주소로 문의 내용을 받겠습니다.

② API Keys 메뉴 선택하기

로그인하면 Resend 대시보드가 나타납니다.

왼쪽 메뉴에서 API Keys를 선택합니다.

오른쪽 위의 + Create API Key 버튼을 클릭합니다.

③ API 키 만들기

API 키를 만드는 화면에서 다음과 같이 설정합니다.

이름 (Name)

my-first-site

권한 (Permission)

Sending access

Name에는 프로젝트 이름을 입력합니다.

Permission은 Sending access를 선택합니다.

이 권한은 이메일 발송에 필요한 권한만 부여하는 설정입니다.

모든 권한을 허용하는 Full access보다 필요한 권한만 사용하는 것이 안전합니다.

설정을 확인한 후 Add 버튼을 클릭합니다.

④ API 키 복사하기

API 키가 생성되면 화면에 인증 정보가 표시됩니다.

Resend는 생성된 키를 처음 한 번만 확인할 수 있도록 제공합니다.

따라서 이때 복사해서 안전한 장소에 저장해야 합니다.

API 키를 분실했다면 기존 키를 다시 확인하려고 하지 말고 새 키를 발급받으면 됩니다.

중요한 보안 주의사항

API 키를 복사한 뒤에는 채팅창이나 메모 앱에 붙여 넣지 마세요. 바로 다음 단계에서 .env 파일에 저장합니다. 다른 사람에게 노출되었다면 해당 키를 폐기하고 새로 발급받아야 합니다.

4. .env 파일과 .gitignore 이해하기

이제 발급받은 API 키를 안전하게 보관해야 합니다.

이때 사용하는 것이 .env 파일입니다.

.env는 비밀 정보를 보관하는 파일

.env는 프로그램이 실행될 때 필요한 비밀 정보를 저장하는 파일입니다.

예를 들어 다음과 같은 정보가 들어갈 수 있습니다.

  • API 키
  • 이메일 주소
  • 데이터베이스 비밀번호
  • 외부 서비스 인증 정보

이번 실습에서는 Resend API 키와 이메일 주소를 저장하겠습니다.

.gitignore는 Git에서 제외할 파일을 지정

.gitignore는 Git이 특정 파일을 관리하지 않도록 지정하는 파일입니다.

예를 들어 .env 파일이 GitHub에 올라가면 API 키가 다른 사람에게 공개될 수 있습니다.

따라서 .env 파일을 Git의 관리 대상에서 제외해야 합니다.

두 파일의 역할은 다음과 같습니다.

.env

비밀 정보를 저장하는 파일

.gitignore

GitHub에 비밀 파일이 올라가지 않도록 제외하는 설정

5. .gitignore를 먼저 설정하기

이 단계에서는 순서가 매우 중요합니다.

먼저 .env 파일을 만들지 말고 .gitignore부터 확인해야 합니다.

안티그래비티에서 기존 프로젝트 폴더를 엽니다.

왼쪽 파일 목록에서 .gitignore를 찾아 클릭합니다.

파일 안에 다음 내용이 있는지 확인합니다.

.env*

이 설정은 .env로 시작하는 파일을 Git에서 제외한다는 의미입니다.

만약 없다면 다음 프롬프트를 사용합니다.

📋 안티그래비티 복사용 프롬프트

현재 프로젝트의 .gitignore 파일을 확인해줘. .env* 항목이 있는지 확인하고, 없다면 추가해줘. 기존 설정은 삭제하지 마. 수정한 내용을 보여줘.

설정이 완료되면 다음 단계로 넘어갑니다.

주의

이미 Git이 추적하고 있는 .env 파일은 .gitignore에 추가하는 것만으로 추적이 중단되지 않습니다. 기존에 추적된 적이 있다면 Git 추적 상태도 별도로 확인해야 합니다.

6. .env 파일 만들고 API 키 저장하기

이제 비밀 정보를 저장할 파일을 만듭니다.

안티그래비티의 왼쪽 파일 목록에서 새 파일을 생성합니다.

파일 이름은 다음과 같이 입력합니다.

.env

파일을 열고 다음 두 줄을 작성합니다.

RESEND_API_KEY=실제_API_키
CONTACT_EMAIL=내_이메일_주소

위 내용에서 실제_API_키 부분에는 Resend에서 발급받은 키를 넣습니다.

내_이메일_주소에는 Resend에 가입한 이메일 주소를 입력합니다.

실제 입력할 때는 예시 문구를 그대로 사용하지 않습니다.

작성할 때 주의할 점

  • 변수 이름은 대문자로 정확히 입력합니다.
  • 등호 앞뒤에 불필요한 공백을 넣지 않습니다.
  • 값을 임의로 따옴표로 감싸지 않습니다.
  • 파일 이름이 반드시 .env인지 확인합니다.
  • 저장한 후 파일을 닫습니다.

이제 Git이 .env 파일을 제외하는지 확인해야 합니다.

안티그래비티에 다음과 같이 요청합니다.

📋 복사용 프롬프트

git status를 실행해서 현재 Git 상태를 보여줘. .env 파일이 변경 목록에 나타나는지 확인하고, API 키나 이메일 주소 같은 비밀 값은 출력하지 마. .env가 목록에 보이면 작업을 중단하고 알려줘.

.env 파일이 변경 목록에 나타나지 않아야 정상입니다.

만약 .env가 표시된다면 GitHub에 올리지 말고 .gitignore와 Git 추적 상태를 다시 확인합니다.

7. 안티그래비티로 연락하기 기능 만들기

이제 웹사이트에 이메일 문의 기능을 추가하겠습니다.

방문자가 이름과 문의 내용을 입력하고 보내기 버튼을 누르면 Resend를 통해 내 이메일로 전달되는 기능입니다.

이번 실습은 Next.js 프로젝트를 기준으로 진행합니다.

① 연락하기 기능 요청하기

안티그래비티에서 새 대화를 열고 다음 프롬프트를 입력합니다.

📋 안티그래비티 복사용 프롬프트

현재 웹사이트 맨 아래에 연락하기 기능을 만들어줘.

입력 항목은 다음과 같아.

  • 이름
  • 문의 내용
  • 보내기 버튼

다음 조건을 지켜줘.

  • 공식 Resend 패키지를 사용해줘.
  • API 주소는 /api/send로 만들어줘.
  • 발신 주소는 onboarding@resend.dev를 사용해줘.
  • 받는 주소는 process.env.CONTACT_EMAIL에서 읽어줘.
  • API 키는 process.env.RESEND_API_KEY에서 읽어줘.
  • API 키와 이메일 주소를 코드에 직접 작성하지 마.
  • 서버에서만 API 키를 사용하도록 만들어줘.
  • Resend 객체는 요청 처리 함수 안에서 생성해줘.
  • 필수 환경변수가 없으면 이해하기 쉬운 오류를 반환해줘.
  • 성공하면 화면에 '보냈어요!'를 표시해줘.
  • 실패하면 안전하게 처리된 오류 메시지를 보여줘.
  • 입력값 검증과 기본적인 스팸 방지 처리를 고려해줘.

기존 웹사이트 디자인과 기능은 유지하고, 필요한 파일만 수정해줘.

여기서 중요한 것은 API 키를 프롬프트에 직접 입력하지 않는 것입니다.

AI에게는 환경변수 이름만 알려주면 됩니다.

② AI가 생성한 코드 확인하기

안티그래비티가 작업을 완료하면 변경된 파일을 확인합니다.

특히 Next.js 프로젝트라면 다음 파일이 생성되거나 수정될 수 있습니다.

app/api/send/route.ts

프로젝트 구조에 따라 API 경로는 다를 수 있습니다.

중요한 것은 다음 세 가지입니다.

  • Resend 공식 패키지를 사용했는가?
  • API 키를 process.env.RESEND_API_KEY에서 읽는가?
  • 받는 주소를 process.env.CONTACT_EMAIL에서 읽는가?

또한 실제 API 키가 코드에 직접 들어가 있으면 안 됩니다.

확인 후 변경 사항을 승인합니다.

③ Resend 객체를 함수 안에서 생성하는 이유

Resend 객체를 서버 코드의 최상단에서 생성하면 환경변수가 없는 상태에서 모듈이 초기화될 때 문제가 발생할 수 있습니다.

따라서 요청 처리 함수 안에서 환경변수를 확인한 다음 객체를 생성하도록 구성하는 것이 좋습니다.

이렇게 하면 환경변수가 누락된 경우에도 사이트 전체가 아니라 이메일 전송 요청에서 오류를 처리할 수 있습니다.

8. 내 컴퓨터에서 이메일 전송 테스트하기

이제 실제로 이메일이 도착하는지 확인하겠습니다.

먼저 안티그래비티에서 개발 서버를 실행합니다.

📋 복사용 프롬프트

현재 프로젝트를 npm run dev 명령어로 실행해줘. 서버가 정상적으로 실행되면 접속할 수 있는 localhost 주소를 알려줘.

보통 다음 주소로 접속할 수 있습니다.

http://localhost:3000

3000번 포트를 다른 프로그램이 사용하고 있다면 3001번 등 다른 포트가 사용될 수 있습니다.

이메일 보내기 테스트

  1. 브라우저에서 localhost 주소를 엽니다.
  2. 페이지 아래쪽으로 이동합니다.
  3. 연락하기 영역을 찾습니다.
  4. 이름과 문의 내용을 입력합니다.
  5. 보내기 버튼을 클릭합니다.
  6. 보냈어요! 메시지가 나타나는지 확인합니다.
  7. Resend에 가입한 이메일 계정을 확인합니다.

Gmail을 사용한다면 기본 받은편지함뿐 아니라 업데이트 탭과 스팸함도 확인하세요.

Resend 대시보드의 Emails 메뉴에서도 발송 기록과 상태를 확인할 수 있습니다.

테스트 이메일의 수신 제한

Resend의 기본 테스트 발신 주소인 onboarding@resend.dev를 사용할 때는 수신 주소에 제한이 있습니다.

일반적으로 Resend에 가입한 본인 이메일 주소로 테스트해야 합니다.

다른 사람에게도 이메일을 보내려면 본인 도메인을 Resend에 등록하고 DNS 인증을 완료하는 과정이 필요합니다.

이 부분은 다음 단계에서 도메인을 연결할 때 함께 설정할 수 있습니다.

9. GitHub에 업로드하기 전에 .env 확인하기

내 컴퓨터에서 이메일이 정상적으로 도착했다면 이제 GitHub에 변경 사항을 올립니다.

하지만 여기서 반드시 확인해야 할 것이 있습니다.

.env 파일이 GitHub에 올라가면 안 됩니다.

안티그래비티에 다음과 같이 요청합니다.

📋 복사용 프롬프트

현재 변경된 파일 목록을 확인해줘. .env와 API 키, 비밀번호 등 비밀 정보가 포함된 파일이 커밋 대상에 들어가지 않았는지 확인해줘. 비밀 값 자체는 출력하지 마. 안전한 파일만 커밋하고 GitHub로 push해줘. 커밋 메시지는 '연락하기 이메일 기능 추가'로 해줘.

AI가 보여 주는 파일 목록을 직접 확인합니다.

특히 git add 명령으로 추가되는 파일 목록에 .env가 없는지 확인하세요.

GitHub에 업로드한 뒤에도 저장소의 파일 목록을 새로 고쳐 확인합니다.

.gitignore는 보이지만 .env는 보이지 않아야 정상입니다.

이미 .env가 GitHub에 올라갔다면?

단순히 파일을 삭제하는 것만으로는 충분하지 않습니다.

  1. Resend에서 노출된 API 키를 폐기합니다.
  2. 새 API 키를 발급받습니다.
  3. .env와 Vercel 환경 변수에 새 키를 등록합니다.
  4. GitHub에 남은 비밀 정보도 안전하게 정리합니다.
  5. 필요하면 Git 기록에서 해당 정보를 제거합니다.

10. Vercel 환경 변수에 API 키 등록하기

이제 가장 중요한 단계입니다.

내 컴퓨터에서는 이메일이 정상적으로 전송되었지만, 인터넷에 공개된 Vercel 주소에서는 오류가 발생할 수 있습니다.

이유는 간단합니다.

Vercel은 GitHub에 올라간 프로젝트 파일을 가져옵니다.

하지만 보안을 위해 GitHub에 올리지 않은 .env 파일까지 자동으로 가져오지는 않습니다.

따라서 Vercel에 비밀 정보를 별도로 등록해야 합니다.

① Vercel 프로젝트 열기

Vercel 홈페이지에 로그인합니다.

앞서 배포한 my-first-site 프로젝트를 선택합니다.

새로운 프로젝트를 만들 필요는 없습니다.

② Environment Variables 메뉴 선택

프로젝트 왼쪽 메뉴에서 Settings 또는 Environment Variables 항목을 찾습니다.

화면에 따라 Settings 안에서 Environment Variables를 선택해야 할 수도 있습니다.

오른쪽 위의 Add Environment Variable 버튼을 클릭합니다.

③ 첫 번째 환경 변수 등록

첫 번째 줄에는 Resend API 키를 등록합니다.

Key

RESEND_API_KEY

Value

Resend에서 발급받은 실제 API 키

Key에는 변수 이름을 입력합니다.

Value에는 실제 API 키를 입력합니다.

값을 입력할 때 앞뒤에 공백이나 따옴표가 들어가지 않도록 주의하세요.

④ 두 번째 환경 변수 등록

다음으로 + Add new variable을 눌러 두 번째 항목을 추가합니다.

Key

CONTACT_EMAIL

Value

Resend 가입에 사용한 이메일 주소

두 변수의 이름은 .env 파일에 작성한 이름과 정확히 일치해야 합니다.

대문자와 밑줄까지 확인하세요.

⑤ Production 환경 확인하기

환경 변수를 적용할 환경을 선택하는 항목이 있습니다.

이번 실습에서는 공개 웹사이트에 적용하기 위해 Production을 선택합니다.

설정을 확인한 다음 Save를 누릅니다.

11. Redeploy를 반드시 실행해야 하는 이유

환경 변수를 등록하고 저장했다고 해서 즉시 공개 웹사이트에 적용되는 것은 아닙니다.

이 부분에서 초보자들이 자주 실수합니다.

Vercel에 환경 변수를 새로 등록했다면 다시 배포해야 합니다.

이 과정을 Redeploy라고 합니다.

Redeploy 실행 순서

  1. 환경 변수 두 개가 정상적으로 저장되었는지 확인합니다.
  2. 환경 변수 저장 후 나타나는 Redeploy 안내를 확인합니다.
  3. Redeploy 버튼을 클릭합니다.
  4. 확인 창이 나타나면 다시 Redeploy를 선택합니다.
  5. Deployments 메뉴에서 배포 상태를 확인합니다.

저장 안내를 놓쳤다면 Deployments 메뉴에서 해당 배포의 오른쪽에 있는 점 세 개 메뉴를 눌러 Redeploy를 선택할 수도 있습니다.

반드시 기억하세요!

환경 변수 등록 → Save → Redeploy → Ready

이 과정을 완료해야 새 환경 변수가 공개 웹사이트에 반영됩니다.

12. 공개 웹사이트에서 이메일 보내기

이제 마지막 테스트입니다.

Vercel의 Deployments 메뉴에서 가장 최근 배포 상태를 확인합니다.

초록색 Ready가 표시되어야 합니다.

그다음 공개된 .vercel.app 주소로 접속합니다.

  1. 웹사이트를 새로 고침합니다.
  2. 연락하기 영역으로 이동합니다.
  3. 이름과 문의 내용을 입력합니다.
  4. 보내기 버튼을 누릅니다.
  5. 보냈어요! 메시지가 나타나는지 확인합니다.
  6. Resend의 Emails 메뉴에서 발송 결과를 확인합니다.
  7. 내 이메일 받은편지함을 확인합니다.

이메일이 정상적으로 도착했다면 모든 과정이 완료된 것입니다.

최종 성공 확인

① 내 컴퓨터에서 이메일 전송 성공

② GitHub에 코드 업로드 완료

③ Vercel 환경 변수 등록 완료

④ Redeploy 후 Ready 확인

⑤ 공개 주소에서 보낸 이메일이 실제 메일함에 도착

13. 자주 발생하는 오류와 해결 방법

① RESEND_API_KEY 또는 CONTACT_EMAIL이 없다는 오류

원인

Vercel에 환경 변수가 등록되지 않았거나 Redeploy를 진행하지 않은 경우입니다.

해결 방법

  1. Vercel Environment Variables를 확인합니다.
  2. RESEND_API_KEY가 있는지 확인합니다.
  3. CONTACT_EMAIL이 있는지 확인합니다.
  4. Redeploy를 실행합니다.
  5. Ready 상태가 된 후 다시 테스트합니다.

② 403 오류가 발생하는 경우

다음과 같은 메시지가 표시될 수 있습니다.

You can only send testing emails to your own email address

원인

Resend의 테스트 발신 주소를 사용하는 상태에서 가입한 이메일이 아닌 다른 주소로 보내려고 했기 때문입니다.

해결 방법

CONTACT_EMAIL을 Resend 가입에 사용한 이메일 주소와 일치시키세요.

다른 사람에게 보내려면 발신 도메인 인증이 필요합니다.

③ 401 API key is invalid

원인

  • API 키를 잘못 입력함
  • API 키 앞뒤에 공백이 있음
  • API 키가 잘려서 저장됨
  • 기존 API 키가 폐기됨

해결 방법

Resend에서 새 API 키를 발급받고 .env와 Vercel에 다시 등록합니다.

그다음 Redeploy를 실행합니다.

④ 보냈어요!가 나타나지만 이메일이 오지 않는 경우

원인

발송 요청은 성공했지만 이메일이 스팸함으로 이동했거나 실제 전달에 실패했을 수 있습니다.

해결 방법

  1. Gmail 업데이트 탭을 확인합니다.
  2. 스팸함을 확인합니다.
  3. Resend의 Emails 메뉴를 엽니다.
  4. 발송 상태가 Delivered인지 확인합니다.

Queued 상태라면 잠시 기다린 후 다시 확인합니다.

⑤ .env 파일이 GitHub에 올라간 경우

원인

.gitignore 설정이 잘못되었거나 이미 Git에서 추적하고 있던 파일일 수 있습니다.

해결 방법

먼저 노출된 API 키를 Resend에서 폐기합니다.

새 키를 발급받아 .env와 Vercel에 등록합니다.

그다음 Git 기록에서 비밀 정보를 제거하고 다시는 올라가지 않도록 설정합니다.

이미 공개된 키는 GitHub에서 파일을 삭제하는 것만으로 안전해지지 않습니다.

14. API 키를 안전하게 관리하는 방법

이번 실습에서 가장 중요한 부분은 API 키를 보호하는 것입니다.

API 키는 웹사이트의 기능을 실행하는 인증 정보입니다.

다음 원칙을 지키는 것이 좋습니다.

API 키를 보관해도 되는 곳
  • 내 컴퓨터의 .env 파일
  • Vercel Environment Variables
  • API 키를 발급한 서비스의 보안 관리 화면
API 키를 공개하면 안 되는 곳
  • GitHub 공개 저장소
  • HTML과 JavaScript 공개 코드
  • 안티그래비티 채팅창
  • 카카오톡 및 이메일
  • 화면 캡처와 녹화 영상

특히 브라우저에서 실행되는 코드에 API 키를 넣으면 방문자가 개발자 도구를 통해 확인할 수 있습니다.

따라서 API 키를 사용하는 작업은 서버에서 처리해야 합니다.

마무리: 이제 웹사이트에서 직접 이메일을 받을 수 있다

이번 실습에서는 단순히 웹사이트를 보여주는 수준에서 벗어나 방문자가 직접 문의할 수 있는 기능을 만들었습니다.

Resend API를 이용하면 별도의 메일 서버를 직접 구축하지 않고도 이메일 발송 기능을 추가할 수 있습니다.

또한 .env와 Vercel 환경 변수를 이용하면 API 키를 공개하지 않고 안전하게 관리할 수 있습니다.

오늘 꼭 기억할 핵심 내용

① Resend에서 API 키를 발급받습니다.

② .gitignore를 먼저 설정합니다.

③ .env에 API 키와 이메일 주소를 저장합니다.

④ GitHub에 .env를 올리지 않습니다.

⑤ Vercel에 환경 변수를 등록합니다.

⑥ Redeploy 후 공개 주소에서 이메일을 테스트합니다.

이제 여러분이 만든 웹사이트는 단순한 소개 페이지가 아닙니다.

방문자의 문의를 직접 받을 수 있는 웹사이트로 발전한 것입니다.

다음 단계에서는 개인 도메인을 연결하고 Resend에 도메인을 인증하여 다른 사람에게도 이메일을 보낼 수 있도록 확장해 볼 수 있습니다.

참고 자료: 스마택트 바이브코딩 6차시 - API와 비밀의 방
원본 학습 자료 보기