본문으로 건너뛰기

초심자를 위한, 내 글(대쉬보드)을 출간/배포(url 생성)하기(비유적 표현입니다)

randomwalk

2026.07.26

초심자를 위한, 내 글(대쉬보드)을 출간/배포(url 생성)하기(비유적 표현입니다) 본문 이미지

소개

토요일(25일) OT때 했던 작업을 정리해 봅니다. 이 글은 불순물(관련 지식) 없는 완벽한 초심자의 입장에서 쓴 글이니, 조금이나마 문명의 이기(AI)가 묻은 분은 소중한 시간을 다른 곳에 할애해주세요. 당신의 더 나은 삶을 위해서 말이죠.

1. 폴더 만들기
2. 폴더 안에서 claude 코드 실행하기
3. 실행한 claude 코드한테 작업시키기 (간단한 대시보드 만들어줘)
4. 깃허브 레포 만들기
5. 작업한 폴더랑 레포랑 연결하기
6. 연결한 레포에 작업물 올리기
7. vercel 로그인 (깃헙)
위 내용의 의미를 부여하면, 이렇습니다(아래 내용은 제가 다시 ChatGPT에게 물어서 받은 답변을 제 언어로 다시 풀어 쓴 글입니다).

오늘 한 작업은 "글을 써서 책으로 출간하는 과정"과 거의 유사합니다. 작업 폴더는 내 책상, 대시보드는 그 책상 위에서 쓴 원고, GitHub는 원고의 모든 수정본을 순서대로 보관해주는 서고(도서관), Vercel은 그 원고를 실제로 인쇄해서 독자들이 볼 수 있게 진열해주는 서점이라고 생각하면 됩니다. (이제 좀 감이 잡히시나요?)

그리고 "GitHub와 Vercel을 연결한다"는 건, 서점이 서고와 직통 배송선을 뚫어서 "서고에 새 원고가 들어오면 자동으로 가져다가 진열대에 올려놓는" 시스템을 만드는 것이 됩니다. Vercel은 스스로 아무 내용도 만들지 않습니다. 서점이 종이만 갖고 있지 글 자체는 못 쓰는 것과 같죠. Vercel이 웹사이트를 만들려면 "어디서 코드를 가져올지"를 알아야 하는데, 그 원천이 바로 GitHub repo입니다. 연결을 안 하면 Vercel 입장에서는 "인쇄할 원고 자체가 없는" 상태라 진열(=배포)할 것이 없고, 그래서 URL도 만들어지지 않는 겁니다.

이쯤에서 용어 정리를 한번 하고 가겠습니다. 우린 초심자니까요.

  • GitHub: 코드의 모든 버전(수정 이력)을 온라인에 보관해주는 서비스. 여러 서고를 운영하는 대형 도서관 회사라고 보면 됩니다.

  • repo(repository, 저장소): 그 도서관 안에서 이 프로젝트 하나만을 위해 배정된 서고 칸. "이 책과 관련된 모든 버전은 여기에만 넣는다"는 전용 보관함입니다.

  • Vercel: 코드를 실제로 작동하는 웹사이트로 만들어서(빌드) 인터넷에 올려주는(배포) 서비스. 원고를 책으로 찍어 진열해주는 서점입니다.

  • commit: 지금 원고 상태를 "이 시점의 완성본"으로 스냅샷 찍는 것.

  • push: 그 스냅샷을 내 책상(로컬 컴퓨터)에서 서고(GitHub)로 보내는 것.

  • 배포(deploy): 서점 진열대에 실제로 올려서 누구나 볼 수 있게 만드는 것. 그 결과로 URL이 생깁니다.

진행 방법

먼저 작업 폴더를 만들고 이동해서 클로드를 실행합니다(원도우키 + r, cmd).

그다음 저는 자연어로 일정 관리 대쉬보드를 만들어 달라고 주문했습니다.

컴퓨터 화면에 표시된 달력의 스크린샷

깃허브에 repository를 만듭니다.

Slack에서 새 저장소를 만드는 방법

그 다음 깃허브에 작업 폴더를 올립니다.

텍스트 상자와 버튼이 있는 웹페이지의 스크린샷
구글 캘린더 스크린샷

결과와 배운 점

다시 한번 정리합니다. 우린 초심자니까요. 반복만이 망각을 이기는 유일한 길입니다.

  • 작업 폴더 생성 — 책상 마련. 코드를 쓸 물리적 공간.

  • 대시보드 생성 — 실제로 진열해볼 원고를 하나 써본 것. "이 파이프라인이 제대로 작동하는가"를 시험할 최소한의 콘텐츠.

  • GitHub repo 생성 & 폴더 연결 — 내 책상과 서고 사이에 통로를 뚫은 것. 이제부터 내 폴더에서 commit-push 하면 그 내용이 서고에 쌓입니다.

  • Vercel project 생성 — 서점에 "이 책을 취급하겠다"고 등록만 한 상태. 아직 원고는 안 받음.

  • Vercel-GitHub 연결 — 서점과 서고 사이 배송선 개통. 이 순간 Vercel이 repo의 코드를 가져다 실제로 빌드하고 진열대에 올려서, 배포 완료와 함께 URL이 생긴 겁니다.

(기대할) 성과물은, 내가 로컬에서 코드를 고치고 push만 하면 자동으로 인터넷에 반영되는 개인 웹 배포 시스템을 갖게 되는 겁니다.

이후엔 "무엇을 만들지"에만 집중하면 되고, "어떻게 세상에 내보낼지"는 이미 오늘 뚫어놓은 파이프라인이 알아서 처리할 거라 믿습니다.

도움 받은 글 (옵션)

혼자 못 해서 주변 분들의 도움을 받았습니다. 도와주신 모든 분들께 감사의 말씀 전합니다.

2

함께 이야기해요 2

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

뽀짝이 프로필 이미지
뽀짝이2026.07.26

책상·원고·서고·서점 비유가 정말 딱 맞아 떨어져요. "Vercel은 스스로 아무 내용도 만들지 않는다"는 문장 하나로 왜 GitHub 연결이 필요한지를 설명하는 방식 — 개념을 자기 언어로 소화한 다음 다시 쓴 거라 훨씬 와닿습니다.

특히 마지막 정리 부분에서 각 단계를 비유와 함께 다시 한 번 반복하신 게 ("우린 초심자니까요. 반복만이 망각을 이기는 유일한 길입니다") 글 구조로도 실천이에요. 읽는 사람 입장에서 자연스럽게 두 번 배우게 됩니다.

"이후엔 무엇을 만들지에만 집중하면 된다"는 결론이 배포 파이프라인을 이해한 사람만 할 수 있는 말이에요. 오늘 뚫어놓은 파이프라인이 앞으로 어떤 결과물을 내보낼지 기대됩니다 🐈‍⬛

유피테르 프로필 이미지
유피테르2026.07.28

초심자의 시선에서 폴더 생성부터 GitHub 연결, Vercel 배포까지 실제로 밟은 순서를 빠짐없이 기록해 주셔서 따라가는 흐름이 선명했어요. 특히 commit·push·deploy를 각각 어떤 행동인지 풀어 설명한 덕분에 낯선 용어들이 단순히 외우는 대상이 아니라 직접 해볼 수 있는 과정으로 느껴졌습니다. 자연어로 대시보드를 만들고 직접 URL이 생기는 데까지 완주하신 경험을 솔직하게 나눠주셔서 초보자들에게 큰 용기가 될 것 같아요.

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

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

이런 사례도 있어요

사례 전체 보기