Video summary

[전체강의 통합본] 클로드 코드 2시간 안에 마스터하기 | 입문→실전→심화 완전 정복 (풀버전)

Main summary

Key takeaways

Technology

핵심 기술 개념/제품 기능 요약 (Claude Code 강의)

1) 프로젝트 루트 기반 실행 + claude.md(컨텍스트 파일) 설계

  • Claude Code 실행 위치: 반드시 프로젝트 루트(root) 에서 실행
    • 이유: Claude가 현재 디렉터리 기준으로 파일/프로젝트 구조를 탐색하므로, 다른 위치에서 실행하면 구조 탐색·검색·플랜 수립이 비효율/오류 가능.
  • init(Init): 실행 시 clod.md(강의 문맥상 “Claude/CLUDD MD”) 파일 생성.
  • Claude의 동작 원리(중요 분석)
    • Claude는 프로젝트의 파일들을 읽고, 그 뒤 플랜을 세우거나 작업을 수행.
    • 프로젝트가 커질수록 매번 파일을 읽으며 토큰을 많이 소비 → 이를 줄이기 위해 프로젝트 규칙/아키텍처/명령 등을 한 파일(claude.md/cludd.md)에 정리.
  • claud/cludd.md 구성 권장(템플릿 요소)
    • 최상단 절대 규칙(절대 금지/필수)
    • 아키텍처 설명(트리/텍스트 구조)
    • 빌드/테스트 명령
    • 도메인 컨텍스트(예: 제품의 color/size/inventory)
    • 코딩 컨벤션(예: 컴포넌트 PascalCase)
    • 핵심 패턴(예: server/client 사용 규칙, API 에러 통합 등)
  • 파일 크기/토큰 관리 전략
    • root claude.md는 300자(300 chars) 이내로 유지 권장.
    • 커지면 하위 폴더별로 별도 claude.md 분리(예: API용, Web용, Supabase용 등)
    • root 파일에는 각 폴더 md를 참조(reference) 형태로 연결해 “필요할 때만” 로딩되도록 설계.

2) 트리거 키워드 → 커스텀 Slash Command로 자동화(모듈화)

  • md에서 트리거 키워드(예: commit/push 일련 작업)를 등록하면, 특정 키워드가 감지될 때 정해진 단계가 한 번에 실행됨.
  • 더 발전된 방식: 트리거를 Slash command로 변환
    • Commands/ 폴더와 *.md 커스텀 파일 생성
    • 예: “테스트 → 실패 시 중단 → 통과 시 commit/push/deploy → 결과 출력”
  • Slash command의 장점
    • 탭 자동완성 지원
    • Claude Code가 이를 구조적으로 인식해서 트리거 키워드보다 더 안정적
      • 강의에서 “architecture infrastructure” 관점 강조
  • 반복 작업(리뷰/배포 등)은 Slash command로 모듈화하면 생산성 상승.

3) Plan Mode / Accept Mode (Shift+Tab), 토큰 최적화와 정확도

  • Shift+Tab: Flat/Accept/Plan 모드 전환 중 Plan mode로 이동.
  • Plan mode 동작
    • Claude가 파일 수정 권한이 없어서, “테스트/코드 생성”을 계획(구조/케이스/단계)만 먼저 세움.
    • 이후 Accept 모드로 전환되면 실제 생성/실행.
  • 이유(분석)
    • 불필요한 코드 생성 방지 → 토큰 절약
    • “계획을 세우고 그 계획으로 생성”하면 파일 검색에 따라 누적되는 컨텍스트를 덜 들게 되어 성능·비용 효율 향상.
  • ESC
    • 실행 중지/중단(Interrupt) 또는 Rewind UI로 이전 프롬프트로 되돌리기(ESC 2번 등).
  • UI 관련
    • 스크린샷 드래그&드롭으로 UI/UX 개발 시 말로 설명하는 것보다 토큰 효율/정확도가 좋다는 강조.
    • 아키텍처는 이미지(“mmd diagram” 언급)로 저장/사용 추천.

4) 컨텍스트 관리 핵심 Slash 명령(치트/요약 형태)

  • slash context: 컨텍스트 토큰 사용량/현재 상태 확인
  • slash clear: 대화/대화 기록 포함 컨텍스트 제거(토큰 정리)
  • slash compact: 요약을 보존하면서 컨텍스트를 압축(“compression”)
  • 컨텍스트 관리 방식이 응답 품질에 큰 영향을 준다는 관점(“king” 관점) 강조.

5) 모델 선택(우선순위)과 서브 에이전트 비용 절감 아이디어

  • Claude Code 모델 계열
    • Opus(가장 똑똑, 토큰 많이 사용): 복잡 작업용
    • Sonnet(중간): 실용/일상 작업 + 병렬 sub-agent에 비용 효율적
    • Haiku(가장 빠르고 토큰 적음): 빠른 검증/테스트 등
  • 병렬 작업/서브 에이전트에서 Opus 남발을 피하고 Sonnet/Haiku로 토큰 절약 전략.

6) MCP(툴 연결) 관리 및 커스텀 MCP 설계(토큰 비용 이슈)

  • slash mcp로 현재 사용/보유 MCP 서버 목록 확인.
  • 분석
    • MCP는 “연결”만 되어 있어도 툴 설명(description)들이 컨텍스트를 차지.
    • 특히 Notion/Lineal 같은 큰 MCP는 설명 자체가 토큰을 많이 사용.
  • 권장
    • 필요 기능만 골라 커스텀 MCP로 축소해서 사용(“hammer/saw”처럼 필요한 도구만 선택)
    • MCP 대신 로컬 스크립트를 skill로 감싸는 방식도 언급.

