Claude Code와 멀티 에이전트 하네스 입문

프롬프트 하나에서 팀 하나로. Claude Desktop App을 기본 도구로, AI 에이전트 팀의 개념부터 직접 만들어 쓰는 방법까지 배우는 하루짜리 실전 입문 과정.

이 과정은 무엇인가? "AI에게 일을 시키는 것"을 넘어, 여러 AI 에이전트가 역할을 나누어 협력하는 팀을 구성하고 활용하는 방법을 배운다. 설치와 구독부터 에이전트·스킬·팀 생성까지 13개 장 + 3개 별첨을 따라 하면서, 자기 업무에 적용할 수 있는 실전 경험을 쌓는다.

기본 도구는 코딩 경험이 없어도 되는 Claude Desktop App이다. 원격 접속, Claude Code CLI, 저비용 백엔드(DeepSeek/GLM)는 별첨으로 분리해 필요한 사람만 심화 학습한다.

🎯학습 목표

이 과정을 수료한 참가자는 다음을 할 수 있다.

LO-1
설명단일 AI와 멀티 에이전트 팀의 차이를 컨텍스트·역할·병렬성 관점에서 설명하고, 하네스(harness) 개념을 이해한다.
LO-2
설치Claude Desktop App을 MacOS/Windows/Linux에 설치하고, 구독 플랜을 선택하며, 프로젝트와 첫 대화를 시작한다.
LO-3
구성실습 환경을 OS별 설치 스크립트로 구축하고 설치를 검증한다.
LO-4
개념에이전트·스킬·워크플로우, PM 오케스트레이션, 3-Tier 전략, PM Gateway, 디스패치 흐름 등 멀티 에이전트 하네스의 핵심 아키텍처를 설명한다.
LO-5
실행co-consult로 시장 분석 보고서를, co-deck으로 발표자료를 만들어보고, 두 시스템을 연동한 통합 파이프라인을 실행한다.
LO-6
창작자신의 업무에 맞는 에이전트(agent)와 스킬(skill)을 만들고 등록·검증하며, team-builder로 커스텀 에이전트 팀을 구성한다.
LO-7
자동화/sync 명령, Git/GitHub PR 자동화, Hook, CI/CD, dev-sync.ts 동작 원리를 이해하고 자동화 워크플로우를 활용한다.
LO-8
확장원격 접속 환경을 구성하고, Claude Code CLI로 같은 프로젝트를 실행하며, 저비용 백엔드(DeepSeek/GLM) API 키를 환경 변수로 설정해 연결한다.

👥대상자

이 과정은 AI 초보자를 주요 대상으로 한다. 코딩 경험이 없어도, 컴퓨터 기본 조작만 가능하면 따라올 수 있다.

참고: 이 핸드북은 Claude Desktop App을 기본 도구로 사용한다. 터미널/CLI가 익숙한 사용자는 별첨 B(Claude Code CLI)와 별첨 C(저비용 백엔드)로 심화할 수 있다. 원격으로 실습 환경에 접속해야 한다면 별첨 A를 먼저 본다.

📋사전 요구사항

구독·계정

☐ 활성 상태의 Claude Pro 구독 (이 핸드북은 Pro 구독을 전제로 한다)
☐ Claude.ai 계정 (Claude Desktop App 로그인용)

시스템 요구사항

☐ MacOS 또는 Windows 10/11 (Linux는 별첨 B의 Claude Code CLI로 진행)
☐ 최소 2GB 여유 디스크 공간, 인터넷 연결
☐ (권장) C:\git\project\setup 사전 설치 스크립트 폴더 준비 — 3장에서 상세 안내
⚠️ 사전 설치 필수. 강의 당일에 설치 문제로 시간을 낭비하지 않도록, 강의 시작 최소 하루 전에 3장 실습 환경 구축의 사전 체크리스트를 완료해 주세요. OS별 설치 스크립트가 준비되어 있다.

📖강의 형태

형태내용비율
강의개념 설명, 아키텍처 소개, 도구 비교약 30%
실습참가자 직접 설치·대화·프로젝트·에이전트·팀 생성약 55%
토론소그룹 토론, 확인 질문, 실습 결과 공유약 15%
실습 환경

전원이 Claude Desktop App으로 동일한 실습을 진행한다. 모든 명령어는 복사 버튼으로 그대로 사용할 수 있으며, MacOS/Windows/Linux 명령어를 나란히 제공해 어떤 환경에서도 따라올 수 있다.

🕐강의 일정

