Day1 Onboarding

Day 1: Onboarding

이 스킬이 호출되면 아래 STOP PROTOCOL을 반드시 따른다.

---

STOP PROTOCOL — 절대 위반 금지

이 프로토콜은 이 스킬의 최우선 규칙이다.

아래 규칙을 위반하면 수업이 망가진다.

각 블록은 반드시 2턴에 걸쳐 진행한다

┌─ Phase A (첫 번째 턴) ──────────────────────────────┐
│ 1. references/에서 해당 블록 파일의 EXPLAIN 섹션을 읽는다    │
│ 2. 기능을 설명한다                                        │
│ 3. references/에서 해당 블록 파일의 EXECUTE 섹션을 읽는다    │
│ 4. "지금 직접 실행해보세요"라고 안내한다                     │
│ 5. ⛔ 여기서 반드시 STOP. 턴을 종료한다.                    │
│                                                          │
│ ❌ 절대 하지 않는 것: 퀴즈 출제, QUIZ 섹션 읽기             │
│ ❌ 절대 하지 않는 것: AskUserQuestion 호출                  │
│ ❌ 절대 하지 않는 것: "실행해봤나요?" 질문                   │
└──────────────────────────────────────────────────────────┘

  ⬇️ 사용자가 돌아와서 "했어", "완료", "다음" 등을 입력한다

┌─ Phase B (두 번째 턴) ──────────────────────────────┐
│ 1. references/에서 해당 블록 파일의 QUIZ 섹션을 읽는다       │
│ 2. AskUserQuestion으로 퀴즈를 출제한다                     │
│ 3. 정답/오답 피드백을 준다                                 │
│ 4. 다음 블록으로 이동할지 AskUserQuestion으로 묻는다         │
│ 5. ⛔ 다음 블록을 시작하면 다시 Phase A부터.                │
└──────────────────────────────────────────────────────────┘

핵심 금지 사항 (절대 위반 금지)

1. Phase A에서 AskUserQuestion을 호출하지 않는다 — 설명 + 실행 안내 후 바로 Stop 2. Phase A에서 퀴즈를 내지 않는다 — QUIZ 섹션은 Phase B에서만 읽는다 3. Phase A에서 "실행해봤나요?"를 묻지 않는다 — 사용자가 먼저 말할 때까지 기다린다 4. 한 턴에 EXPLAIN + QUIZ를 동시에 하지 않는다 — 반드시 2턴으로 나눈다

공식 문서 URL 출력 (절대 누락 금지)

모든 블록의 Phase A 시작 시, 해당 reference 파일 상단의 > 공식 문서: URL을 반드시 그대로 출력한다.

📖 공식 문서: [URL]

• reference 파일에 URL이 여러 개 있으면 전부 출력한다
• URL을 요약하거나 생략하지 않는다
• 참가자가 직접 클릭해서 공식 문서를 볼 수 있어야 한다

Phase A 종료 시 필수 문구

Phase A의 마지막에는 반드시 아래 형태의 문구를 출력하고 Stop한다:

---
👆 위 내용을 직접 실행해보세요.
실행이 끝나면 "완료" 또는 "다음"이라고 입력해주세요.

이 문구 이후에 어떤 도구 호출(AskUserQuestion 포함)이나 추가 텍스트도 출력하지 않는다.

블록 특수 규칙

• Block 0 (Setup): 퀴즈 없음. Phase A에서 설명+실행 안내 → Stop. Phase B에서 완료 확인만.
• Block 1 (Experience): Phase A에서 3가지 데모 안내 → Stop. Phase B에서 체험 소감 확인.
• Block 2 (Why): Phase A에서 Quiz 1 출제 → 피드백 → Stop. Phase B에서 Quiz 2 + 영상 안내.
• Block 3 (What): 7개 기능 각각이 독립 블록. 3-1부터 3-7까지 각각 Phase A → Phase B.
• Block 3-Break (쉬어가기): Phase A만 있고 Phase B 없음. 퀴즈 없음. 터미널 소개 + Status Line 설정 체험.
• Block 4 (Basics): Phase A에서 설명+실행 안내 → Stop. Phase B에서 퀴즈 3개 연속.

---

References 파일 맵

파일 경로는 이 SKILL.md 기준 상대경로다.

각 reference 파일은 ## EXPLAIN, ## EXECUTE, ## QUIZ 섹션으로 구성된다.

---

진행 규칙

• 한 번에 한 블록씩 진행한다
• "다음", "skip", 블록 번호/이름으로 이동한다
• Claude Code 관련 질문이 오면 claude-code-guide 에이전트(내장 도구)로 답변한다. 답변 후 사용자가 직접 따라할 수 있게 단계별로 안내하고, 질문할 때는 AskUserQuestion을 사용한다. 내장 에이전트 답변이 부정확하다고 판단되면, 공식 문서를 curl로 파일에 저장한 뒤 Read 툴로 꼼꼼히 읽고 정확한 정보로 다시 답한다 (WebFetch는 요약/손실 위험이 있으므로 사용하지 않는다)
• Block 3-4(Subagent) 완료 후 → Block 3-Break(쉬어가기) → Block 3-5(Agent Teams)로 이어진다
• Block 3의 7개 기능이 모두 끝나면 references/block3-summary.md를 읽고 관계도를 보여준다

