본문으로 건너뛰기

클로드 코드로 토스 미니앱 만들기: 콘솔 등록까지 걸린 일

서인

2026.10.22

클로드 코드로 토스 미니앱 만들기: 콘솔 등록까지 걸린 일 본문 이미지

클로드 코드(Claude Code)로 만들던 직장 매너 앱 "월급쟁이 처음이지"를 2026년 10월 22일 하루 동안 토스 미니앱으로 빌드해 검토 요청까지 마쳤어요.

번들은 1.1MB였고, 검토 요청 직전에 세 번 막혔습니다. 앱인토스(Apps in Toss) 콘솔에 처음 앱을 올려 보는 분께 그 세 곳을 먼저 보여 드리려고 정리했습니다.

## 완성 안 됐어도 올려 보기로 했어요

평범한 회사원으로 일하는 지피터스 24기 토스미니앱 멤버 서인입니다. 회사에서 부하 직원에게 제 말 때문에 상처를 받았다는 이야기를 들은 적이 있습니다. 그 뒤로 직장 매너가 필요할 때 꺼내 보고, 선배와 후배 사이 생각의 차이를 줄여 주는 소통 앱을 만들고 있었습니다.

앱은 세 가지로 되어 있습니다. 해도 되는 행동인지 확인하는 매너 사전, 말 꺼내기 어려울 때 쓰는 문장 모음, 마음이 상했을 때 정리해 보는 화면입니다. 브라우저에서 보는 목업은 있었지만 토스에 올려 본 적은 없었습니다. 오늘 아침 클로드 코드에 이렇게 보냈습니다.

> 완성이 됐던 안됐던 그냥 앱 출시 해보는걸로 할래 도와줘 어떻게 하면돼?

## 클로드 코드로 앱인토스 번들 만들기

앱인토스에는 웹 주소가 아니라 SDK로 빌드한 .ait 파일을 올립니다. 그래서 목업 화면을 토스용 번들로 바꾸는 일부터 했습니다.

클로드 코드는 앱인토스 공식 문서(미니앱 등록하기, 비게임 출시 체크리스트, 웹뷰 튜토리얼)를 먼저 열어 순서를 확인했습니다. 그다음 저장소에 toss 폴더를 만들고, 목업 화면을 복사한 뒤 토스 기능을 붙여 .ait를 만드는 빌드를 짰습니다. SDK는 @apps-in-toss/web-framework 3.8.1입니다. 토스 상단 바의 뒤로 가기와 홈 버튼, 문장 복사, 기기 저장, 화면 가장자리 여백을 토스 방식으로 연결했습니다.

첫 출시에서는 광고, 공유, 음악, AI를 뺐습니다. 수노(Suno)로 만든 음악을 깔고 싶어서 "음원파일을 넣는게 좋을까? 너무 무거워 지진 않을까?"라고 물었습니다. 용량은 문제가 아니지만 아직 곡이 없어 출시가 늦어진다는 답을 듣고 "알겠어 넣지 말자"로 정리했습니다. 강아지 그림 여섯 장은 1254px 원본을 480px로 줄여 한 장에 170KB쯤으로 만들었고, 최종 번들은 1.1MB가 됐습니다.

## 앱인토스 콘솔 입력값 정리

콘솔에서 앱을 만들려고 하니 칸이 많았습니다.

> 입력할게 뭐 많은거 같은데... 뭔지 모르겠어

그래서 칸마다 넣을 값을 문서 하나에 표로 받아 그대로 옮겼습니다. 직접 해 보며 알게 된 것은 이렇습니다.

- 앱 이름은 10자 제한입니다. "월급쟁이 처음이지"는 콘솔에서 8/10으로 셌습니다. 띄어쓰기는 세지 않았습니다.

- appName(`nunchibap`)은 한 번 정하면 못 바꿉니다. 빌드 설정 파일의 값과 같아야 업로드됩니다.

- 카테고리는 생활 > 일상 > 자기계발로 골랐습니다.

