DETOX ENGLISHMagic Read AI 웹 매뉴얼
교재 PDF실습 키트

CHAPTER 05

단어 카드와 단어장

옵션 바의 [단어 뜻]을 누르면 단어 카드가 열리게 합니다. 카드에는 한국어 뜻, 영어 뜻, 발음기호와 발음, 어원, 예문이 들어가고, 줄마다 어디서 온 내용인지 출처가 붙습니다. 카드에서 [단어장에 넣기]를 누르면 내 기기에 쌓이고, 쌓인 단어로 섞어서 시험을 봅니다. 이 챕터에서 AI 모델을 고르는 기준도 함께 정리합니다.

사전 내용은 어디서 오나

단어 카드를 만들기 전에, 각 사전이 프로그램으로 가져가는 것을 허락하는지부터 확인했습니다. 웹사이트는 사람이 들어와서 보는 것과 프로그램이 대신 가져가는 것을 다르게 다룹니다.

사전약관과 기술 조치이 앱에서는
네이버 영어사전이용약관에 "네이버의 사전 허락 없이 자동화된 수단(예: 매크로 프로그램, 로봇(봇), 스파이더, 스크래퍼 등)을 이용하여" 사람의 실제 이용을 전제로 하지 않는 방식으로 쓰지 말라고 적혀 있습니다. 공식 공개 API도 없습니다카드의 [네이버 사전] 버튼이 그 단어의 네이버 사전 페이지를 바로 엽니다
Longman (LDOCE)운영사 Pearson의 법적 고지에 "data mining, robots, scraping"을 쓰지 말라고 적혀 있습니다[Longman] 버튼으로 그 단어의 페이지를 엽니다
Online Etymology Dictionary프로그램이 요청하면 로봇 확인 화면으로 막습니다[어원 사전] 버튼으로 그 단어의 페이지를 엽니다

그래서 카드 안에 미리 채워 두는 내용은 프로그램 사용을 허락한 출처에서 가져오고, 위의 세 사전은 버튼 한 번으로 바로 열어 보게 합니다. 사전을 사람이 직접 여는 것은 각 사이트가 원래 의도한 쓰임새입니다.

카드의 칸채우는 곳표시
영어 뜻, 발음기호, 발음 소리Free Dictionary API (Wiktionary 기반, CC BY-SA). Merriam-Webster Learner's 키를 받아 두면 학습자용 정의와 예문을 먼저 (비상업용 무료, 하루 1,000건)출처 이름
한국어 뜻AI 문맥 풀이: 영어 정의와 책 속 문장을 근거로 '이 문장에서의 뜻'을 한국어로'AI 풀이' + [네이버 사전]
어원Wiktionary의 어원 부분을 AI가 한국어 두세 줄로 요약'AI 요약 · Wiktionary' + [어원 사전]
예문책 속 그 문장 → 사전 예문 → Tatoeba 영한 예문(CC BY 2.0 FR). AI가 지은 예문은 마지막 수단출처 이름, AI 예문은 'AI 예문'

1. 단어 카드 만들기

Opus 5.5 권장단어 카드 만들기
옵션 바의 [단어 뜻]에 단어 카드를 연결해 줘. CLAUDE.md의 '사전 출처 규칙'을 그대로 따른다.
- 서버 /api/word: Free Dictionary API로 영어 뜻·품사·발음기호·발음 파일, Wiktionary에서 어원 부분, Tatoeba에서 영한 예문 2개를 가져온다. 출처마다 worker/sources/의 파일 하나로.
- 같은 호출에서 Claude Haiku 5.5(effort low, 구조화 출력)에게 단어와 책 속 문장, 영어 정의를 주고 받는다: 이 문장에서의 한국어 뜻 한 줄, 품사, 뜻 풀이 한 줄, 어원 한국어 요약 두세 줄(Wiktionary 내용만 근거로, 없으면 '정보 없음').
- 다섯 단어 이하 구절(구동사·관용구)을 골랐으면 구절 전체로 풀이한다.
- 카드 구성: 단어와 발음기호, 발음 듣기(영국·미국), 이 문장에서의 뜻(AI 풀이 표시), 영어 뜻(출처), 어원(AI 요약 · Wiktionary), 예문(출처), [단어장에 넣기].
- 버튼: [네이버 사전] [Longman] [어원 사전] — 그 단어의 페이지를 데스크톱은 옆 창, 폰은 새 탭으로 연다.
- 결과는 IndexedDB에 저장해서 같은 단어를 다시 열면 AI를 부르지 않는다. 응답의 토큰 사용량을 기능별 비용 기록에 더한다.
- 서버가 출처 하나에서 실패해도 나머지는 보여 준다.
samples의 원문에서 stubbornly, make out, quarrel, a far cry from을 차례로 골라 보고 카드 스크린샷을 보여 줘.