---

시작

스킬 시작 시 아래 테이블을 보여주고 AskUserQuestion으로 어디서 시작할지 물어본다.

AskUserQuestion({
  "questions": [{
    "question": "어디서부터 시작할까요?",
    "header": "시작 블록",
    "options": [
      {"label": "Block 0: Setup", "description": "첫 실행 설정 + 에디터"},
      {"label": "Block 1: Experience", "description": "Working Backward 데모 3가지"},
      {"label": "Block 2: Why", "description": "왜 CLI? 왜 터미널?"},
      {"label": "Block 3: What", "description": "7개 기능 소개"}
    ],
    "multiSelect": false
  }]
})

시작 블록 선택 후 → 해당 블록의 Phase A부터 진행한다.

Block 0: Setup

Claude Code 설치는 이미 README의 Step 0에서 완료한 상태다.

이 블록에서는 첫 실행 설정과 에디터를 안내한다.

EXPLAIN

Phase A 시작 시 반드시 아래 형태로 출력한다:

```

📖 공식 문서: https://code.claude.com/docs/ko/setup

📖 빠른 시작: https://code.claude.com/docs/ko/quickstart

```

에디터 (선택사항)

Claude Code는 터미널에서 claude만 치면 된다. 하지만 파일을 눈으로 보면서 작업하고 싶다면 에디터를 설치할 수 있다:

"이 캠프에서는 에디터 없이 터미널에서 claude만 쳐도 충분합니다. 에디터는 나중에 필요할 때 설치해도 됩니다."

Mac 꿀팁: 숨겨진 폴더 보기

Mac에서는 .으로 시작하는 폴더(.claude, .git 등)가 기본적으로 안 보인다. Claude Code에게 시키면 된다:

Finder에서 .claude, .git 처럼 숨겨진 폴더도 볼 수 있게 설정해줘

설정이 끝나면 Finder로 직접 확인해보자:

open ./

.claude/skills/ 폴더 안에 지금 배우고 있는 교안이 들어있다! Finder에서 직접 눈으로 확인해보자.

첫 실행

터미널에 claude 한 글자를 입력하라고 안내한다. Anthropic 계정 로그인 + Claude 구독(Pro, Max, Teams, Enterprise) 연결을 확인시킨다.

Output Style 설정

로그인이 끝나면 아래 순서로 Output Style을 설정하라고 안내한다:

1. Claude Code 대화창에 /config 입력 2. Output style 선택 3. Explanatory 선택

/config
→ Output style 선택
→ Explanatory 선택

Explanatory 모드로 설정하면 Claude가 코드를 작성할 때 왜 그렇게 하는지 설명을 함께 해준다. 배우는 단계에서 가장 적합한 모드다.

EXECUTE

참가자에게 순서대로 실행하라고 안내한다:

1. 첫 실행: 터미널에서 claude 입력 2. 첫 대화: "안녕, 나는 [이름]이고 [직업]이야. 나한테 인사해줘" 3. 자유 대화: 5분간 자유롭게 대화

QUIZ

AskUserQuestion({
  "questions": [{
    "question": "설치와 첫 대화까지 완료했나요?",
    "header": "Setup 확인",
    "options": [
      {"label": "모두 완료!", "description": "Block 1로 이동"},
      {"label": "아직 진행 중", "description": "더 시간이 필요함"},
      {"label": "트러블슈팅 필요", "description": "설치나 실행에 문제 발생"}
    ],
    "multiSelect": false
  }]
})

Block 0은 퀴즈 대신 완료 확인만 한다.

Block 1: Experience

Phase A 시작 시 반드시 아래 형태로 출력한다:

```

📖 공식 문서: https://code.claude.com/docs/ko/quickstart

```

7일 후 모습을 먼저 체험한다. 외우지 않는다. 느끼기만 한다.

EXPLAIN

먼저 아래 Before/After 테이블을 보여준다:

3가지 데모를 안내한다:

데모 1: Skill 실행 — /weekly-sync

강사가 직접 시연한다. 참가자는 보기만 한다.

강사가 터미널에서 아래를 입력하고, Claude가 Slack 메시지 수집 → git log 확인 → 문서 생성까지 자동으로 진행하는 과정을 보여준다:

/weekly-sync

핵심 포인트: 한 마디면 끝. Slack, git, 문서 작성이 하나의 Skill로 자동화된다. 7일 후에는 여러분도 이런 걸 직접 만들 수 있다.

데모 2: 모호한 요청 → AskUserQuestion으로 명확화

우리 팀 업무를 개선해줘

먼저 위처럼 모호하게 요청한다. Claude가 혼자 추측해서 결과를 내놓을 것이다.

이번엔 다르게 요청한다:

우리 팀 업무를 개선해줘. 모호한 부분은 AskUserQuestion으로 질문해서 명확하게 만들어

Claude가 "어떤 팀인가요?", "몇 명인가요?", "가장 큰 병목은?" 등 선택지를 제시하며 질문하는 과정을 체험시킨다.

핵심 포인트: AskUserQuestion을 활용하면 Claude가 추측 대신 질문한다. 결과의 정확도가 완전히 달라진다. 이 패턴이 Day 3 /clarify의 핵심이다.

데모 3: Claude에게 물어보기

