AI 실습 워크숍, 설치에 2시간 쓰지 않는 법 — 전날 점검 스크립트와 당일 타임테이블 5단계

AI 실습 워크숍에서 세팅 시간은 사고가 아니라 매번 생기는 상수입니다. 참가자가 전날 점검 스크립트를 돌려 결과를 캡처해 보내게 하고, 당일 설치 대기 시간에 개념 설명을 채우면 세팅 때문에 커리큘럼이 반토막 나는 일을 막을 수 있습니다.

이 글은 이런 분께 필요합니다

• 비개발자 대상 AI 실습(코딩 에이전트, 노코드 자동화 등)을 처음 여는 강사·교육 담당자
• 사전 안내 메일에 설치 목록을 보냈는데 당일 절반이 설치를 안 해 온 경험이 있는 분
• 오프라인과 온라인을 같이 진행해야 하는 워크숍 운영자

준비물은 지금 쓰는 사전 안내 메일과 타임테이블입니다. Step 2의 스크립트는 Mac용이며, 2026년 10월 7일 macOS 26.5.1에서 직접 실행해 확인했습니다.

먼저 왜 이 글을 쓰게 됐는지 짧게 적습니다. 대학생·취업준비생 대상 5시간 원데이 워크숍에서 초기 세팅에만 2시간이 걸렸고, 준비한 커리큘럼의 절반만 진행했습니다. 참가자 대부분이 코딩 에이전트도, 코드 에디터도, 터미널도 그날 처음 봤습니다. 설치 자체는 어렵지 않았습니다. 여러 명이 동시에, 각자 다른 이유로 막혔고, 강사는 한 명씩 순서대로 풀어야 했던 것이 문제였습니다.

Step 1. 막히는 지점 8가지를 사전 안내에 미리 적습니다

강사 메모에 쌓인 실제 막힘 지점입니다. 대부분은 "그게 정상이에요" 한마디면 풀리는데, 당일에 처음 들으면 손이 멈춥니다. 그래서 사전 안내 메일에 이 표를 그대로 넣습니다.

막히는 지점	실제 증상	미리 할 안내
로그인 상태 확인 안 함	탭이 안 보이거나 응답 없음	앱 오른쪽 위 계정부터 확인하세요
설치가 멈춘 줄 착각	"멈춘 것 같아요"	30초~1분은 정상입니다
전역 설치 권한 오류	EACCES	sudo를 붙이지 말고 강사에게 알려주세요
폴더 경로에 한글·공백	나중 실습에서 경로가 안 잡힘	영문 폴더 이름을 쓰세요
Windows 보안 알림	SmartScreen·방화벽 팝업에서 정지	허용을 눌러도 됩니다
macOS 권한 팝업	폴더 접근 승인 창	허용을 누르세요
브라우저 로그인 후 복귀 실패	승인했는데 앱으로 안 돌아옴	새로고침하지 말고 잠시 기다리세요
회사·학교 노트북 정책	설치 자체가 막힘	개인 노트북을 가져오세요

마지막 줄은 당일에 해결할 방법이 거의 없습니다. 사전 안내에서 가장 굵게 적습니다.

Step 2. 참가자에게 전날 점검 스크립트를 돌리게 합니다

설치 목록을 적어 보내기만 하면 대부분 읽지 않습니다. 그래서 결과가 돌아오는 장치를 넣었습니다. 참가자는 전날 터미널에 아래 내용을 통째로 붙여 넣고, 마지막 화면을 캡처해 보냅니다.

cat > ~/Desktop/setup-check.sh <<'SCRIPT'
#!/bin/bash
# 워크숍 전날 실행하는 사전 점검 (macOS)
ok(){ echo "✅ $1"; }; ng(){ echo "❌ $1"; FAIL=1; }
FAIL=0
echo "macOS $(sw_vers -productVersion)"
command -v git >/dev/null && ok "git $(git --version | awk '{print $3}')" || ng "git 없음 → xcode-select --install"
command -v node >/dev/null && ok "node $(node -v)" || ng "node 없음 → https://nodejs.org 에서 LTS 설치"
command -v npm >/dev/null && ok "npm $(npm -v)" || ng "npm 없음 (node와 함께 설치됩니다)"
FREE=$(df -g ~ | awk 'NR==2{print $4}')
[ "$FREE" -ge 5 ] && ok "여유 공간 ${FREE}GB" || ng "여유 공간 ${FREE}GB (5GB 이상 비워주세요)"
DIR="${1:-$HOME/ai-workshop}"
case "$DIR" in *[[:space:]]*|*[가-힣]*) ng "작업 폴더 경로에 공백/한글: $DIR";; *) mkdir -p "$DIR" && ok "작업 폴더 $DIR";; esac
for h in registry.npmjs.org github.com; do
  curl -s -m 8 -o /dev/null "https://$h" && ok "인터넷 연결 $h" || ng "$h 접속 실패 (회사망·VPN 확인)"
