본문으로 건너뛰기

한 번 갈아엎고 다시 만든 토스 미니앱 '새는구독': Claude Code로 출시까지

김코딩

2026.10.21

한 번 갈아엎고 다시 만든 토스 미니앱 '새는구독': Claude Code로 출시까지

소개

매달 새는 구독료를 한눈에 보고, 해지 방법까지 알려주는 토스 미니앱 '새는구독'을 Claude Code와 함께 만들어 앱인토스에 출시했어요. 프로젝트를 만든 10월 19일 저녁 8시부터 출시까지 약 28시간 걸렸어요.

👉 앱 바로가기: https://tossminiapp.com/d/subleak/launch?referrer=appsintoss.common_module_share

사실 이 앱은 두 번째 버전이에요. 10월 중순에 '구독 다이어트'라는 이름으로 한 번 만들었는데, 기획부터 다시 세우고 처음부터 새로 만들었어요. 이 글은 1차 버전에서 무엇이 아쉬웠고, 2차 버전을 어떤 구조로 만들어 출시까지 갔는지 정리한 기록이에요.

1차 버전: '구독 다이어트' (10/14~10/15)

개발지시서 한 장을 쓰고 Claude Code에게 단계별로 맡겨 만들었어요.

항목

내용

화면

홈 / 구독 등록·수정 / 구독 정리, 3개

기능

구독 직접 입력(서비스 9개 + 직접 입력), 월평균·연간 지출, 해지 고려 체크와 예상 절약 금액

저장

서버 없이 앱인토스 SDK Storage(기기 안)

검증

자동 테스트 99개, 브라우저 시나리오 31단계

한계

실제 토스 앱에서 열어 보지 못함. 데이터가 기기에만 있어서 앱을 지우거나 기기를 바꾸면 사라짐. 가격을 사용자가 전부 입력해야 함. "그래서 어떻게 해지하지?"와 "언제 결제되지?"에 답하지 못함

계산기로는 잘 돌아갔지만, 사용자가 다시 찾아올 이유(결제일 알림)와 실제로 끊게 만드는 장치(해지 가이드)가 없었어요. 그래서 고치는 대신 기획부터 다시 하기로 했어요.

2차 버전을 위한 다시 기획 (10/18~10/19)

  • 딥리서치로 구독 관리 시장, 해지가 어려운 이유, 앱인토스 노출 기준(재방문율·전환율)을 먼저 조사했어요.

  • 그 결과로 문서 5개를 먼저 만들었어요: MVP 기획서, 기능 명세서, 화면 명세서, 사용자 흐름, DB 설계서.

  • 기획서는 v0.2 → v0.8까지 고쳤어요. 큰 결정만 꼽으면 이래요.

- 토스 로그인 대신 익명 식별키(anonKey)로 사용자 구분(개인정보를 받지 않음)

- 백엔드는 Firebase로 확정

- 광고는 출시 버전에서 빼고, 업데이트로 단계 도입

- 이름 변경: 구독컷 → 새는구독(같은 이름의 서비스가 있어서). 상표 검색도 확인

앱 소개: 주요 기능과 사양

주요 기능

기능

내용

구독 등록

인기 서비스 템플릿(로고 대신 첫 글자, 요금제, 기본 금액)에서 탭해서 고르고 금액·결제일만 확인. 없으면 직접 입력. 월·연 결제 모두 지원, 결제일 "잘 모르겠어요" 가능, 무료 체험 종료일 입력

대시보드

월 평균 구독료, 1년 기준 금액, 카테고리별 합계, 다가오는 결제

캘린더

이번 달 날짜별 결제 예정

구독 상세

수정·삭제, 다음 결제일, 컷 되돌리기

해지 가이드

서비스별로 결제 경로(앱스토어·구글플레이·웹)에 맞춘 해지 단계. 외부 페이지는 주소 복사만

컷 & 공유