Claude Code에서 MCP가 뭐야?

핵심 메시지: 기능을 다 외울 필요 없다. 모르면 Claude에게 물어보면 된다.

EXECUTE

참가자에게 데모 2, 3을 직접 실행하라고 안내한다:

1. 데모 1 (보기만): /weekly-sync 시연은 강사가 보여준 것으로 완료 2. 데모 2 실행: 일부러 모호하게 요청 → 그다음 AskUserQuestion 활용 버전으로 재요청 → 차이 체험 3. 데모 3 실행: Claude Code 자체에 대해 질문

QUIZ

체험 정리:
1. Skill 실행 → 한 마디로 복잡한 업무 자동화
2. 모호한 요청 → AskUserQuestion으로 Claude가 질문하며 명확화
3. 모르는 것 → Claude에게 물어보기

AskUserQuestion({
  "questions": [{
    "question": "3가지 데모 중 가장 인상적이었던 건?",
    "header": "체험 확인",
    "options": [
      {"label": "데모 1: /weekly-sync", "description": "한 마디로 복잡한 업무 자동화"},
      {"label": "데모 2: AskUserQuestion", "description": "Claude가 질문으로 명확화"},
      {"label": "데모 3: Claude에게 물어보기", "description": "모르면 물어보면 된다"}
    ],
    "multiSelect": false
  }]
})

Block 1도 정답이 없는 체험 확인이다.

Block 2: Why

EXPLAIN

Phase A 시작 시 반드시 아래 형태로 출력한다:

```

📖 공식 문서: https://code.claude.com/docs/ko/how-claude-code-works#%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8-%EB%A3%A8%ED%94%84

```

왜 CLI인가? 왜 터미널인가? 2개의 퀴즈로 이해한다.

Block 2는 설명 없이 바로 퀴즈로 진행하는 특수 블록이다.

Phase A에서 퀴즈 1을 내고, Phase B에서 퀴즈 2 + 영상을 안내한다.

QUIZ-1

Quiz 1: 왜 CLI인가?

AskUserQuestion({
  "questions": [{
    "question": "왜 굳이 터미널을 깔아서 Claude Code를 사용해야 할까요?",
    "header": "Quiz 1",
    "options": [
      {"label": "CLI는 컴퓨터의 모든 일을 할 수 있어서", "description": "GUI는 버튼만 누를 수 있지만 CLI는 제한 없음"},
      {"label": "터미널이 더 예뻐서", "description": "예쁜 건 GUI가 더 예쁨"},
      {"label": "프로그래머처럼 보이려고", "description": "멋은 부산물일 뿐"},
      {"label": "Anthropic이 시켜서", "description": "아무도 안 시킴"}
    ],
    "multiSelect": false
  }]
})

정답: 1번. 해설로 아래 도식을 보여준다:

GUI:  사용자 → [버튼] [버튼] [버튼] → 제한된 기능
CLI:  사용자 → 자유로운 명령어 ────→ 컴퓨터의 모든 기능
      AI 에이전트 → CLI ────────────→ 소프트웨어 직접 제어

QUIZ-2

Quiz 2: 왜 Cowork가 아니라 터미널인가?

AskUserQuestion({
  "questions": [{
    "question": "왜 CoWork 같은 비개발자용 툴이 아니라 터미널에서 Claude Code를 써야 할까요?",
    "header": "Quiz 2",
    "options": [
      {"label": "모두가 코딩으로 새로운 차원의 일을 하게 될 것이라서", "description": "코딩 = 개발자 전유물이 아니라 모든 지식노동의 도구가 된다"},
      {"label": "Claude CoWork 같은 비개발자용 도구가 더 나아서", "description": "CoWork도 좋지만 터미널이 자유도의 끝판왕"},
      {"label": "터미널이 무료라서", "description": "둘 다 유료"},
      {"label": "개발자만 쓸 수 있어서", "description": "비개발자도 씀. 지금 여기서."}
    ],
    "multiSelect": false
  }]
})

정답: 1번. 해설:

Cursor, CoWork 같은 도구 → 정해진 UI 안에서의 생산성
터미널 Claude Code   → 코딩이라는 새로운 차원의 일

결과적으로 토큰을 많이 쓸 수 있다 = 엄청나게 많은 노동력을 가진 사람이 된다

오늘만 지나면 출발선에 서게 된다. 내일부터는 더 근본적인 원리를 알게 되는 날들이다.

영상 시청

아래 영상을 시청하라고 안내한다:

https://youtu.be/JI8S9T7r2SQ?si=aGYqNMqklAeL9pZs&t=23

"AI 분야가 지식 노동보다 더 큰 규모가 될 수 있는 '소프트웨어 공장 카테고리'라고 보고 있다. 그럴듯한게, 이 그래프들을 보면 말도 안됨. 기존 코딩 생산성 툴의 시장을 그냥 키워버림"

Block 3-1: Memory

Phase A 시작 시 반드시 아래 형태로 출력한다:

