Preflight. 시작 전 확인
HANDS-ON LAB / PREFLIGHT CHECK
Chapter 1을 열기 전, 5분 프리플라이트
실습 환경이 켜져 있고 브라우저로 닿는지만 확인하면 준비 끝입니다. 아래 다섯 항목을 순서대로 체크하세요. 전부 초록이 되면 그대로 Chapter 1로 진입합니다.
소요 시간 5분 · 확인 항목 5개 · 환경 Workshop Studio + EC2 code-server · Update 2026.07
CHECK 01 · 워크샵 접속 (1분)
배부받은 Workshop Studio 이벤트 링크로 접속해 AWS 콘솔이 열리는 것까지 확인합니다.
이벤트 접속 코드는 현장에서 배부됩니다. 접속 후 좌측 메뉴의 콘솔 열기로 AWS Management Console에 들어가면 이 계정이 오늘 하루 여러분의 실습 계정입니다. 리전은 ap-northeast-2 (서울)인지 우측 상단에서 확인하세요.
CHECKPOINT
- Workshop Studio로 AWS 콘솔이 열렸고 리전이 서울이다
CHECK 02 · 실습용 EC2 2대 확인 (1분)
실습을 위해 EC2 2대가 활성화되어 있습니다. EC2 콘솔에서 두 인스턴스가 실행 중인지 확인하세요.
| 인스턴스 | 역할 | 모델 경로 |
|---|---|---|
| Claude Enterprise용 EC2 | Claude Enterprise 라이센스를 활성화해서 사용 | Anthropic 1P |
| Claude Code on Bedrock용 EC2 | Anthropic 직접 호출 대신 Amazon Bedrock 기반의 Claude 모델을 호출 | Amazon Bedrock 3P |
택 1, 그리고 직접 접속 금지
두 경로 중 개인 선호에 따라 하나를 선택하면 됩니다. 이 랩에서는 EC2에 직접 접속하지 않고, EC2에 사전 배포된 **VSCode Server(code-server)**를 브라우저로 호출합니다. SSH 키는 필요 없습니다.
CHECKPOINT
- EC2 콘솔에서 두 인스턴스가 실행 중이다
CHECK 03 · 접속 주소 확인 (1분)
CloudShell에서 한 줄로 두 접속 주소를 뽑습니다. 콘솔 상단의 터미널 아이콘이 CloudShell입니다.
CloudShell, 전체 복사
echo "C4EEndpointUrl: $(aws cloudformation describe-stacks --stack-name vscode-server --query "Stacks[0].Outputs[?OutputKey=='C4EEndpointUrl'].OutputValue" --output text)" && echo "CCBEndpointUrl: $(aws cloudformation describe-stacks --stack-name vscode-server --query "Stacks[0].Outputs[?OutputKey=='CCBEndpointUrl'].OutputValue" --output text)"
출력 예시
C4EEndpointUrl: https://dre8s36xxxxx.cloudfront.net/?folder=/home/ec2-user CCBEndpointUrl: https://d3f4g87xxxxx.cloudfront.net/?folder=/home/ec2-user
C4EEndpointUrl은 Claude Enterprise용, CCBEndpointUrl은 Claude Code on Bedrock용 접속 주소입니다. 선택한 쪽 하나만 있으면 됩니다.
지름길
Workshop Studio 팀 페이지의 Outputs 표에서도 같은 두 URL을 바로 복사할 수 있습니다. CloudShell 커맨드는 콘솔에서 다시 찾을 때의 방법입니다.
CHECKPOINT
- 두 EndpointUrl이 출력되었고 하나를 골랐다
CHECK 04 · code-server 접속 (1분)
선택한 주소를 브라우저 새 탭에 붙여 넣으면 VS Code와 같은 화면이 열립니다.
주소 끝의 ?folder=/home/ec2-user가 시작 폴더를 지정합니다. 열리면 상단 메뉴에서 Terminal, New Terminal로 통합 터미널을 하나 띄워 두세요. 오늘 모든 랩이 이 화면 하나에서 진행됩니다.
CHECKPOINT
- code-server가 열렸고 통합 터미널이 떠 있다
CHECK 05 · Claude Code 기동 확인 (1분)
터미널에서 Claude Code가 설치되어 응답하는지만 확인합니다. 인증과 첫 세션은 Chapter 1에서 합니다.
Terminal, 전체 복사
claude --version
출력 예시
2.1.x (Claude Code)
CHECKPOINT
- 버전이 출력되었다, 프리플라이트 완료
다음 단계
다섯 칸이 전부 초록이면 이륙 허가입니다.
| 증상 | 원인 | 처방 |
|---|---|---|
| EndpointUrl이 빈 값 | 스택 이름 또는 리전 불일치 | 리전 ap-northeast-2 확인 후 스택 이름 vscode-server로 재실행 |
| CloudFront 주소가 안 열림 | 배포 직후 전파 지연 | 2~3분 뒤 새로고침, 그래도 안 되면 다른 EndpointUrl로 교차 확인 |
| 터미널에 claude가 없음 | PATH 미적용 세션 | 터미널을 닫고 새로 열기, 지속되면 브라우저 새로고침 후 재접속 |
NEXT
Chapter 1, 설치부터 Headless 자동화까지
인증(Claude account with subscription 또는 Bedrock)과 첫 세션이 Chapter 1의 첫 Task입니다. 화면 캡처가 포함된 준비 원문은 Notion, Claude Code 워크샵 준비 에서 볼 수 있습니다.
이전 / 다음
← Chapter Hands-on Labs · Ch1. 설치와 Headless 자동화 →
원문: Claude Code Deep Dive Workshop · Preflight. 시작 전 확인 · 기준: 2026.07