READY
준비 점검
지난 수업에 오신 분은 1번과 2번을 확인만 하고 3번부터 하시면 됩니다. 처음 오신 분은 1번부터 차례로 하세요. 준비를 못 하고 오셨어도 걱정 안 하셔도 됩니다. 1~3번만 지금 하고, 4번 API 키는 챕터 2를 하는 동안 만들어도 늦지 않습니다.
1. VS Code와 Claude Code
VS Code는 코드를 보고 고치는 프로그램이고, Claude Code는 그 안에서 일하는 AI 작업자입니다.
- VS Code가 없으면 code.visualstudio.com에서 받아 설치합니다.
- VS Code 왼쪽 세로줄의 네모 네 개 아이콘(확장)을 누르고 검색칸에
Claude Code를 입력해, 만든 곳이 Anthropic인 것을 설치합니다. - 이미 설치했다면 확장 아이콘에 숫자가 붙어 있는지 봅니다. 마우스를 올렸을 때 "requires restart"가 보이면 Restart(다시 시작)를 눌러 업데이트를 끝내세요. 스킬과 플러그인 기능은 최신 버전에서 잘 동작합니다.
- VS Code 오른쪽 아래 상태 표시줄의 ✻ Claude Code를 눌러 Claude 창을 열고, Claude 입력칸 아래 모델 이름을 눌러 Opus 5.5, Sonnet 5.5, Haiku 5.5가 보이면 됩니다.
2. Node.js
Node.js는 오늘 만드는 앱을 내 컴퓨터에서 돌려 보는 실행기입니다. 함께 깔리는 npm은 앱의 부품(라이브러리)을 받아 오는 설치 도구입니다.
Node.js와 npm이 설치돼 있는지 확인하고 버전을 한 줄씩 알려 줘. Node.js가 22보다 낮거나 없으면 설치 방법을 내 운영체제에 맞게 알려 줘.
Node.js가 없으면 nodejs.org에서 LTS라고 적힌 버전을 받아 설치한 뒤 VS Code를 껐다 켜세요.
3. 작업 폴더와 실습 키트
작업 폴더 만들기
Windows
C 드라이브 바로 아래에 magic-read-ai 폴더를 만듭니다. VS Code에서 File → Open Folder로 이 폴더를 엽니다.
Mac
홈 폴더(집 모양 아이콘) 아래에 magic-read-ai 폴더를 만듭니다. VS Code에서 File → Open Folder로 이 폴더를 엽니다.
VS Code 왼쪽 위에 MAGIC-READ-AI가 보이면 됩니다. 폴더 이름은 영어 소문자와 하이픈으로 둡니다. 한글이나 띄어쓰기가 있으면 일부 도구가 경로를 잘못 읽을 수 있습니다.
키트 받기
키트에는 Claude가 먼저 읽는 설명서(CLAUDE.), 디자인 재료, 앱 속 AI가 따를 지시서, 연습용 원문이 들어 있습니다. 앱 코드는 들어 있지 않습니다. 코드는 오늘 여러분이 Claude와 함께 만듭니다.
https://web-manual-magic-read-ai.detoxenglish.ca/magic-read-ai-kit.zip 에서 실습 키트를 받아서 이 폴더에 바로 풀어 줘. 폴더 안에 이미 있는 파일은 지우지 마. 다 풀면 어떤 폴더와 파일이 생겼는지 한 줄씩 알려 줘.
| 키트 안 | 무엇인가 |
|---|---|
CLAUDE. | 이 앱의 설계 규칙. 쓰는 부품, 폴더 위치, AI 비용 규칙, 사전 출처 규칙이 적혀 있어 Claude가 매번 먼저 읽습니다 |
designs/ | 아트 디렉션 브리프 양식과 디자인 견본 세 가지 (챕터 2) |
prompts/ | 앱 속 AI가 따를 지시서: 번역 스타일, 주관식 채점 기준, 문제 유형 (챕터 6·7) |
samples/ | 연습용 단편 「The Bookbinder of Harbor Street」의 PDF, 같은 글을 폰으로 찍은 듯한 사진, 원문 텍스트 |
. | API 키를 넣을 파일의 견본 (준비 4번) |
. | Claude가 .(키 파일)를 읽지 못하게 막아 둔 설정 |
4. Claude API 키 (앱 속 AI용)
Claude Code를 쓰는 구독과 별개로, 내가 만든 앱이 AI를 부를 때는 API 키가 필요합니다. 구독이 매달 정해진 만큼 타는 정기권이라면, API 키는 탈 때마다 충전금에서 빠지는 선불 교통카드에 가깝습니다. 앱이 Haiku 5.5를 부를 때마다 충전해 둔 금액에서 아주 조금씩 빠져나갑니다.
- 브라우저에서 console.anthropic.com에 들어가 로그인합니다. Claude 구독과 같은 이메일을 써도 됩니다.
- 왼쪽 메뉴의 결제(Billing) 화면에서 크레딧을 충전합니다. 오늘 앱은 5달러로도 몇 달을 씁니다.
- 같은 콘솔의 사용 한도(Limits) 화면에서 월 사용 한도를 정해 둡니다. 예: 월 5달러. 한도를 넘으면 앱의 AI 기능만 멈추고 다른 기능은 그대로 됩니다.
- API Keys 화면에서 새 키를 만들고 이름을
magic-read-ai로 붙입니다. 키는 처음 한 번만 보이니 바로 복사합니다. - VS Code 왼쪽 파일 목록에서
.을 복사해 이름을dev. vars. example .로 바꾸고,dev. vars ANTHROPIC_API_KEY=뒤에 키를 붙여 넣습니다.APP_PASSCODE=뒤에는 나만 아는 낱말을 하나 적습니다(챕터 9에서 앱을 인터넷에 올렸을 때 남이 내 키로 AI를 못 쓰게 막는 암호). Ctrl+S(Mac은 ⌘+S)로 저장합니다.
5. 브라우저와 기기
- 데스크톱: Chrome 또는 Edge. 앱 설치(챕터 9)와 화면 확인에 씁니다.
- 폰과 아이패드: 챕터 9에서 설치해 봅니다. 아이폰·아이패드는 Safari, 안드로이드는 Chrome을 씁니다.
오늘 드는 비용
| 항목 | 금액 | 메모 |
|---|---|---|
| Claude 구독 (Pro 이상) | 지금 쓰는 요금제 그대로 | 앱을 만들 때 |
| Claude API 크레딧 | 5달러 충전 | 혼자 매일 써도 몇 달. 챕터마다 비용 상자에 계산이 있습니다 |
| 듣기(TTS) | 0원부터 | 브라우저에 들어 있는 목소리는 무료. 더 좋은 목소리는 챕터 8 |
| 앱 올리기 (Cloudflare) | 0원 | 무료 요금제로 충분합니다. 계정은 챕터 9에서 만듭니다 |