- 번들을 올린 뒤 토스 앱에서 한 번 이상 테스트해야 검토 요청 버튼이 열려요([미니앱 등록하기](https://developers-apps-in-toss.toss.im/guide/operation/console-workspace.md), 2026년 10월 22일 기준).

▲ 앱인토스 콘솔에 올린 월급쟁이 처음이지 번들, SDK 3.8.1

등록 준비를 하는 사이에 앱도 조금 손봤습니다. 사전에 없는 상황을 적으면 질문 세 개로 판단해 주는 화면이 있는데, 결과가 다섯 문장뿐이라 어떤 상황을 넣어도 비슷하게 나왔습니다. 적은 말에서 회식, 연차, 메신저 같은 분류를 찾아 결과를 70가지로 나눴습니다. 판정 라벨은 "괜찮아요(초록) / 조심해요(노랑) / 바꿔 보세요(빨강)"로 정하고 앞에 신호등 색 점을 붙였습니다.

## "문제"라는 말이 게임으로 읽혔어요

첫 번째로 막힌 곳은 단어였습니다. 토스 앱에서 테스트하다가 이렇게 전했습니다.

> 테스트 해보는데 문제라는 말을 쓰면 안돼 게임으로 분류 된다고 했어

앱에 "오늘의 매너 퀴즈", "문제 1/3", "연속 N일" 같은 말이 있었습니다. 직장 매너 앱인데 이런 말 때문에 퀴즈 게임처럼 읽힌 것입니다. 화면에서 "문제"는 "상황"으로, "오늘의 매너 퀴즈"는 "오늘의 매너 체크"로, "연속 N일"은 "N일째 확인"으로 바꿨습니다. 내용 속 "문제"가 들어간 문장 여섯 곳도 다시 썼고, 검토자용 출시 노트에서도 퀴즈, 문제, 점수, 연속을 뺐습니다.

▲ 문제 대신 상황 1/3으로 바꾼 오늘의 매너 체크 화면

비게임 앱이면 이 네 단어는 처음부터 안 쓰는 게 낫습니다. 저는 테스트하다 알게 돼서 번들을 한 번 더 만들어 올렸습니다.

## 앱인토스 주요 기능 검사에서 막혔어요

검토 요청을 누르자 콘솔이 이렇게 막았습니다.

> 주요 기능 검사에 실패했어요. 검토 요청을 다시 눌러주세요.

다시 눌러 봤지만 "마찬가지야"였습니다. 처음에는 앱을 열면 소개 화면이 먼저 나와서 검사가 홈의 기능을 못 찾는다고 보고, 토스 안에서는 홈부터 열리게 번들을 고쳤습니다. 그래도 같은 문구가 떴습니다.

원인은 이름 규칙이었습니다. 공식 문서 [주요 기능 등록하기](https://developers-apps-in-toss.toss.im/guide/operation/function.md)에 한국어 기능 이름은 10자 이내의 '~하기'나 명사형으로 쓰라고 되어 있습니다(2026년 10월 22일 기준). 제가 넣은 "이럴 때 뭐라고 하지", "속상한 일이 있었나요"는 질문 문장이었습니다.

영어 이름에서 한 번 더 막혔습니다. 문서에는 "첫 글자만 대문자"라고 되어 있어서 "Check manners"로 고쳤더니, 콘솔은 반대로 막았습니다.

> 각 단어의 첫 글자는 대문자 또는 숫자여야 해요.

▲ 앱인토스 콘솔 주요 기능 검사 실패와 영어 이름 대문자 오류

중간에 "Find what to say"를 권받았을 때는 제가 "글자수가 긴거 아닌가?"라고 되물어서 짧은 이름으로 바꿨습니다. 문서와 콘솔이 다를 때는 콘솔을 따랐고, 최종 이름은 이렇습니다.

- 직장 매너 확인하기 / Check Manners

- 할 말 찾아보기 / Find Words

- 속상한 일 정리하기 / Sort Feelings

이 이름으로 바꾸고 나서야 검토 요청이 들어갔습니다.

## 결과와 아직 안 된 것

결과물은 검토 요청까지 마친 앱 "월급쟁이 처음이지"와 1.1MB짜리 .ait 번들입니다. 브라우저 미리보기는 [jamkkan-t.vercel.app](https://jamkkan-t.vercel.app)에서 누구나 열 수 있습니다. 홈에서는 강아지가 오늘의 직장 매너 카드를 건네고, 그 아래로 내 소통 습관과 세 기능이 이어집니다.

▲ 강아지가 오늘의 직장 매너 카드를 건네는 홈 화면

작업에는 클로드 코드와 클로드 오푸스 5.5(Claude Opus 5.5)를 썼습니다. 토스에 앱을 올려 보는 건 처음이라 전과 비교할 시간은 없습니다. 오늘 오전 11시쯤 시작해서, 쉬는 시간을 빼고 220분 넘게 걸렸습니다.

아직 안 된 것도 있습니다.

- 검토는 영업일 기준 3일에서 7일이 걸려서, 결과는 아직 모릅니다.

- 토스 안에서는 소개 화면 대신 홈부터 열리고, 강아지가 걷는 움직임도 꺼 둔 상태입니다.

- 강아지가 자라는 성장 그림과, 내 선배와 후배의 말 습관을 저장해 두는 기능은 검토를 통과한 뒤 붙일 계획입니다.

함께 이야기해요 0

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

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

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

이런 사례도 있어요

사례 전체 보기