×
Claude Code Deep Dive Workshop
Claude Code는 개인의 생산성 도구에서 팀의 개발 프로세스를 구성하는 요소로 자리를 옮기고 있습니다. 이 단계의 논의는 기능보다 운영에 가깝습니다. 어디까지 권한을 허용할지, 사용량과 비용을 어떤 지표로 파악할지, 검증된 방식을 어떻게 팀에 배포할지를 이틀에 걸쳐 순서대로 다룹니다.
Day 1은 개인 환경에서 조직 표준으로 확장하는 흐름입니다. 아키텍처와 설치, 헤드리스 실행(Chapter 1)에서 시작해 역할별 서브에이전트(Chapter 2), managed-settings 기반의 정책 통제와 OpenTelemetry 관측(Chapter 3), 스킬과 플러그인 형태의 팀 스타터 킷 배포(Chapter 4)로 이어집니다.
Day 2는 자동화와 측정, 통합에 집중합니다. Chapter 5에서 Claude Code를 파이프라인 구성 요소로 전환하고, 토큰 효율과 메터링을 강의와 데모로 다룬 뒤, 오후 캡스톤에서 이틀간의 결과물로 실제 접속 가능한 서비스를 배포하고 하네스 엔지니어링까지 적용해 봅니다. 이론과 실습을 같은 비중으로 배치했으며, 전 과정은 참가 조직의 환경과 과제에 맞추어 구성한 맞춤형 워크샵입니다.
교육 환경
개인 노트북 설정 차이로 실습이 막히지 않도록, 모든 참가자에게 동일한 EC2 인스턴스를 제공합니다. 별도 설치나 SSH 없이 브라우저로 code-server에 접속하면 사전에 설치된 Claude Code가 바로 준비되어 있습니다.
최신 브라우저만 있으면 충분합니다. 로컬에 아무것도 설치하지 않아도 되며, 접속 주소와 계정 정보는 현장에서 배부합니다.
1인 1인스턴스의 EC2에 브라우저로 접속합니다. VS Code와 같은 화면에서 편집기와 통합 터미널을 함께 쓰므로, 코드와 claude 세션을 나란히 두고 진행할 수 있습니다.
CLI와 플러그인이 미리 준비된 상태로 제공됩니다. 통합 터미널에서 claude를 실행하고 원하는 인증 경로만 고르면 첫 세션이 시작됩니다.
Anthropic Claude Enterprise 기반과 Amazon Bedrock 기반 중 원하는 경로를 골라 접속합니다. Chapter 1에서 두 경로를 나란히 비교하고, 조직 단위 통제와 비용 관측은 Chapter 3에서 다룹니다.
이틀간 세 모델을 과제 성격에 맞춰 바꿔 쓰며 차이를 직접 체감합니다.
실습 중 질문과 트러블슈팅은 Slack에서 실시간으로 받습니다. 미리 참여해 두면 당일이 편합니다.
Slack 채널 열기 →
현장에서는 QR로 바로 초대 링크에 참여할 수 있습니다.
행사장 무선 접속 정보입니다. 대소문자와 특수문자를 그대로 입력하세요.
개인 환경에서 조직 표준으로
CH 01Claude Code, 아키텍처 소개와 설치부터 Headless 자동화까지
10:10 개요와 아키텍처 → 11:00 설치와 인증, 도구 시스템 → Lab 1 설치와 첫 세션
먼저 아키텍처를 봅니다. 에이전트 루프가 맥락을 읽고 도구를 고르고 결과를 다시 판단하는 구조를 이해하면, 이후 모든 설정과 통제가 "어디에 손을 대는 것인지"로 읽힙니다. 그 지도를 손에 든 뒤 설치와 인증으로 넘어가 Claude Enterprise와 Bedrock 경로를 비교하고, CLAUDE.md에 프로젝트의 맥락을 심어 같은 질문의 답이 달라지는 것을 확인합니다. 마지막으로 실제 버그를 Plan 모드로 잡은 뒤 같은 작업을 헤드리스 한 줄로 재현합니다.
산출물동작 구조에 대한 이해, 인증이 완료된 실습 환경, 대화 없이 실행되는 첫 자동화 파이프라인
CH 02Subagents, 전문 에이전트를 만들고 지휘하기
개념과 격리 모델 → 정의 파일과 디스패치 → 실전 봇 5종 → Lab 2 커스텀 Subagent 작성과 실행
하나의 세션에 모든 일을 맡기면 맥락이 뒤섞입니다. Subagent는 역할별로 창을 나누고 도구 권한까지 격리하는 장치입니다. frontmatter 몇 줄로 code-reviewer, test-writer, docs-writer를 정의해 보고, 읽기만 허용된 에이전트가 파일을 고치려다 멈추는 순간을 직접 봅니다. 자동 위임과 @멘션 지목, 병렬 디스패치 세 패턴을 비교한 뒤 실전 봇 5종을 훑습니다. 정의 파일은 곧 커밋 가능한 자산이라, 여기서 만든 에이전트가 Chapter 4의 팀 킷으로 그대로 들어갑니다.
산출물저장소에서 곧바로 동작하는 전문 서브에이전트 3종
CH 03Admin Setup, 통제 가능한 Enterprise 배포
플릿 배포와 버전 통제 → 자격증명 → 게이트웨이와 네트워크 → managed 정책과 관측, 비용 통제
도입을 막는 질문은 대개 기능이 아니라 통제입니다. 이 챕터는 관리자의 관점으로 시선을 옮깁니다. 사내 npm 미러로 배포 경로와 버전을 통제하고, Bedrock IAM과 SSO로 자격증명을 조직 체계에 편입시키고, 프록시와 PrivateLink로 트래픽 경로를 정리합니다. managed-settings로 사용자가 되돌릴 수 없는 정책선을 긋고, DLP Hook으로 시크릿 유출을 차단한 뒤 OpenTelemetry로 사용량과 비용을 관측 대상으로 만듭니다.
산출물조직 단위 배포와 통제 방안을 설명할 수 있는 설계안
CH 04Settings, 나의 Claude Code를 팀의 플랫폼으로
설정 스코프와 권한 규칙 → Hooks와 MCP → LAB 커스텀 커맨드와 스킬, 통합 자유 실습
혼자 쓸 때 편했던 설정은 팀에 그대로 옮기면 충돌합니다. settings.json의 user / project / managed 세 스코프가 어떻게 겹치고 누가 이기는지 실험으로 확인하고, allow / deny / ask 권한 규칙을 세 단계로 대조합니다. Hooks로 편집 직후 검사를 자동으로 걸고, MCP 서버를 붙여 외부 시스템을 도구로 편입시킵니다. 마지막 랩의 규칙은 하나입니다 - 파일을 손으로 짜지 말고 Claude에게 시켜서 팀 스타터 킷을 만드는 것. 완성된 킷은 플러그인으로 묶어 배포하면 동료는 설치 한 줄로 같은 환경을 갖습니다.
산출물커밋해 동료에게 그대로 전달할 수 있는 팀 표준 설정 한 세트
자동화와 측정, 그리고 통합
CH 05CLI Reference, Claude Code를 파이프라인 부품으로
플래그 지도 → Headless와 구조화 출력 → 세션 관리와 자동화 표면 → CI 통합 → Lab 1-2 Headless 자동화 파이프
사람이 앉아 있어야 하는 도구는 자동화가 아닙니다. 이 챕터는 대화 도구를 부품으로 바꿉니다. -p와 --json-schema로 출력을 기계가 읽을 수 있는 형태로 고정하고, 커밋 범위를 인자로 받는 리뷰 봇 스크립트를 만들고, 여러 호출 결과를 CSV와 HTML 대시보드로 엮습니다. resume과 Routines, Deep Link로 세션을 다시 불러오는 법을 익힌 뒤 GitHub Actions와 OIDC로 CI에 연결합니다.
산출물PR 단위로 자동 실행되는 리뷰 워크플로와 헤드리스 호출 패턴
토큰을 효율적으로 쓰는 법, 메터링 & 모니터링
토큰 효율 패턴 → 캐싱과 모델 선택 → 데모 OpenTelemetry 수집과 대시보드
같은 결과를 더 적은 토큰으로 얻는 습관에는 패턴이 있습니다. 어떤 맥락을 상주시키고 무엇을 스킬로 밀어낼지, 캐싱이 유리해지는 지점은 어디이고 과제 성격에 따라 어떤 모델을 고를지 정리한 뒤, OpenTelemetry로 세션과 팀 단위 사용량을 수집하고 대시보드로 확인하는 과정을 데모로 보여 드립니다. 비용 논의의 기준을 체감에서 측정값으로 옮기는 45분이며, 여기서 다루는 관측 구조가 그대로 조직 운영 지표가 됩니다.
산출물사용량과 비용을 근거와 함께 설명할 수 있는 관측 구성 방안
CAPSTONE여섯 챕터를 하나의 작품으로
① superpowers로 설계와 계획 → ② Phase 단위 빌드와 검증 → ③ 개장, 배포 또는 시연과 Slack 공유
마지막 반나절은 앞선 챕터에서 익힌 것을 전부 꺼내 쓰는 시간입니다. 세 갈래 중 하나를 골라 완주합니다: 게임(Clawd Jump 플랫포머), 증시(터미널 시황 데스크), 미술관(제너러티브 아트 전시). 어느 쪽이든 브레인스토밍에서 개장까지 같은 리듬이고, 마지막에는 내 작품의 URL과 스크린샷을 Slack에 공유합니다.
산출물직접 설계하고 배포한, 접속 가능한 서비스 한 건
자율 실습과 참고 자료
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을 비추거나 이 카드를 눌러 접속하세요.
설문 열기 →