# Lesson 12 Cost Mgmt

> AI 에이전트 강의 패키지의 12강 (심화 트랙 5) — 비개발자가 토큰·비용 메커니즘을 이해하고, 본인 환경에서 비용을 추적·절약하는 기본 방법을 익힐 때 사용하는 30분 대화형 강의. API를 직접 쓰는 학습자는 사용량 대시보드 점검을, 미사용 학습자는 토큰 절약 패턴 사고를 적용한다. 사용자가 "12강 시작", "토큰", "LLM 비용", "API 비용", "API 비용 줄이고 싶어요", "에이전트 쓰니까 너무 비싸요", "비싼 호출", "비용 추적", "비용 절약", "캐싱" 같은 표현을 쓰거나, 11강 끝난 후 자연스럽게 이어지는 강의에 진입하려 할 때 반드시 이 스킬을 사용한다. 단순 비용 절약 팁이 아니라, 한 청크씩 게임처럼 진행되는 30분짜리 가이드형 학습 흐름이라는 점이 핵심이다.

- Skill: `matthewoong/lesson-12-cost-mgmt` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add matthewoong/lesson-12-cost-mgmt`
- Raw SKILL.md: https://api.skillmd.com/api/skills/matthewoong/lesson-12-cost-mgmt/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: Matthewoong (https://skillmd.com/u/matthewoong)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/matthewoong/lesson-12-cost-mgmt

---


# Lesson 12 — 비용 관리 (심화 트랙 5)

> 학습자가 끝나면 토큰·비용 메커니즘을 이해하고, *어떤 도구를 쓰든* 비용을 추적·절약하는 기본 방법을 익힌다.

⚠ **첫 청크에 안내**: API 키를 직접 안 쓰시는 분도 *토큰 개념*은 모든 도구 사용자에게 도움이 됩니다. 직접 키 사용 학습자는 *대시보드 점검*까지, 미사용 학습자는 *토큰 절약 사고*까지가 목표예요.

---

## 0. 시작하기 전에
공통 5개 문서 참조.

---

## 1. 진입 시 행동
공통 패턴. **첫 청크 출력 전 안내**:
```
이 강의는 두 가지 학습자를 모두 위해 설계됐어요.

  - API 키 직접 사용 학습자 → 사용량 대시보드 점검 + 절약 1가지 적용
  - API 키 미사용 학습자 → 토큰 개념 + 절약 사고 패턴 익히기

{{name}}님은 어느 쪽이세요?
  (1) API 키 직접 써요
  (2) API 키 직접 안 써요 (Claude Code/Cursor 등 도구만)
  (3) 잘 모르겠어요
```

응답에 따라 가이드 실습 분기 (4-1).

`progress["12-cost-mgmt"]`. 헤더 `📘 [Lesson 12 · 청크 X/Y]`.

---

## 2. 진도 갱신 + draft 키 명세

| 시점 | 갱신 |
|---|---|
| 12강 첫 진입 | `status = "in_progress"`, `current_chunk = 1` |
| 청크 통과 | `current_chunk += 1` |
| 청크 1 답변 | `draft.api_user_type = "direct" | "indirect"` |
| 청크 3 답변 | `draft.current_monthly_estimate = <한 달 사용량 추정>` |
| 청크 7 답변 | `draft.top_3_calls = [<자주/비싼 호출 3개>]` |
| 청크 5~7 답변 | `draft.optimization_ideas = [<적용할 절약 패턴들>]` |
| 실습 통과 | `practice_status = "done"`, `status = "completed"` |

### 12강이 사용하는 `draft` 키

| 키 | 시점 | 형식 |
|---|---|---|
| `api_user_type` | 청크 1 | "direct" / "indirect" |
| `current_monthly_estimate` | 청크 3 | string |
| `top_3_calls` | 청크 7 | array |
| `optimization_ideas` | 청크 5~7 | array |

---

## 3. 이론 lesson 흐름
청크 8개. 첫 청크는 *토큰이 뭐예요? — 모든 LLM의 공통 단위*로 시작.

### 12강에서 *왜* 한 청크씩 가는가
비용은 *추상적*인데 청구서로만 체감되는 *지연된 피드백*이 있어요. 한 청크씩 *원리 → 본인 추정 → 절약 → 다음*으로 가야 학습자가 매 단계에서 *내 사용 패턴*과 연결할 수 있습니다.

---

## 4. 가이드 실습 — 옵션 2개 인라인 (학습자 유형별 분기)

### 4-0. 진입 시 draft 정리

```
🎉 이론 끝! 이제 본인 환경에 적용해볼 시간이에요.

📝 학습자 유형: <draft.api_user_type>
📝 한 달 사용량 추정: <draft.current_monthly_estimate>
📝 자주/비싼 호출 후보:
   - <draft.top_3_calls[0]>
📝 적용할 절약 패턴:
   - <draft.optimization_ideas[0]>
```

### 4-1. 옵션 제시 (학습자 유형에 따라 자동 분기)

```
{{name}}님은 [direct/indirect] 학습자이시니까:

  (direct) (1) 사용량 대시보드 직접 점검 + 절약 1가지 적용 (추천)
           (2) 가상 사례로 연습
  (indirect) (1) 본인 도구의 토큰 사용 패턴 점검 + 슬림화 1가지
             (2) 가상 사례로 토큰 절약 사고 연습

번호로 답해주세요.
```

### 4-2. 옵션 ① — 본인 환경 적용
- direct: 가입한 제공자의 사용량 대시보드 URL 안내, 한 달 비용 확인, *비싼 호출 1개* 식별, 절약 패턴 1개 적용
- indirect: 본인 도구의 컨텍스트 패턴 점검, 슬림화 가능한 부분 1개 식별

### 4-3. 옵션 ② — 가상 사례
강의 제공 시나리오로 *동일한 사고*를 연습.

### 4-4. 검증 기준

| 항목 | 통과 기준 |
|---|---|
| 토큰 개념을 *한 줄로 설명* 가능 | ✅ |
| 본인 사용 패턴 (또는 가상)에서 *비싼 호출 1개 식별* | ✅ |
| 절약 패턴 1개를 *실제 적용*하거나 적용 계획 수립 | ✅ |

3개 중 2개 이상 ✅.

---

## 5~7. (공통)
다음 강의: 13-local-cloud-privacy.

---

## 8. 강의 작성자 메타

- **트랙**: 심화 5강
- **선행**: 기초 1~7강 + 심화 8~11강 (권장)
- **분량**: 약 30분
- **외부 자료**: 도구별 사용량 대시보드 (direct 학습자만)
- **비용**: 없음 (대시보드 확인은 무료)
- **학습 목표**:
  - 토큰이 무엇이고 *어떻게 비용으로 환산되는지* 안다
  - 본인 환경에서 *비싼 호출 1개*를 식별
  - 절약 패턴 1개를 적용하거나 적용 계획을 세운다
- **다음 강의**: 13-local-cloud-privacy

---

## 9. 빠른 자기 점검
- [ ] 학습자 프로필 읽음
- [ ] `📘 [Lesson 12 · 청크 X/Y]`
- [ ] 한 청크만, 끝에 ❓/🛠/🔀
- [ ] 자리표시자 채움
- [ ] 도구명 노출 X
- [ ] 시도 전 답 X
- [ ] `progress["12-cost-mgmt"]` 갱신
- [ ] **12강 추가**: 학습자 유형(direct/indirect)에 맞는 분기를 적용했는가