← 에이아이머니랩 무료 자료
@ai._.moneylab 가이드

코드 몰라도 말로 시켜서
토스 미니앱 만들기

토스 앱 안에서 돌아가는 작은 앱(앱인토스)을 Claude Code에 말로 시켜 만드는 순서예요. 저희가 앱 하나를 출시하면서 실제로 시킨 순서와 겪은 일을 바탕으로 프롬프트를 정리했어요. 복사 버튼을 누르면 그대로 붙여 넣을 수 있어요.

0

준비물

  • Claude Code: 컴퓨터에 깔아 두고 대화창에 말로 시켜요. 코드는 Claude가 쓰고 파일도 직접 만들어요.
  • 앱인토스 개발자 콘솔 가입: 토스 계정으로 가입하고 워크스페이스와 앱을 만들어요. 앱의 영어 이름(appName)은 나중에 못 바꿔요.
  • 사업자 등록: 광고만 붙인 앱은 예상 수익이 5천 원이 될 때까지는 사업자 없이 운영돼요. 저희 콘솔에 뜬 경고 문구에서 본 내용이에요. 그 뒤로는 사업자 승인이 없으면 앱이 멈춰요. 결제를 붙일 때는 저희도 사업자 등록부터 했어요.
  • Cloudflare 계정: 서버가 필요할 때만요.
1

아이디어 정하기

토스 미니앱(앱인토스)으로 만들 수 있는 재미있는 앱 아이디어 5개를 줘.
- 사람들이 매일 다시 들어올 이유가 있는 것
- 친구에게 보내고 싶어지는 장면이 하나씩 있는 것
- 로그인 없이 시작할 수 있는 것
아이디어마다 한 줄 설명, 매일 들어올 이유, 광고를 붙일 자리를 적어 줘.

나오는 것 아이디어 5개 표. 마음에 안 들면 "더 웃긴 쪽으로"처럼 방향만 말하고 다시 받아요.

저희도 처음 받은 1등 아이디어는 끌리지 않아서 다시 받았어요. 고른 건 사고 싶은 물건을 판사 돼지가 재판해 주는 앱 '사도돼지'였어요.

2

앱 뼈대 만들기

토스 앱인토스 미니앱을 만들 거야. 토스 공식 시작 도구(create-ait-app)로 React + TypeScript + Vite 프로젝트를 만들어 줘.
처음에는 화면 하나만: [여기에 1번에서 고른 아이디어의 첫 화면을 한 줄로].
- 앱 이름(appName)은 [콘솔에서 만든 이름]으로
- 기록은 일단 폰 안에만 저장
- 다 만들면 개발 서버를 켜고 브라우저에서 열리는지 직접 확인해 줘
- 콘솔에 올릴 .ait 파일을 만드는 명령도 알려 줘

나오는 것 브라우저에서 열리는 첫 화면과, 콘솔에 올릴 앱 파일(.ait)을 만드는 방법.

3

화면과 기능 더하기

한 번에 하나씩 시키는 게 덜 꼬여요. 고칠 때는 화면을 보고 느낀 그대로 말하면 돼요.

지금 앱에 기능 하나만 더해 줘: [기능 한 줄].
- 다른 화면은 건드리지 마
- 작은 폰과 큰 폰 두 크기로 직접 눌러 보고, 글자가 넘치거나 겹치면 고쳐 줘
- 끝나면 무엇을 바꿨는지 짧게 알려 줘

나오는 것 기능 하나가 붙은 앱과 바뀐 곳 설명.

고칠 때 저희가 실제로 한 말은 "세트로 해"처럼 짧은 말이었어요. 친구가 써 보고 한 말을 그대로 붙여 넣기도 했어요.

4

서버가 필요할 때

친구 투표나 랭킹처럼 여러 사람의 기록을 모아야 하면 서버가 있어야 해요. 저희는 Cloudflare Workers와 D1 데이터베이스를 썼어요.

[기능 이름]에 쓸 서버를 Cloudflare Workers + D1 으로 만들어 줘.
- 비밀값(키, 토큰, 비밀번호)은 코드와 저장소에 절대 넣지 말고 wrangler secret 으로만
- 이름·전화번호 같은 개인 정보는 받지 마
- 받은 글은 길이와 내용을 검사하고, 한 사람이 너무 자주 보내면 막아 줘
- 토스 미니앱 주소에서 오는 요청만 받게 허용 목록을 둬
- 내가 Cloudflare 로그인만 하면 되게 배포 순서를 한 줄씩 알려 줘

