Claude 에이전트
실전 마스터 클래스
실제 화면을 보면서 따라하는 자동화 구축 가이드. 코딩 없이 시작하고, 단계적으로 확장합니다.
목차
Cowork 실전 제작
코딩 없이 Claude Desktop 앱에서 에이전트를 만들고 자동화합니다.
아침 브리핑 에이전트
Apple Silicon (M1+) 필수
macOS Sonoma 14+ 권장
Intel Mac 미지원
Windows 10 (1809+) 이상
최신 Claude Desktop 필수
RAM 8GB+ 권장
구독: Claude Pro ($20/월) 이상 · claude.com/download
앱 상단 Chat | Cowork | Code 탭에서 Cowork 선택 → 하단 "Work in a Folder"로 작업 폴더 지정.
Cowork는 지정된 폴더 안에서만 파일을 읽고 씁니다. 테스트 폴더로 시작하세요.
Settings > Connectors에서 Gmail, Calendar 등을 연결 후 작업을 지시합니다.
"오늘의 브리핑" 요약 문서를 만들어서
바탕화면/DailyBrief/ 폴더에 날짜별로 저장해줘
① Gmail — 중요 메일 확인
② Calendar — 오늘 일정
③ Slack — 미읽음 DM
④ 브리핑 문서 생성 & 저장
Calendar ✓ — 4개 일정
Slack ✓ — 2개 DM
📄 ~/Desktop/DailyBrief/2026-04-14_브리핑.md
바탕화면 & 다운로드 자동 정리
📸 스크린샷 → Screenshots/YYYY-MM/
📄 문서 → Documents/YYYY-MM/
🖼️ 이미지 → Images/
📦 나머지 → Others/
정리 후 로그 파일을 만들어줘.
📸 Screenshots — 34개
📄 Documents — 21개
🖼️ Images — 15개
📦 Others — 13개
📋 cleanup-log-20260414.txt
/schedule로 자동 반복 설정
📅 스케줄 작업 설정
각 작업 클릭 → 과거 실행 히스토리(성공/실패/건너뜀) 확인 가능. PC가 꺼져서 건너뛴 작업은 앱 재실행 시 자동 실행됩니다.
Skills & Plugin으로 에이전트 강화
앞으로 보고서 작성 시 자동 적용됩니다.
Data Analyst
CSV·Excel 분석 & 시각화
Content Writer
블로그·SNS 콘텐츠 제작
Marketing
경쟁사 분석·캠페인 기획
HR Operations
채용·온보딩 자동화
Skill = 하나의 지시문. "보고서는 이 형식으로 써"
Plugin = Skill + Connector + 서브에이전트 패키지. "마케팅 전문가 모드"
📱 모바일 Dispatch
📅 일정 4개
· 10:00 팀 스탠드업
· 14:00 디자인 리뷰
· 16:00 1:1 미팅
· 19:00 러닝 클럽
📧 중요 메일 3개
· [긴급] 서버 점검 안내
· 프로젝트 일정 변경
· 분기 리뷰 초대
① PC↔폰 대화 실시간 동기화
② 폰에서 작업 지시 → PC에서 실행
③ 완료 시 푸시 알림
④ 결과 파일 모바일에서 확인
PC가 켜져있고 Claude Desktop 앱이 실행 중이어야 합니다.
서브에이전트 & 에이전트 팀
여러 에이전트가 동시에 협업합니다. 프롬프트 한 줄로 팀을 구성할 수 있습니다.
에이전트 팀이란?
지금까지
사원 1명에게
"리서치도 하고, 보고서도 쓰고, PPT도 만들어"
에이전트 팀
사원 A: 리서치
사원 B: 보고서
사원 C: PPT
① 서브에이전트
팀장 1명 + 부하직원 N명
팀장이 일을 나눠주고 결과 종합
┌──┼──┐
📋A 📋B 📋C
└──┼──┘
📊 종합 결과
② 에이전트 팀
동료 N명이 공유 칸반보드를 보고
각자 할 일을 골라서 작업
┌───┬───┐
🧑A 🧑B 🧑C
각자 선택해서 작업
🔄 서로 결과 공유
Cowork에서 서브에이전트 쓰기
🔍 리서처 — 시장 트렌드 조사
✍️ 라이터 — 보고서 본문 작성
🎨 디자이너 — 차트·인포그래픽
"N개 서브에이전트로 동시에 처리해"
"병렬로 작업해"
"각각 다른 에이전트가 담당하게 해"
언제 뭘 써야 하나요?
| 상황 | 추천 | 이유 |
|---|---|---|
| 간단한 작업 1개 | 그냥 시키기 | 서브에이전트 불필요 |
| 파일 10개 분석 | 서브에이전트 | 독립 작업 → 병렬 효과 큼 |
| 리서치→보고서→PPT | 역할 지정 | 의존성 있지만 부분 병렬 가능 |
| 대규모 코드 리뷰 | 에이전트 팀 | 결과 공유 & 교차 검증 |
| 순서 중요한 작업 | ❌ 쓰지 마세요 | 한 에이전트가 낫습니다 |
서브에이전트 3개 = 토큰 약 3배. 간단한 작업에는 낭비입니다.
Claude Code 실전 제작
터미널 기반 에이전트. 클라우드 스케줄링으로 PC 꺼져도 24/7 자동화.
설치 & CLAUDE.md 설정
에이전트가 매 세션마다 자동으로 읽는 설정 파일입니다.
| 파일 위치 | 범위 | 용도 | Git |
|---|---|---|---|
| ~/.claude/CLAUDE.md | 전역 | 개인 스타일, 공통 규칙 | ❌ |
| ./CLAUDE.md | 프로젝트 | 기술 스택, API 규칙 | ✓ 팀 공유 |
| ./CLAUDE.local.md | 개인 오버라이드 | 내 개인 설정 | ❌ |
| 하위폴더/CLAUDE.md | 디렉토리별 | 모노레포 하위 규칙 | 선택 |
읽는 순서: ~/.claude/ → ./CLAUDE.md → 하위폴더 → .local.md (나중이 우선)
CLAUDE.md 없으면 에이전트는 매번 백지 상태. 있으면 세션마다 자동으로 맥락을 파악합니다. CLAUDE.md = 에이전트의 업무 매뉴얼.
에러 모니터링 & Slack 알림
/loop — 터미널 세션 안에서만. 닫으면 종료.
/schedule — Desktop 앱에 영구 저장.
클라우드 — PC 꺼져도 Anthropic 서버에서 실행.
☁️ 클라우드 24/7 스케줄
Cloud Scheduled Tasks
하네스 엔지니어링
"그냥 만들어줘" 대신, 설계도를 먼저 세우고 맡기는 방법.
2D 액션 게임으로 배우는 하네스
❌ 바이브 코딩
"2D 게임 만들어줘"
→ 벽 뚫고 지나감
→ 적이 안 움직임
→ 수정하면 다른 곳 깨짐
→ 3시간 후 포기
✓ 하네스 엔지니어링
① CLAUDE.md 설계도 작성
② Phase별 구현 계획
③ 각 Phase 테스트 기준
④ AI가 단계별 실행+검증
⑤ 동작하는 게임 완성
바이브 코딩이었다면 리팩토링으로 Phase 2~3이 깨졌을 것. CLAUDE.md의 "금지 규칙"이 AI를 잡아줍니다.
하네스 = 설계(CLAUDE.md) + 단계(Phase) + 검증(테스트) + 가드레일(금지 규칙)
📝 CLAUDE.md에 쓸 것
✓ 기술 스택 & 제약
✓ Phase 분할
✓ 각 Phase 완료 조건
✓ 금지 사항
🎯 실행 시 지킬 것
✓ 한 번에 한 Phase
✓ 확인 후 다음 단계
✓ 문제 시 롤백 후 재시도
✓ 최종 통합 테스트
현황 확인 총정리
현황 확인 방법
| 방법 | 위치 | 확인 내용 |
|---|---|---|
| Cowork Scheduled | Desktop 사이드바 | 실행 히스토리, 성공/실패, 결과물 |
| Dispatch | Claude 모바일 앱 | 실시간 대화, 완료 알림, 추가 지시 |
| claude.ai/code/scheduled | 웹브라우저 | 클라우드 스케줄, 세션, 비용, 로그 |
| Channels | Telegram / Discord | Claude Code 실행 결과 수신 |
| 로컬 파일 | 내 PC 폴더 | 에이전트가 저장한 보고서·로그 |
1단계 — Claude Desktop 설치 → Cowork "아침 브리핑" → /schedule
2단계 — 파일 정리, 보고서 추가 → Dispatch로 모바일 확인
3단계 — Claude Code → 클라우드 스케줄 24/7 → Channels 알림
"아침 브리핑" 하나로 시작해서 프롬프트를 매일 조금씩 다듬으세요. 프롬프트가 설계도이고, 좋은 프롬프트 = 좋은 에이전트입니다.