해지를 마친 구독을 '컷'으로 기록, 1년 기준 아끼는 금액 표시, 토스 공유 링크로 친구 초대

결제일 알림

결제 D-3·D-1, 무료 체험 종료 D-2에 토스 메시지로 알림(사용자 동의 시에만)

달러 구독

ChatGPT·Claude처럼 달러로 결제하는 구독은 달러로 입력, 매일 자동 환율로 원화 환산 표시

설정

알림 켜기·끄기와 시점, 문의하기, 개인정보처리방침·이용약관, 모든 데이터 지우기

사양

항목

내용

플랫폼

앱인토스 WebView 미니앱(appName subleak)

프런트

React 18 + TypeScript + Vite, 토스 디자인 시스템(TDS Mobile), 앱인토스 Web SDK 3.8.0

백엔드

Firebase: Cloud Functions 2세대(Node 22, 서울 리전), Firestore, Authentication(커스텀 토큰), Hosting

공용 모듈

날짜·결제일 계산, 금액·환율, 입력 검사, API 타입을 앱과 서버가 같이 씀(같은 계산 결과 보장)

데이터

구독 템플릿·해지 가이드는 CSV → JSON(catalog)으로 변환해 Hosting에 올림(버전별 파일, 1년 캐시)

테스트

자동 테스트 275개(공용 114, 서버 66, 앱 55, 에뮬레이터 통합 40)

백엔드와 프런트 연동

구조

[토스 앱 속 미니앱 (React)]
   │ ① 토스 SDK: User.createAnonymousKeyAuthCode() → 인증 코드
   │ ② Firebase 호출형 함수(httpsCallable) authExchange(코드)
   ▼
[Cloud Functions] ──mTLS──▶ [앱인토스 서버 API: anonKey 교환]
   │ ③ uid = HMAC(비밀값, anonKey) → 커스텀 토큰 발급
   ▼
[미니앱] signInWithCustomToken → 이후 모든 호출에 로그인 토큰이 자동으로 붙음
   │
   ├─ 구독 API (httpsCallable) ──▶ Functions ──▶ Firestore
   └─ 템플릿·해지 가이드 ──────▶ Hosting의 catalog JSON (fetch)

[예약 함수] 매일 09:00 알림 발송 ──mTLS──▶ 앱인토스 기능성 메시지 API
  • Firestore 보안 규칙은 전부 거부로 두고, 앱은 데이터베이스를 직접 읽지 못하게 했어요. 모든 읽기·쓰기는 서버 함수를 거쳐요.

  • anonKey 원문은 저장하지 않고, 알림 발송에 필요한 값만 AES-256-GCM으로 암호화해 저장해요.

진행 방법

사용한 도구

도구

용도

Claude Code (데스크톱 앱)

기획서 읽기, 코딩, 테스트, 배포, 브라우저 확인, 콘솔 입력 문구까지

딥리서치

시장·사용자 문제·앱인토스 정책 조사

ChatGPT

앱 로고 캐릭터

일하는 방식

기획 문서를 폴더에 넣어 두고, Claude Code에게 "이 문서대로 만들되, 문서와 다르게 해야 하는 건 고치지 말고 끝에 목록으로 알려줘"라고 했어요.

  1. 단계마다 멈추고 보고받기. 한 단계가 끝나면 멈추고 한국어로 보고하게 했어요.

  2. 커밋은 내가 말할 때만. 중간 결과가 마음에 안 들면 되돌리기 쉬웠어요.

  3. 돈이 드는 일은 안전장치와 같이 설명받기. Blaze(종량제) 전환 전에 예산 알림·지출 한도·호출 제한을 겹쳐서 걸었어요.

  4. 모르는 건 추측하지 말라고 하기. 공식 문서로 확인 못 한 SDK 동작은 목록으로 남기고, 실기기 테스트 때 하나씩 확인했어요.

  5. 비밀값은 내가 직접 입력. 인증서·암호 키는 터미널에서 제가 넣고, Claude Code는 값을 보지 않게 했어요.

  6. 화면 캡처로 질문하기. 콘솔에서 막히면 캡처만 보내도 어디를 눌러야 하는지 알려줬어요.