7) Skills / Sub-agents / Hooks / (고급) 멀티 인스턴스/자동화 조합

Skills(스킬) = “작업 매뉴얼” 재사용 가능

  • Prompt와 차이
    • Prompt는 매번 입력/복사로 누적 토큰 발생
    • Skills는 만들어두면 재사용되어 규격/체크리스트로 품질 일관성 강화
  • 컨텍스트 효율
    • Skill은 2단계 로딩(설명/이름/짧은 컨텍스트 → 필요 시 전체 프롬프트 로딩) 방식이라 총 컨텐츠가 커도 필요할 때만 로딩되어 부담 감소.
  • Skill 제작
    • Skill Creator 플러그인 설치(Play store 언급)
    • skill.md 구조
      • 상단: name/description
      • 하단: prompt 핵심
    • description 작성 팁
      • 사용자가 실제로 말할 표현(예: “slide creation”)과 핵심 기능을 구체적으로 포함해야 자동 인식이 잘 됨.

Sub-agents(서브 에이전트) = 분리된 컨텍스트로 병렬 처리/격리

  • 메인 Claude와 별도 컨텍스트/워킹스페이스를 가짐 → 컨텍스트 오염 방지.
  • 강의에서 정리한 장점(4가지)
    • 병렬 처리(시간 단축)
    • 컨텍스트 보호
    • 역할 전문화(test/frontend/backend 등)
    • 재사용성(다른 워크플로에서도 활용)
  • 주의
    • 의존성이 있는 작업은 병렬화 비추천
    • 서브 에이전트에 역할을 과도하게 넣지 말 것(전문성 저하)
  • 내장 예시
    • Exploration/Plan/Bash/Guide 등 sub-agent가 내부적으로 존재.

Hooks = “이벤트 기반 자동 실행 엔진”

  • 흐름
    • 이벤트 발생 → matcher 조건 확인 → 조건 만족 시 action 실행(린트/포맷/알림 등)
  • 데모
    • Claude가 response waiting 상태로 들어갈 때 macOS notification + sound 실행
  • 주의
    • hook 실행 동안 Claude는 대기(일시 정지) 함
    • 오래 걸리는 작업은 타임아웃 설정/백그라운드 처리 권장.

8) 워크플로 철학: Plan mode 중심 + TDD + “한 세션 한 기능”

  • 큰 변경뿐 아니라 모든 작업 시작에 Plan mode 추천
    • Plan을 검토하고(파일 변경/권한/단계 확인) Accept 후 실행.
  • TDD-based smart coding
    • 작은 변경마다 테스트 작성 → 통과 확인 → 커밋 반복
    • 디버깅/되돌리기 쉬워짐.
  • 세션 습관
    • “한 세션에 기능/작업 하나” 원칙
    • 예: 로그인 구현 끝 → 정리/새 세션 → 다음 기능.

9) 스크립트로 “무거운 작업” 오프로딩(컨텍스트 오염 방지)

  • 대용량 파일/대규모 데이터 처리(예: 100k 라인 마이그레이션)를 대화 안에서 처리하면 컨텍스트가 비대해지고 품질 저하.
  • 해결
    • Claude가 마이그레이션 스크립트 작성/실행
    • 결과만(예: JSON 요약) 받아 다음 작업 진행
    • 컨텍스트를 깨끗하게 유지.

10) 고급 프레임워크/패턴: WAT (Workflow-Agent-Tools)

  • Nate K가 제안한 프레임워크 채택
    • W: Workflow(단계 명확화)
    • A: Agent(역할 분리, self-healing/병렬)
    • T: Tools(작은 스크립트 조합, 실패 시 작은 단위 디버그 용이)
  • 예시: 블로그 댓글/코멘트 기능 추가
    • DB 스키마 마이그레이션 설계 → 단계별 테스트 작성
    • 에이전트 분배/오류 복구 → 스크립트/후크로 자동 검증
  • 핵심: “AI의 추론”과 “코드 실행”을 분리해 복잡 작업도 안정적으로 처리.

11) 시리즈 데모(전체 조합)로 생산성 극대화

  • 실제 프로젝트(예: 쿠팡 로켓그로스 정산 분석 대시보드)에서:
    • 10개 클라이언트 피드백을 한 번에 반영
    • 커스텀 MCP로 Gemini가 플랜 품질 검토
    • 백엔드/프론트/유닛테스트 서브 에이전트 병렬 실행
    • 코드리뷰 플러그인으로 PR에 대해 리뷰 에이전트 병렬 수행
    • 커스텀 Skill “Client Report”로 변경 결과 보고서 자동 생성
  • 수치 강조
    • 수동 반영이면 반나절 → Claude Code 파이프라인으로 약 30분 수준(강의 발화 기준)

주요 스피커/소스(강의 내 출처)

  • 메인 강의자/발화자: “실벨(Silbel)” 개발자(자기소개/명시)로 언급
  • 외부 출처/소스
    • Nate K: WAT 프레임워크 제안자로 언급
    • Jemini(제미니): 커스텀 MCP로 플랜 리뷰 검증에 사용(외부 AI 모델/API로 설명)
    • ChatGPT / Jeminai(대체 발화 포함): 계획/검토를 다른 AI로 크리틱하는 용도로 언급

Original video