바이브 코딩 →

로컬호스트(localhost, 127.0.0.1)Localhost (127.0.0.1)

로컬호스트(Localhost)는 우리 집 안에서만 통하는 방 번호 같은 것 — 127.0.0.1처럼 "지금 이 컴퓨터 자신"을 가리키는 주소로, 내 PC에서만 열리고 다른 사람에게는 열리지 않아요.

로컬호스트는 집 안에서만 쓰는 "내 방"이라는 표현과 비슷해요. 가족끼리는 "내 방에 있어"라고 하면 통하지만, 밖에 있는 친구에게 "내 방으로 와"라고 하면 어디인지 알 수 없어요. localhost와 127.0.0.1도 "지금 이 컴퓨터 자신"을 뜻하는 약속된 주소라서, 내 PC에서 열면 내 PC를 가리키고 친구 PC에서 열면 친구 PC를 가리켜요. 그래서 그 주소를 남에게 보내면 열리지 않아요.

강의에서는 사이트를 배포하기 전에 localhost 미리보기 서버를 띄워 화면을 보면서 피드백하는 장면이 자주 나와요. 클로드 코드에게 "미리보기로 띄워 줘"라고 하면 localhost:3000 같은 주소가 나오고, 브라우저로 열어 확인해요. AI 에이전트의 게이트웨이 주소 기본값 127.0.0.1도 내 컴퓨터를 뜻하며, 같은 컴퓨터에 봇을 하나 더 띄울 때는 포트 번호만 다르게 줘서 구분해요. 또 도메인을 산 뒤에는 Supabase·Vimeo·환경 변수 등에 넣어 둔 localhost를 실제 도메인으로 바꿔야 로그인이 정상 작동한다고 짚어 줘요. 우분투 프롬프트에 보이는 사용자명@localhost도 같은 뜻이에요.

초보가 가장 많이 묻는 건 "왜 친구가 못 여나요?"예요. localhost는 공개된 주소가 아니라서, 다른 사람과 공유하려면 Vercel 같은 곳에 배포하고 도메인을 연결하거나 터널을 써야 해요. 또 localhost 뒤의 숫자(:3000)는 포트라서, 같은 컴퓨터에서 여러 프로그램을 동시에 띄울 때 서로 다른 번호를 써야 충돌하지 않아요. 미리보기가 안 열리면 서버가 꺼져 있지 않은지부터 확인하세요.

💡 대표 예시

  • 사이트 미리보기 — 배포 전 localhost:3000을 열어 화면을 보며 수정을 요청한다
  • 봇 추가 — 같은 PC에 봇을 하나 더 띄우며 포트 번호만 다르게 지정한다
  • 도메인 연결 후 — 환경 변수에 남은 localhost를 실제 도메인으로 바꾼다
  • 공유 실패 — 친구에게 보낸 localhost 링크가 안 열려 배포 후 주소를 보낸다
  • 로그인 오류 — Supabase 리디렉션 주소가 localhost로 남아 있는지 확인한다

🔗 관련 용어

이 개념, 직접 적용해볼까요?

AI와 함께 나만의 사이트·서비스를 만드는 법을 강의에서 배워보세요.