타임라인 (2차 버전, 출시까지 약 28시간)

시각

단계

한 일

10/19 20:11

세팅

공식 도구로 프로젝트 생성, Firebase 뼈대, 공용 계산 모듈, 로컬 에뮬레이터

10/19 22:37

서버 연결

익명 식별 → 서버 로그인, 구독 저장 API

10/19 23:48

1단계

첫 사용 화면(인트로·구독 선택·금액 확인·첫 결과)

10/20 16:31

2단계

구독 상세·편집, 캘린더, 하단 탭

10/20 16:58

3단계

해지 가이드, 컷 완료·공유

10/20 17:48

4단계

설정, 문의, 모든 데이터 지우기, 이벤트 기록

10/20 18:12

5단계

템플릿 데이터를 Hosting으로

10/20 18:39

6단계

결제일 알림(템플릿 승인 전이라 에뮬레이터로 검증)

10/20 20:38

7단계

Blaze 전환, 비밀값 등록, 실제 배포

10/20 22:50

실기기 테스트

휴대폰에서 찾은 문제 수정, 달러 구독 추가

10/20 23:13

출시 준비

출시 가이드 대응(핀치 줌 막기, 식별값 암호화), 약관 마무리

10/20 23:40

콘솔

로고, 스크린샷, 앱 정보 입력 → 출시 검토 요청

10/21 00:31

출시

검토 승인 → 콘솔에서 [출시하기], 상태 '현재 출시됨' 🎉

결과와 배운 점

결과

항목

1차 '구독 다이어트'

2차 '새는구독'

화면

3개

인트로부터 설정까지 10여 개 + 하단 탭

데이터

기기 안

서버(Firestore), 기기를 바꿔도 유지

핵심 기능

합계·절약 계산

템플릿 등록, 캘린더, 해지 가이드, 컷 공유, 결제일 알림, 달러 환산

자동 테스트

99개

275개

실제 토스 앱

못 열어 봄

실기기 테스트 → 검토 승인 → 출시

시행착오

증상

원인

해결

배포하자 서버 함수 16개가 모두 실패

업로드 제외 목록의 src가 빌드 결과 폴더(lib/.../src)까지 빼 버림

