안녕하세요!
바이브 코딩 글을 읽다 보면 깃허브, API, 배포 같은 단어가 설명 없이 툭툭 튀어나옵니다. 결론부터 말씀드리면 이 셋만 알아도 절반은 이해됩니다.
전부 실생활에 비슷한 게 있습니다. 어렵게 외울 필요 없이 익숙한 그림 하나씩만 붙이면 됩니다.
오늘은 자주 나오는 낯선 단어를 실생활 비유로 하나씩 정리해 드리겠습니다. 읽고 나면 다음 글부터 용어에 걸려 넘어지지 않으실 겁니다.
깃허브, 작업물을 담아 두는 창고
깃허브는 코드를 저장하는 곳입니다. 사진을 구글 드라이브에 올리듯 코드를 깃허브에 올려 둔다고 생각하면 되는데, 다른 점이라면 수정 기록까지 전부 남는다는 점입니다.
한글 문서로 치면 "변경 이력 보기"에 가장 가깝습니다. 간단합니다. 어제 버전, 오늘 버전을 언제든 꺼내 볼 수 있고, 잘못 고쳤으면 되돌릴 수도 있습니다.
여러 사람이 같이 만들 때도 유용합니다. 같은 파일을 동시에 고쳐도 깃허브가 충돌을 정리해 줍니다. 팀 프로젝트에서는 거의 기본입니다.
혼자 하는 프로젝트라도 안심하고 저장할 창고 하나쯤 가지고 있으면 든든하며, AI 코딩 도구도 대개 깃허브와 바로 연결됩니다.
API, 가게에 주문 넣는 창구
API라는 말이 제일 낯설게 들립니다. 처음엔 다 그렇습니다. 쉽게 말하면 주문을 받는 창구이며, 식당에서 주방을 직접 못 봐도 주문서만 넣으면 음식이 나오는 것과 같습니다.
날씨 정보를 예로 들어 보겠습니다. 내 프로그램이 직접 하늘을 관측할 수는 없는데, 대신 날씨 API에 "서울 기온 알려줘"라고 주문서를 넣으면 숫자가 돌아옵니다.
내부 로직은 몰라도 됩니다. 어떤 주문서를 넣으면 어떤 답이 오는지만 알면 가져다 쓸 수 있습니다. API는 남이 만든 기능을 빌려 쓰는 문입니다.
결제, 지도, 로그인 같은 기능도 대부분 이 방식으로 붙입니다. 전부 처음부터 만들 필요 없이, 이미 있는 창구에 주문만 넣으면 됩니다. 그래서 개발 속도가 크게 빨라집니다.
배포, 세상에 문을 여는 것
배포는 만든 걸 세상에 공개하는 일입니다. 집으로 치면 완공 후 현관문을 여는 순간과 같습니다. 내 컴퓨터 안에서만 돌던 프로그램을 누구나 볼 수 있는 주소로 옮기는 겁니다.
배포 전에는 나만 볼 수 있습니다. 아무리 잘 만들어도 링크를 보낼 방법이 없으니 남에게 자랑할 수가 없습니다.
배포하고 나면 상황이 달라집니다. 주소 하나만 알려주면 누구든 폰이나 컴퓨터로 바로 접속해서 써 볼 수 있습니다. 이 순간부터 진짜 서비스가 됩니다.
요즘은 배포도 예전만큼 어렵지 않습니다. 버튼 몇 번이면 끝나는 서비스도 여럿 나와 있습니다. 막막해 보이지만 실제로는 생각보다 간단한 절차입니다.
세 단어를 하나로 이어 보면
이 세 단어는 사실 이어져 있습니다. 깃허브에 코드를 저장하고, API로 필요한 기능을 붙이고, 마지막으로 배포해서 공개합니다.
순서로 외우면 잊히지 않습니다. "창고에 담고, 창구에 주문 넣고, 문을 연다." 이렇게만 기억해 두시면 됩니다.
AI에게 시킬 때도 이 순서가 통합니다. "깃허브에 올려 줘", "날씨 API 붙여 줘", "이거 배포까지 해줘". 말 몇 마디로 전 과정이 이어집니다.
그 밖에 자주 보이는 단어들
디버깅은 오류를 찾아 고치는 일입니다. "버그를 잡는다"는 말 그대로 문제가 생긴 곳을 찾는 과정입니다. AI에게 "에러 메시지야, 고쳐 줘"라고 붙여넣기만 해도 대부분 해결됩니다.
프론트엔드는 눈에 보이는 화면, 백엔드는 그 뒤에서 계산하고 저장하는 부분을 가리킵니다. 가게로 치면 손님이 보는 홀과 안 보이는 주방의 관계와 같습니다.
이 정도만 알아도 바이브 코딩 대화를 따라가는 데 큰 어려움이 없습니다. 모르는 단어가 나오면 그때그때 AI에게 물어보셔도 됩니다.
정리하면
깃허브는 저장 창고, API는 주문 창구, 배포는 세상에 여는 문입니다. 셋 다 실생활 비유 하나면 충분히 이해됩니다.
용어에 겁먹을 필요는 없습니다. 모르는 단어가 나올 때마다 오늘 배운 비유를 떠올려 보세요. 생각보다 빨리 익숙해지실 겁니다.
이 세 단어를 익혔다면 이제 직접 프로젝트 하나를 만들어 볼 차례입니다. 작은 것부터 시작해 보세요.
