[앱인토스 1편] ChatGPT로 기획하고 Claude Code로 개발 준비까지 — 앱인토스 미니앱 착수 전 단계 정리
2026.10.02
![[앱인토스 1편] ChatGPT로 기획하고 Claude Code로 개발 준비까지 — 앱인토스 미니앱 착수 전 단계 정리 본문 이미지](/_next/image?url=https%3A%2F%2Fcdn-beta.gpters.org%2Fexternal%2F3155d3ace356269d40b3b354.jpg&w=3840&q=75)
## 소개
### 시도하고자 했던 것과 그 이유
토스 앱 안에서 돌아가는 앱인토스(Apps in Toss) 미니앱을 혼자 만들어 보고 있어요.
주제는 20~30대를 위한 습관 형성 앱이에요. 아직 출시 전이라 자세한 내용은 밝히기 어렵지만, 큰 방향은 이래요.
앱의 아이디어는 보안을 위해 개발 후에 공개합니다.
- 일상에서 자주 부딪히는 "작은 순간"에 짧게 개입해요
- 사용자가 그 순간을 잘 넘기면 바로 작은 보상을 줘요
- 그 결과가 캐릭터와 작은 세계의 성장으로 쌓여요
습관 앱을 써 보면 "매일 체크해야 하는 부담"과 "하루 빼먹으면 리셋되는 좌절감" 때문에 금방 그만두게 되더라고요.
그래서 기록보다 보상을 먼저 주고, 실패해도 벌점이 없는 구조를 만들어 보고 싶었어요.
앱인토스를 고른 이유는 두 가지예요.
- 토스 사용자에게 별도 설치 없이 바로 보여줄 수 있어요
- 웹(React) 기술로 만들 수 있어서 비개발자도 바이브코딩으로 도전해 볼 만해요
이번 글은 코드를 한 줄도 쓰기 전, "개발 준비"를 어디까지 해 두었는지에 대한 기록이에요.
---
## 진행 방법
### 사용한 도구
| 단계 | 도구 | 역할 |
|---|---|---|
| 아이디어·기획 | ChatGPT | 아이디어 구체화, 기획 문서 3종 작성 |
| 캐릭터 레퍼런스 | 이미지 생성 AI | 캐릭터 콘셉트 이미지 5종 |
| 개발 준비 | Claude Code (+ oh-my-claudecode) | 문서 통합, 충돌 정리, 공식 문서 검토, 준비 체크리스트 관리 |
| 플랫폼 연동 | apps-in-toss-console MCP | Claude Code에서 앱인토스 콘솔 작업(미니앱 생성·번들 업로드·검수 등) |
### 1단계. ChatGPT와 대화하며 기획 발전시키기
처음에는 한 줄짜리 아이디어였어요. ChatGPT와 계속 대화하면서 아래 순서로 키워 갔어요.
앱의 아이디어는 개발 후에 공개합니다.
1. "이런 순간에 쓰는 앱이 있으면 어떨까?" → 핵심 루프 정의
2. 핵심 원칙 정리 (예: 입력보다 선택, 한 화면 한 질문, 못 해도 벌점 없음, 보상 먼저, 기록은 나중)
3. 문서 3종으로 정리
- PRD — 제품 요구사항, 데이터 모델, 이벤트 설계
- UX/UI 와이어프레임 — 화면 약 20개
- 캐릭터 디자인 시스템 — 메인 캐릭터 + 서브 캐릭터들의 성격·색·포즈
### 2단계. Claude Code로 "개발 준비 노트" 만들기
기획 문서 3개를 프로젝트 폴더에 넣고 Claude Code에게 읽혔어요.
코드 작성은 금지하고, 개발 전에 문서를 통합하고 문제를 찾아 달라고 요청했어요.

