CHECK 01
워크샵 접속
1분배부받은 Workshop Studio 이벤트 링크로 접속해 AWS 콘솔이 열리는 것까지 확인합니다.
이벤트 접속 코드는 현장에서 배부됩니다. 접속 후 좌측 메뉴의 콘솔 열기로 AWS Management Console에 들어가면
이 계정이 오늘 하루 여러분의 실습 계정입니다. 리전은 ap-northeast-2 (서울)인지 우측 상단에서 확인하세요.
CHECKPOINT
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
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
CHECK 04
code-server 접속
1분선택한 주소를 브라우저 새 탭에 붙여 넣으면 VS Code와 같은 화면이 열립니다.
주소 끝의 ?folder=/home/ec2-user가 시작 폴더를 지정합니다. 열리면 상단 메뉴에서
Terminal, New Terminal로 통합 터미널을 하나 띄워 두세요. 오늘 모든 랩이 이 화면 하나에서 진행됩니다.
CHECKPOINT
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 미적용 세션 | 터미널을 닫고 새로 열기, 지속되면 브라우저 새로고침 후 재접속 |