TL;DR
- Vercel 사용법의 핵심은 세 줄이다.
npm i -g vercel로 CLI를 깔고,vercel login으로 로그인하고, 프로젝트 폴더에서vercel을 친다.- Git 저장소를 연결해두면 push할 때마다 프리뷰 URL이 따로 생긴다. 프로덕션에 올리기 전에 그 주소로 먼저 확인하는 흐름이다.
- 무료(Hobby) 플랜은 월 1M 엣지 요청과 100GB 전송까지다. 팀으로 쓰거나 커스텀 도메인이 필요해지는 순간 월 $20 Pro로 넘어간다.
Vercel 사용법을 찾는 사람은 대개 두 부류다.
Next.js로 뭔가 만들어놓고 남에게 보여줄 주소가 필요한 사람, 그리고 AWS에서 EC2와 로드밸런서와 CloudFront를 붙이다 지친 사람.
두 경우 모두 원하는 건 같다.
코드를 밀어 넣으면 주소가 나오고, 그 주소가 알아서 빨라지는 것.
Vercel이 파는 게 정확히 그 부분이다.
빌드 서버를 고르고, CDN 캐시 정책을 짜고, HTTPS 인증서를 갱신하는 일을 플랫폼이 가져간다.
그래서 처음 써보면 허무할 정도로 빨리 끝난다.
문제는 그다음이다.
프리뷰 배포와 프로덕션 배포가 어떻게 나뉘는지, 환경변수를 어디에 넣어야 로컬과 배포본이 같은 값을 보는지, 무료로 쓰다가 어느 지점에서 요금이 붙기 시작하는지.
공식 문서에 다 적혀 있지만 흩어져 있어서 처음 오는 사람은 순서를 잡기 어렵다.
아래는 계정을 만든 시점부터 커스텀 도메인을 연결하고 요금 상한을 걸어두는 지점까지, 공식 문서와 요금표에 적힌 값만 가지고 순서대로 정리한 것이다.
Vercel이 대신 처리하는 배포 과정
직접 서버를 굴려 웹앱을 띄운다고 해보자.
빌드할 머신을 준비하고, 산출물을 어딘가에 올리고, 도메인을 연결하고, 인증서를 발급받고, 트래픽이 몰릴 때 인스턴스를 늘리고, 정적 파일은 CDN에 태워야 한다.
여기까지가 코드를 한 줄도 고치지 않고 해야 하는 일이다.
Vercel은 이 목록을 통째로 가져간다.
저장소를 연결하면 프레임워크를 감지해 빌드 명령을 알아서 정하고, 결과물을 전 세계 엣지 노드에 배포하고, HTTPS 인증서를 발급·갱신한다.
서버 함수는 Fluid compute 위에서 돌아가는데, 요금이 켜져 있는 시간이 아니라 실제로 코드가 실행된 시간에 붙는다.
유휴 시간에 돈이 새지 않는다는 뜻이다.
규모 감각을 잡으려면 공식 홈에 적힌 사례가 참고가 된다.
Notion은 하루 수백만 건의 에이전트 대화를 Vercel 위에서 처리하고, Zapier는 월 1억 회 넘는 웹사이트 방문을 여기서 받는다.
Mintlify는 2만 개 넘는 회사의 문서 사이트를 Vercel 위에 얹어 운영한다.
Vercel 사용법, 배포까지 세 단계
공식 시작 문서가 요구하는 준비물은 두 가지다.
Vercel 계정, 그리고 Node.js 18 이상.
그다음은 세 단계다.
첫째, CLI를 전역으로 설치한다.
npm i -g vercelpnpm을 쓴다면 pnpm i -g vercel, yarn은 yarn global add vercel, bun은 bun add -g vercel이다.
둘째, 로그인한다.
vercel login터미널에 뜨는 안내를 따라가면 브라우저로 인증이 넘어간다.
셋째, 프로젝트 폴더로 이동해 명령 하나를 친다.
vercelCLI가 프레임워크를 감지하고, 빌드하고, 배포까지 마친다.
이 단계에서 나오는 주소는 프리뷰용이다.
프로덕션으로 올리려면 플래그를 붙인다.
vercel --prodVercel 사용법 중에 실제로 외워야 하는 건 사실상 이 두 명령이다.
나머지는 대시보드에서 클릭으로 처리된다.
Git 연결과 프리뷰 배포가 갈리는 지점
CLI 배포는 손이 빠르지만 혼자 쓸 때 이야기다.
팀으로 굴리려면 저장소를 연결하는 쪽이 낫다.
GitHub이나 GitLab 저장소를 프로젝트에 붙여두면 push가 일어날 때마다 배포가 돈다.
여기서 갈리는 게 두 종류의 배포다.
기본 브랜치에 들어간 커밋은 프로덕션으로 나가고, 그 외 브랜치와 PR은 프리뷰 환경으로 나간다.
프리뷰는 커밋마다 고유한 주소를 받는다.
리뷰어에게 “3번 화면 확인해달라”고 말할 때 로컬을 띄우게 하는 대신 링크를 던지면 된다.
이 구조의 이점은 되돌리기가 쉽다는 데 있다.
배포마다 결과물이 따로 남아 있어서, 문제가 생기면 이전 배포를 프로덕션으로 승격시키는 식으로 원복한다.
빌드를 다시 돌리지 않는다.
환경변수와 커스텀 도메인 설정 순서
환경변수는 프로젝트 설정에서 Local, Preview, Production 환경별로 따로 지정한다.
개발용 키와 운영용 키를 갈라 넣으라는 뜻이다.
CLI에서 vercel env pull을 쓰면 배포 환경에 등록해둔 값을 로컬 .env 파일로 내려받을 수 있어서, 로컬과 배포본이 서로 다른 값을 보는 사고를 줄인다.
도메인은 프로젝트 설정의 Domains에서 붙인다.
소유한 도메인의 DNS에 Vercel이 안내하는 레코드를 넣으면 연결되고, 인증서는 자동으로 발급된다.
다만 커스텀 도메인을 무료로 얹는 건 Pro 플랜 혜택으로 표기돼 있다.
개인 프로젝트를 .vercel.app 주소로 쓰다가 회사 도메인을 붙이려는 시점이 보통 유료 전환 지점이 된다.
요금이 붙는 지점, Hobby와 Pro 차이
요금표는 세 층이다.
Hobby는 월 $0, Pro는 월 $20, Enterprise는 협의다.
Pro는 월 $20에 사용량 크레딧 $20이 포함된다.
| 항목 | Hobby | Pro |
|---|---|---|
| 월 요금 | $0 | $20 (사용량 크레딧 $20 포함) |
| 엣지 요청 | 월 100만 건 포함 | 월 1,000만 건 포함, 초과분 100만 건당 $2부터 |
| 데이터 전송 | 월 100GB 포함 | 월 1TB 포함, 초과분 GB당 $0.15부터 |
| 방화벽 커스텀 룰 | 3개까지 | 40개까지 |
| IP 차단 | 3개까지 | 100개까지 |
| 커스텀 도메인 | — | 무료 제공 |
| 빌드 대기열 | 있음 | 없음(빌드 우선) |
봇 대응은 따로 계산된다.
방화벽 요청 제한은 월 100만 건까지 포함이고 그 위로는 100만 건당 $0.50부터, BotID는 기본 검사가 포함이며 심층 분석은 1,000건당 $1이다.
요금이 무서운 건 상한이 없을 때다.
Vercel은 Spend Management로 한도를 걸고 알림을 받고, 예산을 넘기기 전에 사용을 멈추도록 설정할 수 있다.
개인 프로젝트를 Pro로 올렸다면 이걸 먼저 켜두는 편이 안전하다.
AI 코딩 에이전트와 붙여 쓰기
요즘 Vercel 문서는 에이전트를 전제로 쓰여 있다.
시작 문서 첫머리에 사람이 읽을 설명 대신 에이전트에게 그대로 붙여넣을 프롬프트가 실려 있을 정도다.
Claude Code나 Cursor를 쓴다면 플러그인을 설치한다.
npx plugins add vercel/vercel-plugin설치하면 별도 설정 없이 활성화되고, /vercel-plugin:deploy prod나 /vercel-plugin:env 같은 슬래시 명령이 붙는다.
에이전트가 배포와 환경변수를 직접 다룰 수 있게 된다.
Cline, Windsurf, GitHub Copilot처럼 다른 에이전트를 쓴다면 Skills 쪽이다.
npx skills add vercel-labs/agent-skills2026년 8월 변경로그를 보면 이 방향이 더 뚜렷하다.
Slack에서 @Vercel을 불러 장애를 진단하고 PR을 검토하는 기능, 에이전트용 보안 연결 계층인 Connect, 신원 공급자로 내부 에이전트와 배포를 보호하는 Passport가 연달아 나왔다.
배포가 실패할 때 먼저 볼 곳
Vercel 사용법을 익히는 과정에서 가장 자주 막히는 지점은 빌드 로그다.
대시보드의 해당 배포를 열면 빌드 단계별 로그가 그대로 남아 있어서, 로컬에서는 되는데 여기서만 깨지는 경우 원인을 로그에서 찾는다.
흔한 원인은 세 가지다.
- 환경변수를 Production에만 넣고 Preview에는 넣지 않은 경우. 프리뷰 배포에서만 값이 비어 터진다.
- Node.js 버전 차이. 로컬이 22인데 프로젝트 설정이 18이면 최신 문법에서 갈린다.
- 대소문자를 구분하지 않는 맥에서 개발하고 리눅스 빌드 서버에서 깨지는 import 경로 문제.
로그만으로 안 잡히면 vercel 명령을 로컬에서 직접 돌려본다.
CLI가 같은 빌드 과정을 태우기 때문에 대시보드보다 반복이 빠르다.
한계와 안 맞는 경우
맞지 않는 쪽도 분명하다.
- 상태를 오래 들고 있어야 하는 워크로드. 함수 실행 시간 단위로 요금이 붙는 구조라, 상시 대기하는 소켓 서버나 무거운 배치 작업은 다른 곳이 낫다.
- 트래픽이 크게 튀는 서비스를 상한 없이 운영하는 경우. 엣지 요청과 전송량이 종량이라 캐시 설계가 어긋나면 청구서가 먼저 반응한다.
- 데이터베이스까지 한곳에서 해결하려는 경우. Vercel은 앱을 태우는 층이고 DB는 별도 서비스를 붙인다. 이 조합이 부담스럽다면 Supabase 사용법 쪽 구성을 먼저 보는 게 낫다.
- 특정 리전 안에 데이터를 묶어둬야 하는 규제 환경. 멀티 리전 컴퓨트와 장애 조치는 Enterprise 층에 걸려 있다.
제품 만들 때 가져갈 설계
Vercel을 쓰지 않더라도 훔쳐올 만한 설계가 몇 개 있다.
프리뷰 환경을 커밋 단위로 만든 결정이 첫째다. “확인해보고 말해줘”라는 요청의 비용을 링크 하나로 낮췄다.
리뷰 단계가 있는 제품이라면 어디에나 적용된다.
둘째는 유휴 시간에 과금하지 않는다는 원칙을 이름으로 내건 것이다.
Fluid compute라는 이름과 “No idle, no waste”라는 문구가 요금 모델을 그대로 설명한다.
가격 정책을 제품 기능처럼 파는 방식이다.
셋째는 지출 상한을 기능으로 만든 점이다.
종량제 서비스가 흔히 받는 불만이 예측 불가능한 청구서인데, 한도·알림·자동 정지를 묶어 그 불안을 정면으로 다룬다.
실행 체크리스트
- Node.js 18 이상이 깔려 있는지 확인하고
npm i -g vercel로 CLI를 설치합니다. vercel login으로 계정을 연결합니다.- 프로젝트 폴더에서
vercel을 실행해 프리뷰 배포가 나오는지 봅니다. - 결과가 괜찮으면
vercel --prod로 프로덕션에 올립니다. - 팀으로 쓴다면 Git 저장소를 연결해 push마다 프리뷰가 생기도록 바꿉니다.
- 환경변수를 Preview와 Production으로 나눠 등록하고, 로컬에는
vercel env pull로 내려받습니다. - 커스텀 도메인을 붙일 계획이면 Pro 전환 시점을 미리 잡습니다.
- Pro로 올린 직후 Spend Management에서 지출 한도와 알림을 설정합니다.
- AI 코딩 에이전트를 쓴다면 플러그인이나 Skills를 설치해 배포를 맡깁니다.
자주 묻는 질문
Vercel은 무료로 쓸 수 있나요
Hobby 플랜이 월 $0입니다.
엣지 요청 월 100만 건, 데이터 전송 월 100GB까지 포함되고 CDN, 자동 CI/CD, 방화벽, DDoS 완화가 들어갑니다.
개인 프로젝트나 포트폴리오 정도면 이 안에서 해결됩니다.
다만 커스텀 도메인 무료 제공은 Pro 혜택으로 표기돼 있습니다.
Next.js가 아니어도 배포되나요
됩니다.
CLI가 프로젝트를 감지해 빌드 설정을 잡습니다.
Next.js는 Vercel이 만든 프레임워크라 통합이 가장 깊지만, 지원 프레임워크 목록이 따로 있고 컨테이너로 워크로드를 돌리는 경로도 열려 있습니다.
배포를 되돌리려면 어떻게 하나요
배포마다 결과물이 따로 보관되므로, 이전 배포를 프로덕션으로 승격시키면 됩니다.
코드를 되돌려 다시 빌드하는 것보다 빠릅니다.
요금이 예상보다 많이 나올 수 있나요
엣지 요청과 데이터 전송이 종량이라 트래픽이 튀면 늘어납니다.
그래서 Spend Management로 한도를 걸고 알림을 받도록 설정해두는 편이 낫습니다.
예산을 넘기기 전에 사용을 멈추게 하는 옵션도 있습니다.
