---
title: 8일차 강의노트
tags:
  - 강의자료
  - AI에이전트크리에이터
  - 토큰절약
  - 앱인토스
  - 미니앱
created: 2026-10-08
---

# 8일차 강의노트
## AI 활용 효율화 & 토스 미니앱 개발 실무

### 학습목표
- 토큰·비용을 아끼면서 클로드를 오래, 효율적으로 쓰는 전략을 익힌다.
- 앱인토스(토스 미니앱) 플랫폼의 개발부터 배포까지 전체 흐름을 경험한다.
- 실제 오픈 심사 정책을 이해하고 통과 가능한 미니앱을 기획할 수 있다.

오늘은 두 가지를 다룬다. 하나는 클로드를 더 오래, 더 적은 비용으로 쓰기 위한 효율화 전략이고, 다른 하나는 토스 생태계 안에서 동작하는 미니앱(앱인토스)을 직접 만들어보는 실습이다.

## 1. 토큰 절약 전략

### 1-1. 모델 선택
작업 난이도에 맞는 모델을 고르는 것이 가장 큰 절약 포인트다.

| 작업 유형 | 권장 모델/설정 |
|---|---|
| 간단한 질의응답, 포맷 변환 | 가벼운 모델 |
| 일반적인 코딩·문서 작업 | 표준 모델 |
| 복잡한 설계·디버깅 | 고성능 모델(필요할 때만) |

### 1-2. 주요 명령어

| 명령어 | 기능 |
|---|---|
| `/model` | 현재 세션에서 쓸 모델을 전환 |
| `/effort` | 응답에 들이는 추론 노력(속도 vs 정확도)을 조절 |
| 플랜모드 | 실제 작업 전에 계획만 먼저 세워 불필요한 시행착오를 줄임 |
| `/context` | 현재 대화가 차지하는 컨텍스트 사용량을 확인 |
| `/clear` | 대화 맥락을 완전히 초기화 |
| `/compact` | 지금까지의 대화를 요약해 컨텍스트를 압축 |
| `/btw` | 본 작업 흐름을 끊지 않고 곁가지 질문을 처리 |
| `/rewind` | 이전 시점으로 되돌아가 다시 시도 |
| `/mcp disable` | 당장 쓰지 않는 MCP 커넥터를 비활성화해 컨텍스트 낭비 방지 |

> [!tip]
> 긴 세션일수록 `/context`로 사용량을 주기적으로 확인하고, 필요 없는 MCP는 꺼두고, 대화가 늘어지면 `/compact`로 정리하는 습관을 들이면 훨씬 오래, 안정적으로 작업할 수 있다.

<!-- lecture-diagram:start day-8-1 -->
**그림으로 정리 · 대화가 길어졌다면, 먼저 상태부터 확인**

![대화가 길어졌다면, 먼저 상태부터 확인](assets/diagrams/day-08-1.svg)

안 쓰는 MCP는 비활성화하고, 작업 난이도에 맞게 모델과 추론 강도를 조절합니다.
<!-- lecture-diagram:end -->

### 1-3. 실습
지금까지 진행한 대화 중 하나를 골라 `/context`로 사용량을 확인해보고, `/compact`를 실행한 뒤 응답 품질이 유지되는지 비교해본다.

## 2. 앱인토스(토스 미니앱) 개발 실무

### 2-1. 앱인토스란
토스 앱 안에서 별도 설치 없이 실행되는 미니앱 플랫폼이다. 토스의 방대한 사용자 기반 안에서 바로 서비스를 노출할 수 있다는 것이 가장 큰 장점이다.

### 2-2. 개발 환경 준비
- **MCP 연결**: 클로드 설정에서 앱인토스 관련 MCP 커넥터를 연결해 개발 가이드·API 문서를 대화 중에 바로 참조
- **프로젝트 생성**: `npx create-ait-app` 명령으로 미니앱 기본 템플릿 생성
- **설정 파일**: `granite.config.ts`에서 앱 이름, 아이콘, 권한 등 미니앱 메타 정보를 설정