```

📖 공식 문서: https://code.claude.com/docs/ko/memory

📖 기능을 목표에 맞추기: https://code.claude.com/docs/ko/features-overview#%EA%B8%B0%EB%8A%A5%EC%9D%84-%EB%AA%A9%ED%91%9C%EC%97%90-%EB%A7%9E%EC%B6%94%EA%B8%B0

📖 기능이 어떻게 로드되는지 이해하기: https://code.claude.com/docs/ko/features-overview#%EA%B8%B0%EB%8A%A5%EC%9D%B4-%EC%96%B4%EB%96%BB%EA%B2%8C-%EB%A1%9C%EB%93%9C%EB%90%98%EB%8A%94%EC%A7%80-%EC%9D%B4%ED%95%B4%ED%95%98%EA%B8%B0

```

Camp 2 변경점: 1기에서는 CLAUDE.md만 다뤘지만, 그 사이 Auto Memory 기능이 새로 추가됐다. 2기에서는 CLAUDE.md와 Auto Memory를 함께 배운다. 내가 쓰는 지시문(CLAUDE.md)과 Claude가 스스로 기록하는 메모(Auto Memory) — 이 두 가지가 Claude의 기억 시스템이다.

EXPLAIN

1. CLAUDE.md — 내가 쓰는 지시문

세션 시작
  │
  ▼
┌─────────────┐     ┌─────────────┐
│ CLAUDE.md   │────▶│ 시스템       │────▶ Claude가 규칙을 아는 상태로 대화 시작
│ (내 지시문)  │     │ 프롬프트     │
└─────────────┘     └─────────────┘
  항상 읽힘            매번 자동 주입

2. Auto Memory — Claude가 스스로 적는 메모

세션 중 작업
  │
  ▼
┌─────────────────┐     ┌──────────────────────┐
│ Claude가 패턴    │────▶│ ~/.claude/projects/  │
│ 발견/학습        │     │   <project>/memory/  │
└─────────────────┘     │   ├── MEMORY.md      │
                        │   ├── debugging.md   │
  다음 세션 시작          │   └── patterns.md   │
  │                     └──────────────────────┘
  ▼                              │
┌─────────────┐                  │
│ MEMORY.md   │◀─────────────────┘
│ 자동 로드    │  (첫 200줄이 시스템 프롬프트에 주입)
└─────────────┘

Auto Memory가 기록하는 것들:

• 프로젝트 패턴: 빌드 명령어, 테스트 방식, 코드 스타일
• 디버깅 인사이트: 까다로운 문제의 해결법, 자주 나는 에러 원인
• 아키텍처 노트: 핵심 파일, 모듈 관계, 중요한 추상화
• 내 선호사항: 소통 방식, 워크플로우 습관, 도구 선택

Auto Memory 관리:

• 기본으로 켜져 있다 (따로 설정할 필요 없음)
• /memory 로 Auto Memory 토글 가능
• "이건 기억해둬", "pnpm 쓴다고 기억해" 같이 직접 지시해도 된다
• ~/.claude/projects/<프로젝트>/memory/ 에 마크다운 파일로 저장된다

EXECUTE

3가지를 순서대로 실행하라고 안내한다:

1. `/init` — CLAUDE.md 자동 생성

/init

현재 폴더를 분석해서 CLAUDE.md를 자동으로 생성해준다. 프로젝트 구조, 기술 스택, 빌드 방법 등을 자동으로 파악해서 작성한다.

2. `/memory` — 메모리 확인

/memory

CLAUDE.md와 Auto Memory 파일들을 확인하고 편집할 수 있다. Auto Memory 토글도 여기서 할 수 있다.

3. Auto Memory 직접 체험

Claude Code에 이렇게 말해본다:

나는 [이름]이고, [직업]이야. 이걸 기억해둬.

Claude가 Auto Memory에 정보를 기록하는 것을 직접 확인해보자. /memory 로 저장된 내용을 열어볼 수 있다.

QUIZ

AskUserQuestion({
  "questions": [{
    "question": "CLAUDE.md와 Auto Memory의 차이는?",
    "header": "Quiz 3-1",
    "options": [
      {"label": "CLAUDE.md는 내가 쓰고, Auto Memory는 Claude가 쓴다", "description": "각각 작성 주체가 다르다"},
      {"label": "같은 파일이다", "description": "이름만 다른 같은 기능"},
      {"label": "Auto Memory는 한 번만 읽힌다", "description": "매 세션마다 읽히는지 아닌지"}
    ],
    "multiSelect": false
  }]
})

정답: 1번. CLAUDE.md는 내가 Claude에게 주는 지시문이고, Auto Memory는 Claude가 작업하면서 스스로 기록하는 메모다. 둘 다 매 세션 시작 시 자동으로 읽힌다.

Block 3-2: Skill

Phase A 시작 시 반드시 아래 형태로 출력한다:

```

📖 공식 문서: https://code.claude.com/docs/ko/skills

📖 참고: https://agentskills.io/what-are-skills

```

EXPLAIN

CLAUDE.md ━━━━━━━━━━━━━━━━━━━━━━━━━ 항상 로딩 (매 세션)
Skill A   ─ ─ ─ ─ ─ ─ ┐
Skill B   ─ ─ ─ ─ ─ ─ ─ ─ ─ ┐
Skill C   ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┐  필요할 때만 로딩
                       ▼         ▼         ▼
                  "/sync" 호출  자동 매칭  "/wrap" 호출

Skill 폴더 구조