done
[ $FAIL -eq 0 ] && echo "모두 통과. 이 화면을 캡처해서 보내주세요." || echo "❌ 항목을 해결하거나, 이 화면을 캡처해서 강사에게 보내주세요."
SCRIPT
bash ~/Desktop/setup-check.sh

2026년 10월 7일 Mac에서 실행한 실제 결과입니다.

macOS 26.5.1
✅ git 2.55.0
✅ node v26.7.0
✅ npm 11.19.0
✅ 여유 공간 60GB
✅ 작업 폴더 /Users/popcorn/ai-workshop
✅ 인터넷 연결 registry.npmjs.org
✅ 인터넷 연결 github.com
모두 통과. 이 화면을 캡처해서 보내주세요.

점검 항목은 내 워크숍에 맞게 바꿔 씁니다. 예를 들어 코딩 에이전트를 쓴다면 command -v 줄을 하나 더 넣어 그 도구가 설치됐는지 확인합니다. 받은 캡처에서 ❌가 있는 사람만 전날 따로 연락하면, 당일 순차 처리가 크게 줄어듭니다.

Step 3. 당일 첫 시간에 "다 같이 설치 → 대기 중 개념" 순서를 고정합니다

전날 점검을 해도 당일 설치·로그인은 남습니다. 이 시간을 비워두지 않습니다. 강사 메모에 이 순서를 못 박아 두었습니다.

순서	시간	하는 일
1	30초	오늘 만들 결과물 데모
2	5분	다 같이 동시에 설치·로그인 시작
3	15~20분	다운로드가 도는 동안 개념 설명 (예: 왜 한 폴더에 작업을 쌓는가)
4	나머지	각자 실습

빨리 끝난 사람은 개념을 듣고, 늦는 사람은 그 시간에 따라잡습니다. 설치가 끝날 때까지 다 같이 기다리는 시간이 없어집니다.

Step 4. 관전 모드와 최소 보장선을 시작할 때 말합니다

시작할 때 두 문장을 그대로 말합니다.

1. "설치가 안 되면 관전하셔도 됩니다. 오늘 만든 결과물은 끝나고 그대로 받을 수 있습니다."
2. "오늘 최소 목표는 ○○까지입니다. 그 뒤는 사람마다 다르게 끝나도 괜찮습니다."

첫 문장이 있으면 막힌 사람이 죄책감 없이 옆 사람 화면을 같이 보는 쪽으로 넘어갑니다. 두 번째 문장은 목표를 두 층으로 나눕니다. 그날 워크숍에서 "3시간 안에 크롬 확장 완성"은 공격적인 목표였습니다. 다시 한다면 최소 보장은 "확장을 브라우저에 올리고 구조와 디버깅 흐름을 따라가 보기"까지로 잡겠습니다.

막힌 사람이 처음부터 다시 하지 않도록, 단계별 완성본(체크포인트)을 미리 저장해 두고 해당 단계로 바로 복귀할 수 있게 준비합니다.

Step 5. 첫 실습은 30분 안에 끝나는 작은 것으로 정합니다

큰 프로젝트로 바로 들어가지 않습니다. 뽀모도로 타이머나 습관 체크 앱처럼 30분 안에 끝나는 것으로 "AI에게 작게 시키고 눈으로 확인하는" 흐름을 먼저 익히게 합니다. 화려한 데모는 그다음입니다.

결과가 화려한 데모일수록 외부 사이트 구조, 브라우저 권한 같은 변수가 많습니다. 당일 그 사이트가 바뀌면 데모가 통째로 무너지므로, 녹화본과 완성본을 폴백으로 준비합니다.

이런 상황이 나오면 이렇게 하세요

상황	대응
점검 캡처를 절반만 보냄	강의 15분 전 체크인 시간을 따로 잡고, 안 보낸 사람부터 스크립트를 돌리게 합니다
❌ node 없음이 여러 명	전날 설치 링크를 다시 보내고, 당일 Step 3의 동시 설치 시간에 포함합니다
회사 노트북이라 설치 차단	당일 해결은 어렵습니다. 관전 모드로 안내하고 결과물을 공유합니다
온라인 참가자 반응이 없음	"화면에 ○○ 보이면 채팅에 1"처럼 확인 신호를 자주 받습니다. 실습형이라면 온라인은 별도 회차로 분리하는 것도 고려합니다
한 명에게 10분 넘게 붙잡힘	관전 모드로 전환하고 쉬는 시간에 다시 봅니다

온라인 이야기를 덧붙입니다. 그날 온라인 참가자가 13명으로 오프라인보다 많았는데, 카메라를 끄고 반응이 거의 없어서 누가 막혔는지 알 방법이 없었습니다. 실습형 워크숍에서 온라인과 오프라인은 필요한 개입 방식이 다르다는 게 제 결론입니다.

정리

세팅 시간은 강사 실력 문제가 아니라 구조 문제였습니다. 전날 점검 스크립트로 결과를 받고, 당일에는 설치 대기 시간을 개념 설명으로 채우고, 관전 모드와 최소 보장선을 처음부터 말해 두면 같은 5시간에서 실습이 훨씬 많이 남습니다.