2026년 8월 10–11일 진행된 Claude Code Deep Dive Workshop(Anthropic × AWS)의 참가자 노트입니다. 커리큘럼의 구조와 각 세션이 무엇을 다루는지를 제가 다시 정리한 것이고, 실습을 따라가며 남긴 메모를 덧붙입니다.
Important
공식 워크샵 자료가 아닙니다. 강의자료·핸즈온 랩 원문의 저작권은 주최 측과 원저작자에게 있습니다. 이 저장소에는 원문을 옮겨 담지 않고, 직접 작성한 요약과 개인 메모만 둡니다. 원문은 아래 출처를 참고하세요.
Claude Code를 설치하고 → 자동화 부품으로 만들고 → 하나의 서비스 팀원으로 승격시키는 이틀.
이 단계의 논의는 기능보다 운영에 가깝습니다.
- 어디까지 권한을 허용할 것인가
- 사용량과 비용을 어떤 지표로 파악할 것인가
- 검증된 방식을 어떻게 팀에 배포할 것인가
| Day 1 — 8/10(월) | Day 2 — 8/11(화) | |
|---|---|---|
| 부제 | 개인 역량으로 첫 완결 | AI 통합으로 두 번째 완결 |
| 층위 | 개인 도구 | 팀 플랫폼 → 조직 비용 |
| 세션 | INTRO · Ch1 · Ch2 · Ch3 | Ch4 · Ch5 · 초청 세션 · FinOps |
| 캡스톤 | 라운드 1 · 135분 · Bedrock 미사용 | 라운드 2 · 170분 · Bedrock 분석 포함 |
| 강의 : 실습 | 105분 : 165분 | 190분 : 170분 |
| 남기는 것 | CLAUDE.md · Subagent 정의 · 완결 경험 |
훅·스킬 킷 · 리뷰 봇 · 비용 기준 |
타임테이블
| 시각 | 분량 | 구분 | 세션 |
|---|---|---|---|
| 10:00–10:30 | 30분 | 강의 | INTRO — Claude Code 아키텍처 |
| 10:30–11:15 | 45분 | 강의 | Ch 1 — 설치부터 Headless 자동화까지 |
| 11:15–11:45 | 30분 | LAB | Lab 1 — 기본 환경 구성 |
| 11:45–13:00 | 75분 | — | 점심 |
| 13:00–14:25 | 85분 | 강의+LAB | Ch 2 — Subagents |
| 14:25–14:40 | 15분 | — | Break |
| 14:40–15:10 | 30분 | 브리핑 | Ch 3 — Admin Setup |
| 15:10–15:20 | 10분 | — | Break |
| 15:20–17:35 | 135분 | 캡스톤 | Round 1 — 게임 / 미술관 택 1 |
| 17:35–18:00 | 25분 | — | 쇼케이스 · 랩업 |
| 세션 | 흐름 | 핵심 |
|---|---|---|
| INTRO | 오리엔테이션 → 에이전트 루프 → 오늘의 지도 | 루프가 맥락을 읽고 → 도구를 고르고 → 결과를 판단하는 구조를 잡으면, 이후 모든 설정이 "어디에 손을 대는 것인지"로 읽힌다 |
| Ch 1 | 설치·인증 → CLAUDE.md와 도구 → Plan 모드·Headless |
프로젝트 맥락을 심으면 같은 질문의 답이 달라진다. 대화로 한 일을 헤드리스 한 줄로 재현 |
| Ch 2 | 격리 모델 → 정의 파일·디스패치 → 실전 봇 | Subagent는 역할별로 창을 나누고 도구 권한까지 격리하는 장치. 읽기만 허용된 에이전트가 파일을 고치려다 멈추는 순간을 직접 본다 |
| Ch 3 | 배포·자격증명 → managed 정책 → 관측 | 도입을 막는 질문은 대개 기능이 아니라 통제다 |
| 캡스톤 R1 | 설계 → Phase 빌드·검증 → 개장·공유 | Day 1의 마지막은 강의가 아니라 완결 |
00 사전 준비 확인 2분
01 설치 및 검증 (Node 18+) 6분
02 인증 설정 5분 ← Enterprise / Bedrock 택 1
03 프로젝트 준비와 첫 세션 7분
04 CLAUDE.md 작성 8분
05 디버깅 시나리오와 Plan 모드 8분
06 Headless 자동화 4분
01 첫 Subagent: code-reviewer 8분
02 도구 권한 격리 체험 6분
03 에이전트 3종 완성 7분 ← test-writer, docs-writer
04 Task 디스패치 3패턴 10분 ← 자동 위임 / @멘션 / 병렬
05 Headless 통합과 CI 맛보기 7분
정의 파일은 곧 커밋 가능한 자산이다. 여기서 만든 에이전트가 오후 캡스톤에서 그대로 일한다.
| Press Start | Frame It | |
|---|---|---|
| 만드는 것 | 마스코트 Clawd의 플랫포머 게임 | 제너러티브 아트 2점으로 여는 전시 |
| 분량 | 135분 | 120분 |
| 진짜 주제 | 요구사항이 눈에 보인다 — 화면이 즉시 답을 준다 | 추상이 태어나는 순간 — 두 번째 작품이 도착할 때 공통 계약을 추출 |
| Bedrock | 미사용 | 미사용 |
타임테이블
| 시각 | 분량 | 구분 | 세션 |
|---|---|---|---|
| 10:00–10:10 | 10분 | — | 리캡 |
| 10:10–11:20 | 70분 | 강의+LAB | Ch 4 — Settings, 팀의 플랫폼으로 |
| 11:20–12:10 | 50분 | 강의+LAB | Ch 5 — CLI, 파이프라인 부품으로 |
| 12:10–13:10 | 60분 | — | 점심 |
| 13:10–13:50 | 40분 | 초청 | Claude Code의 미래와 전략 (Anthropic) |
| 14:00–16:50 | 170분 | 캡스톤 | Round 2 — 증시 / 유튜브 택 1 |
| 17:00–17:30 | 30분 | 강의+데모 | FinOps — 모델 라우팅과 메터링 |
| 17:30–18:00 | 30분 | — | 쇼케이스 · 클로징 |
| 세션 | 핵심 |
|---|---|
| Ch 4 · Settings | 개인 설정을 팀 플랫폼으로 승격. Part A(설정 계층·권한 규칙·Hooks·MCP) + Part B 슈퍼랩. 슈퍼랩의 규칙은 하나 — 파일을 손으로 짜지 말고 Claude에게 시켜서 만들 것 |
| Ch 5 · CLI | 사람이 앉아 있어야 하는 도구는 자동화가 아니다. -p와 구조화 출력으로 결과를 기계가 읽는 형태로 고정하고, 리뷰 봇 하나를 끝까지 만든다 |
| 초청 세션 | 모델과 에이전트 하네스가 어디로 가는지. 캡스톤 전에 만드는 이유를 채우는 40분 |
| 캡스톤 R2 | 이틀을 전부 소환. Bedrock 분석이 서비스의 심장에 들어간다 |
| FinOps | 방금 쓴 토큰을 소재로, 비용 논의의 기준을 체감에서 측정값으로 |
| Market Desk | Trend Radar | |
|---|---|---|
| 만드는 것 | 웹 시황 대시보드 | 급상승 30 트렌드 레이더 |
| 스택 | FastAPI + React + 차트 | 수집기 + 스냅샷 스토어 + 레이더 |
| AI 호출 | Bedrock 분석을 SSE 스트리밍 | Bedrock을 REST로 직접 |
| 배운 개념 | 캐시 single-flight · 폴링 vs 스트리밍 | 멱등 스냅샷 · 기준선이 정보를 만든다 |
개인 노트북 설정 차이로 실습이 막히지 않도록, 참가자마다 동일한 EC2 인스턴스가 제공됩니다.
브라우저 ──▶ CloudFront ──▶ ALB ──▶ EC2 : code-server
└─ Claude Code 사전 설치
| 항목 | 내용 |
|---|---|
| 사전 준비물 | 최신 브라우저만. 로컬 설치 없음, SSH 키 없음 |
| 접속 | 브라우저에서 code-server — VS Code와 같은 화면, 편집기 + 통합 터미널 |
| 모델 접근 | Claude Enterprise 또는 Amazon Bedrock 중 택 1 |
| 리전 | ap-northeast-2 |
| 기준 버전 | Claude Code 2.1.x |
브라우저에서 로컬 서버 미리보기
캡스톤에서 띄운 서버의 localhost는 EC2의 localhost라 내 노트북에서 열리지 않습니다.
code-server의 포트 프록시를 씁니다.
https://<code-server-주소>/proxy/8000/
↑ 끝 슬래시를 빠뜨리면 열리지 않습니다
실습을 따라가며 남긴 개인 메모입니다. 진행에 따라 채워 넣습니다.
이 저장소의 정리는 아래 공식 자료를 읽고 직접 작성한 것입니다. 원문의 저작권은 주최 측과 원저작자에게 있으며, 본 저장소는 원문을 재배포하지 않습니다.
- Hands-on Lab 포털 — https://whchoi98.github.io/ccw-hands-on-lab/index.html
- 세션 소개 / 아젠다 — https://whchoi98.github.io/ccw-hands-on-lab/eDM.html
- 강의자료 저장소 — https://github.com/whchoi98/claude-code-workshop
- Claude Code 공식 문서 — https://docs.claude.com/en/docs/claude-code
이 저장소에 담긴 제가 작성한 노트는 CC BY 4.0으로 공유합니다. 인용된 세션 제목·구성 등 워크샵 자체의 정보는 원저작자에게 권리가 있습니다.
참가 노트 · 공식 자료 아님 · 2026.08