my-skill/
├── SKILL.md          # 필수: 스킬의 본체. 메타데이터 + 지시사항
├── scripts/          # 선택: 실행할 코드 (Python, Bash 등)
├── references/       # 선택: 참고 문서, 교안, 데이터
└── assets/           # 선택: 템플릿, 리소스 파일

• SKILL.md만 있으면 스킬이 된다. 나머지는 필요할 때 추가한다
• 지금 이 온보딩도 SKILL.md + references/ 구조로 만들어져 있다

EXECUTE

지금 이 온보딩 자체가 Skill이다. 직접 체험해보기 위해, 새 세션을 열고 아래를 입력해보라고 안내한다:

/day1-test-skill

이 테스트 스킬을 실행하면 축하 메시지가 나온다. Skill이 어떻게 동작하는지 직접 체험하는 것이다.

QUIZ

AskUserQuestion({
  "questions": [{
    "question": "Skill은 CLAUDE.md와 달리 어떻게 로드되나요?",
    "header": "Quiz 3-2",
    "options": [
      {"label": "필요할 때만 점진적으로 로드된다", "description": "호출하거나 자동 매칭될 때만 컨텍스트에 올라옴"},
      {"label": "CLAUDE.md처럼 매번 전부 로드된다", "description": "그러면 컨텍스트 윈도우가 금방 찬다"},
      {"label": "한 번 로드하면 영구 저장된다", "description": "세션이 끝나면 사라짐"}
    ],
    "multiSelect": false
  }]
})

정답: 1번. CLAUDE.md는 매 세션마다 전부 로드되지만, Skill은 점진적 로딩(Progressive Disclosure) — 필요할 때만 꺼내 읽힌다. 컨텍스트 윈도우는 유한하니까.

Block 3-3: MCP

Phase A 시작 시 반드시 아래 형태로 출력한다:

```

📖 공식 문서: https://code.claude.com/docs/ko/mcp

```

EXPLAIN

Claude ──── "Slack에서 메시지 읽어줘"
  │
  ▼ 툴 콜링
┌──────────┐    MCP 프로토콜    ┌──────────┐
│ Claude   │ ◀═══════════════▶ │ Slack    │
│ Code     │    표준 규격       │ Server   │
└──────────┘                   └──────────┘
  내 컴퓨터                      외부 서비스

EXECUTE

Claude에게 MCP에 대해 물어보라고 안내한다:

MCP가 뭔지 쉽게 설명해줘. 내가 쓸 수 있는 MCP 서버 예시 3개도 알려줘

QUIZ

AskUserQuestion({
  "questions": [{
    "question": "MCP를 한 마디로 말하면?",
    "header": "Quiz 3-3",
    "options": [
      {"label": "Claude와 외부 도구를 연결하는 표준 프로토콜", "description": "Slack, Calendar 등을 플러그처럼 꽂는 것"},
      {"label": "Claude의 내장 기능", "description": "MCP는 외부 연결이지 내장이 아님"},
      {"label": "프로그래밍 언어", "description": "도구 연결 프로토콜임"}
    ],
    "multiSelect": false
  }]
})

정답: 1번.

Block 3-4: Subagent

Phase A 시작 시 반드시 아래 형태로 출력한다:

```

📖 공식 문서: https://code.claude.com/docs/ko/sub-agents

```

EXPLAIN

┌─ 메인 Claude ──────────────────────────┐
│  대화 컨텍스트: [A, B, C, D, E...]     │
│                                        │
│  "PDF 분석해줘" ──┐                     │
│                   ▼                    │
│  ┌─ Subagent ──────────────┐           │
│  │ 컨텍스트: [blank slate]  │           │
│  │ 작업: PDF 분석            │           │
│  │ 결과: 요약 3줄 ──────────┼──▶ 전달   │
│  └─────────────────────────┘           │
└────────────────────────────────────────┘

EXECUTE

Subagent가 실제로 동작하는 걸 체험하라고 안내한다:

이 폴더의 파일 구조를 탐색해서 정리해줘. Explore 에이전트를 사용해

QUIZ

AskUserQuestion({
  "questions": [{
    "question": "Subagent는 왜 필요한가요?",
    "header": "Quiz 3-4",
    "options": [
      {"label": "독립된 공간에서 전담 처리시키려고", "description": "메인 대화 컨텍스트를 소비하지 않고 별도 처리"},
      {"label": "Claude가 혼자 못해서", "description": "Claude가 못하는 건 아니고 효율의 문제"},
      {"label": "필수 기능이라서", "description": "없어도 되지만 있으면 강력함"}
    ],
    "multiSelect": false
  }]
})

정답: 1번.

Block 3-5: Agent Teams

Phase A 시작 시 반드시 아래 형태로 출력한다:

```

📖 공식 문서: https://code.claude.com/docs/ko/agent-teams

```

EXPLAIN

┌─ 리더 ─────────────────────────────────────┐
│                                            │
│  ┌─ Agent A ─┐  ┌─ Agent B ─┐  ┌─ Agent C ─┐
│  │ 시장조사   │  │ 보고서    │  │ 발표자료   │
│  └─────┬─────┘  └─────┬─────┘  └─────┬─────┘
│        │              │              │
│        └──────── 메시지 ─────────────┘
│                    +
│            공유 태스크 리스트
└────────────────────────────────────────────┘
  Subagent: 리더에게만 보고
  Teams:    팀원끼리 직접 소통

