2026년 11월 12일 직접 시험 · 클로드 코드 2.1.322(Opus 5.5) · 설치 화면은 안드로이드 에뮬레이터(크롬)로 녹화 · 걸린 시간은 1회 측정값

클로드 코드로 웹앱을 만들고 나면 "이거 폰에 앱처럼 깔아 두고 쓰고 싶다"는 생각이 듭니다. 그렇다고 앱스토어 · 플레이스토어에 올리려면 개발자 등록과 심사를 거쳐야 합니다. 작은 앱 하나를 친구에게 보여 주거나 내가 쓰는 정도라면, 브라우저가 공식으로 지원하는 **홈 화면 설치(PWA)**로 충분합니다. 이 글은 지난 편에서 폰 조이스틱을 붙인 작은 점프 게임 '젬 점프'를 실제로 폰 홈 화면에 깔아 본 기록입니다.
PWA로 깔면 뭐가 달라지나요?
홈 화면에 아이콘이 생기고, 누르면 주소창 없이 앱만 화면에 꽉 차게 열립니다. 일반 즐겨찾기처럼 브라우저 탭이 열리는 게 아니라, 앱 이름과 아이콘을 가진 별도의 창으로 뜹니다.

아이콘을 누르면 게임 아이콘이 들어간 시작 화면이 잠깐 나오고, 상태 표시줄까지 숨긴 전체 화면으로 게임이 열렸습니다. 클로드가 manifest에 "display": "fullscreen"을 넣었기 때문입니다.

클로드 코드에는 뭐라고 보내면 되나요?
아래 한 줄이면 됩니다. 게임 폴더(index.html 한 개짜리)에서 클로드 코드를 열고 그대로 보냈습니다.
이 웹앱을 폰 홈 화면에 설치되는 앱(PWA)으로 만들어 줘

2분 25초(145초) 뒤 작업이 끝났고, 파일 8개가 바뀌었습니다. 새로 생긴 것은 앱 이름 · 아이콘 · 화면 방식을 적은 manifest.webmanifest, 한 번 열어 두면 인터넷 없이도 켜지게 해 주는 서비스 워커 sw.js, 그리고 아이콘 5장(안드로이드용 192 · 512, 둥글게 잘려도 되는 maskable 512, 아이폰용 180, 브라우저 탭용 32)입니다. index.html에는 manifest · 아이콘 연결과 서비스 워커 등록 코드가 들어갔고(19줄 변경), 게임 코드는 건드리지 않았습니다.

아이콘도 따로 그려 달라고 하지 않았는데 게임 속 캐릭터 · 보석 · 발판으로 직접 그려 넣었습니다. 아이콘 이미지를 따로 준비하지 않아도 된다는 점이 생각보다 편했습니다.
'PWA'라는 말을 꼭 넣어야 하나요?
우리 시험에서는 아니었습니다. 같은 게임을 새로 복사해 "이 게임을 폰에서 앱처럼 쓰고 싶어"라고만 보냈더니, 2분 34초(154초) 만에 똑같이 PWA로 만들어 줬습니다. 그쪽은 아이콘이 3장(파일 6개)으로 조금 적었을 뿐, manifest와 서비스 워커는 같게 들어갔습니다.

| 보낸 말 | 걸린 시간 | 바뀐 파일 | 결과 |
|---|---|---|---|
| "이 웹앱을 폰 홈 화면에 설치되는 앱(PWA)으로 만들어 줘" | 2분 25초 | 8개(아이콘 5장) | PWA |
| "이 게임을 폰에서 앱처럼 쓰고 싶어" | 2분 34초 | 6개(아이콘 3장) | PWA |
한 번씩 해 본 결과라 언제나 같다고 장담할 수는 없습니다. 확실하게 하려면 "설치되는 앱(PWA)으로"라고 적는 쪽이 안전합니다. 다만 단어 하나보다 더 자주 막히는 곳은 그다음, 올리는 주소입니다.
폰에는 어떻게 까나요?
설치 버튼은 https 주소에서 열었을 때만 뜹니다. 파일을 폰에 복사해 직접 열거나 일반 http 주소로 열면 설치되지 않습니다(web.dev 설치 조건: manifest의 이름 · 아이콘 · 시작 주소 · 화면 방식 + HTTPS). 그래서 순서는 이렇습니다.
- 클로드 코드에 위 한 줄을 보낸다.
- 폴더를 통째로 https 주소에 올린다. 깃허브 페이지 같은 무료 정적 호스팅이면 충분합니다.
- 폰 브라우저로 그 주소에 들어가서 홈 화면에 추가한다.
- 안드로이드(크롬): 오른쪽 위 메뉴(⋮) → 홈 화면에 추가 → 설치
- 아이폰(사파리): 공유 버튼 → 홈 화면에 추가