2. 단어장

Sonnet 5.5 권장단어장 만들기
[단어장에 넣기]를 누르면 단어를 IndexedDB(Dexie)에 저장해 줘.
- 저장할 것: 단어(원형), 고른 형태, 이 문장에서의 뜻, 책 속 문장, 책 이름과 문장 위치, 저장한 날, 복습 정보(ts-fsrs 5.4.2의 카드 상태)
- 처음 저장할 때 navigator.storage.persist()를 요청한다.
- 단어장 화면: 사전처럼 단어와 뜻이 한 줄씩. 책별·날짜별로 보기, 검색, '아는 단어로 표시'
- 책 화면에서 단어장에 있는 단어는 DESIGN.md의 '새 단어' 표시로 보인다.
- 설정 → 백업: 단어장 내보내기(파일)와 가져오기. 

3. 단어 시험에 AI가 몇 개 필요할까

단어 시험을 만들기 전에 모델을 고르는 법부터 정리합니다. 결론부터 말하면 단어 시험 대부분은 AI가 필요 없습니다.

모델을 고르는 네 가지 질문

질문답에 따라
1. 정답이 정해져 있나?정해져 있으면 코드로 합니다. AI를 붙이지 않습니다 (객관식 채점, 철자 확인, 점수 계산)
2. 틀리면 얼마나 곤란한가?가볍다면 작은 모델 하나. 점수처럼 결과를 믿을 수 있어야 하는 일은 작은 모델 둘이 따로 보고, 의견이 다를 때만 큰 모델
3. 얼마나 자주 부르나?단어를 누를 때마다 부르는 일은 가장 싼 모델로. 한 달에 몇 번 없는 일은 비싼 모델도 괜찮습니다
4. 바로 봐야 하나?누르자마자 떠야 하는 일은 빠른 작은 모델. 밤사이 미리 해 두는 일은 일괄 처리(Batch, 50% 할인)

Haiku 5.5로 먼저 만들고 예시 열 개를 직접 확인해서, 틀리는 곳이 보이는 기능만 Sonnet 5.5로 올립니다.

같은 일, 모델만 바꾸면

단어 카드의 문맥 뜻 풀이 한 번을 입력 약 800토큰, 출력 약 300토큰으로 잡고 계산했습니다(가격은 100만 토큰당, 2026년 11월 Anthropic 기준).

모델입력 / 출력 가격풀이 한 번하루 30단어 × 30일
Haiku 5.5$0.10 / $0.50약 $0.0002약 $0.21
Sonnet 5.5$2 / $10약 $0.0046약 $4.1
Opus 5.5$4 / $20약 $0.0092약 $8.3

단어 뜻 한 줄을 정리하는 일에 Opus를 쓰면 같은 결과에 마흔 배를 냅니다. 이런 것을 오버킬(overkill)이라고 합니다. 앱을 만들 때 Claude Code에서 Opus를 쓰는 것과, 앱 안에서 매번 부르는 AI에 Opus를 쓰는 것은 다른 이야기입니다. 만드는 일은 한 번이고, 앱 속 AI는 단어를 누를 때마다 불립니다.

이 앱의 AI 배치표