Agent Teams 활성화 (settings.json)

Agent Teams는 기본적으로 꺼져 있다. settings.json에 환경 변수를 추가해야 켜진다.

아래 내용을 ~/.claude/settings.json에 추가한다:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

이미 다른 설정이 있으면 env 블록 안에 한 줄만 추가하면 된다.

>

⚠️ Ghostty 사용자 참고: Agent Teams의 분할 창(tmux) 모드는 Ghostty에서 지원되지 않는다.

기본 In-process 모드는 정상 동작하니 걱정하지 않아도 된다.

(분할 창 미지원: VS Code 터미널, Windows Terminal, Ghostty)

라이브 데모

강사가 iTerm2로 전환하여 tmux -CC를 실행한다.

여러 터미널 패널에서 Agent들이 동시에 동작하는 모습을 실시간으로 보여준다.

"지금 보시는 것처럼 각 Agent가 독립된 터미널에서 동시에 작업하고, 서로 메시지를 주고받습니다."

EXECUTE

1단계: settings.json 설정

아래 명령어를 Claude Code에 입력해서 Agent Teams를 활성화하라고 안내한다:

내 settings.json에 Agent Teams를 활성화하는 설정을 추가해줘

Claude가 ~/.claude/settings.json 파일에 "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } 을 추가해줄 것이다.

2단계: 설정 확인 체크리스트

설정이 끝났으면 아래 체크리스트를 보여주고, 완료했다고 할 때 검증한다:

✅ 체크리스트
- [ ] ~/.claude/settings.json 에 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 가 "1"로 설정됨

검증 방법

사용자가 "완료", "했어", "다음" 등을 입력하면 Phase B에서 아래를 수행한다:

1. ~/.claude/settings.json 파일을 Read 툴로 읽는다 2. CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS가 "1"로 설정되어 있는지 확인한다 3. 설정이 되어 있으면 → "설정 완료! Agent Teams를 사용할 준비가 됐습니다" + 퀴즈 진행 4. 설정이 안 되어 있으면 → "아직 설정이 안 된 것 같아요. 다시 한번 확인해볼까요?" + 재안내

QUIZ

settings.json 검증을 먼저 수행한 후, 통과하면 퀴즈를 출제한다:

AskUserQuestion({
  "questions": [{
    "question": "Agent Teams와 Subagent의 차이는?",
    "header": "Quiz 3-5",
    "options": [
      {"label": "각자 독립 인스턴스에서 서로 소통하며 협업", "description": "Subagent는 보고만, Teams는 팀원끼리 대화 + 공유 태스크 리스트"},
      {"label": "Subagent를 여러 개 돌리는 것", "description": "단순 병렬이 아니라 소통 + 공유 태스크 리스트"},
      {"label": "이름만 다름", "description": "구조 자체가 다름"}
    ],
    "multiSelect": false
  }]
})

정답: 1번.

Block 3-6: Hook

Phase A 시작 시 반드시 아래 형태로 출력한다:

```

📖 공식 문서: https://code.claude.com/docs/ko/hooks-guide

```

EXPLAIN

AI (확률적)                    Hook (결정론적)
  "파일 저장 후                   파일 저장 이벤트
   포맷팅 해줘"                      │
      │                            ▼
      ▼                     ┌──────────────┐
  대부분 함                  │ prettier     │
  가끔 까먹음                │ --write .    │ ← 100% 실행
                            └──────────────┘

EXECUTE

2단계로 안내한다.

1단계: Hook 이해하기

먼저 Claude에게 물어보라고 안내한다:

Hook이 뭔지 예시와 함께 설명해줘. 내 업무에서 쓸 수 있는 Hook 아이디어 3개도 제안해줘

2단계: 직접 Hook 추가하기

Claude에게 아래와 같이 입력하라고 안내한다:

Stop Hook을 추가해줘. 응답이 끝나면 현재 시간을 터미널에 출력하도록

Claude가 .claude/settings.local.json에 Stop 이벤트 Hook을 추가해줄 것이다.

예시 결과: 응답이 끝날 때마다 [완료] 14:32:05 같은 시간이 터미널에 표시된다.

QUIZ

AskUserQuestion({
  "questions": [{
    "question": "Hook은 언제 실행되나요?",
    "header": "Quiz 3-6",
    "options": [
      {"label": "특정 이벤트가 발생했을 때 자동으로", "description": "응답 완료, 도구 실행 등 이벤트 기반"},
      {"label": "내가 직접 실행할 때", "description": "자동 실행이 핵심"},
      {"label": "매일 정해진 시간에", "description": "스케줄러와는 다름"}
    ],
    "multiSelect": false
  }]
})

정답: 1번.

Block 3-7: Plugin

Phase A 시작 시 반드시 아래 형태로 출력한다:

```

📖 공식 문서: https://code.claude.com/docs/ko/plugins

📖 마켓플레이스: https://code.claude.com/docs/ko/discover-plugins

```

EXPLAIN

개별 설치 (Plugin 없이)          Plugin (한 번에)
┌─────────┐                    ┌─────────────────┐
│ Skill A │ ← 수동 복사         │ marketing-plugin│
│ Skill B │ ← 수동 복사         │ ┌─ Skill A,B   │
│ MCP 설정 │ ← 수동 설정   vs   │ ├─ MCP 설정    │
│ Hook 설정│ ← 수동 설정         │ ├─ Hook 설정   │
│ Agent   │ ← 수동 설정         │ └─ Agent       │
└─────────┘                    └────────┬────────┘
  팀원 각자 반복                         │
                              claude plugin add
                                한 줄이면 끝

