claude-howto 딥다이브
— 시각적 다이어그램 + 복사-붙여넣기 템플릿으로 배우는 Claude Code 교육 가이드

1프로젝트 한줄 요약

claude-howto는 Claude Code의 모든 기능을 시각적 다이어그램 + 실전 템플릿 + 단계별 학습 경로로 가르치는 오픈소스 교육 가이드입니다. claude 명령어를 처음 치는 순간부터 에이전트 오케스트레이션, 훅, 스킬, MCP 서버, 플러그인까지 — Claude Code 생태계 전체를 10개 모듈로 체계화했습니다.

2왜 주목받는가

경쟁 대비 장점

3기술 스택 전체 지도

3-1. 다루는 기술 (Claude Code 생태계)

3-2. 만드는 데 쓴 기술

4아키텍처 심화 분석

레포 전체 구조도

핵심 설계 패턴: Progressive Disclosure (점진적 공개)

이 레포의 가장 중요한 설계 철학입니다. LLM의 컨텍스트 윈도우는 유한합니다. 모든 정보를 한번에 넣으면 성능이 떨어집니다.

Claude Code 기능 125+ 분류 체계

5디렉토리 구조 해부

01-slash-commands/ — 슬래시 커맨드

06-hooks/ — 훅 예제 파일들

07-plugins/ — 플러그인 번들 예제

6학습 포인트 (기술별)

6-1. 슬래시 커맨드 동적 컨텍스트 주입

배울 것: 커스텀 커맨드의 동적 컨텍스트 주입 패턴.

---
name: commit
description: 스마트 커밋 생성
---

현재 변경사항을 분석하고 커밋 메시지를 생성하세요.

변경 파일: !`git diff --cached --stat`
최근 커밋 스타일: !`git log --oneline -5`

6-2. 스킬 아키텍처와 Progressive Disclosure

배울 것: LLM 컨텍스트 효율화의 핵심 패턴. Reference Content(참조형) vs Task Content(작업형) 구분. context: fork로 서브에이전트 컨텍스트에서 격리 실행. disable-model-invocation: true로 고위험 작업 자동 실행 방지.

6-3. 서브에이전트 오케스트레이션

메인 에이전트 (사용자 대화)
    ├── @code-reviewer → 코드 품질 분석
    ├── @test-engineer → 테스트 전략 수립
    ├── @secure-reviewer → 보안 취약점 스캔
    └── @documentation-writer → 문서 자동 생성

핵심 개념: 도구 제한(Principle of Least Privilege), 모델 선택(Haiku=단순, Opus=복잡), Worktree 격리, 에이전트 체이닝, Resumable.

6-4. MCP 연동 (4가지 트랜스포트)

// .claude/settings.json 예시
{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": { "Authorization": "Bearer ${GITHUB_TOKEN}" }
    }
  }
}

4가지 트랜스포트: HTTP(권장), Stdio(로컬), WebSocket(양방향), SSE(레거시). 환경변수 확장 문법: ${VAR}, ${VAR:-default}.

6-5. 훅 시스템 (4종 타입)

6-6. EPUB 빌드 스크립트 (Python 비동기)

배울 것: httpx + asyncio로 비동기 HTTP 클라이언트 구현, Kroki.io API로 Mermaid → PNG 서버사이드 렌더링, tenacity로 재시도 로직 구현, ebooklib으로 EPUB 생성.

async def render_diagrams(mermaid_blocks):
    async with httpx.AsyncClient() as client:
        tasks = [render_one(client, block) for block in mermaid_blocks]
        return await asyncio.gather(*tasks)

7하드웨어 / 시스템 요구사항

8직접 해볼 수 있는 실습 과제

9관련 기술 심화 학습 로드맵

1주차 — Claude Code 기초 (3시간)

2주차 — 스킬 & 서브에이전트 (5시간)

3주차 — MCP & 훅 (4시간)

4주차 — 플러그인 & 고급 기능 (5시간)

5주차 — 종합 프로젝트

실제 프로젝트에 1~4주차 학습 내용을 전부 적용하는 "통합 워크플로우" 구축. 스킬 + 에이전트 + MCP + 훅을 모두 사용하는 플러그인을 만들어서 팀에 배포.

10핵심 키워드 사전

11참고 링크

• GitHub 레포 — luongnv89/claude-howto
• Claude Code 공식 문서
• Anthropic MCP 문서
• Claude Code 스킬 가이드
• 작성자 블로그
• Kroki.io (다이어그램 렌더링)
• TrendShift