학생용 35개 슬라이드와 1:1로 대응합니다. 설치 성공에만 머물지 않고, 안전한 작업 폴더·행동 승인·자연어 규칙·체크리스트 검증까지 완성하도록 설계했습니다.
4장은 Claude Code를 처음 설치하고 내 컴퓨터의 실제 파일을 다루는 전환점입니다. 교수자는 화면을 대신 조작하기보다 학습자가 경로·권한·결과를 직접 읽고 판단하도록 지도해야 합니다.
장의 전환점과 결과물을 예고한다.
4장은 Claude Code를 내 컴퓨터의 작업자로 들이고 실제 파일과 앱을 만드는 첫 장이다.
“AI가 내 컴퓨터에서 일한다”는 말에서 기대와 걱정을 한 가지씩 받는다.
설치 성공만을 목표로 축소하지 않는다. 규칙·승인·검증까지가 학습 목표다.
수업 말미에 실제 정산 앱 파일이 남는지 확인한다.
3장의 긴장을 완화하고 성취 기대를 만든다.
터미널 안에서도 학습자가 할 핵심 행동은 한국어로 지시하고 결과를 확인하는 것이다.
오늘 얻고 싶은 결과물을 한 문장으로 말하게 한다.
기술 용어를 먼저 쏟아내지 않는다.
학습자가 “모임 정산 앱”을 최종 결과로 말할 수 있다.
설치·생성·규칙·검증의 전체 성과를 합의한다.
설치가 끝이 아니라 첫 파일 생성, CLAUDE.md, 앱 검증까지 수행한다.
네 항목 중 가장 어려울 것 같은 항목에 손들게 한다.
유료 계정이 없는 학습자를 공개적으로 구분하지 않는다.
네 도달점과 개인 지원 필요를 파악한다.
수업의 구조와 현재 위치를 제공한다.
개념→설치→첫 실행→규칙→앱→특수 조작→점검 순서다.
설치 뒤 곧바로 앱을 만들지 않고 첫 파일을 만드는 이유를 예측하게 한다.
목차를 세부 설명 시간으로 사용하지 않는다.
학습자가 오늘의 순서를 설명한다.
Claude 웹과 Code를 권한·환경 차이로 구분한다.
웹은 브라우저에서 결과를 제공하고 Code는 허용한 작업 폴더에서 파일과 도구를 다룬다.
재택 비서와 상주 비서가 각각 잘하는 일을 하나씩 말하게 한다.
“Code가 더 똑똑한 별도 AI” 또는 “컴퓨터 전체에 무제한 접근”으로 설명하지 않는다.
실행 장소와 결과 저장 위치를 구분한다.
결과 저장과 파일 접근 범위를 명료화한다.
선택 모델·지침·도구·권한에 따라 실제 결과는 달라질 수 있으나 핵심은 허용된 로컬 도구 사용이다.
웹 아티팩트와 PC 파일의 차이를 묻는다.
둘의 두뇌가 항상 완전히 동일하게 동작한다고 단정하지 않는다.
Claude 종료 후에도 파일이 남는 쪽을 답한다.
에이전트 반복 고리와 통제 필요성을 연결한다.
상황 파악→작업→확인→재시도 고리가 큰 일을 가능하게 하지만 멈출 조건이 필요하다.
어느 단계에서 사람이 개입해야 하는지 묻는다.
자동 재시도를 무조건 신뢰하거나 무한히 허용하지 않는다.
승인·합격선·중단 중 하나를 제시한다.
계정·권한·환경의 준비 상태를 확인한다.
Claude Code 지원 구독, 인터넷, 터미널, 설치 권한, 안전한 실습 폴더가 필요하다.
준비 체크를 개별 수행하고 미비 항목을 표시한다.
결제정보·인증코드를 수집하지 않는다. 개인 결제를 수업 중 강제하지 않는다.
미준비자는 짝 관찰 또는 시범 경로로 배치한다.
설치 흐름을 하나의 갈림길로 단순화한다.
node -v 성공이면 Node.js 설치를 건너뛰고, 실패하면 LTS 설치 후 Claude Code를 설치한다.
자신의 예상 분기를 고르게 한다.
모든 학습자에게 Node.js를 재설치시키지 않는다.
두 분기의 다음 행동을 말한다.
Node.js 설치 여부를 증거로 판단한다.
node -v의 버전 출력이 성공 기준이며 숫자 일치는 필요 없다.
2분 타이머로 실행하고 성공/미설치 두 구역으로 지원한다.
출력 예시까지 입력하지 않게 한다. 명령은 한 줄씩 실행한다.
버전 문자열 또는 명령 없음 오류를 확인한다.
명령 없음 오류를 정상적인 설치 분기로 해석한다.
nodejs.org의 운영체제별 LTS 설치 프로그램을 사용하고 기본 경로로 진행한다.
설치 대상자만 공식 사이트를 열게 한다.
비공식 다운로드 링크를 사용하지 않는다. 기관 PC 권한 문제와 개인 역량을 구분한다.
LTS와 운영체제에 맞는 설치 파일을 선택한다.
Node.js와 npm 설치 완료를 검증한다.
기존 터미널을 닫고 새로 열어 node -v와 npm -v를 각각 실행한다.
두 명령을 한 줄씩 실행하고 결과를 체크한다.
버전 번호가 예시와 다르다는 이유로 실패 처리하지 않는다.
두 버전 문자열이 모두 나온다.
공식 npm 명령으로 Claude Code를 설치한다.
npm install -g @anthropic-ai/claude-code 한 줄 전체를 복사해 실행하고 완료까지 기다린다.
5분 타이머를 사용하고 OS별 오류를 표식으로 분류한다.
명령을 분할하거나 설치 도중 터미널을 닫지 않는다. API 키 방식과 혼용하지 않는다.
오류 없이 프롬프트가 돌아오거나 설치 완료 출력이 보인다.
특정 Windows 오류에만 제한적으로 대응한다.
“스크립트를 실행할 수 없습니다”일 때 관리자 PowerShell에서 RemoteSigned를 설정하고 npm을 재확인한다.
오류 문구가 정확히 일치하는 학생만 절차를 진행한다.
모든 Windows PC의 정책을 일괄 변경하지 않는다. 기관 관리 PC에서는 담당자 승인을 받는다.
npm 사용법이 출력되는지 확인한다.
Claude Code 실행 화면에 진입한다.
claude를 실행하고 테마를 선택한다. 화면 문구는 버전에 따라 달라도 된다.
3분 타이머 후 성공 화면과 오류 화면을 나눈다.
claude 명령 없음은 설치 실패로 단정하기 전에 새 터미널을 열고 다시 확인한다.
Claude Code 환영 또는 로그인 화면이 보인다.
구독 계정 인증 절차를 안전하게 완료한다.
구독 계정 로그인 선택→브라우저 승인→필요 시 코드 입력→Login successful 순서다.
교수자는 화면만 안내하고 인증코드 입력은 학습자가 직접 한다.
인증코드·비밀번호·결제정보를 화면 공유, 채팅, 사진으로 노출하지 않는다.
Login successful을 본다.
폴더 신뢰를 경로 확인 행동과 연결한다.
방금 만든 실습 폴더만 신뢰하고 홈·다운로드처럼 넓은 폴더에서는 종료 후 새 폴더에서 재실행한다.
화면의 현재 경로를 소리 내어 읽고 신뢰 여부를 선택하게 한다.
“항상 1번”이라고 기계적으로 안내하지 않는다. 폴더 범위 밖 접근도 권한과 설정에 따라 달라질 수 있다.
실습 폴더 경로를 확인한 뒤에만 승인한다.
mkdir→cd→claude의 안전한 시작 습관을 형성한다.
세 명령을 각각 실행하고 프롬프트 경로가 my-first-app으로 바뀐 뒤 claude를 시작한다.
3분 타이머로 한 줄씩 실행시킨다.
세 줄을 한꺼번에 붙이지 않는다. 이미 폴더가 있으면 새 이름을 사용한다.
현재 경로에 my-first-app이 보인다.
자연어 지시와 실제 작업 과정의 관계를 관찰한다.
영어·코드 출력은 과정 표시이며 Error·Failed·Permission denied와 최종 결과는 별도 확인한다.
지시 후 “무엇을 만들려 하는지”를 완료 전에 예측하게 한다.
빠른 출력 자체를 성공으로 판단하지 않는다.
완료 보고와 실제 파일을 모두 확인한다.
허락 창을 승인 판단 훈련으로 사용한다.
1은 이번 한 번, 2는 세션 동안 유사 편집 허용, 3은 거절이다. 초보자는 1을 기본으로 한다.
각 선택지를 고를 상황을 짝과 한 가지씩 만든다.
권한 요청이 모든 행동에 항상 나타난다고 단정하지 않는다. 내용을 읽지 않고 2를 고르게 하지 않는다.
무엇을 하려는지 설명한 뒤 선택할 수 있다.
Code 결과가 내 PC의 실제 파일임을 확인한다.
ls로 index.html을 확인하고 브라우저에서 열어 결과와 수정 반영을 본다.
파일 존재→브라우저 표시→배경색 수정의 세 증거를 확인한다.
완료 보고만 보고 넘어가지 않는다.
index.html 존재와 수정 반영을 직접 확인한다.
CLAUDE.md를 자연어 규칙과 합격선의 저장소로 이해한다.
프로젝트 단위 지침이며 강제 잠금장치는 아니므로 반영 여부를 검증해야 한다.
반복해서 말하기 싫은 규칙 한 가지를 쓰게 한다.
개인 맞춤 설정과 완전히 동일하거나 규칙 준수를 보장한다고 설명하지 않는다.
규칙과 검증의 역할을 구분한다.
정산 앱용 독립 폴더를 준비한다.
split-bill을 만들고 이동한 뒤 정확한 현재 경로를 확인한다.
3분 타이머로 실행하고 ls로 필요시 확인한다.
기존 프로젝트와 섞지 않는다.
프롬프트 경로에 split-bill이 보인다.
OS별 텍스트 파일 저장 오류를 예방한다.
Windows는 모든 파일·UTF-8, macOS는 일반 텍스트·.md 유지가 핵심이다.
저장 후 파일 확장명을 직접 보이게 하고 짝 점검한다.
CLAUDE.md.txt, 서식 있는 문서, 다른 폴더 저장을 놓치지 않는다.
파일명이 정확히 CLAUDE.md이고 split-bill 안에 있다.
좋은 규칙에 기능·제약·합격선이 포함됨을 이해한다.
만들 것, 기능, 디자인·기술, 완성 체크리스트가 서로 다른 역할을 한다.
요구사항 하나를 어느 섹션에 넣을지 분류한다.
기능 목록만 길게 쓰고 검증 조건을 빼먹지 않는다.
각 섹션의 질문에 답할 수 있다.
원고의 상세 CLAUDE.md를 정확히 작성한다.
참여자·지출·정산·복사·저장, 375px, 단일 파일, 외부 라이브러리 금지, 8개 검증을 포함한다.
교수자는 전체 원문을 배포하고 저장 후 ls로 파일을 확인시킨다.
슬라이드 요약만 저장하게 하지 않는다. 실제 실습에는 원고의 전체 규칙이 필요하다.
전체 규칙과 테스트 데이터가 파일에 포함된다.
CLAUDE.md 기반 제작과 증거 요구를 경험한다.
프롬프트는 짧지만 규칙·제약·합격선은 파일에 있으므로 반복 작업을 유도할 수 있다.
15분 타이머, 5분 단위 진행 체크, 승인 요청은 한 번씩 읽게 한다.
학생 키보드를 대신 잡지 않는다. 무조건 세션 전체 허용을 권하지 않는다.
index.html과 검증 보고가 생성된다.
8개 합격 기준을 실제 동작으로 검증한다.
참여자·지출·정산·형식·자기송금·저장·복사·375px를 직접 확인한다.
짝을 바꿔 상대 앱을 체크하게 하고 실패 항목을 기록한다.
AI 보고를 증거로 갈음하지 않는다. 브라우저 오류는 화면 상황을 Claude에 전달한다.
8개 항목마다 통과·실패와 증거가 있다.
정산 알고리즘의 핵심 숫자를 사람 손으로 검증한다.
총 65,000원, 약 21,667원, 영희→민수 9,667원, 철수→민수 13,667원을 대조한다. 나머지 배분 규칙에 따라 합계가 보존되어야 한다.
계산 결과 합계와 자기 송금 여부를 검산한다.
반올림만으로 합계 불일치를 남기지 않는다. 표시값과 실제 부담액 규칙을 혼동하지 않는다.
송금 후 최종 부담액 합계가 총액과 일치한다.
수정 후 회귀 검증 습관을 형성한다.
한 기능 수정이 다른 기능을 깨뜨릴 수 있으므로 CLAUDE.md를 다시 읽고 전체 체크리스트를 재실행한다.
의도적인 작은 수정 후 8개 항목 전체 재검증을 요청한다.
수정한 항목 하나만 확인하고 끝내지 않는다.
재검증 보고와 직접 확인 결과가 일치한다.
특수 명령을 사용 시점과 연결한다.
/help, /clear, /compact, /usage, /init의 역할을 구분하며 새 빈 프로젝트에서는 직접 규칙 작성이 유리하다.
상황 카드를 읽고 적절한 명령을 고르게 한다.
/clear가 파일을 삭제한다고 설명하지 않는다. /compact 요약에서 세부가 빠질 수 있다.
각 상황에 맞는 명령을 선택한다.
사용량·중단·대상 지정을 안전 조작으로 익힌다.
/usage는 한도, Esc는 현재 작업 중단, @파일명은 대상 명시다. 중단해도 이미 변경된 파일은 자동 복구되지 않는다.
@index.html 예시를 실행하고 Esc 뒤 변경 파일 확인 질문을 연습한다.
Esc와 Ctrl+D, Ctrl+C를 혼동하지 않는다.
중단 후 변경 내역 확인과 복구 요청을 말할 수 있다.
도구 전환이 작업·저장·규칙·검증을 어떻게 바꿨는지 통합한다.
웹은 아티팩트·개인 맞춤·눈 확인, Code는 PC 파일·CLAUDE.md·체크리스트와 증거다.
비교표의 빈칸을 말로 채우게 한다.
Part 1을 열등한 방식으로 폄하하지 않는다. 용도 차이다.
네 비교 항목을 설명한다.
4장의 수행 기준을 개별 확인한다.
안전한 폴더 실행, 승인 판단, 파일 생성, 규칙 저장, 앱 제작, 숫자 검증, 재검증, 특수 조작을 확인한다.
완료하지 못한 항목에는 다음 행동과 지원자를 적게 한다.
설치 실패를 학습 실패로 낙인찍지 않는다. 오류 보존과 안전한 진단도 성취다.
최소·표준·확장 도달 수준을 판정한다.
규칙·울타리·승인·검증을 하네스의 씨앗으로 정리한다.
CLAUDE.md와 체크리스트는 이후 하네스 엔지니어링의 기반이며 5장에서 uv를 사용한 문서 자동화로 확장한다.
출구 티켓: 오늘 다시 혼자 할 수 있는 행동과 아직 도움이 필요한 행동을 하나씩 쓴다.
앱 결과만 칭찬하지 않고 안전한 승인과 검증 과정을 함께 인정한다.
학습자가 자신의 다음 연습 과제를 정한다.