EXECUTE

3단계로 직접 플러그인을 설치해본다.

1단계: 공식 플러그인 설치

Claude Code에는 공식 마켓플레이스가 있다. /plugin 명령어로 둘러보고 하나를 설치해보자:

/plugin

목록에서 마음에 드는 공식 플러그인을 골라 설치해본다.

2단계: superpowers 플러그인 설치

개발 워크플로우를 강화하는 인기 플러그인이다. 마켓플레이스를 먼저 등록하고, 거기서 설치한다:

/plugin marketplace add obra/superpowers-marketplace

마켓플레이스가 등록되면 플러그인을 설치한다:

/plugin install superpowers@superpowers-marketplace

3단계: clarify 플러그인 설치

AI Native Camp 운영팀이 만든 플러그인이다. 우리만의 마켓플레이스에서 가져온다:

/plugin marketplace add team-attention/plugins-for-claude-natives

/plugin install clarify

clarify는 모호한 요청을 명확하게 만들어주는 플러그인이다. Day 3에서 깊이 다룬다.

QUIZ

AskUserQuestion({
  "questions": [{
    "question": "Plugin은 뭘 묶은 것인가요?",
    "header": "Quiz 3-7",
    "options": [
      {"label": "Skill + MCP + Hook + Agent 등을 하나의 패키지로", "description": "여러 기능을 팀 단위로 배포"},
      {"label": "Skill만 묶은 것", "description": "Skill 외에도 MCP, Hook, Agent 포함"},
      {"label": "외부 도구만 묶은 것", "description": "내부 기능도 포함"}
    ],
    "multiSelect": false
  }]
})

정답: 1번.

Block 3-Break: 쉬어가기 — 터미널 & Status Line

이 블록은 퀴즈 없이 가볍게 진행한다. Phase A만 있고 Phase B는 없다.

사용자가 "완료" 또는 "다음"이라고 하면 Block 3-5로 넘어간다.

EXPLAIN

여기까지 Claude Code의 핵심 기능 4개(Memory, Skill, MCP, Subagent)를 배웠다. 잠깐 숨 고르기.

Claude Code는 터미널에서 돌아간다. 어떤 터미널을 쓰느냐에 따라 경험이 달라진다.

터미널 추천

기본 Terminal.app도 쓸 수 있지만, 위 터미널들은 색상, 폰트, 분할 화면 등이 훨씬 자유롭다.

Claude Code Status Line

Claude Code 화면 맨 아래에 상태 표시줄을 커스터마이즈할 수 있다. 지금 쓰는 모델, 컨텍스트 사용량, Git 브랜치 등을 실시간으로 보여준다.

설정하는 가장 쉬운 방법:

Claude Code에 이렇게 말하면 된다:

/statusline 모델 이름과 컨텍스트 사용률을 보여줘

이 한 줄이면 Claude가 알아서 스크립트를 만들고 설정까지 해준다.

직접 만들고 싶다면:

~/.claude/settings.json에 추가:

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  }
}

그리고 ~/.claude/statusline.sh를 만든다:

#!/bin/bash
input=$(cat)
MODEL=$(echo "$input" | jq -r '.model.display_name')
PCT=$(echo "$input" | jq -r '.context_window.used_percentage // 0' | cut -d. -f1)

# 프로그레스 바
BAR_WIDTH=10
FILLED=$((PCT * BAR_WIDTH / 100))
EMPTY=$((BAR_WIDTH - FILLED))
BAR=$(printf "%${FILLED}s" | tr ' ' '▓')$(printf "%${EMPTY}s" | tr ' ' '░')

echo "[$MODEL] $BAR $PCT%"

결과: [Opus] ▓▓░░░░░░░░ 25%

jq가 없으면 brew install jq (Mac) 또는 sudo apt install jq (Linux)

EXECUTE

두 가지를 해보라고 안내한다:

1. Status Line 설정: Claude Code에 /statusline 모델 이름과 컨텍스트 사용률을 프로그레스 바로 보여줘라고 입력 2. 터미널 구경: 위 터미널 중 하나의 공식 사이트를 방문해서 스크린샷 구경

Block 3: 마무리

Block 3 마무리 시 반드시 아래 형태로 출력한다:

```

📖 전체 기능 개요: https://code.claude.com/docs/ko/features-overview

```

7개 기능의 관계를 정리해서 보여준다:

┌─ Memory ────── CLAUDE.md(내 지시문) + Auto Memory(Claude의 메모)
│
├─ Skill ─────── 반복 업무를 레시피로 저장
│   └─ MCP ───── Slack, Calendar 등 외부 도구 연결
│
├─ Subagent ──── 하나의 작업을 백그라운드에서 처리
│   └─ Agent Teams ── 여러 Subagent가 동시에 작업
│
├─ Hook ──────── 특정 이벤트 발생 시 자동 실행
│
└─ Plugin ────── 위의 모든 것을 묶어서 팀에 공유

전부 외울 필요 없다. 모르면 Claude에게 물어보면 된다.

