← 에디토리얼

바이브코딩 도전기 · 2026.11.17 · 7분

바이브코딩 앱 만들기, 앱스토어 없이 폰에 5분

AItoZ 개발팀 · 2026.11.17 발행

바이브코딩 앱 만들기, 앱스토어 없이 폰에 5분 — 바이브코딩 도전기

클로드 코드에 "물 마시기 기록하는 앱 만들어 줘. 폰 홈 화면에 아이콘으로 깔아서 앱처럼 쓰고 싶어." 한 줄을 보냈더니 약 5분 만에 웹앱(PWA)이 나왔고, 안드로이드 에뮬레이터 크롬에서 '앱 설치'로 홈 화면 아이콘까지 깔았습니다. 막힌 곳은 코드가 아니라 주소였습니다 — PC 주소(http)로 열면 '바로가기 만들기'만 뜨고, https나 localhost여야 '앱 설치'가 뜹니다.

2026년 11월 17일 직접 시험 · Claude Code(Opus 5.5) 지시 1번 · 안드로이드 16 에뮬레이터(Google Play 이미지) · 크롬 143 · 앱은 이 시험에서 새로 만든 것

안드로이드 홈 화면에 깔린 '물 한 잔' 아이콘과, 그 아이콘으로 연 앱 화면

"내가 만든 걸 폰에서 앱처럼 쓰고 싶다"는 생각, 바이브코딩을 해 보면 한 번쯤 듭니다. 그런데 앱스토어에 올리려면 개발자 등록 · 심사 · 빌드 도구까지 넘어야 할 산이 많죠. 그래서 이번에는 앱스토어를 거치지 않는 방법, 웹앱(PWA)을 만들어 홈 화면에 설치하는 길을 직접 해 봤습니다. 결론부터 말하면 만드는 데 약 5분, 설치는 몇 초였고, 막힌 곳은 코드가 아니라 '어떤 주소로 여느냐'였습니다.

클로드 코드에 뭐라고 보냈나요?

딱 한 줄(두 문장)입니다. 기능 목록이나 기술 이름은 넣지 않았습니다.

물 마시기 기록하는 앱 만들어 줘. 폰 홈 화면에 아이콘으로 깔아서 앱처럼 쓰고 싶어.

여기에 작업 폴더 위치, 인터넷에서 아무것도 내려받지 말 것, 확인용 서버 포트 같은 작업 환경 안내만 붙였습니다(내용 지시는 아님). 보내고 나서 끝났다는 보고가 오기까지 5분 25초였고, 지시는 이 한 번으로 끝났습니다.

나온 것은 다음과 같습니다(11월 17일 폴더에서 줄 수를 직접 셌습니다).

파일 줄 수 하는 일
index.html 473 앱 화면 전체(컵 버튼 · 물 차오르는 컵 · 7일 그래프 · 설정)
manifest.webmanifest 17 앱 이름 · 아이콘 · 시작 주소 · display: standalone
sw.js 37 서비스 워커(파일 캐시)
serve.py · make_icons.py 38 · 69 확인용 서버 · 아이콘 PNG 4장 만들기

합쳐 파일 5개 634줄에 아이콘 PNG 4장입니다. 이름은 '물 마시기 기록', 홈 화면에 보이는 짧은 이름은 '물 한 잔'으로 클로드가 정했습니다.

크롬에서 localhost:51380으로 연 첫 화면

150 · 250 · 350 · 500ml 컵 버튼을 누르면 기록되고, 가운데 컵에 물이 차오르면서 목표(기본 2,000ml)까지 남은 양이 보입니다. 목표를 채우면 색종이가 터지고, 최근 7일 그래프 · 되돌리기 · 다크 모드까지 들어 있었습니다.

어디서 막혔나요?

주소에서 막혔습니다. 클로드는 끝나고 "폰을 PC와 같은 와이파이에 연결한 뒤 http://PC주소:51380으로 들어가 홈 화면에 추가하라"고 안내했는데, 그대로 PC 주소로 열면 크롬 메뉴에 '앱 설치'가 없고 '홈 화면에 추가 → 바로가기 만들기'만 뜹니다. 주소창에는 주의 표시(⚠)가 붙고, 앱 안에 만들어 둔 '추가' 안내도 나오지 않았습니다.

