기업 교육용 eLearning 강좌 제작에는 Articulate Storyline이나 Articulate Rise 같은 저작 도구가 흔히 쓰입니다. 그런데 바탕화면의 빈 폴더 하나에서 출발해 Claude Code(Anthropic의 AI 코딩 agent)만으로 8페이지짜리 상호작용 강좌를 만들고, LMS(학습관리시스템)에 올릴 수 있는 SCORM 1.2 패키지까지 한 시간 안에 완성한 사례가 있습니다. 이 글은 그 작업 순서를 처음부터 끝까지 따라가면서, 어느 단계에서 AI에게 맡기고 어느 단계에서 사람이 판단해야 하는지 짚습니다. 결론부터 말하면 AI는 코드를 쓰고, 사람은 감독처럼 방향을 정하고 결과를 검수하는 구조입니다.
시작 준비: 폴더, 모델, effort 선택
첫 단계는 코드가 아니라 폴더입니다. 바탕화면에 'Course 101'이라는 빈 폴더를 만들고, Claude Code의 작업 공간을 이 폴더로 지정한 뒤 'Trust workspace' 안내를 수락해 쓰기 권한을 줍니다. 작업 공간은 로컬 폴더 외에 클라우드나 원격 제어 방식도 고를 수 있는데, GitHub 같은 저장소를 쓰면 버전 관리와 branch 작업, 테스트, 되돌리기가 쉬워집니다. 스토리보드나 Word 문서가 있으면 슬라이드 구조를 추정하는 데 도움이 되지만, 없어도 Claude Code가 샘플 콘텐츠를 만들어 줍니다.
다음은 모델과 effort(모델이 추론에 쓰는 노력 수준) 선택입니다. 모델 선택 목록에는 Fable 5.1, Opus 3, Sonnet 3.5, Haiku 4.5가 보이고, effort는 Fast, High, Extra, Ultracode 가운데 고를 수 있습니다. 이 사례에서는 첫 생성에 Opus와 Extra effort를 썼습니다. Sonnet이나 Haiku보다 사용량을 더 많이 쓰지만, 처음 세우는 뼈대가 튼튼해야 이후 작업이 편하다는 판단입니다. 뼈대가 잡힌 뒤의 작은 버그 수정이나 스타일 조정은 Sonnet으로 내려서 사용량을 아끼는 방식을 권합니다.
사용량 관리도 사람의 몫입니다. Claude Code 설정의 Usage 항목에서 5시간 단위 세션 한도와 주간 한도를 확인할 수 있습니다. 작업 당시 세션 사용량은 29%였습니다. 5시간 세션 한도는 예전 휴대폰 요금제처럼 답답하게 느껴질 수 있지만, 한도가 있는 이상 큰 prompt를 반복해서 보내면 금방 바닥나므로 아래에서 설명할 작은 단위 수정 전략이 사용량 측면에서도 중요합니다.
첫 prompt: 뼈대만 요청합니다
prompt를 쓰기 전에 두 가지 설계 판단을 먼저 내립니다. 하나는 도구 역할 분담입니다. Claude Design(Anthropic의 디자인 시안 도구)은 테마, 버튼, HTML/CSS 시각 기반을 잡는 데 뛰어나지만 SCORM 패키징이나 복잡한 로직, 동적 상호작용은 처리하지 못합니다. 그래서 표준 작업 흐름은 Claude Design에서 시각 프로토타입을 만들고, 그 디자인 token과 스타일 가이드를 Claude Code로 옮겨 앱 로직을 구현하는 순서입니다. 이번 사례는 디자인 단계를 건너뛰고 Claude Code만으로 시작했기 때문에 첫 결과물의 시각 완성도가 다소 투박했고, 이 점이 오히려 디자인 단계를 먼저 두는 이유를 보여 줍니다.
다른 하나는 강좌 구조입니다. Articulate Rise처럼 길게 스크롤하는 형식과 슬라이드를 한 장씩 넘기는 형식 가운데, 이 사례는 슬라이드형을 택했습니다. 스크롤형은 딱딱한 교과서처럼 느껴지기 쉽고, 슬라이드형은 학습자가 한 번에 한 주제에 집중하게 한다는 판단입니다.
이렇게 정한 뒤 'Standards of Conduct(행동 규범)'를 주제로 한 모듈을 만들라는 prompt를 보냈습니다. 요청한 요소는 다음과 같습니다.
- 강좌 제목과 설명을 보여 주는 상단 고정 player
- 페이지 제목 목록이 나오는 slide-out drawer 메뉴
- 하단의 Back, Next 이동 버튼
- 기업 행동 규범 주제에 맞는 Pexels나 Unsplash의 자리표시 사진
여기서 핵심 전략이 나옵니다. 강좌 커리큘럼 전체를 첫 prompt에 쏟아붓지 않는 것입니다. 요구 사항이 너무 많으면 모델이 세부 지시를 건너뛰거나 무시하는 경향이 있고, 큰 prompt는 추론 부담이 커서 세션 한도를 빠르게 소진합니다. 반대로 첫 prompt로 큰 틀만 세우고, 이후 모듈 하나씩 좁은 prompt로 다듬으면 사용량을 아끼면서 세밀한 조정이 가능합니다. 메뉴 클릭 상태 확인, 이동 버튼 디버깅처럼 한 번에 한 부분씩 점검하는 방식입니다.

