macOS와 Windows 중에서 고릅니다
실습을 시작할 때 zsh와 PowerShell 중 쓰는 컴퓨터와 같은 쪽을 고릅니다. 나중에 상태바에서 바꿔도 가상 파일과 실습 진행은 그대로 남습니다.
macOS · zsh
student@lab roomie % ls -a
Windows · PowerShell
PS C:\Users\student\roomie> dir
Claude Code 실습용 가상 터미널
실수해도 되는 터미널.
~/roomie실습 초기화
터미널
student@lab roomie % claude
Claude Code v2.1.211
Welcome back, student!
Opus · Claude subscription
~/roomie
>메시지를 입력하거나 / 로 명령 보기
권한 모드 defaultmacOS · zsh저장됨한 / EN
실습 과정
설치부터 가드레일까지, 실습 여섯 개
실습마다 미션 패널이 단계를 하나씩 안내하고, 막히면 힌트를 보여 줍니다. 각 실습에서 직접 입력하게 되는 명령을 함께 적었습니다.
Lab 0설치와 첫 실행
운영체제에 맞는 설치 명령을 실행하고, 버전과 설치 상태를 확인한 뒤 처음으로 실행합니다.
claude --versionclaude doctor/status
Lab 1기본 조작: 규칙 파일·단축키·필수 명령
규칙 파일 CLAUDE.md 를 만들고, 자주 쓰는 단축키와 필수 명령을 손에 익힙니다.
/init/context/rewind
Lab 2컨텍스트 다루기
메모리와 문서 참조로 필요한 내용만 불러오고, 계획과 구현을 다른 대화로 나눕니다.
/memory/context/clear
Lab 3확장 기능: 스킬·서브에이전트·훅·MCP
스킬, 서브에이전트, 훅, MCP 서버를 직접 만들어 연결합니다.
/agents/hooks/mcp
Lab 4종합 과제: 요청 8건을 한 번에
plan mode 로 요청 8건을 묶어 계획을 세우고, 서브에이전트 병렬 실행과 PR 코드 리뷰를 거쳐 릴리스 노트까지 씁니다.
Shift+Tab/mcpdocs/plan-finals.md
Lab 5가드레일 세우기
권한 규칙, 훅 차단, 자동 검사로 실수가 코드에 들어가기 전에 막습니다.
/permissionspermissions.deny!npm test
이 서비스가 다른 점
설정 파일을 고치면 터미널의 동작이 바뀝니다
.claude/settings.json 같은 설정 파일을 고치고 저장하면, 다음 도구 호출부터 에뮬레이터가 그 설정대로 움직입니다. 규칙을 외우는 대신 바꿔 보고 결과를 확인합니다.
저장 전deny 규칙 없음
.claude/settings.json
1{
2 "permissions": {
3 "allow": [],
4 "deny": []
5 }
6}
>secrets 폴더의 키 파일 내용 보여 줘
Glob(pattern: "secrets/*")
⎿Found 1 file
Read(secrets/calendar-api.key)
⎿Read 1 lines
secrets/calendar-api.key 내용입니다:
lab-demo-calendar-key-0000 (fake value for the lab)
키 값이 그대로 대화에 들어왔습니다. 이런 읽기는 permissions.deny 로 막아 두는 편이 안전합니다.
저장 후deny 규칙 2개
.claude/settings.json저장됨
1{
2 "permissions": {
3 "allow": [],
4+ "deny": [
5+ "Read(./secrets/**)",
6+ "Bash(rm -rf *)"
7+ ]
8 }
9}
>secrets 폴더의 키 파일 내용 보여 줘
Glob(pattern: "secrets/*")
⎿Found 1 file
Read(secrets/calendar-api.key)
⎿Permission to use Read on secrets/calendar-api.key has been denied by a deny rule (Read(./secrets/**) · .claude/settings.json).
설정의 deny 규칙(Read(./secrets/**))이 이 작업을 막았습니다. 규칙을 바꾸지 않는 한 secrets/calendar-api.key 에는 접근하지 않겠습니다.
Lab 5 가드레일 세우기의 5-4 단계에서 이 장면을 직접 만듭니다. 키 값은 실습용 가짜 값입니다.
진행 상황은 계정에 자동으로 저장됩니다
실습 진행 기록과 가상 파일이 가입한 계정에 저장됩니다. 실습실에서 하다 멈춰도 다른 기기에서 로그인하면 이어서 할 수 있습니다.
실습실 PC내 노트북같은 단계에서 이어 하기
진행 방식
가입하고, 환경을 고르고, 미션을 따라 합니다
- 1 / 3
가입하기
이름, 학교, 이메일, 비밀번호를 입력하고 교수자와 학습자 중 역할을 골라 계정을 만듭니다. 진행 상황이 이 계정에 저장됩니다.
- 2 / 3
환경 고르기
평소 쓰는 컴퓨터와 같은 터미널 환경을 고릅니다. 설치 명령과 프롬프트가 그 환경에 맞게 바뀝니다.
- 3 / 3
미션 따라 하기
미션 패널이 알려 주는 단계를 하나씩 입력합니다. 막히면 힌트를 열고, 단계를 마치면 다음 단계로 넘어갑니다.
교사용
수업에서 이렇게 씁니다
학생들은 각자 브라우저에서 같은 실습을 진행합니다. 실제 AI를 호출하지 않으므로 학생별 API 키나 사용 요금을 준비하지 않아도 됩니다.
학생마다 자기 계정
학생이 각자 이메일로 가입하고, 진행 기록과 가상 파일은 계정별로 따로 저장됩니다.
실습 가이드 슬라이드
실습 순서를 따라가는 가이드 슬라이드를 함께 제공합니다. 수업 화면에 띄워 놓고 같이 진행할 수 있습니다.
설치 없이 브라우저만
실습실 PC에 아무것도 설치하지 않습니다. 브라우저에서 로그인하면 바로 시작합니다.
자주 묻는 질문
시작하기 전에 많이 묻는 것
- 실제 Claude Code가 내 컴퓨터에 설치되나요?
- 아니요, 연습 환경입니다. 설치 명령부터 브라우저 안의 가상 터미널과 가상 파일시스템에서 실행하므로, 내 컴퓨터의 파일이나 설정은 바뀌지 않습니다.
- 요금이 드나요?
- 가입하면 무료로 시작할 수 있습니다. 실습 중에는 실제 AI나 외부 API를 호출하지 않아 사용량에 따른 요금이 생기지 않고, 같은 실습을 여러 번 다시 해도 마찬가지입니다.
- 진행 상황은 어디에 저장되나요?
- 가입한 계정에 자동으로 저장됩니다. 실습 진행 기록과 가상 파일이 함께 저장되므로 다른 기기에서 로그인해도 이어서 할 수 있습니다.
- 실제 환경과 무엇이 다른가요?
- 응답은 실습 시나리오에 맞춰 미리 정해 둔 시뮬레이션입니다. 실습에서 다루는 명령과 요청에는 실제와 비슷하게 반응하지만, 실습 밖의 자유로운 질문에 AI처럼 답하지는 않습니다. 설정 파일을 고친 내용은 동작에 그대로 반영됩니다.
- 탈퇴하면 기록은 어떻게 되나요?
- 계정, 실습 진행 기록, 저장된 가상 파일이 모두 삭제되며 되돌릴 수 없습니다.