이 과정에 대하여
Claude Code로 나만의 AI 에이전트 팀을 구축하는 실전 가이드입니다.
- 대상: 개발자가 아닌 모든 직무 (마케팅, 기획, 영업, HR 등)
- 방식: 실전 가이드 중심, 막히면 해결하는 방법 포함
- 목적: 기억용 아카이브 + 새 환경에서 빠른 도입
왜 Claude Code인가?
| 일반 AI 챗봇 | Claude Code |
|---|
| 웹 브라우저에서 대화 | 터미널에서 직접 작업 |
| 파일 업로드해서 분석 | 프로젝트 전체를 이해 |
| 결과물 복사-붙여넣기 | 파일 직접 생성/수정 |
| 매번 맥락 설명 | CLAUDE.md로 맥락 유지 |
| 일회성 대화 | 스킬로 반복 작업 자동화 |
핵심 철학: 혼자 일하지만, 팀으로 일한다
| 혼자 일하는 사람 | AI 팀과 일하는 사람 |
|---|
| 모든 업무를 직접 처리 | 역할별 AI에게 위임 |
| 맥락을 매번 설명 | CLAUDE.md로 맥락 유지 |
| 반복 작업에 시간 소모 | 스킬로 자동화 |
| 한 가지 관점으로 검토 | 여러 에이전트로 다각도 검토 |
| 도구 하나만 사용 | MCP로 여러 서비스 연동 |
상황별 선택 가이드
| 상황 | 추천 챕터 |
|---|
| ”처음 시작한다” | → 1~3장 순서대로 |
| ”회사 전체 업무 자동화” | → 4장 (스타트업 팀) |
| “프로덕트 출시 프로젝트” | → 5장 (스쿼드 팀) |
| “기능별로 가볍게 쓰고 싶다” | → 6장 (테마 에이전트) |
| “특정 작업만 반복 자동화” | → 3장 (스킬 시스템) |
| “외부 도구 연동하고 싶다” | → 부록 B (MCP 서버) |
| “뭔가 안 된다” | → 부록 C (트러블슈팅) |
에이전트 팀 구성 미리보기
🚀 스타트업 팀 (10명)
전 직무를 커버하는 범용 팀 구성
| 역할 | 담당 | 활용 예시 |
|---|
| CEO | 전략, 의사결정 | ”CEO 관점에서 검토해줘” |
| COO | 운영, 프로세스 | ”SOP 작성해줘” |
| 마케팅 | 콘텐츠, 광고 | ”SNS 포스트 만들어줘” |
| 영업 | 세일즈, 제안 | ”제안서 초안 작성해줘” |
| 기획/PM | 제품 기획 | ”PRD 작성해줘” |
| 디자이너 | UI/UX, 브랜딩 | ”디자인 피드백 줘” |
| CS | 고객 응대 | ”고객 문의 답변해줘” |
| HR | 채용, 조직 | ”JD 작성해줘” |
| 재무 | 회계, 예산 | ”예산 분석해줘” |
| 법무 | 계약, 컴플라이언스 | ”계약서 검토해줘” |
🎯 스쿼드 팀 (10명)
프로덕트 조직 중심 팀 구성
| 역할 | 담당 | 활용 예시 |
|---|
| PM | 제품 전략, 로드맵 | ”로드맵 검토해줘” |
| PO | 백로그, 스프린트 | ”유저 스토리 작성해줘” |
| UX 리서처 | 사용자 조사 | ”인터뷰 가이드 만들어줘” |
| 디자이너 | UI/UX 설계 | ”와이어프레임 피드백 줘” |
| 데이터 분석가 | 지표, 분석 | ”퍼널 분석해줘” |
| 마케팅 | GTM, 캠페인 | ”출시 전략 세워줘” |
| 그로스 | 실험, 최적화 | ”A/B 테스트 설계해줘” |
| 콘텐츠 | 문서, 가이드 | ”헬프센터 문서 작성해줘” |
| CS | VOC, 피드백 | ”피드백 분류해줘” |
| QA | 테스트, 품질 | ”테스트 케이스 작성해줘” |
🎭 테마 에이전트
기능 중심의 유연한 구성
| 테마 | 에이전트 예시 | 특징 |
|---|
| 신화 | Athena, Hermes, Apollo | 기억하기 쉬운 캐릭터 |
| 군대 | Commander, Scout, Engineer | 명확한 지휘 체계 |
| 스포츠 | Coach, Striker, Defender | 팀워크 중심 |
| 기본 | Orchestrator, Researcher, Writer | 직관적 기능 명 |
필요한 것
| 항목 | 설명 | 비용 |
|---|
| Claude Code | 터미널 기반 AI 도구 | 무료 설치 |
| Anthropic API | Claude 모델 접근 | 사용량 기반 과금 |
| 터미널 | Mac/Linux/Windows | 무료 |
| Node.js | v18 이상 | 무료 |
이 과정을 마치면
환경 구축
- Claude Code 설치 및 API 설정
- CLAUDE.md로 프로젝트 맥락 관리
- 스킬 시스템으로 반복 작업 자동화
- MCP 서버로 외부 서비스 연동
에이전트 팀 운영
- 상황에 맞는 팀 구성 선택 (스타트업/스쿼드/테마)
- 역할별 에이전트 프롬프트 설계
- 멀티 에이전트 협업 워크플로우
- 에이전트 체이닝으로 복잡한 작업 처리
실무 적용
- 기획서 작성부터 검토까지 자동화
- 리서치 → 분석 → 보고서 파이프라인
- 반복 업무의 스킬화
- 팀 전체가 공유하는 설정 구축
문제 해결
- 에러 메시지 해석 및 해결
- 막혔을 때 스스로 해결하는 방법
- 커뮤니티 리소스 활용
참고한 GitHub 레포지토리
Anthropic 공식
커뮤니티 큐레이션
설정/템플릿
에이전트/워크플로우
공식 문서
업데이트 로그