# Claude Code 마스터리 워크북 — 자료 모음

이 저장소는 **Claude Code** 실습용 워크북과 **Starter** 프로젝트를 담습니다. 슬라이드를 암기하는 대신, 미션별 **행동·검증·의도적 실패**로 익힙니다.

## 문서

| 파일 | 대상 |
|------|------|
| [workbook-learner.md](workbook-learner.md) | 실습자 — Mission 1~5 절차·체크리스트 |
| [workbook-instructor.md](workbook-instructor.md) | 강사 — 타이밍, 분기, 토큰·비용 가드 |
| [cheat-sheet-one-pager.md](cheat-sheet-one-pager.md) | 공통 — 명령어·설정 템플릿 1장 |

## Starter Repo

실습은 [`starter/`](starter/) 디렉터리를 프로젝트 루트로 사용합니다.

```bash
cd starter
# 필요 시 가상환경
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python -m todo_cli --help
```

자세한 미션 순서는 `starter/README.md`와 `workbook-learner.md`를 따릅니다.

## 준비물

- Node.js 18 이상 및 **Claude Code CLI** 설치
- Claude Pro/Max 또는 Anthropic API 키(제품 정책에 맞게)
- (Mission 3) GitHub MCP 사용 시 `GITHUB_PERSONAL_ACCESS_TOKEN` 등 [GitHub MCP 서버](https://github.com/modelcontextprotocol/servers) 문서 참고

## 저비용 실습 팁

긴 대화·멀티 에이전트는 토큰을 많이 씁니다. 제품 CLI에서 지원하는 경우 저비용 모델 플래그를 사용하고, `starter` 코드는 **500줄 이하**로 유지합니다.