src/**로 수정

배포는 됐는데 앱이 부르면 403

첫 배포 실패 때 '누구나 호출' 권한이 빠진 채 만들어짐

호출형 함수 13개에만 권한 추가(예약 함수는 비공개)

휴대폰 첫 로그인 실패 ①

서버 계정에 토큰 서명 권한(signBlob) 없음

서버 계정에 자기 자신으로만 서명하는 권한 부여

휴대폰 첫 로그인 실패 ②

배포 번들에 개발용 가짜 API 키가 들어감

실제 값으로 다시 빌드, 가짜 값이면 빌드가 멈추게 막음

로컬에서 템플릿 데이터가 안 불러와짐

Windows용 Hosting 에뮬레이터가 CORS 헤더를 적용하지 못함

개발 서버가 대신 받아 오게 우회(실제 배포는 정상)

달러↔원 전환하면 금액이 사라짐, 월/연 토글이 무반응

통화·주기 전환 시 금액 처리 누락

요금제 기준 통화를 기본값으로, 주기 전환 시 짝이 되는 요금제로 변경

영어 앱 이름 반려

SubLeak처럼 단어 중간 대문자 불가

Sub Leak

검토 요청한 번들이 최신이 아님

번들을 여러 번 올려서 헷갈림

deploymentId 비교 후 요청 취소, 최신 번들로 다시 요청

②번은 토스 앱의 웹 디버그 툴즈(미니앱 더보기 → 웹 디버그 툴즈) Network 탭 캡처 한 장으로 원인을 찾았어요.

배운 점과 꿀팁

  1. 1차 버전은 버려도 남는 게 있어요. 개발지시서 쓰는 법, 단계별 승인, "추측 금지" 규칙은 2차에서 그대로 썼어요.

  2. 고치기보다 다시 기획하는 게 빠를 때가 있어요. 저장 위치(기기 → 서버)처럼 뼈대가 바뀌면 새로 만드는 편이 깔끔했어요.

  3. 실기기 테스트는 일찍. 에뮬레이터에서 다 통과해도 권한·API 키 문제는 실제 배포에서만 드러났어요.

  4. 출시 가이드는 미리 읽기. 핀치 줌, 민감 정보 암호화, 진입 시 바텀시트 금지, 영어 이름 규칙 등은 처음부터 맞추는 게 편해요.

비용 안전장치

  • 예산 알림: 월 5,000원(50%·90%·100%에 메일)

  • Cloud Run Functions 지출 한도: 4,000원

  • 코드: 사용자당 분당 60회 호출 제한, 함수 동시 실행 상한, 오래된 기록 자동 삭제(TTL)

  • 빌드 이미지 1일 뒤 자동 삭제

앞으로의 계획

  • 결제일 알림 메시지 템플릿 승인 후 알림 켜기

  • 템플릿 요금 데이터 정리, 광고는 업데이트로 단계 도입

써 보기

토스 앱에서 열려요: https://tossminiapp.com/d/subleak/launch?referrer=appsintoss.common_module_share

도움 받은 글

  • 앱인토스 개발자센터: WebView SDK, 익명 식별키, 기능성 메시지, 출시 체크리스트

  • TDS Mobile 문서

  • Firebase 문서: Cloud Functions 2세대, 커스텀 토큰 인증

3

함께 이야기해요 3

로그인하고 댓글을 남겨 주세요

뽀짝이 프로필 이미지
뽀짝이2026.10.21

코딩님, 99개 테스트가 통과한 1차 버전을 "계산기로는 잘 돌아갔지만 다시 찾아올 이유와 실제로 끊게 만드는 장치가 없다"고 판단해 기획부터 다시 하신 결정이 인상 깊어요. 잘 돌아가는 코드를 버리는 건 쉽지 않았을 텐데, 결제일 알림과 해지 가이드라는 빈칸을 정확히 짚으셨네요.

딥리서치 뒤에 문서 5개를 먼저 만들고 기획서를 v0.2에서 v0.8까지 다듬은 과정, 그리고 이름이 겹쳐 구독컷을 새는구독으로 바꾸고 상표까지 확인한 꼼꼼함이 좋았어요. 프로젝트 시작부터 출시까지 약 28시간이라는 속도가 이 준비 덕분이라는 게 글에서 느껴집니다. 앱 출시 축하드려요! 기지개 한 번 펴고 저도 구독 정리하러 가볼게요 🐈‍⬛

은
은쌤T2026.10.22

계산기로는 잘 돌아갔지만 다시 찾아올 이유와 실제로 끊게 하는 장치가 없어서, 고치지 않고 기획부터 다시 하셨다는 결정에 눈이 갔어요. 테스트 99개짜리 1차를 내려놓는 게 쉬운 선택은 아니니까요.

문서와 다르게 해야 하는 건 고치지 말고 끝에 목록으로 알려 달라는 지시는 저도 빌려 쓰고 싶습니다.

백경_BK 프로필 이미지
백경_BK2026.10.22

너무 대단한 서비스를 만들어주신거 아닌가요?!
디테일하게 어떻게 하셨는지도 설명해주셔서 감사해요.

보면서 와.. 전문가다 라는 느낌이 들더라구요.
괜찮으시다면, 이번에 스터디 발표를 부탁드려도 될까요?
어떻게 하셨는지 다른 스터디원분들도 보시면 도움이 많이 되실 것 같아요!

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기