학습목표
- 토큰·비용을 아끼면서 클로드를 오래, 효율적으로 쓰는 전략을 익힌다.
- 앱인토스(토스 미니앱) 플랫폼의 개발부터 배포까지 전체 흐름을 경험한다.
- 실제 오픈 심사 정책을 이해하고 통과 가능한 미니앱을 기획할 수 있다.
오늘은 두 가지를 다룬다. 하나는 클로드를 더 오래, 더 적은 비용으로 쓰기 위한 효율화 전략이고, 다른 하나는 토스 생태계 안에서 동작하는 미니앱(앱인토스)을 직접 만들어보는 실습이다.
1. 토큰 절약 전략
1-1. 모델 선택
작업 난이도에 맞는 모델을 고르는 것이 가장 큰 절약 포인트다.
| 작업 유형 | 권장 모델/설정 |
|---|---|
| 간단한 질의응답, 포맷 변환 | 가벼운 모델 |
| 일반적인 코딩·문서 작업 | 표준 모델 |
| 복잡한 설계·디버깅 | 고성능 모델(필요할 때만) |
1-2. 주요 명령어
| 명령어 | 기능 |
|---|---|
/model |
현재 세션에서 쓸 모델을 전환 |
/effort |
응답에 들이는 추론 노력(속도 vs 정확도)을 조절 |
| 플랜모드 | 실제 작업 전에 계획만 먼저 세워 불필요한 시행착오를 줄임 |
/context |
현재 대화가 차지하는 컨텍스트 사용량을 확인 |
/clear |
대화 맥락을 완전히 초기화 |
/compact |
지금까지의 대화를 요약해 컨텍스트를 압축 |
/btw |
본 작업 흐름을 끊지 않고 곁가지 질문을 처리 |
/rewind |
이전 시점으로 되돌아가 다시 시도 |
/mcp disable |
당장 쓰지 않는 MCP 커넥터를 비활성화해 컨텍스트 낭비 방지 |
실습 팁 긴 세션일수록
/context로 사용량을 주기적으로 확인하고, 필요 없는 MCP는 꺼두고, 대화가 늘어지면/compact로 정리하는 습관을 들이면 훨씬 오래, 안정적으로 작업할 수 있다.
그림으로 정리대화가 길어졌다면, 먼저 상태부터 확인
/context현재 맥락 사용량 확인
맥락을 이어갈 때
/compact이전 대화를 요약·압축
새로 시작할 때
/clear기존 대화 맥락 초기화
1-3. 실습
지금까지 진행한 대화 중 하나를 골라 /context로 사용량을 확인해보고, /compact를 실행한 뒤 응답 품질이 유지되는지 비교해본다.
2. 앱인토스(토스 미니앱) 개발 실무
2-1. 앱인토스란
토스 앱 안에서 별도 설치 없이 실행되는 미니앱 플랫폼이다. 토스의 방대한 사용자 기반 안에서 바로 서비스를 노출할 수 있다는 것이 가장 큰 장점이다.
2-2. 개발 환경 준비
- MCP 연결: 클로드 설정에서 앱인토스 관련 MCP 커넥터를 연결해 개발 가이드·API 문서를 대화 중에 바로 참조
- 프로젝트 생성:
npx create-ait-app명령으로 미니앱 기본 템플릿 생성 - 설정 파일:
granite.config.ts에서 앱 이름, 아이콘, 권한 등 미니앱 메타 정보를 설정
2-3. 개발 흐름
npx create-ait-app으로 프로젝트 생성granite.config.ts설정(앱 이름, 아이콘, 시작 화면 등)- 로컬에서 개발 서버 실행 후 기능 구현
- QR 테스트: 빌드 후 발급되는 QR코드를 토스 앱으로 스캔해 실기기에서 바로 테스트
- 검토 요청: 완성 후 토스에 정식 심사(검토) 요청 제출
그림으로 정리토스 미니앱의 개발부터 검토 요청까지
- 01프로젝트 생성create-ait-app
- 02앱 설정이름·아이콘·권한
- 03기능 구현핵심 기능부터
- 04QR 테스트토스 앱에서 확인
- 05검토 요청오픈 정책 점검 후
2-4. 오픈 정책 체크리스트
- 앱 이름·아이콘이 가이드라인을 준수하는지
- 불필요한 권한을 요청하지 않는지
- 개인정보 처리 관련 안내가 포함되어 있는지
- 실제 동작하지 않는 더미 화면이 없는지
- 토스 브랜드/UI를 오인하게 하는 요소가 없는지
2-5. 트러블슈팅
- QR 테스트에서 화면이 안 뜰 때:
granite.config.ts설정값과 실제 빌드 결과물 경로가 일치하는지 먼저 확인한다. - 심사 반려: 실제 반려 메시지와 최신 오픈 정책을 대조해 수정한다. 개인·계정 정보는 제거한 뒤 AI에 해결 방법을 물어본다.
2-6. 실전 사례 3선
- 날씨 기반 추천 미니앱: 현재 위치의 날씨에 맞춰 활동을 추천
- 간단 가계부 미니앱: 지출을 빠르게 기록하고 카테고리별로 요약
- 동네 맛집 큐레이션 미니앱: 사용자 리뷰 기반으로 맛집을 추천
각 사례는 "핵심 기능 1~2개만 확실하게"라는 공통점이 있다. 처음부터 기능을 욕심내기보다, QR 테스트로 빠르게 확인 가능한 최소 기능부터 완성하는 것이 기능 누락과 사용성 문제를 찾는 데 도움이 된다. 승인 여부는 플랫폼 심사에 따른다.
오늘 실습
- 지금까지의 대화 세션에서 토큰 절약 명령어(
/context,/compact등)를 직접 사용해보기 npx create-ait-app으로 미니앱 프로젝트 생성- 간단한 기능 하나를 구현하고 QR 테스트로 실기기 확인
- 오픈 정책 체크리스트로 자체 점검
오늘의 실습 산출물
- 토큰 절약 체크리스트
- 앱인토스 미니앱 초안(QR 테스트 완료)
관련 노트
실습 검증과 문제 해결
미니앱의 핵심 경로 확인
- 직접 해볼 일: 실제 기기에서 시작 화면→입력→결과→뒤로 가기를 한 번씩 수행한다.
- 예상 결과와 판정 기준: 중복 탭이나 빈 입력에도 화면이 멈추지 않고, 오류가 나면 재시도 또는 돌아가기 방법을 보여야 한다.
- 오류를 좁히는 방법: 개발 PC에서 되는 기능도 기기의 권한·네트워크에 따라 실패한다. 지원 SDK와 현재 심사 가이드를 확인하고 승인 결과를 미리 단정하지 않는다.
이 항목은 교육용 검증 시나리오이며 실제 실행 성공·수익·플랫폼 승인을 보고하는 사례가 아니다. 결과 화면과 수정 내용을 기록하면 다음 실습에서 같은 오류를 줄일 수 있다.
자료 업데이트 안내
2026-10-12 주요 설명 보완. 설치 명령·계정별 기능·요금과 심사 규정은 실행 시점의 공식 문서를 다시 확인한다.
- 앱인토스 개발 문서
- 강의 내용 문의 및 오류 신고: 라인블록