Block 4: Basics

Phase A 시작 시 반드시 아래 형태로 출력한다:

```

📖 공식 문서: https://code.claude.com/docs/ko/cli-usage

```

EXPLAIN

CLI, git, GitHub, 에디터 기초를 퀴즈와 함께 배운다.

CLI 기초

이 5개면 충분하다. Claude Code가 나머지는 다 해준다.

git 기초

"보고서_최종.docx → 보고서_최종_진짜.docx → 보고서_최종_찐최종.docx" — git을 쓰면 이런 일이 없다.

git은 실행 취소의 끝판왕이다. 뭘 해도 돌아갈 수 있다.

더 알고 싶다면:

- git 간편 안내서 — 한국어, 한 페이지로 끝

- Learn Git Branching — 브라우저에서 직접 해보는 시각적 git 튜토리얼

- 코딩애플 - Git & GitHub — 무료 한국어 영상 강의

GitHub 기초

더 알고 싶다면:

- GitHub 공식 시작 가이드 — 한국어, GitHub이 직접 만든 튜토리얼

- 초보자를 위한 git과 GitHub 시작기 (모두의연구소) — 비개발자 눈높이 한국어 블로그

에디터 비교

"이 캠프에서는 터미널에서 claude만 쳐도 충분합니다."

EXECUTE

Claude Code에게 명령어를 대신 시켜보는 체험이다. 아래 3가지를 순서대로 Claude Code에 입력하라고 안내한다:

1. CLI 체험 — Claude에게 현재 위치를 물어본다:

지금 내가 어느 폴더에 있는지 알려줘

Claude가 pwd를 실행해서 경로를 보여줄 것이다. 직접 pwd를 칠 필요가 없다!

1-2. CLI 직접 체험 — Claude Code 안에서 !를 붙이면 터미널 명령어를 직접 실행할 수 있다:

!cat .claude/skills/day1-onboarding/references/block4-basics.md

지금 배우고 있는 바로 이 교안의 내용이 화면에 출력된다! !는 "Claude한테 시키지 말고 내가 직접 실행할게"라는 뜻이다.

2. git 체험 — Claude에게 git 상태를 물어본다:

이 폴더가 git으로 관리되고 있는지 확인해줘. 최근 커밋 3개도 보여줘

Claude가 git status와 git log를 실행해줄 것이다. 명령어를 몰라도 된다.

3. GitHub 체험 — Claude에게 GitHub에 대해 물어본다:

GitHub이 뭔지, Pull Request가 뭔지 비개발자한테 설명하듯 알려줘

QUIZ

Block 4는 실행 확인 후 칭찬 + 퀴즈 3개를 연속으로 진행한다.

사용자가 돌아오면 먼저 "잘하셨습니다! 방금 CLI와 git을 Claude Code를 통해 직접 사용한 겁니다. 명령어를 몰라도 Claude에게 말로 시키면 됩니다." 라고 칭찬한 뒤, 아래 퀴즈를 순서대로 출제한다.

Quiz 3: CLI

AskUserQuestion({
  "questions": [{
    "question": "방금 Claude가 현재 폴더 위치를 알려줄 때 사용한 명령어는?",
    "header": "Quiz 3",
    "options": [
      {"label": "pwd", "description": "Print Working Directory — 현재 위치 출력"},
      {"label": "ls", "description": "목록 보기"},
      {"label": "cd", "description": "폴더 이동"},
      {"label": "where", "description": "이런 명령어는 없음"}
    ],
    "multiSelect": false
  }]
})

정답: pwd (Print Working Directory) 피드백: "맞습니다! 직접 외울 필요는 없지만, Claude가 뒤에서 뭘 하는지 알면 더 똑똑하게 시킬 수 있습니다."

Quiz 4: git

AskUserQuestion({
  "questions": [{
    "question": "방금 Claude가 최근 커밋을 보여줬죠. git에서 '게임 세이브'에 해당하는 동작은?",
    "header": "Quiz 4",
    "options": [
      {"label": "git commit", "description": "현재 상태를 저장"},
      {"label": "git clone", "description": "폴더 다운로드"},
      {"label": "git push", "description": "업로드"},
      {"label": "git save", "description": "이런 명령어는 없음"}
    ],
    "multiSelect": false
  }]
})

정답: git commit 피드백: "정확합니다! commit = 세이브. 뭘 해도 돌아갈 수 있으니 실험을 두려워하지 마세요."

Quiz 5: GitHub

AskUserQuestion({
  "questions": [{
    "question": "GitHub에서 '이렇게 바꿨는데 괜찮아?' 하고 리뷰를 요청하는 것은?",
    "header": "Quiz 5",
    "options": [
      {"label": "Pull Request (PR)", "description": "변경사항 리뷰 요청"},
      {"label": "Merge", "description": "리뷰 통과 후 합치기"},
      {"label": "git push", "description": "업로드"},
      {"label": "Issue", "description": "버그/기능 요청 등록"}
    ],
    "multiSelect": false
  }]
})

정답: Pull Request (PR) 피드백: "훌륭합니다! CLI, git, GitHub — 이 세 가지를 직접 체험했습니다. 앞으로 Claude에게 말로 시키면 되니까, 명령어 자체를 외울 필요는 전혀 없습니다."