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 (서울)인지 우측 상단에서 확인하세요.

워크샵 접속: Access AWS account 버튼으로 콘솔에 들어갑니다. Outputs 표에 두 접속용 URL(C4E, CCB)이 이미 보입니다.

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 키는 필요 없습니다.

실습용 EC2 2대: c4e-endpoint(Claude Enterprise)와 ccb-endpoint(Claude Code on Bedrock), 둘 다 Running.

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용 접속 주소입니다. 선택한 쪽 하나만 있으면 됩니다.

콘솔 상단의 CloudShell을 열어 위 커맨드 한 줄을 붙여 넣으면 두 URL이 출력됩니다.

지름길 Workshop Studio 팀 페이지의 Outputs 표에서도 같은 두 URL을 바로 복사할 수 있습니다. CloudShell 커맨드는 콘솔에서 다시 찾을 때의 방법입니다.

CHECKPOINT

두 EndpointUrl이 출력되었고 하나를 골랐습니다

CHECK 04

code-server 접속

1분

선택한 주소를 브라우저 새 탭에 붙여 넣으면 VS Code와 같은 화면이 열립니다.

주소 끝의 ?folder=/home/ec2-user가 시작 폴더를 지정합니다. 열리면 상단 메뉴에서 Terminal, New Terminal로 통합 터미널을 하나 띄워 두세요. 오늘 모든 랩이 이 화면 하나에서 진행됩니다.

접속 구조: CloudFront가 커스텀 헤더로 ALB(8888)를 지나 EC2의 code-server에 닿습니다. Claude Code는 이미 설치되어 있습니다.

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 미적용 세션	터미널을 닫고 새로 열기, 지속되면 브라우저 새로고침 후 재접속

Chapter 1, 설치부터 Headless 자동화까지

인증(Claude account with subscription 또는 Bedrock)과 첫 세션이 Chapter 1의 첫 Task입니다. 화면 캡처가 포함된 준비 원문은 Notion, Claude Code 워크샵 준비에서 볼 수 있습니다.

READING CHECK

이 페이지를 읽으셨나요?

읽음 표시는 실습 체크포인트와 별도로 관리됩니다. 아직 읽지 않음