결과물은 개발 준비 노트 v0.1.md 하나로, 아래 내용이 들어 있어요.
- 세 문서를 합친 통합 화면 맵 (문서마다 화면 번호가 달라서 하나로 맞췄어요)
- 문서 간 충돌 4건: 사람이 결정해야 하는 것
- 예: 성장 체계가 문서마다 세 가지로 다르게 정의돼 있었어요 (레벨 기준 vs 누적 횟수 기준)
- 예: 캐릭터 기본 의상이 레벨 보상 아이템과 겹쳤어요
- 오타·불일치 10여 건과 수정안
- 문서에 정의가 없는 항목 15건(G1~G15)과 기본값 제안
- 에셋 현황 점검 (용량, 배경 투명 여부, 파일명, 필요한 수량 대비 확보 수량)
충돌 항목은 Claude가 선택지를 제시하고 제가 하나씩 골라서 확정했어요.
### 3단계. 앱인토스 공식 문서와 대조하기
앱인토스는 공식 문서를 LLM용 색인(`llms.txt`)으로도 제공해요. Claude Code에게 이 문서를 읽고 기획과 다른 부분을 찾아 달라고 했어요.
여기서 기획을 꽤 많이 바꿔야 했어요 (아래 "시행착오"에서 자세히 정리했어요).
정리한 내용은 앱인토스 개발 가이드 정리 v0.1.md로 따로 저장했어요.
- SDK 버전, 설정 파일, 로컬 테스트 방법
- 검수 규칙 (상단 바, 뒤로가기, 진입 직후 바텀시트 금지 등)
- 필요한 API (저장소, 서버 시간, 공유, 햅틱, 분석 로그)
- 디자인 시스템(TDS) 컴포넌트 매핑
- 배포 절차
### 4단계. 콘솔 MCP 연결
앱인토스는 공식 Claude Code 하네스를 제공해요. 저는 `apps-in-toss-console` MCP 연결을 마친 상태예요.
덕분에 Claude Code 안에서 미니앱 생성, 번들 업로드, 검수 요청, 지표 조회 같은 콘솔 작업을 할 수 있어요.
```bash
# 공식 하네스 설치 (터미널에서 직접 실행)
claude plugin marketplace add toss/apps-in-toss-harness
claude plugin install ait@apps-in-toss -y
# 이후 Claude Code 대화창에서 /mcp → apps-in-toss-console 로그인
```
다만 미니앱 생성처럼 되돌릴 수 없는 외부 작업은 실행 전에 반드시 제 확인을 받도록 규칙으로 정해 두었어요.
### 5단계. CLAUDE.md로 "세션이 바뀌어도 이어지는" 준비 상태 만들기
준비 작업이 여러 세션에 걸쳐 진행되다 보니, 새 세션마다 상황을 다시 설명하는 게 번거로웠어요.
그래서 프로젝트 루트의 CLAUDE.md에 확정된 결정, 다음 할 일 체크리스트, 지켜야 할 플랫폼 규칙을 모아 두었어요.
## 새 세션 시작 시 할 일
세션이 시작되면 사용자에게 먼저 "다음 작업(개발 전 준비)" 진행 상황을
한국어로 짧게 알려주고, 어떤 항목부터 할지 확인한다.
개발(코드 작성)은 사용자가 시작하라고 할 때만 한다.
## 기준 문서 (프로젝트 루트)
| 파일 | 내용 |
|---|---|
| PRD v1.0.md | 제품 요구사항, 데이터 모델, 이벤트 |
| UX_UI Wireframe v1.0.md | 화면 설계 |
| Character Design System v1.0.md | 캐릭터 |
| 개발 준비 노트 v0.1.md | 세 문서 통합본 + 충돌·누락 정리 + 확정 사항 — 가장 먼저 읽을 것 |
| 앱인토스 개발 가이드 정리 v0.1.md | 공식 문서·TDS 정리 |
## 확정된 결정
1. (게임 규칙 관련 결정) ...
2. 개발 순서: 로컬 저장 기반 Core Loop 프로토타입 먼저 → 이후 서버 연결
3. 사용자 식별: 토스 로그인 없이 User.getAnonymousKey()
4. 문구: 캐릭터 대사 포함 모든 문구 해요체
5. UI: TDS(@toss/tds-mobile 2.5.x) + React 18 (TDS는 React 19 미지원)
6. 캐릭터: Soft 2D 벡터로 재제작
...
## 다음 작업 (개발 전 준비)
- [ ] 1. 2D 캐릭터 에셋 제작 프롬프트 작성
- [ ] 2. 공식 Claude Code 플러그인 설치
- [ ] 3. 앱 이름·appName 결정 (등록 후 변경 불가)
- [ ] 4. 콘솔에 미니앱 등록 (실행 전 사용자 확인 필수)
- [ ] 5. 에셋 최적화
- [ ] 6. 콘솔 등록 자산 준비 (로고, 스크린샷, 약관 등)
- [ ] 7. 개발 착수 (사용자 지시 후)
## 개발 시 꼭 지킬 앱인토스 규칙 (요약)
- CSR만, eval·iframe 금지, HTTPS·wss만, 라이트 모드만
- 상단 바는 SDK가 자동 제공 → 직접 그리지 않음
- 진입 직후 바텀시트 금지, 첫 화면 뒤로가기 = 종료
- 로컬 저장은 네이티브 Storage API, 날짜 판정은 Environment.getServerTime()
- 공유는 텍스트·링크만, 이미지는 File.saveBase64로 저장
...
```
### 실제로 사용한 프롬프트
① 새 세션 시작
```
'/Users/jaeyoung/Vibe Coding/TossApp_01/CLAUDE.md' 읽고 준비해줘.
```
→ Claude가 기준 문서를 읽고, 체크리스트 항목별 진행 상태(완료 / 일부 완료 / 대기)를 표로 보고한 뒤 어떤 작업부터 할지 물어봤어요.
② 착수 가능 여부 점검
```
우선 궁금한건 프로젝트 개발에 착수하기 위해 필요한 모든 준비가 완료된거야?
```
→ "전부 끝나진 않았지만, 로컬 프로토타입은 지금 바로 시작할 수 있다"는 답을 받았어요. 남은 일은 세 묶음으로 나눠서 정리해 줬어요.
- 개발을 막지 않는 것: 2D 에셋(임시 이미지로 대체 가능), 플러그인, 미결 수치
- 시작 전에 정하면 좋은 것: appName(등록 후 변경 불가), git 저장소 초기화, Node 버전 호환성
- 출시 전에만 필요한 것: 콘솔 등록, 로고·스크린샷, 약관·개인정보처리방침
---
## 결과와 배운 점
### 현재 상태
| 항목 | 상태 |
|---|---|
| 기획 문서 3종 (PRD·와이어프레임·캐릭터) | ✅ 완료 |
| 문서 통합 + 충돌 해결 (개발 준비 노트) | ✅ 완료 |
| 핵심 결정 8개 확정 | ✅ 완료 |
| 앱인토스 공식 문서 검토·정리 | ✅ 완료 |
| 콘솔 MCP 연결 | ✅ 완료 |
| 2D 캐릭터 에셋 | ⬜ 제작 예정 |
| appName 확정 · 콘솔 등록 | ⬜ 예정 |
| 출시용 자료 (로고·스크린샷·약관) | ⬜ 예정 |
| 개발 착수 | ⏸ 대기 |
### 배운 점과 나만의 꿀팁
1. 기획은 ChatGPT, 정리와 검증은 Claude Code로 나눴더니 좋았어요.
대화로 아이디어를 키우는 데는 ChatGPT가 편했어요. 반면 여러 문서를 동시에 읽고 서로 어긋나는 곳을 찾는 일은 파일을 직접 읽는 Claude Code가 훨씬 정확했어요.
2. AI가 만든 기획 문서도 서로 꼭 어긋나요.
같은 대화에서 나온 문서 3개인데도 화면 번호, 보상 수치, 성장 기준이 다 달랐어요. 개발 전에 "통합본 + 충돌 목록"을 한 번 만들어 두는 것을 강력히 추천해요.
3. 플랫폼 공식 문서를 기획 단계에서 먼저 확인해야 해요.
앱인토스는 llms.txt를 제공해서 Claude에게 통째로 읽히기 좋았어요. 이걸 개발 중에 발견했다면 화면과 에셋을 다시 만들어야 했을 거예요.
4. CLAUDE.md는 "세션 인수인계서"예요.
"새 세션이 시작되면 먼저 진행 상황을 보고하고, 코드는 내가 시키기 전엔 쓰지 마"라고 적어 두었어요. 덕분에 세션이 바뀌어도 한 줄 프롬프트로 바로 이어갈 수 있었어요.
5. 되돌릴 수 없는 작업에는 확인 규칙을 걸어 두세요.
앱인토스의 appName은 등록 후 바꿀 수 없어요. MCP로 콘솔을 조작할 수 있는 만큼 "실행 전 사용자 확인 필수"를 문서에 명시해 두었어요.
### 시행착오
공식 문서를 읽고 나서야 기획을 바꾼 부분이 많았어요.
| 처음 기획 | 공식 문서 기준 | 바꾼 방향 |
|---|---|---|
| 3D 클레이 느낌 캐릭터 | 3D 그래픽은 토스가 제공하는 리소스만 사용 가능 | 2D 벡터로 다시 제작 (자체 캐릭터 IP도 지킬 수 있어요) |
| 캐릭터가 반말로 말하기 | 모든 문구는 해요체 | 짧고 친근한 해요체로 변경 |
| 토스 로그인부터 개발 | 비게임 앱은 익명 키로 로그인 없이 사용자 식별 가능 | 익명 키 사용, 로그인 단계 제거 |
| 결과 이미지를 공유 | 공유 API는 텍스트·링크만 지원 | "이미지는 기기에 저장 + 링크 공유" 두 단계로 변경 |
| 화면 상단에 직접 만든 설정 버튼 | 상단 바는 SDK가 자동 제공 | 내비바 액세서리 버튼으로 이동 |
| 최신 React 19 사용 | 디자인 시스템(TDS)이 React 19 미지원 | React 18로 결정 |
| 습관 독려 푸시 | 기능성 푸시에 리텐션·유도 문구 금지 | MVP에서 제외 |
이미지 생성 AI로 만든 레퍼런스 이미지에서도 문제가 나왔어요. 한 장에 실제 서비스 로고와 텍스트가 그려져 있었어요. 그대로 썼다면 상표 문제와 검수 문제가 생길 수 있었어요.
그래서 2D로 다시 만들 때는 "대사 금지, 실제 브랜드 로고 금지, 투명 배경"을 프롬프트 조건으로 넣기로 했어요.
### 도움이 필요한 부분
- 2D 캐릭터를 여러 포즈·표정으로 일관되게 뽑는 방법이 궁금해요. 같은 캐릭터를 20~30장 만들어야 하는데, 생성할 때마다 얼굴이 달라지는 문제를 어떻게 해결하시는지 알고 싶어요.
- 앱인토스 검수를 통과해 보신 분의 경험담도 듣고 싶어요. 특히 반려된 사례가 궁금해요.
### 앞으로의 계획
1. 2D 캐릭터 에셋 제작 프롬프트 작성 → 에셋 제작
2. 앱 이름·appName 확정 → 콘솔 MCP로 미니앱 등록
3. 로컬 저장 기반 핵심 루프 프로토타입 개발 → 직접 써 보며 "재미있는지" 검증
(재미가 없으면 출시하지 않는다는 원칙을 세워 두었어요)
4. 재미가 검증되면 서버 연결, 기록·통계 화면 추가
5. 출시 자료 준비 → 검수 → 출시
다음 글에서는 실제 개발 과정을 공유할게요!
## 도움 받은 글 (옵션)
- 앱인토스 개발자 문서 (LLM용 색인): https://developers-apps-in-toss.toss.im/llms.txt
- 토스 디자인 시스템(TDS Mobile) 문서: https://tossmini-docs.toss.im/tds-mobile/llms.txt
- 앱인토스 공식 Claude Code 하네스: https://github.com/toss/apps-in-toss-harness
로그인하고 댓글을 남겨 주세요
Develiper님, 코드를 한 줄도 쓰기 전에 "개발 준비"를 어디까지 해 두었는지를 기록하신 점이 인상적이에요. 특히 기획 문서 3종을 Claude Code에게 읽히고 충돌 4건, 정의 없는 항목 15건(G1~G15)을 찾아 선택지로 하나씩 확정하셨다는 과정이 구체적이라 따라 해 보기 좋아요.
성장 체계가 문서마다 세 가지로 다르게 정의돼 있었다는 예시가 생생했고, 공식 문서(llms.txt)와 대조하면서 기획을 꽤 바꿔야 했다는 시행착오도 도움이 됐어요. 미니앱 생성처럼 되돌릴 수 없는 작업은 실행 전에 확인을 받도록 규칙으로 정해 두신 것, 세션이 바뀌어도 이어지도록 CLAUDE.md에 확정 결정과 다음 할 일을 모아 두신 것도 실전 노하우네요.
"기록보다 보상을 먼저, 실패해도 벌점 없는 구조"라는 방향도 궁금해져요. 2편에서 개발 착수 후기도 기다릴게요. 고롱고롱… 기분 좋게 읽고 갑니다 ✨
20-30대를 겨냥한 습관형성 앱이라니 너무 좋아요!
어떤 캐릭터를 만들어 가실지도 너무 궁금하네요 ㅎㅎ
2D 캐릭터를 일관되게 뽑는 과정은 제 경험을 정리해서 공유드려 볼게요!! 앱인토스 검수 반려 사례도 정리하려면.. 좀 걸릴것 같아서 전체적인 플로우라도 보여드릴 수 있게 준비해볼게요!
다음 사례들도 기대하고 있겠습니다!




공식 문서 읽고 처음 기획을 어떻게 바꿨는지 정리한 표는 그대로 체크리스트로 써도 되겠어요.
저도 앱인토스 딥리서치하면서 비슷한 규칙들을 정리했는데, 기획 단계에서 표로 대조해 두신 게 훨씬 실용적이네요.
습관 앱인데 재미가 없으면 출시하지 않는다는 원칙을 세우신 게 인상적입니다.