안드로이드에서는 메뉴를 누르자 앱 이름 '젬 점프'와 아이콘이 들어간 설치 창이 바로 떴고, 설치를 누르니 홈 화면에 추가할지 한 번 더 물었습니다.


아이폰은 Apple 사용 설명서대로 사파리 공유 버튼 안에서 '홈 화면에 추가'를 한 번 더 찾아 들어가야 합니다. 안드로이드는 메뉴에서 바로 끝나는데 아이폰은 이 한 단계가 더 있어서, 써 보라고 링크를 보낼 때 이 부분은 따로 알려 주는 게 좋겠다고 느꼈습니다.

주의할 점은 무엇인가요?
- 앱스토어 앱과 똑같지는 않습니다. 앱스토어 검색에 나오지 않으니 주소는 직접 알려 줘야 합니다. 브라우저 기능 위에서 도는 웹앱이라, 앱스토어 앱에서 되는 기능이 모두 되는 것은 아닙니다.
- 우리는 테스트라 PC 안 주소(localhost)로 열었습니다. 브라우저가 테스트용 주소로 열어 줘서 설치 창이 떴지만, 다른 사람 폰에서 쓰려면 반드시 https 주소에 올려야 합니다.
- 에뮬레이터라서 보인 차이. 녹화는 안드로이드 에뮬레이터(구글 플레이 이미지, 로그인 안 함)로 했고, 크롬 메뉴가 영어로 나왔으며 아이콘 귀퉁이에 작은 크롬 표시가 붙었습니다. 실제 폰에서는 메뉴 이름 · 아이콘 모양이 다를 수 있습니다.
- 고쳐서 다시 올릴 때. 서비스 워커가 옛 파일을 저장해 두기 때문에, 클로드 설명대로
sw.js맨 위VERSION을"v2"처럼 올려야 바뀐 내용이 확실히 반영됩니다. - 걸린 시간은 1회 측정입니다. 2026년 11월 12일 클로드 코드(Opus 5.5)로 한 번씩 잰 값이고, 모델 · 앱 크기에 따라 달라집니다.
한 번에 정리하면?
- 앱스토어 심사 없이도, 브라우저의 홈 화면 설치(PWA)로 내 웹앱을 폰에 아이콘 · 전체 화면 앱으로 깔 수 있다.
- 클로드 코드에 "이 웹앱을 폰 홈 화면에 설치되는 앱(PWA)으로 만들어 줘" 한 줄 → 2분 25초, manifest · 서비스 워커 · 아이콘까지 알아서 붙었다.
- 진짜 챙길 것은 https 주소. 무료 호스팅에 올린 뒤 안드로이드는 크롬 메뉴, 아이폰은 사파리 공유 버튼에서 홈 화면에 추가.
다음 편에서는 이 앱에 토스 결제창을 붙여 봅니다.
출처
- web.dev, What does it take to be installable?: https://web.dev/articles/install-criteria
- MDN Web Docs, Making PWAs installable: https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Guides/Making_PWAs_installable
- Apple iPhone 사용 설명서, 홈 화면에 웹사이트 추가: https://support.apple.com/guide/iphone/bookmark-favorite-webpages-iph42ab2f3a7/ios
- 시킨 말 · 바뀐 파일 · 걸린 시간 · 설치 녹화: AItoZ 직접 시험(2026-11-12, 클로드 코드 2.1.322 · 안드로이드 에뮬레이터 크롬)
- 영상: AItoZ 유튜브 쇼츠 '앱스토어 없이 내 앱을 폰에? 클로드 코드 한 줄로 홈 화면 앱(PWA) 만들기'