기능AI모델 × 호출 수한 번에
객관식 채점, 단어 시험 출제·채점, 통계없음코드0원
단어 문맥 뜻 풀이있음Haiku × 1 (저장해서 재사용)약 $0.0002
번역 초안있음Haiku × 1 (저장)약 $0.00017 (챕터 6)
번역 다듬기누를 때만Sonnet × 1약 $0.004 (챕터 6)
독해 문제 만들기있음Haiku × 1 (읽기를 마칠 때)약 $0.002 (챕터 7)
주관식 채점있음Haiku × 2, 의견이 다르면 Sonnet × 1약 $0.003 (챕터 7)
채점 이의 제기누를 때만Opus × 1약 $0.03 (드물게)
단어 시험 '문장 만들기'있음Haiku × 1약 $0.0003
사진 다시 읽기누를 때만Haiku × 1 (한 쪽)약 $0.0005 (챕터 3)
주간 약점 한마디있음Haiku × 1 (일주일에 한 번)약 $0.0005 (챕터 7)

4. 섞어서 보는 단어 시험

시험 문제는 내 단어장에서 코드가 만듭니다. 문장 만들기를 빼면 문제마다 AI를 부르지 않으니 아무리 풀어도 비용이 들지 않습니다.

문제 유형만드는 법채점
뜻 고르기단어를 보여 주고, 내 단어장의 다른 단어 뜻 세 개를 오답으로 섞음코드
단어 고르기한국어 뜻을 보여 주고 단어 넷 중 고르기코드
빈칸 채우기그 단어를 저장한 책 속 문장에서 단어를 빈칸으로코드 (철자 한 글자 실수는 '거의 맞음')
듣고 쓰기발음을 들려주고 철자 쓰기코드
문장 만들기 (선택)그 단어로 내 문장 쓰기Haiku × 1 — 정답이 하나가 아니라서 이것만 AI

섞어서 보는 단어 시험(랜덤 누적 시험)도 그냥 무작위로 뽑으면 이미 잘 아는 단어가 자꾸 나옵니다. 복습 알고리즘(FSRS)이 계산한 '지금 잊었을 확률'과 틀린 횟수로 무게를 주고 뽑되, 일부는 완전히 무작위로 남겨 오래된 단어도 가끔 섞이게 합니다.

Opus 5.5 권장단어 시험 만들기
단어장으로 섞어서 보는 단어 시험을 만들어 줘. AI는 '문장 만들기' 유형에서만 쓴다.
- 문제 수 선택(10·20·30), 유형은 뜻 고르기·단어 고르기·빈칸 채우기·듣고 쓰기를 섞는다.
- 뽑는 법: 단어마다 무게 = 0.05 + (1 − ts-fsrs가 계산한 지금 기억할 확률) + 0.15 × min(틀린 횟수, 5) + 0.3 × (이번 주 읽은 글에 나왔으면 1). 무게로 뽑되 25%는 모든 단어에서 완전 무작위. 지난 시험에서 맞힌 단어는 빼고, 틀린 단어는 다시 넣기.
- 채점은 코드로. 빈칸·듣고 쓰기는 철자 한 글자 차이를 '거의 맞음'으로.
- 답을 고르면 바로 맞음·틀림과 책 속 문장을 보여 주고, 결과를 ts-fsrs 복습 기록으로 남긴다.
- '문장 만들기'(선택 유형): Haiku 5.5가 단어를 맞게 썼는지, 더 자연스러운 문장 한 개, 한국어 한 줄 조언을 준다.
- 시험이 끝나면 맞힌 수, 자주 틀린 단어, 다음 복습 날짜를 보여 준다.

집에서 이어 하기

  • Merriam-Webster Learner's 키 받기: dictionaryapi.com에서 무료 키를 받아 .dev.vars의 MW_LEARNERS_KEY= 뒤에 넣고 "Learner's 사전을 첫 출처로 써 줘"
  • 복습 알림: 오늘 복습할 단어 수를 서재 화면 위에 보여 주기
  • 아는 단어 걸러 내기: 단어장에 '아는 단어'로 표시한 단어는 책에서 형광펜을 끄기