▲ 한 부분씩 지시하는 감독 방식
생성 결과 점검: 8페이지 프로토타입에서 무엇을 고칠지 찾기
첫 생성이 끝나면 Claude Code가 localhost:4321에 미리보기 서버를 띄웁니다. 결과물은 상단 제목 바, 자리표시 사진, Next/Back 버튼, slide-out 메뉴를 갖춘 8페이지 강좌였습니다. 터미널 기록을 보면 레이아웃 충돌을 스스로 감지해 넘치는 메타데이터 텍스트를 고치고, 여러 화면 크기에서 반응형 배치를 검증한 과정도 남아 있습니다. 생성된 8개 페이지 템플릿은 다음과 같습니다.
| 순서 | 페이지 템플릿 |
|---|---|
| 1 | 'Start course' 버튼이 있는 도입 슬라이드 |
| 2 | 이미지가 나란히 놓인 학습 목표 |
| 3 | 행동 규범 4대 원칙 개요 |
| 4 | 탭으로 구성한 직장 내 시나리오 |
| 5 | 분기형 시나리오 질문 |
| 6 | 즉시 피드백이 있는 Knowledge Check |
| 7 | 아코디언 형식의 절차 체크리스트 |
| 8 | 요약 복습 슬라이드 |
이 단계에서 사람의 눈이 필요합니다. 미리보기를 직접 눌러 보며 발견한 문제는 네 가지였습니다. 첫째, 메뉴가 'All pages', 'Introduction', 'Content Page', 'Scenario', 'Knowledge Check', 'Summary' 탭으로 페이지를 유형별로 자동 분류했는데, 기술적으로는 영리하지만 학습자가 순서대로 진행하는 흐름을 흐트러뜨릴 수 있습니다. 둘째, 도입 슬라이드에 'Start course' 버튼과 하단 Next 버튼이 함께 있어 이동 수단이 중복됩니다. 셋째, 카드에 hover 효과가 있어 클릭할 수 있어 보이지만 실제 클릭 동작이 없습니다. 클릭되지 않는 요소에 hover 효과를 두면 사용자가 혼란을 겪으므로 피해야 합니다. 넷째, 기본 외곽선과 다듬어지지 않은 카드처럼 시각 디자인이 단순합니다.
비교 기준으로 삼을 만한 완성형 강좌도 있습니다. SCORM Cloud(SCORM 패키지 테스트 플랫폼)에 올려 둔 'Welcome to Acme 101'이라는 온보딩 강좌는 영어와 스페인어를 바로 바꾸는 언어 전환, 데스크톱에서 모바일까지 이어지는 반응형 배치, 단일 선택과 다중 선택 문제, 드래그 앤 드롭 분류, 오디오 내레이션, 완료 조건이 걸린 아코디언, 팀 소개 탭 카드, flip card 격자까지 갖추고 있습니다. 다국어 전환이 간단한 이유는 모든 강좌 문구를 외부 JSON 파일로 빼 두었기 때문입니다. 첫 프로토타입과 이 완성형 사이의 거리가 곧 앞으로 반복해서 다듬을 작업량입니다.
주석 도구로 한 부분씩 다듬기
수정 지시는 말로만 하지 않고 화면에 직접 표시합니다. Claude Code의 미리보기 브라우저 오른쪽 위에 있는 주석 도구로 빨간 펜과 화살표, 선택 상자를 그려 'Add to chat'으로 prompt에 붙일 수 있고, 선택 도구로 특정 요소의 DOM selector를 바로 prompt에 넣을 수도 있습니다. 어떤 요소를 말하는지 모호함이 사라지므로 CSS와 배치 수정이 정확해집니다. 이 사례에서 진행한 수정은 다음 순서였습니다.
| 대상 | 지시 내용 | 이유 |
|---|---|---|
| 메뉴 | 유형별 필터 탭을 없애고 순차 페이지 목록만 표시 | 선형 진행 유지 |
| 상단 바 | Resources와 메뉴 버튼의 테두리 제거, 텍스트 버튼을 아이콘으로 교체, 그라데이션 배경을 진한 파란색 단색으로 | 그라데이션 바는 10년 전 디자인처럼 보임 |
| 하단 이동 버튼 | Next/Back 텍스트 버튼을 화살표만 있는 원형 버튼으로 | 번역 불필요, 모바일에서 글자 깨짐 방지 |
| 도입 CTA | 'Start the course' 버튼을 메타데이터 배지와 같은 줄 오른쪽으로 옮기고 pill 모양으로 | 'pill' 같은 정확한 디자인 용어로 지시 |
| 학습 목표 | 데스크톱에서 왼쪽 절반 full-bleed 이미지, 오른쪽 절반 텍스트의 50/50 분할, 모바일에서는 이미지 위, 텍스트 아래로 쌓기 | 전문적인 인상 |
몇 가지 눈여겨볼 점이 있습니다. 두 번째 이후의 수정은 이미 구조가 있는 코드 위에서 이뤄지기 때문에 첫 생성보다 훨씬 빠르게 끝납니다. 아이콘만 있는 이동 버튼도 hover 시 tooltip으로 설명 텍스트를 남겨 두면 접근성을 해치지 않습니다. 메뉴와 Resources 패널은 수정 후 각각 독립적으로 열리고, 한쪽을 열면 다른 쪽이 자동으로 닫히는지 직접 눌러 확인했습니다. 학습 목표 페이지는 Chrome의 반응형 보기로 데스크톱, 모바일, 태블릿을 번갈아 띄워 이미지가 위로 붙고 본문이 아래에서 스크롤되는지 확인했습니다. 데스크톱 배치를 바꿀 때마다 모바일과 태블릿을 함께 보는 습관이 필요합니다.
그리고 'pill shape', 'rounded rectangle', 'full-bleed split' 같은 디자인 용어를 정확히 쓰는 것이 AI를 지휘하는 데 가장 가치 있는 기술이라는 점입니다. 용어를 몰라도 시작은 할 수 있지만, 정확한 어휘가 있어야 원하는 결과를 한 번에 얻습니다.