PC 주소(http://10.0.2.2:51380)로 열었을 때 크롬 메뉴 — '홈 화면에 추가'만 있음

왼쪽 PC 주소로 연 창은 '바로가기 만들기', 오른쪽 localhost로 연 창은 '앱 설치'

에뮬레이터에서 10.0.2.2는 PC를 가리키는 주소라, 실제 폰에서 같은 와이파이의 PC 주소로 연 것과 같은 상황입니다. 클로드도 보고 끝에 "인터넷이 없을 때도 열리려면 https 주소에 올려야 한다"고 적긴 했지만, 설치 버튼 자체가 안 뜬다는 말은 없었습니다.

왜 https나 localhost여야 하나요?

PWA는 그렇게 정해져 있기 때문입니다. MDN 문서(Making PWAs installable, 2026년 10월 6일 수정본)는 "설치할 수 있으려면 https로, 또는 localhost나 127.0.0.1의 로컬 개발 환경에서 제공돼야 한다"고 적고 있습니다. 같은 문서에 크롬 계열 브라우저가 요구하는 매니페스트 항목도 나옵니다.

PWA 설치 조건 — https 또는 localhost

  • name 또는 short_name
  • icons — 192px과 512px 아이콘
  • start_url
  • display(또는 display_override)
  • prefer_related_applications가 없거나 false

이번에 클로드가 만든 매니페스트는 이 항목을 모두 갖추고 있었습니다(직접 확인). 그러니 코드는 문제가 없었고, 여는 주소만 바꾸면 되는 상황이었습니다.

그럼 어떻게 설치했나요?

에뮬레이터 안에서 localhost로 열었습니다. PC의 51380 포트를 에뮬레이터의 같은 포트로 연결해(adb의 포트 연결) 에뮬레이터 크롬에서 http://localhost:51380을 열었더니, 바로 앱 안의 '추가' 안내가 나왔고 누르니 크롬의 '앱 설치' 창이 떴습니다.

localhost로 열고 '추가'를 누르자 뜬 크롬 '앱 설치' 창

  1. 확인용 서버 켜기(python serve.py, 포트 51380)
  2. 폰(이번엔 에뮬레이터)에서 localhost:51380이 PC로 가도록 포트 연결
  3. 크롬에서 localhost:51380 열기
  4. 앱의 '추가' 또는 크롬 메뉴 → '앱 설치' → 설치
  5. 몇 초 뒤 홈 화면에 '물 한 잔' 아이콘

홈 화면에 생긴 '물 한 잔' 아이콘

아이콘을 누르면 물방울 시작 화면이 잠깐 뜨고 주소창 없이 앱이 열립니다. 컵 버튼을 누를 때마다 물이 차오르고, 2,000ml를 넘기면 색종이가 터졌습니다. 써 보니 겉으로는 앱스토어에서 받은 앱과 구분이 안 됐습니다.

아이콘으로 연 앱 — 주소창 없이 열리고 목표를 채운 화면

내 진짜 폰에서는 어떻게 하나요?

두 가지 길이 있습니다. 이번 시험은 에뮬레이터에서만 했고, 아래 두 방법은 다음 편에서 직접 해 볼 예정입니다.

방법 어떻게 주의
USB 포트 포워딩 크롬 개발자 도구의 원격 디버깅으로 폰을 연결하고 'Port forwarding'에 포트를 적으면, 폰 크롬에서 localhost:포트로 PC 서버를 열 수 있음(Chrome DevTools 공식 문서) 내 폰 한 대 시험용. PC를 꺼 두면 새로 열 때 서버가 없음
https 주소에 올리기 정적 파일을 https 호스팅에 올리고 그 주소로 열기 기록은 폰 브라우저 안에만 저장돼 다른 기기와 이어지지 않음

한 번에 정리

  • 한 줄 요청으로 PWA는 약 5분(5분 25초) 만에 나왔다. 파일 5개 634줄 + 아이콘 4장, 지시 1번.
  • PC 주소(http)로 열면 '바로가기 만들기'만 뜬다. 설치는 https 또는 localhost에서만 된다(MDN).
  • localhost로 열면 크롬 '앱 설치' → 홈 화면 아이콘 → 주소창 없이 열린다.
  • 걸린 시간은 모델 · 상황에 따라 다를 수 있다. 각 상표는 해당 회사의 것이다.

출처

다음 글AI로 3D 게임 만들기, 지도 그림 0장으로 끝없는 하늘을 날았다→