×
Claude Code Deep Dive Workshop
Claude Code는 개인의 생산성 도구에서 팀의 개발 프로세스를 구성하는 요소로 자리를 옮기고 있습니다. 이 단계의 논의는 기능보다 운영에 가깝습니다. 어디까지 권한을 허용할지, 사용량과 비용을 어떤 지표로 파악할지, 검증된 방식을 어떻게 팀에 배포할지를 이틀에 걸쳐 순서대로 다룹니다.
Day 1은 개인 역량으로 첫 완결까지 가는 흐름입니다. 아키텍처 소개와 설치, 헤드리스 실행(Chapter 1)에서 시작해 역할별 서브에이전트(Chapter 2)를 익히고, managed-settings 기반의 정책 통제와 관측은 브리핑(Chapter 3)으로 지도를 잡습니다. 오후에는 캡스톤 라운드 1에서 게임, 미술관, 지진 워치 세 트랙 중 하나를 골라, 설계부터 개장과 공유까지 첫 완결을 경험합니다.
Day 2는 팀 플랫폼화와 AI 통합에 집중합니다. 훅과 스킬을 팀 자산으로 승격하고(Chapter 4), Claude Code를 파이프라인 구성 요소로 전환한 뒤(Chapter 5), Anthropic이 직접 전하는 Claude Code의 미래와 전략 세션에 이어 캡스톤 라운드 2에서 Bedrock 분석이 살아 있는 서비스(증시, 유튜브, 뉴스룸 렌즈 중 택 1)를 하네스 엔지니어링까지 얹어 완주합니다. 방금 쓴 토큰을 소재로 모델 라우팅과 메터링을 정리하며 이틀을 닫습니다. 이론과 실습을 같은 비중으로 배치했으며, 전 과정은 참가 조직의 환경과 과제에 맞추어 구성한 맞춤형 워크샵입니다.
교육 환경
개인 노트북 설정 차이로 실습이 막히지 않도록, 모든 참가자에게 동일한 EC2 인스턴스를 제공합니다. 별도 설치나 SSH 없이 브라우저로 code-server에 접속하면 사전에 설치된 Claude Code가 바로 준비되어 있습니다.
최신 브라우저만 있으면 충분합니다. 로컬에 아무것도 설치하지 않아도 되며, 접속 주소와 계정 정보는 현장에서 배부합니다.
1인 1인스턴스의 EC2에 브라우저로 접속합니다. VS Code와 같은 화면에서 편집기와 통합 터미널을 함께 쓰므로, 코드와 claude 세션을 나란히 두고 진행할 수 있습니다.
CLI와 플러그인이 미리 준비된 상태로 제공됩니다. 통합 터미널에서 claude를 실행하고 원하는 인증 경로만 고르면 첫 세션이 시작됩니다.
Anthropic Claude Enterprise 기반과 Amazon Bedrock 기반 중 원하는 경로를 골라 접속합니다. Chapter 1에서 두 경로를 나란히 비교하고, 조직 단위 통제와 비용 관측은 Chapter 3에서 다룹니다.
워크샵 환경에 Claude Fable 5, Claude Opus 5, Claude Sonnet 5 세 모델이 제공됩니다. 과제 성격에 맞춰 바꿔 쓰며 차이를 직접 체감합니다.
실습 중 질문과 트러블슈팅은 Slack에서 실시간으로 받습니다. 미리 참여해 두면 당일이 편합니다.
행사장 무선 접속 정보입니다. 대소문자와 특수문자를 그대로 입력하세요.
개인 역량으로 첫 완결
INTROClaude Code 아키텍처 소개
인사와 오리엔테이션 → 에이전트 루프 아키텍처 → 오늘의 지도
간단한 인사와 함께 구조부터 봅니다. 에이전트 루프가 맥락을 읽고 도구를 고르고 결과를 다시 판단하는 아키텍처를 이해하면, 이후의 모든 설정과 통제가 "어디에 손을 대는 것인지"로 읽힙니다. 이 지도를 손에 들고 이틀을 시작합니다.
CH 01Claude Code, 설치부터 Headless 자동화까지
설치와 인증 경로 → CLAUDE.md와 도구 시스템 → Plan 모드와 헤드리스
Claude Enterprise와 Bedrock 인증 경로를 비교하고, CLAUDE.md에 프로젝트의 맥락을 심으면 같은 질문의 답이 달라지는 이유를 봅니다. 실제 버그를 Plan 모드로 잡는 흐름과 같은 작업을 헤드리스 한 줄로 재현하는 패턴까지, 바로 이어지는 설치 랩에서 손으로 확인할 것들을 지도로 잡습니다.
LAB 1기본 환경 구성
설치와 인증 → 첫 세션과 CLAUDE.md → 헤드리스 한 줄 재현
방금 본 것을 그대로 손으로 만듭니다. 설치와 인증을 마치고 첫 세션을 열어 CLAUDE.md의 효과를 확인한 뒤, 대화 없이 실행되는 헤드리스 호출 한 줄까지. 여기서 굳힌 환경이 이틀 내내, 특히 오후 캡스톤 라운드 1의 발판이 됩니다.
CH 02Subagents, 전문 에이전트를 만들고 지휘하기 (LAB 1, 2)
개념과 격리 모델 → 정의 파일과 디스패치 → 실전 봇 5종 → Lab 2 커스텀 Subagent 작성과 실행
하나의 세션에 모든 일을 맡기면 맥락이 뒤섞입니다. Subagent는 역할별로 창을 나누고 도구 권한까지 격리하는 장치입니다. frontmatter 몇 줄로 code-reviewer, test-writer, docs-writer를 정의해 보고, 읽기만 허용된 에이전트가 파일을 고치려다 멈추는 순간을 직접 봅니다. 자동 위임과 @멘션 지목, 병렬 디스패치 세 패턴을 비교한 뒤 실전 봇 5종을 훑습니다. 정의 파일은 곧 커밋 가능한 자산이라, 여기서 만든 에이전트가 오후 캡스톤에서 그대로 일합니다.
CH 03Admin Setup 브리핑, 통제 가능한 Enterprise 배포
배포와 자격증명 → managed 정책과 관측 → 오후 캡스톤의 Bearer 키가 도는 자리
도입을 막는 질문은 대개 기능이 아니라 통제입니다. 1차 피드백을 반영해 이 챕터는 30분 브리핑으로 압축했습니다: 플릿 배포와 버전 통제, Bedrock IAM/SSO 자격증명, managed-settings 정책선과 OpenTelemetry 관측의 핵심 지도를 잡고, 상세 구축은 전체 자료와 후속 거버넌스 상담으로 안내합니다. 오후 캡스톤에서 쓰는 Bearer 키가 어느 통제선 안에서 도는지, 그 배경이 여기 있습니다.
LAB캡스톤 라운드 1, 오늘 배운 것으로 첫 완결 (Capstone 1, 3, 5)
① superpowers로 설계와 계획 → ② Phase 단위 빌드와 검증 → ③ 개장과 Slack 공유, 여유가 있다면 퀄리티 강화 라운드
Day 1의 마지막은 강의가 아니라 완결입니다. 세 갈래 중 하나를 골라 브레인스토밍에서 개장까지 달립니다: 게임(Clawd Jump 플랫포머, 로컬 완결), 미술관(제너러티브 아트 전시, 로컬 완결), 지진 워치(전 세계 실시간 지진 지도, Bedrock 브리핑과 CloudFront 실배포). 코딩 경험이 적다면 미술관 트랙을 권합니다, 어느 쪽이든 계획 → 실행 → 커밋의 완결 리듬은 같습니다. 마치면 내 작품의 URL과 스크린샷을 Slack에 공유합니다.
AI 통합으로 두 번째 완결
CH 04Settings, 나의 Claude Code를 팀의 플랫폼으로
설정 스코프와 권한 규칙 → Hooks와 MCP → 슈퍼랩 훅과 스킬을 팀 자산으로
개인의 설정을 팀의 플랫폼으로 승격시키는 시간입니다. 설정 계층과 권한 규칙을 정리하고, Hooks로 세션에 규율을 심고, 스킬과 MCP를 프로젝트 자산으로 만드는 슈퍼랩을 진행합니다. 여기서 만든 훅과 스킬이 오후 캡스톤 라운드 2의 하네스로 그대로 들어갑니다.
CH 05CLI Reference 핵심, Claude Code를 파이프라인 부품으로
-p 와 구조화 출력 → Lab 헤드리스 리뷰 봇 한 개 완주 → 데모 CI 통합(GitHub Actions, OIDC)
사람이 앉아 있어야 하는 도구는 자동화가 아닙니다. 1차 피드백을 반영해 핵심만 남겼습니다: -p와 --json-schema로 출력을 기계가 읽는 형태로 고정하고, 커밋 범위를 인자로 받는 리뷰 봇 하나를 끝까지 만듭니다. CI 통합과 세션 자동화의 확장은 데모와 자율 실습 자료로 제공하고, 팀 단위 심화는 후속 Advanced 워크샵에서 다룹니다.
SPECIALClaude Code의 미래와 전략, by Anthropic
로드맵과 방향 → 에이전틱 개발의 다음 단계 → Q&A
Anthropic이 직접 전하는 Claude Code의 미래와 전략입니다. 모델과 에이전트 하네스가 어디로 가는지, 오늘 배운 워크플로가 그 지도 위 어디에 있는지를 듣고, 질문으로 이어갑니다. 오후 캡스톤 라운드 2를 시작하기 전, 만드는 이유를 채우는 40분입니다.
LAB캡스톤 라운드 2, AI를 품은 두 번째 완결 (Capstone 2, 4, 6)
① superpowers로 설계와 계획 → ② Phase 단위 빌드와 검증 → ③ 개장과 Slack 공유, 여유가 있다면 퀄리티 강화 라운드
이틀의 학습을 전부 소환하는 라운드입니다. 세 갈래 중 하나를 골라 완주합니다: 풀 트랙 증시(SSE 스트리밍 대시보드), 유튜브(트렌드 레이더) 또는 2시간 트랙 뉴스룸 렌즈(키 발급 없음, CloudFront 실배포로 개장). 계획 → 실행 → 커밋을 반복해 완결하고, 결과 화면 또는 공개 URL을 Slack에 공유합니다.
FINOPS토큰을 효율적으로 쓰는 법, 모델 라우팅과 메터링
방금 쓴 토큰으로 보는 효율 패턴 → Opus / Sonnet / Haiku 라우팅 기준 → 데모 OpenTelemetry 수집과 대시보드
캡스톤을 막 마친 지금이 이 이야기를 하기 가장 좋은 순간입니다. 방금 여러분이 쓴 토큰을 소재로 캐싱이 유리해지는 지점과 과제 성격별 모델 선택 기준(Opus/Sonnet/Haiku)을 정리하고, OpenTelemetry로 세션과 팀 단위 사용량을 대시보드로 확인하는 과정을 데모로 보여 드립니다. 비용 논의의 기준을 체감에서 측정값으로 옮기는 30분입니다.
자율 실습과 참고 자료
Agent SDK, Claude Code를 코드에서 부른다
터미널의 에이전트 루프를 내 프로그램 안으로. query, resume 대화 메모리, 커스텀 도구. 자율 실습 트랙입니다.
랩 열기 → REF 1디렉토리 구조, 무엇이 어디에 있는가
~/.claude와 .claude, managed의 세 층 지도와 설정 우선순위, CLAUDE.md 계층 합산.
열기 → REF 2슬래시 커맨드, 세션을 조종하는 레버
작업 흐름, 병렬, 검수, 세션 이동, 상태로 묶은 선별 목록과 워크샵 등장 위치.
열기 → REF 3플러그인, 팀의 하네스를 배포하는 단위
설치 3동사와 워크샵 3종(superpowers, project-init, harness-eval)의 역할, 신뢰 가드.
열기 → PDF강의자료 PDF 전체
Chapter 1-5 슬라이드 PDF와 랩 문서 원본이 모여 있는 저장소 폴더입니다.
GitHub → DOC기타 Tech Doc
워크샵 본편 밖의 기술 문서 모음 (tech_doc 폴더).
GitHub →Hands-on Lab 포털 열기
챕터 랩 전체와 Capstone Mission 4종, Reference 3부작을 한 화면에서 진행 상황과 함께 관리합니다.
교육 후 설문
3분이면 충분합니다. 여러분의 한 줄이 다음 워크샵의 품질이 됩니다. 카메라로 QR을 비추거나 이 카드를 눌러 접속하세요.
설문 열기 →