나오는 것 서버 코드, 데이터베이스 표, 점검 스크립트, 배포 순서. 로그인은 직접 해요.

토스 앱 안에서 시험할 때 앱 주소는 private-apps.tossmini.com으로 끝났어요. 이 주소를 허용 목록에 안 넣으면 서버 기능이 전부 막혀요.

5

콘솔에 올리고 검토 받기

  • 콘솔에서 앱 파일(.ait)을 올리면 약 1분 뒤 시험 버전이 생겨요. QR을 토스 앱으로 찍어 폰에서 직접 눌러 봐요.
  • 파일을 올린 뒤 '임시저장'을 꼭 눌러야 검토에 그 버전이 들어가요.
  • 같은 파일을 다시 올리면 "이미 존재하는 버전"이라고 막혀요. 다시 만들어서 올려요.
  • 앱 파일은 10MB를 넘으면 안 돼요. 저희는 글꼴 파일을 줄여 맞췄어요.
  • 로고는 600×600 PNG, 배경색이 있어야 하고 모서리를 둥글게 깎으면 안 돼요. 부제는 20자, 상세 설명은 500자까지예요.
  • AI로 만든 그림을 쓰면 앱 화면에 그렇다고 적어 둬요.
  • 마지막 약속 항목 체크와 '검토 요청'은 직접 눌러요.

반려된 일 앱 파일 안에 시험용 광고 번호가 들어 있다는 이유로 한 번 반려됐어요. 시험용 번호는 시험용 파일에만 들어가게 바꾸고 다시 내서 그날 통과했어요.

콘솔에 낼 앱 파일을 만들어 줘. 그 전에 확인해 줘.
- 파일 크기가 10MB 안인지
- 시험용 광고 번호(test 가 들어간 광고 ID)가 앱 파일 안에 글자로 남아 있지 않은지
- 화면에 임시 문구나 샘플 그림이 남아 있지 않은지
문제가 있으면 고친 뒤에 파일을 만들어 줘.

나오는 것 확인 결과와 콘솔에 올릴 .ait 파일.

6

광고 붙이기

광고 그룹은 콘솔에서 만들고, 광고 번호가 나오기까지 몇 시간 걸렸어요. 실제 광고 번호로 시험하면 토스 정책 위반이라, 시험할 때는 시험용 번호를 써요.

콘솔에서 받은 광고 번호를 앱에 붙여 줘.
- 보상을 주는 광고(예: 광고 보면 한 번 더 하기)는 보상형 광고로, 끝까지 본 경우에만 보상
- 전면 광고는 할 일이 끝난 자리에서만 띄우고, 뜰 차례면 버튼에 '광고'라고 미리 표시
- 전면 광고는 연달아 뜨지 않게 간격과 하루 횟수를 정해 줘
- 시험용 광고 번호는 시험용 빌드에만 들어가게 하고, 정식 앱 파일에는 남지 않게
광고 번호: [콘솔에서 받은 번호]

나오는 것 광고가 붙은 앱. 보상형 광고는 토스 앱 안에서만 제대로 시험돼요.

보상을 줄 자리에 전면 광고를 쓰면 '끝까지 봤다'는 신호가 안 와서 보상이 영영 안 나가요. 그래서 저희는 보상을 주는 자리를 전부 보상형으로 만들었어요.

7

막혔을 때

아래 오류가 나. 바로 고치지 말고 원인부터 찾아서 알려 줘. 원인이 확실하면 고치고, 고친 뒤에 같은 상황을 다시 돌려서 안 나는지 확인해 줘.
[여기에 오류 메시지나 화면에서 본 것을 그대로 붙여 넣기]

나오는 것 원인 설명과 고친 내용, 다시 돌려 본 결과.

폰에서만 나는 오류는 잘 안 보여요. 저희는 앱에서 난 오류를 서버로 모아 보게 시켜 두었어요.

예시 앱 사도돼지의 판결문 화면. 38만 9천 원짜리 겨울 롱패딩이 노동 33시간이라며 기각 도장이 찍혀 있다
+

이렇게 만든 앱

이 순서로 만든 사도돼지는 11월 13일 저녁에 출시했고, 토스 콘솔 기준 11월 16일 1,243명, 17일 993명이 새로 들어왔어요.

사도돼지 열어 보기

위 프롬프트는 저희가 실제로 시킨 말을 다듬어 정리한 거예요. 이 글자 그대로 처음부터 돌려 본 건 아니라서, 결과는 조금씩 달라요.
토스, Anthropic, Cloudflare와 제휴는 없어요. 이 페이지는 AI의 도움을 받아 만들었어요.