하루 총 소요 시간 약 6시간 40분 (휴식 제외). 휴식 2회(각 10~15분)를 포함하면 약 7시간~7시간 10분이다.

일정 구성 원칙

오전(Part 1)은 기초 개념과 환경 구축에 집중하고, 오후(Part 2·3·4)는 실습·창작·자동화를 통해 만든 것을 직접 응용한다. 별첨은 강의 후 필요에 따라 학습하도록 안내한다.

10분

도입

강의 목표·전체 로드맵 소개, 사전 준비물 확인

강의

25분

1장 · 왜 AI 에이전트 팀인가?

AI 트렌드, 단일 AI vs 에이전트 팀 비교, 하네스 개념, 기대 효과

강의 확인질문

30분

2장 · Claude Desktop App 시작하기

설치, 구독 플랜, 첫 대화, 프로젝트, Artifacts 실습

실습(참가자 직접)

30분

3장 · 실습 환경 구축

사전 체크리스트, OS별 설치 스크립트, 설치 검증

실습(참가자 직접)

☕ 휴식 1 (10~15분)
40분

4장 · 멀티 에이전트 하네스 개념

에이전트·스킬·워크플로우, PM 오케스트레이션, 3-Tier 전략, PM Gateway, 디스패치 흐름

강의 확인질문

10분

개념 확인 활동 · 짝지어 설명하기

방금 배운 하네스 개념(에이전트·스킬·워크플로우, PM Gateway)을 2인 1조로 서로 설명하며 즉시 정리한다.

활동(짝 활동)

30분

5장 · ai-workspace-standards 살펴보기

저장소 구조(L0→L1→L2), AGENTS.md/CLAUDE.md 역할, variant 개념, 템플릿 상속

강의

40분

6장 · co-consult: AI 컨설팅 실습

PM 대화법, 7-Phase 워크플로우, 시장 분석 프로젝트 실습, 산출물 확인

실습(참가자 직접)

40분

7장 · co-deck: AI 프레젠테이션 실습

11-Stage 파이프라인, theme/style 선택, Gate 승인, 미니 발표자료 실습

실습(참가자 직접)

☕ 휴식 2 (10~15분)
30분

8장 · co-consult + co-deck 통합 파이프라인

보고서 → 발표자료 연동, 풀 파이프라인 실습(주제 입력 → 완성 발표자료)

실습(참가자 직접) 결과 공유

35분

9장 · 에이전트 만들기와 수정

에이전트 파일 형식, frontmatter, agent-lifecycle-manager, 간단한 전문 에이전트 작성 실습

실습(참가자 직접)

35분

10장 · 스킬 만들기와 수정

스킬 파일 형식, trigger, skill-lifecycle-manager + skill-creator, 커스텀 스킬 작성 실습

실습(참가자 직접)

30분

11장 · 나만의 에이전트 팀 구성하기

team-builder 5-step 워크플로우, 자기 분야 커스텀 에이전트 팀 제안서 받기

실습(참가자 직접)

25분

12장 · 워크플로우와 자동화 이해

/sync 명령, Git/GitHub PR 자동화, Hook, CI/CD 기초, dev-sync.ts

강의

20분

13장 · 다음 단계 + 마무리

학습 로드맵, 커뮤니티, 응용 시나리오, FAQ, 전체 회고

토론

📚다루는 주제

파트주제관련 장
기초 개념AI 에이전트 팀의 필요성, 하네스 개념, Claude Desktop App 설치·구독·프로젝트, 실습 환경 구축1~3장
하네스 이해에이전트·스킬·워크플로우, PM 오케스트레이션, 3-Tier 전략, ai-workspace-standards 구조4~5장
실습co-consult 컨설팅, co-deck 프레젠테이션, 통합 파이프라인6~8장
창작에이전트 생성, 스킬 생성, 나만의 에이전트 팀 구성9~11장
자동화/sync, Git/GitHub, Hook, CI/CD, dev-sync.ts12장
마무리학습 로드맵, 커뮤니티, 응용 시나리오, FAQ13장
심화(별첨)원격 접속(Tailscale/NoMachine/RDP), Claude Code CLI, 저비용 백엔드(DeepSeek/GLM/LiteLLM)별첨 A/B/C

✅수료 후 얻게 되는 것

🎤강사 정보

[강사 이름 · 소속 · 직함]

[강사 프로필: AI 에이전트 도입/운영 경험, 주요 관심 분야, 연락처]

이 섹션은 강사가 직접 채워 넣도록 비워둔 영역이다.

🔗참고 자료