▲ 주석 지시와 반응형 레이아웃 검증
SCORM 1.2 패키징과 LMS 검증
LMS 연동 스크립트를 손으로 쓰는 대신 SCORM 패키징용 skill(Claude Code에 미리 정의해 둔 작업 절차)을 씁니다. 명령창에 'anthropic.skills:scorm-cmi5-wrapper'를 입력해 skill을 부르고, 모든 페이지를 보면 완료 상태를 보내고 퀴즈 결과와 점수가 LMS에 전달되는 SCORM 1.2 패키지로 묶어 달라고 요청했습니다.
여기서 다시 사람의 선택이 필요합니다. 패키징 과정에서 터미널 옵션으로 세 가지를 묻는데, 이 사례의 선택은 다음과 같습니다.
- 점수 산정 대상: Knowledge Check만 포함
- 점수 보고 기준: 첫 번째 시도
- 상태 처리: 'Completed, score alongside (Recommended)'
세 번째 항목이 중요한 이유는 SCORM 1.2가 상태 필드를 하나만 갖기 때문입니다. SCORM 2004는 'Complete'와 'Passed'를 따로 보고하지만, 1.2에서는 완료와 통과 가운데 어떻게 다룰지 정해야 하고, LMS마다 해석이 달라 보고 결과가 미묘하게 어긋날 수 있습니다. 완료를 기록하면서 퀴즈 점수도 함께 보내고 싶다면 'Completed, score alongside'가 맞습니다. 프로젝트의 README.md 파일은 프로젝트 규칙과 지침을 담는 지속 메모리 역할을 하므로, 이런 결정을 적어 두면 다음 prompt에서도 같은 기준이 유지됩니다.
패키징이 끝나면 프로젝트 루트에 'standards-of-conduct-scorm12.zip'이 생깁니다. macOS Finder에서 index.html, assets, README.md와 함께 zip 파일이 있는지 확인한 뒤 SCORM Cloud에 올려 샌드박스에서 실행합니다. 이전 테스트 등록을 지워 깨끗한 상태로 만들고, 강좌를 끝까지 넘기며 탭과 시나리오 화면, Knowledge Check를 거쳐 정답을 제출하고 창을 닫았습니다. SCORM Cloud의 debug 기록에는 완료 상태 'Complete', 점수 100.00%, 실행 시간 38초가 찍혔습니다. 완료 추적과 점수 보고가 모두 LMS까지 전달된 것입니다.
사람이 개입하는 지점과 다음 단계
이 사례에서 사람이 판단한 지점을 모으면 다음과 같습니다.
- 폴더 준비, 모델과 effort 선택, 사용량 확인
- 슬라이드형과 스크롤형, 디자인 도구 사용 여부 같은 구조 결정
- 첫 prompt의 범위를 뼈대로 제한하는 판단
- 미리보기를 직접 눌러 보며 문제 찾기
- 주석과 정확한 디자인 용어로 한 부분씩 수정 지시
- 반응형 화면 검증
- SCORM 점수 기준과 상태 처리 방식 선택
- SCORM Cloud에서 완료와 점수 전달 검증
AI가 코드를 쓰더라도 방향 설정과 검수는 빠지지 않습니다. 다만 저작 도구를 다루는 기술보다 교수 설계 판단과 디자인 어휘가 핵심 역량이 되는 것으로 보입니다.
한 편을 완성한 뒤에는 템플릿화를 권합니다. 강좌 문구를 JSON 데이터 파일로 빼내어 HTML/CSS player 로직과 분리하면, 프로젝트 껍데기를 복제한 뒤 텍스트와 미디어만 바꿔 다음 강좌를 만들 수 있고 다국어 번역도 수월해집니다. 다만 이번 사례는 Claude Code 활용의 겉면을 다룬 것이고, Word 문서를 강좌 템플릿으로 바꾸는 방법이나 Claude Design으로 player 인터페이스를 다듬는 방법 같은 더 깊은 설계 패턴은 이 글의 범위를 벗어납니다.
직접 시도해 본다면 빈 폴더와 짧은 첫 prompt로 시작해 8페이지 정도의 작은 모듈을 만들고, SCORM Cloud에서 완료와 점수가 넘어오는지까지 확인하는 것을 첫 목표로 삼는 것이 좋습니다. 그 과정에서 내린 선택을 README.md에 적어 두면 두 번째 강좌부터는 훨씬 빠르게 진행할 수 있습니다.