### 2-3. 개발 흐름
1. `npx create-ait-app`으로 프로젝트 생성
2. `granite.config.ts` 설정(앱 이름, 아이콘, 시작 화면 등)
3. 로컬에서 개발 서버 실행 후 기능 구현
4. **QR 테스트**: 빌드 후 발급되는 QR코드를 토스 앱으로 스캔해 실기기에서 바로 테스트
5. **검토 요청**: 완성 후 토스에 정식 심사(검토) 요청 제출

<!-- lecture-diagram:start day-8-2 -->
**그림으로 정리 · 토스 미니앱의 개발부터 검토 요청까지**

![토스 미니앱의 개발부터 검토 요청까지](assets/diagrams/day-08-2.svg)

실기기에서 확인한 최소 기능을 완성한 뒤 심사를 요청합니다. 반려 시 사유를 확인해 수정합니다.
<!-- lecture-diagram:end -->

### 2-4. 오픈 정책 체크리스트
- 앱 이름·아이콘이 가이드라인을 준수하는지
- 불필요한 권한을 요청하지 않는지
- 개인정보 처리 관련 안내가 포함되어 있는지
- 실제 동작하지 않는 더미 화면이 없는지
- 토스 브랜드/UI를 오인하게 하는 요소가 없는지

### 2-5. 트러블슈팅
- **QR 테스트에서 화면이 안 뜰 때**: `granite.config.ts` 설정값과 실제 빌드 결과물 경로가 일치하는지 먼저 확인한다.
- **심사 반려**: 실제 반려 메시지와 최신 오픈 정책을 대조해 수정한다. 개인·계정 정보는 제거한 뒤 AI에 해결 방법을 물어본다.

### 2-6. 실전 사례 3선
1. **날씨 기반 추천 미니앱**: 현재 위치의 날씨에 맞춰 활동을 추천
2. **간단 가계부 미니앱**: 지출을 빠르게 기록하고 카테고리별로 요약
3. **동네 맛집 큐레이션 미니앱**: 사용자 리뷰 기반으로 맛집을 추천

각 사례는 "핵심 기능 1~2개만 확실하게"라는 공통점이 있다. 처음부터 기능을 욕심내기보다, QR 테스트로 빠르게 확인 가능한 최소 기능부터 완성하는 것이 기능 누락과 사용성 문제를 찾는 데 도움이 된다. 승인 여부는 플랫폼 심사에 따른다.

## 오늘 실습
1. 지금까지의 대화 세션에서 토큰 절약 명령어(`/context`, `/compact` 등)를 직접 사용해보기
2. `npx create-ait-app`으로 미니앱 프로젝트 생성
3. 간단한 기능 하나를 구현하고 QR 테스트로 실기기 확인
4. 오픈 정책 체크리스트로 자체 점검

## 오늘의 실습 산출물
- 토큰 절약 체크리스트
- 앱인토스 미니앱 초안(QR 테스트 완료)

## 관련 노트
- [[7일차_강의노트]]
- [[9일차_강의노트]]


## 실습 검증과 문제 해결

### 미니앱의 핵심 경로 확인

- **직접 해볼 일**: 실제 기기에서 시작 화면→입력→결과→뒤로 가기를 한 번씩 수행한다.
- **예상 결과와 판정 기준**: 중복 탭이나 빈 입력에도 화면이 멈추지 않고, 오류가 나면 재시도 또는 돌아가기 방법을 보여야 한다.
- **오류를 좁히는 방법**: 개발 PC에서 되는 기능도 기기의 권한·네트워크에 따라 실패한다. 지원 SDK와 현재 심사 가이드를 확인하고 승인 결과를 미리 단정하지 않는다.

이 항목은 교육용 검증 시나리오이며 실제 실행 성공·수익·플랫폼 승인을 보고하는 사례가 아니다. 결과 화면과 수정 내용을 기록하면 다음 실습에서 같은 오류를 줄일 수 있다.

## 자료 업데이트 안내

2026-10-12 주요 설명 보완. 설치 명령·계정별 기능·요금과 심사 규정은 실행 시점의 공식 문서를 다시 확인한다.

- [앱인토스 개발 문서](https://developers-apps-in-toss.toss.im/)
- 강의 내용 문의 및 오류 신고: [라인블록](mailto:lineblock55@gmail.com)